Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

autodoc-py

Generate Python API reference pages for DreamLake Dockit. Python 3.10+; no runtime dependencies. Source is parsed with Python's AST, never imported, so historical versions do not need their dependencies installed and application startup code does not execute.

python -m pip install dreamlake-autodoc-py==0.2.0a1
autodoc-py src/vuer --module vuer --output docs/pages/api \
  --section 'Python API' \
  --source-url https://github.com/vuer-ai/vuer/blob/main/src/vuer

For reproducible builds, pin installation to a commit and use the documented revision's commit SHA in --source-url. Run the command on each version branch against its matching source directory (vuer or src/vuer). Set --url-prefix when the public API root differs from /api; links use absolute routes so they work with or without trailing slashes. The output follows Dockit's pages/**/+Page.mdx convention and includes frontmatter for navigation and search.

The generator emits module docstrings, public classes and functions, class methods and constructors, annotated and assigned class attributes, signatures, and source links. Local explicit and star imports produce linked public re-export indexes; local base classes contribute inherited member lists. Literal __all__ controls which locally defined classes/functions are included. Private modules and tests are skipped. MDX expression and JSX characters in prose are escaped, while inline and fenced code are preserved. A manifest tracks generated files so removed modules disappear without deleting manual pages. All Python files are parsed before output changes.

Group modules into topic pages

By default, each public module gets its own page. Use --page-map api-pages.json to combine related modules into a small set of reader-facing pages, each with an API index and its functions, classes, and methods:

autodoc-py src/example --module example --output docs/pages/api \
  --page-map api-pages.json
{
  "pages": [
    {
      "slug": "configuration",
      "title": "Configuration",
      "description": "Create and load configuration objects.",
      "modules": ["example", "example.config"],
      "symbols": {"example.config": ["Config", "load"]}
    },
    {
      "slug": "cli",
      "title": "Command-line interface",
      "description": "Parse arguments and generate command help.",
      "modules": ["example.cli", "example.cli.*"]
    }
  ],
  "exclude": {"example.legacy*": "Historical compatibility implementation"}
}

modules accepts exact names or glob patterns; every public module must belong to exactly one page or match an explicit exclusion. Patterns must match existing modules. The optional symbols mapping selects names per module; omit it to include that module's public API. Omitted symbols or excluded modules cannot remain targets of generated API links. Each page may also set intro and order.

Heading anchors include the source module, such as /api/configuration#example.config--config, so identically named symbols from different modules remain distinct. Generated re-export and inheritance links point into these topic pages. .autodoc-routes.json records the old module routes and anchors for configuring redirects in your host; the generator does not install redirects itself.

Public singleton assignments such as EnvVar = _EnvVar() document the local class's API under the public instance name, without executing its constructor. Google-style Args, Returns, and related sections become readable Markdown; indented Example and Examples blocks become fenced Python code, preserving comments and literal braces. Existing Markdown fences and lists are preserved.

This is static source documentation: dynamically generated members, external-package re-exports and inheritance, module-qualified base expressions, and runtime signatures are not resolved. Local inheritance is resolved in base declaration order with overridden names suppressed; this is not a complete Python C3 method-resolution implementation. Docstrings retain their text; Sphinx roles and directives are not executed. Use the preserved Sphinx builds when exact historical Sphinx rendering is required. Syntax must be supported by the Python interpreter running the generator.

The distribution name is dreamlake-autodoc-py; the command is autodoc-py. It is a standard Python package built with setuptools, compatible with both pip and uv. Until a PyPI release is available, install from Git as above or run directly with uv:

uvx --from git+https://github.com/dreamlake-ai/autodoc-py.git autodoc-py --help

See usage and integration and release notes.

Development:

python -m pip install -e .
python -m unittest discover -s tests -v
# Build the wheel and source distribution with uv:
uv build

Historical compatibility: validation/vuer-tags-2026-09-07.json records successful source generation and generated link/anchor checks across all 149 upstream Vuer tags, including the original tassa/, intermediate vuer/, and modern src/vuer/ package layouts. This checks source compatibility and internal links, not historical runtime behavior or MDX compilation. Re-run with:

python validation/audit_vuer_tags.py /path/to/vuer --report /tmp/vuer-audit.json

Python reference display

Generated pages include API cards with constructor and callable signatures, linked local types, parameter/default tables, return values, bases, attributes, and labeled properties/static/class/async methods. Public type aliases and trailing attribute docstrings are included. Google and Sphinx parameter fields are formatted without executing directives. The generator copies autodoc.css next to its output and imports it from each page; no shell patch is needed.

NamedTuple/dataclass field signatures reflect source declarations. Dynamically created APIs and external inherited constructors are not executed or inferred.

Metadata

Release files for dreamlake-autodoc-py 0.2.0a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dreamlake-autodoc-py 0.2.0a1
File Size Uploaded Provenance Actions
dreamlake_autodoc_py-0.2.0a1.tar.gz 30.7 kB Without provenance Details for dreamlake_autodoc_py-0.2.0a1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for dreamlake-autodoc-py 0.2.0a1
File Interpreter ABI Platform Actions
dreamlake_autodoc_py-0.2.0a1-py3-none-any.whl Python 3 none any Details for dreamlake_autodoc_py-0.2.0a1-py3-none-any.whl

Total release size: 53.0 kB

Release files / dreamlake_autodoc_py-0.2.0a1.tar.gz

Download URL dreamlake_autodoc_py-0.2.0a1.tar.gz
Size 30.7 kB
Tags Source
SHA-256 checksum
How to use checksums
64b31e265da22f71b3252ddd98c910ad9d04c138ca72d7ef6cd2cdcc911a0736
BLAKE2b-256 checksum
How to use checksums
9de35a8a3aa965041ebc10020605a65774cbf3e2712d21f05297ac0cfec55528
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / dreamlake_autodoc_py-0.2.0a1-py3-none-any.whl

Download URL dreamlake_autodoc_py-0.2.0a1-py3-none-any.whl
Size 22.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7c64897c1f32afcbe23a08b17dd8ff9609b9ebe0e72d5ef9fd4b6b73340454b9
BLAKE2b-256 checksum
How to use checksums
912b97a02f7b725270fc03ebbb38fb958bec854dcbd1f01af84687a26d3ee969
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for dreamlake-autodoc-py 0.2.0a1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page