{ "module": "hexa.model", "content": { "path": "hexa.model", "docstring": "# Summary\n\nShared neutral model for hexa port trees.\n\nAll utilities (``parse_yaml``, ``generate_abc``, ``parse_abc``,\n``generate_yaml``, ``check_matches``) serialize through this single model.\n\n---\n# Notes\n\n- The model is NOT tied to any sample — any port tree fits.", "objects": { "NestedConfig": { "name": "NestedConfig", "kind": "attribute", "path": "hexa.model.NestedConfig", "signature": null, "docstring": null }, "ConfigValue": { "name": "ConfigValue", "kind": "attribute", "path": "hexa.model.ConfigValue", "signature": null, "docstring": null }, "MethodSpec": { "name": "MethodSpec", "kind": "class", "path": "hexa.model.MethodSpec", "signature": "MethodSpec(name: str, args: list[str] = list(), kwargs: dict[str, str] = dict())", "docstring": "Specification of a single abstract method.\n\nAttributes:\n name (str):\n Name of the method.\n\n args (list[str]):\n Positional parameter names.\n\n kwargs (dict[str, str]):\n Keyword-only parameter names mapped to their type expressions.", "members": { "name": { "name": "name", "kind": "attribute", "path": "hexa.model.MethodSpec.name", "signature": null, "docstring": null }, "args": { "name": "args", "kind": "attribute", "path": "hexa.model.MethodSpec.args", "signature": null, "docstring": null }, "kwargs": { "name": "kwargs", "kind": "attribute", "path": "hexa.model.MethodSpec.kwargs", "signature": null, "docstring": null } } }, "PortNode": { "name": "PortNode", "kind": "class", "path": "hexa.model.PortNode", "signature": "PortNode(name: str, port_cls: str, kind: str = 'leaf', attributes: dict[str, ConfigValue] = dict(), children: list[PortNode] = list(), methods: dict[str, MethodSpec] = dict())", "docstring": "A node in the hexa port tree.\n\nEach node is a leaf (no children), a port (has nested port slots), or the\nparent root of the tree. Every node carries a concrete typed shape derived\nfrom an ABC class name.\n\nAttributes:\n name (str):\n Slot name, e.g. ``\"parser\"``, ``\"amount_balance\"``.\n\n port_cls (str):\n ABC class name that gives this port its shape, e.g.\n ``\"TransactionParserPort\"``. Every port has a concrete typed shape.\n\n kind (str):\n One of ``\"leaf\"``, ``\"port\"``, or ``\"parent\"``.\n - ``\"leaf\"``: no children (e.g. ``NumberPort``)\n - ``\"port\"``: has children (e.g. ``TransactionParserPort``)\n - ``\"parent\"``: the root of the tree (e.g. ``ExtractionPipeline``)\n\n attributes (dict[str, ConfigValue]):\n Annotated attributes: ``name -> type_expr`` for scalars, or a\n nested ``dict`` of sub-attributes (a struct) for grouped values.\n\n children (list[PortNode]):\n Nested port slots.\n\n methods (dict[str, MethodSpec]):\n Abstract methods keyed by method name.", "members": { "name": { "name": "name", "kind": "attribute", "path": "hexa.model.PortNode.name", "signature": null, "docstring": null }, "port_cls": { "name": "port_cls", "kind": "attribute", "path": "hexa.model.PortNode.port_cls", "signature": null, "docstring": null }, "kind": { "name": "kind", "kind": "attribute", "path": "hexa.model.PortNode.kind", "signature": null, "docstring": null }, "attributes": { "name": "attributes", "kind": "attribute", "path": "hexa.model.PortNode.attributes", "signature": null, "docstring": null }, "children": { "name": "children", "kind": "attribute", "path": "hexa.model.PortNode.children", "signature": null, "docstring": null }, "methods": { "name": "methods", "kind": "attribute", "path": "hexa.model.PortNode.methods", "signature": null, "docstring": null }, "find": { "name": "find", "kind": "function", "path": "hexa.model.PortNode.find", "signature": "find(name: str) -> PortNode | None", "docstring": "Find a direct child by slot name.\n\nArgs:\n name (str):\n Slot name of the child to look up.\n\nReturns:\n PortNode | None:\n The matching child node, or ``None`` if no child has that name." }, "walk": { "name": "walk", "kind": "function", "path": "hexa.model.PortNode.walk", "signature": "walk() -> list[PortNode]", "docstring": "Return all nodes in depth-first order (self first).\n\nReturns:\n list[PortNode]:\n All nodes of the tree, self first, depth-first." }, "diff": { "name": "diff", "kind": "function", "path": "hexa.model.PortNode.diff", "signature": "diff(other: PortNode, path: str = '') -> list[str]", "docstring": "Return a list of human-readable difference strings.\n\nAn empty list means the trees are equal.\n\nArgs:\n other (PortNode):\n Tree to compare against.\n\n path (str):\n Path prefix used when recursing into nested nodes; defaults to\n the root path.\n\nReturns:\n list[str]:\n Human-readable difference strings, one per discrepancy." } } } } } }