stubber

Role in Velarium: IR → .pyi — render Velarium (ModelSpec) IR as minimal stub text, and expose the stubber CLI for quick IR export and stub generation from live classes.

The IR types and builders live in velarium. stubber re-exports most public IR symbols from stubber for backward compatibility; prefer from velarium import … in new code when you only need IR.

Install

pip install stubber

From the monorepo root:

uv sync --group dev
# or
pip install -e packages/velarium -e "packages/stubber[dev]"

CLI

stubber ir myapp.models:User
stubber ir myapp.models:User -o user.ir.json
stubber stub myapp.models:User -o user.pyi

Library

from velarium import modelspec_from_dataclass, dumps_model_spec
from stubber import generate_pyi

spec = modelspec_from_dataclass(MyModel)
print(generate_pyi(spec))

Version

__version__ is in stubber/__init__.py (Hatch dynamic metadata in this package’s pyproject.toml).

See also

• docs/modelspec-ir.md — IR schema
• docs/valarium.md — ecosystem and backends
• Documentation index