feat: serve docs flat at /<repo>/ with no redirects

- collect.py copies each repo's built site contents directly to a
  top-level <repo>/ dir (was libs|apis|wiki/<repo>/site nesting)
- nginx uses `index index.html lib/index.html api/index.html` so
  /dagpipe/ -> lib/index.html, /auth-server/ -> api/index.html are
  served internally with no redirects
- _index regenerates links against the flat layout
  (/dagpipe/lib/, /auth-server/api/, /mongo-ops/, /blog/...)
- config.yml static entries point at vendored blog/ + media-manager/
- Dockerfile copies per-repo dirs flat into the nginx html root
- removed stale libs/, apis/, wiki/, tutorials/ category trees
This commit is contained in:
2026-09-11 21:32:30 +05:30
parent 0c25cbb19f
commit a32eeaf2b4
882 changed files with 85 additions and 1982 deletions

View File

@@ -0,0 +1,181 @@
{
"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."
}
}
}
}