dryv-author 0.0.1__tar.gz

dryv_author-0.0.1/.gitignore

@@ -0,0 +1,28 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+venv/
+build/
+dist/
+generated/
+# Node / editors
+node_modules/
+.vscode-test/
+.idea
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Dryv local cache and materialized resources
+.dryv/

dryv_author-0.0.1/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.5
+Name: dryv-author
+Version: 0.0.1
+Summary: Lightweight typed Python authoring SDK for Dryv
+License: Apache-2.0
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# 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
+
+```python
+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](../../../../.docs/reference/decisions/0011-declaration-owned-feature-membership.md)).
+
+## API map (TypeScript → Python)
+
+| TypeScript | Python |
+| --- | --- |
+| `property.string.uuid()` | `prop.string.uuid()` |
+| `property.number.integer({ range: { min: 0 } })` | `prop.number.integer(range={"min": 0})` |
+| `field(x).createOnly()` | `field(x).create_only()` |
+| `.query({ filter: ["notEqual"] })` | `.query(filter=["not-equal"])` (`not_equal` also accepted) |
+| `expression.and(...)`, `.or(...)`, `.not(...)` | `expression.all_of(...)`, `.any_of(...)`, `.not_(...)` |
+| `operation().async()` | `operation().async_()` |
+| `operationStep`, `waitFor`, `outputFrom`, `inputFrom` | `operation_step`, `wait_for`, `output_from`, `input_from` |
+| `group.policies(ref1, ref2)` | same: a mapping registers, refs set scope policies |
+
+## Development
+
+```bash
+uv sync
+uv run ruff format . && uv run ruff check --fix . && uv run mypy && uv run pytest
+```

dryv_author-0.0.1/README.md

@@ -0,0 +1,58 @@
+# 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
+
+```python
+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](../../../../.docs/reference/decisions/0011-declaration-owned-feature-membership.md)).
+
+## API map (TypeScript → Python)
+
+| TypeScript | Python |
+| --- | --- |
+| `property.string.uuid()` | `prop.string.uuid()` |
+| `property.number.integer({ range: { min: 0 } })` | `prop.number.integer(range={"min": 0})` |
+| `field(x).createOnly()` | `field(x).create_only()` |
+| `.query({ filter: ["notEqual"] })` | `.query(filter=["not-equal"])` (`not_equal` also accepted) |
+| `expression.and(...)`, `.or(...)`, `.not(...)` | `expression.all_of(...)`, `.any_of(...)`, `.not_(...)` |
+| `operation().async()` | `operation().async_()` |
+| `operationStep`, `waitFor`, `outputFrom`, `inputFrom` | `operation_step`, `wait_for`, `output_from`, `input_from` |
+| `group.policies(ref1, ref2)` | same: a mapping registers, refs set scope policies |
+
+## Development
+
+```bash
+uv sync
+uv run ruff format . && uv run ruff check --fix . && uv run mypy && uv run pytest
+```

