{
  "module": "hexa.parse_abc",
  "content": {
    "path": "hexa.parse_abc",
    "docstring": "Parse an ABC Python module into a hexa PortNode tree.",
    "objects": {
      "annotations": {
        "name": "annotations",
        "kind": "alias",
        "path": "hexa.parse_abc.annotations",
        "signature": "<bound method Alias.signature of Alias('annotations', '__future__.annotations')>",
        "docstring": null
      },
      "dataclasses": {
        "name": "dataclasses",
        "kind": "alias",
        "path": "hexa.parse_abc.dataclasses",
        "signature": "<bound method Alias.signature of Alias('dataclasses', 'dataclasses')>",
        "docstring": null
      },
      "importlib": {
        "name": "importlib",
        "kind": "alias",
        "path": "hexa.parse_abc.importlib",
        "signature": "<bound method Alias.signature of Alias('importlib', 'importlib')>",
        "docstring": null
      },
      "inspect": {
        "name": "inspect",
        "kind": "alias",
        "path": "hexa.parse_abc.inspect",
        "signature": "<bound method Alias.signature of Alias('inspect', 'inspect')>",
        "docstring": null
      },
      "sys": {
        "name": "sys",
        "kind": "alias",
        "path": "hexa.parse_abc.sys",
        "signature": "<bound method Alias.signature of Alias('sys', 'sys')>",
        "docstring": null
      },
      "ABC": {
        "name": "ABC",
        "kind": "alias",
        "path": "hexa.parse_abc.ABC",
        "signature": "<bound method Alias.signature of Alias('ABC', 'abc.ABC')>",
        "docstring": null
      },
      "Path": {
        "name": "Path",
        "kind": "alias",
        "path": "hexa.parse_abc.Path",
        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
        "docstring": null
      },
      "Any": {
        "name": "Any",
        "kind": "alias",
        "path": "hexa.parse_abc.Any",
        "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
        "docstring": null
      },
      "ConfigValue": {
        "name": "ConfigValue",
        "kind": "attribute",
        "path": "hexa.parse_abc.ConfigValue",
        "signature": "<bound method Alias.signature of Alias('ConfigValue', 'hexa.model.ConfigValue')>",
        "docstring": null
      },
      "MethodSpec": {
        "name": "MethodSpec",
        "kind": "class",
        "path": "hexa.parse_abc.MethodSpec",
        "signature": "<bound method Alias.signature of Alias('MethodSpec', 'hexa.model.MethodSpec')>",
        "docstring": "Specification of a single abstract method.",
        "members": {
          "name": {
            "name": "name",
            "kind": "attribute",
            "path": "hexa.parse_abc.MethodSpec.name",
            "signature": "<bound method Alias.signature of Alias('name', 'hexa.model.MethodSpec.name')>",
            "docstring": null
          },
          "args": {
            "name": "args",
            "kind": "attribute",
            "path": "hexa.parse_abc.MethodSpec.args",
            "signature": "<bound method Alias.signature of Alias('args', 'hexa.model.MethodSpec.args')>",
            "docstring": null
          },
          "kwargs": {
            "name": "kwargs",
            "kind": "attribute",
            "path": "hexa.parse_abc.MethodSpec.kwargs",
            "signature": "<bound method Alias.signature of Alias('kwargs', 'hexa.model.MethodSpec.kwargs')>",
            "docstring": null
          }
        }
      },
      "PortNode": {
        "name": "PortNode",
        "kind": "class",
        "path": "hexa.parse_abc.PortNode",
        "signature": "<bound method Alias.signature of Alias('PortNode', 'hexa.model.PortNode')>",
        "docstring": "A node in the hexa port tree.\n\nParameters\n----------\nname : str\n    Slot name, e.g. ``\"parser\"``, ``\"amount_balance\"``.\nkind : 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``)\nport_cls : str\n    ABC class name that gives this port its shape, e.g.\n    ``\"TransactionParserPort\"``.  Every port has a concrete typed shape.\nattributes : dict[str, ConfigValue]\n    Annotated attributes: ``name -> type_expr`` for scalars, or a nested\n    ``dict`` of sub-attributes (a struct) for grouped/structured values.\nchildren : list[PortNode]\n    Nested port slots.\nmethods : dict[str, MethodSpec]\n    Abstract methods keyed by method name.",
        "members": {
          "name": {
            "name": "name",
            "kind": "attribute",
            "path": "hexa.parse_abc.PortNode.name",
            "signature": "<bound method Alias.signature of Alias('name', 'hexa.model.PortNode.name')>",
            "docstring": null
          },
          "port_cls": {
            "name": "port_cls",
            "kind": "attribute",
            "path": "hexa.parse_abc.PortNode.port_cls",
            "signature": "<bound method Alias.signature of Alias('port_cls', 'hexa.model.PortNode.port_cls')>",
            "docstring": null
          },
          "kind": {
            "name": "kind",
            "kind": "attribute",
            "path": "hexa.parse_abc.PortNode.kind",
            "signature": "<bound method Alias.signature of Alias('kind', 'hexa.model.PortNode.kind')>",
            "docstring": null
          },
          "attributes": {
            "name": "attributes",
            "kind": "attribute",
            "path": "hexa.parse_abc.PortNode.attributes",
            "signature": "<bound method Alias.signature of Alias('attributes', 'hexa.model.PortNode.attributes')>",
            "docstring": null
          },
          "children": {
            "name": "children",
            "kind": "attribute",
            "path": "hexa.parse_abc.PortNode.children",
            "signature": "<bound method Alias.signature of Alias('children', 'hexa.model.PortNode.children')>",
            "docstring": null
          },
          "methods": {
            "name": "methods",
            "kind": "attribute",
            "path": "hexa.parse_abc.PortNode.methods",
            "signature": "<bound method Alias.signature of Alias('methods', 'hexa.model.PortNode.methods')>",
            "docstring": null
          },
          "find": {
            "name": "find",
            "kind": "function",
            "path": "hexa.parse_abc.PortNode.find",
            "signature": "<bound method Alias.signature of Alias('find', 'hexa.model.PortNode.find')>",
            "docstring": "Find a direct child by slot name."
          },
          "walk": {
            "name": "walk",
            "kind": "function",
            "path": "hexa.parse_abc.PortNode.walk",
            "signature": "<bound method Alias.signature of Alias('walk', 'hexa.model.PortNode.walk')>",
            "docstring": "Return all nodes in depth-first order (self first)."
          },
          "diff": {
            "name": "diff",
            "kind": "function",
            "path": "hexa.parse_abc.PortNode.diff",
            "signature": "<bound method Alias.signature of Alias('diff', 'hexa.model.PortNode.diff')>",
            "docstring": "Return a list of human-readable difference strings.\n\nAn empty list means the trees are equal."
          }
        }
      },
      "parse_abc": {
        "name": "parse_abc",
        "kind": "function",
        "path": "hexa.parse_abc.parse_abc",
        "signature": "<bound method Function.signature of Function('parse_abc', 17, 81)>",
        "docstring": "Parse an ABC Python module into a :class:`PortNode` tree.\n\nABC classes become port nodes.  A nested-struct attribute is expressed as a\n``@dataclass`` annotation on an ABC port (e.g. ``source: ExtractionSource``\nwhere ``ExtractionSource`` is a ``@dataclass``); the dataclass's fields are\nexpanded into a nested ``attributes`` entry.\n\nParameters\n----------\nmodule_or_path : str | Path | Any\n    A file path to a ``.py`` file, a module import string, or a loaded module.\n\nReturns\n-------\nPortNode\n    The root node of the tree."
      }
    }
  }
}