hyperbase

Changelog

[0.9.0] - 05-04-2026

Added

• readers (txt, url, wikipedia).
• cli interface with repl, parsers, readers.
• hyperedge.Hyperedge.match function (calls parsers.match_pattern).
• ParseResults.
• HyperEdge.text.
• load_edges function.

Changed

• added get_parser to main functions (at hyperbase root).
• improved documentation.
• hedge now accepts ParseResults and can recursively add Hyperedge.text strings.
• renamed function hyperedge.str2atom to str_to_atom.
• Hyperedge is not a frozen dataclasse, instead of inheriting from tuple.
• hedge now throws exceptions instead of returning None values.
• Hyperedge.contains always recursive, removed deep argument.
• simplified Hyperedge.simplify.
• Hyperedge.insert_argrole now private, renamed to Hyperedge._insert_argrole.
• Renamed Hyperedge.insert_edge_with_argrole to add_argument, pos optional (default to add at the end).
• Renamed Hyperedge.edges_with_argrole to arguments_with_role.
• Renamed Hyperedge.normalized to normalise.

Removed

• function patterns.edge_matches_pattern.
• deprecated and obsolete methods from Hyperedge: is_atom, to_str, roots, insert_first_argument, connect, sequence, contains_atom_type, main_concepts, replace_main_concept, has_argroles.

[0.8.0] - 26-03-2026 - hyperbase is the successor of graphbrain

Added

• parser plugin foundation.
• more comprehensive Hyperedge.check_correctness.
• check parse correctness.
• type checking: full code coverage.

Changed

• renamed library to hyperbase.
• trimmed down library to the essentials: hyperedge, patterns and parser foundations.
• converted documentation to Material for MkDocs.

Removed

• hypergraph module, hypergraph database (memory module).
• alphabeta parser implementation.
• old scripts, examples, processors.
• ad hoc utils.
• cli.
• notebook utils.
• obsolete constants.

Added

• patterns.is_wildcard().
• Base class hypergraph.memory.keyvalue.KeyValue for key-value hypergraph databases, removing redundant code between LevelDB and SQLite.
• Tests for LevelDB (only the SQLite Hypergraph implementation was being directly tested).
• Hyperedge.is_unordered_pattern().
• Functional pattern: any.
• Parser-level inference of coreferences between proper nouns.
• Parser.parse_and_add() now adds token information to the main edge of a sentence: the attribute 'tokens' contains the list of tokens and 'tok_pos' a structure with the token position for each atom in the edge.
• Post-processing step improves parser.
• Hypergraph.get_attributes().

Changed

• Entire project is now in pure Python
• Python >=3.10 now required.
• Hypergraph.search(), .match() and .count() now working with functional patterns and argument role matching.
• Fixed bug on match_pattern(), variables were not correctly matched when argument roles were specified past the first position in an atoms functional pattern.
• Simplified default systems connectors (breaks hypergraph DB backwards compatibility).
• max_text argument in parser.parse_and_add().
• Matches from patterns with repeated variables are collected in lists.

Removed

• graphbrain.logic obsolete module.
• LevelDB backend

Changed

• Hyperedge.replace_argroles() .insert_argrole() and .insert_edge_with_argrole() now works with functional patterns such as var.
• Fixed bug when matching patterns containing atoms functional pattern where no atom has argroles.

Removed

• interactive_case_generator() from graphbrain.notebook.