dryv_author-0.0.1/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dryv-author"
+version = "0.0.1"
+description = "Lightweight typed Python authoring SDK for Dryv"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "Apache-2.0" }
+dependencies = []
+
+[dependency-groups]
+dev = [
+    "mypy>=1.17",
+    "pytest>=8.4",
+    "ruff>=0.12",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dryv_author"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F", "I", "UP", "B", "SIM", "RUF"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "lf"
+docstring-code-format = true
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+files = ["src", "tests"]
+pretty = true
+show_error_codes = true
+warn_unreachable = true
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+addopts = ["--strict-config", "--strict-markers", "-ra"]

dryv_author-0.0.1/src/dryv_author/__init__.py

@@ -0,0 +1,184 @@
+"""Dryv Python Author SDK.
+
+Declare software meaning in Python; the matching ``dryv-compiler`` lowers it to canonical
+Runtime IR. The API mirrors the TypeScript author with Pythonic names::
+
+    from dryv_author import dryv, field, operation, prop, schema
+
+    users = dryv.group("users")
+    accounts = users.feature("Accounts")
+    ids = accounts.properties({"Id": prop.string.uuid()})
+    models = accounts.schemas({"User": schema({"id": field(ids.Id).system()})})
+    app = dryv.app("example").groups(users)
+"""
+
+from ._version import AUTHOR_REPRESENTATION_VERSION, AUTHOR_VERSION, __version__
+from .behavior import (
+    EventDeclaration,
+    FailureDeclaration,
+    HttpFacet,
+    OperationDeclaration,
+    PolicyDeclaration,
+    ScheduleFacet,
+    WebSocketFacet,
+    body,
+    bytes_,
+    cookie,
+    csv,
+    daily,
+    event,
+    event_stream,
+    failure,
+    form,
+    header,
+    hours,
+    http,
+    interval,
+    json,
+    minutes,
+    multipart,
+    operation,
+    path,
+    policy,
+    port,
+    query,
+    query_object,
+    representation,
+    respond,
+    schedule,
+    seconds,
+    text,
+    websocket,
+    xml,
+)
+from .composition import (
+    AppDeclaration,
+    ApplicationDeclaration,
+    FeatureDeclaration,
+    GroupDeclaration,
+    application,
+    dryv,
+    feature,
+    is_dryv_app,
+)
+from .core import AuthoringError, OperationRef, Ref, Refs, SchemaRef, ViewRef, WorkflowRef
+from .expressions import ExpressionDeclaration, context, duration, expression, value
+from .interaction import (
+    SurfaceDeclaration,
+    ViewDeclaration,
+    input_from,
+    output_from,
+    part,
+    surface,
+    view,
+)
+from .orchestration import (
+    WorkflowDeclaration,
+    operation_step,
+    wait_for,
+    workflow,
+    workflow_step,
+)
+from .properties import TypeParameter, enum_member, prop
+from .schemas import (
+    FieldSpec,
+    SchemaDeclaration,
+    dynamic,
+    field,
+    projection,
+    relation,
+    schema,
+    source,
+    storage,
+    unknown,
+)
+from .state import AuthorState, StringFormat
+
+__all__ = [
+    "AUTHOR_REPRESENTATION_VERSION",
+    "AUTHOR_VERSION",
+    "AppDeclaration",
+    "ApplicationDeclaration",
+    "AuthorState",
+    "AuthoringError",
+    "EventDeclaration",
+    "ExpressionDeclaration",
+    "FailureDeclaration",
+    "FeatureDeclaration",
+    "FieldSpec",
+    "GroupDeclaration",
+    "HttpFacet",
+    "OperationDeclaration",
+    "OperationRef",
+    "PolicyDeclaration",
+    "Ref",
+    "Refs",
+    "ScheduleFacet",
+    "SchemaDeclaration",
+    "SchemaRef",
+    "StringFormat",
+    "SurfaceDeclaration",
+    "TypeParameter",
+    "ViewDeclaration",
+    "ViewRef",
+    "WebSocketFacet",
+    "WorkflowDeclaration",
+    "WorkflowRef",
+    "__version__",
+    "application",
+    "body",
+    "bytes_",
+    "context",
+    "cookie",
+    "csv",
+    "daily",
+    "dryv",
+    "duration",
+    "dynamic",
+    "enum_member",
+    "event",
+    "event_stream",
+    "expression",
+    "failure",
+    "feature",
+    "field",
+    "form",
+    "header",
+    "hours",
+    "http",
+    "input_from",
+    "interval",
+    "is_dryv_app",
+    "json",
+    "minutes",
+    "multipart",
+    "operation",
+    "operation_step",
+    "output_from",
+    "part",
+    "path",
+    "policy",
+    "port",
+    "projection",
+    "prop",
+    "query",
+    "query_object",
+    "relation",
+    "representation",
+    "respond",
+    "schedule",
+    "schema",
+    "seconds",
+    "source",
+    "storage",
+    "surface",
+    "text",
+    "unknown",
+    "value",
+    "view",
+    "wait_for",
+    "websocket",
+    "workflow",
+    "workflow_step",
+    "xml",
+]

dryv_author-0.0.1/src/dryv_author/_version.py

@@ -0,0 +1,6 @@
+AUTHOR_VERSION = "0.0.1"
+AUTHOR_REPRESENTATION_VERSION = "dryv.author.python/v1alpha5"
+
+__version__ = AUTHOR_VERSION
+
+__all__ = ["AUTHOR_REPRESENTATION_VERSION", "AUTHOR_VERSION", "__version__"]