dryv-author

dryv-author is the Python Authoring SDK installed in an authored project. It mirrors the TypeScript author with Pythonic names, and produces a typed AuthorState that dryv-compiler lowers to canonical dryv.ir/v1alpha1.

The package does not depend on the Dryv Engine and never serializes Runtime IR, selects packs, renders templates, chooses output paths, or writes files.

Example

from dryv_author import body, dryv, field, http, operation, path, prop, respond, schema, storage

users = dryv.group("users")
accounts = users.feature("Accounts")                 # features are registration scopes

ids = accounts.properties({"Id": prop.string.uuid(), "Name": prop.string()})
models = accounts.schemas({
    "User": schema({
        "id": field(ids.Id).system(),
        "name": field(ids.Name).query(filter="*", sort=True),
    }).facets(storage=storage("users").primary_key("id")),
})

create = operation().role("create").inputs(models.User).outputs(models.User)
create.facets(
    http=http("POST", "/users").input(create.input(0), body()).output(create.output(0), respond(201)),
)
accounts.operations({"CreateUser": create})

users.schemas({"AuditEntry": schema({"id": field(ids.Id)})})   # group-owned: no feature

app = dryv.app("accounts").groups(users)

The entrypoint configured in dryv.yaml must expose exactly one module-level dryv.app(...). It may import ordinary modules; every registration records the caller's file and line.

Ownership

Registering through group.feature("Name") makes the group the declaration's group and the feature its feature. Registering directly on the group leaves it group-owned. A declaration can belong to one group and at most one feature (decision 0011).

API map (TypeScript → Python)

Development

uv sync
uv run ruff format . && uv run ruff check --fix . && uv run mypy && uv run pytest