zettcode-sdk 0.3.4__tar.gz

zettcode_sdk-0.3.4/.gitignore

@@ -0,0 +1,37 @@
+**/.venv/
+**/__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.smoke/
+.coverage
+**/.pytest_cache/
+**/.ruff_cache/
+.zett-tool-output/
+.env
+.DS_Store
+
+# viztracer writes its trace here by default.
+/result.json
+
+# The docs site: dependencies, build output, and VitePress' cache.
+node_modules/
+docs/.vitepress/dist/
+docs/.vitepress/cache/
+docs/.vitepress/.temp/
+
+# The TypeScript client is built from its sources; only dist/ is published.
+clients/typescript/dist/
+
+# The gateway's page is built from clients/gateway into the package when a distribution is made (`make gateway-ui`);
+# the build output is not kept in the repository. pyproject's `artifacts` puts it in the wheel all the same.
+packages/zettcode-gateway/src/zettcode/gateway/static/
+
+# The palette gallery is generated by `make palettes`: every widget painted in
+# every palette, written by docs/scripts/palette_gallery.py. Regenerate it
+# rather than committing a 2 MB copy that goes stale the moment a colour moves.
+docs/internal/palettes.html
+
+# The release order is generated from the pyproject.toml files (`make order`); it is not kept in git.
+packages/order.txt

zettcode_sdk-0.3.4/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.5
+Name: zettcode-sdk
+Version: 0.3.4
+Summary: The documented, stable Python surface over ZettCode: sessions, runs, models, daemons
+Project-URL: Repository, https://github.com/Chang-LeHung/zettcode
+Author: Chang-LeHung
+License-Expression: MIT
+Keywords: agent,sdk,zettcode
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: zett-agent<0.3,>=0.2.7
+Requires-Dist: zettcode-broker
+Requires-Dist: zettcode-engine

zettcode_sdk-0.3.4/pyproject.toml

@@ -0,0 +1,45 @@
+[project]
+name = "zettcode-sdk"
+description = "The documented, stable Python surface over ZettCode: sessions, runs, models, daemons"
+requires-python = ">=3.10"
+dynamic = ["version"]
+license = "MIT"
+authors = [{name = "Chang-LeHung"}]
+keywords = ["zettcode", "sdk", "agent"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3.15",
+  "Typing :: Typed",
+]
+dependencies = [
+  "zettcode-engine",
+  "zettcode-broker",
+  "zett-agent>=0.2.7,<0.3",
+  "httpx>=0.27,<1",
+]
+
+[project.urls]
+Repository = "https://github.com/Chang-LeHung/zettcode"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+# One version for the whole repository: the engine ships the file.
+path = "../zettcode-engine/src/zettcode/version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/zettcode"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

zettcode_sdk-0.3.4/src/zettcode/daemon/__init__.py

@@ -0,0 +1,17 @@
+"""Background agents: a session with nobody at the keyboard, which other sessions reach with ``send_message``.
+
+    zettcode daemon spawn          # start one; it prints the session id it is messaged by
+    zettcode daemon list           # every daemon on this machine, alive or dead
+    zettcode daemon kill <id>      # stop one, and remove its record; the session stays
+
+A daemon is an ordinary session — stored where every session is, resumable in the terminal afterwards — plus a
+record of its process under ``~/.zettcode/daemon/<workspace>/<session-id>/`` (:mod:`.state`) and the loop that
+answers messages (:mod:`.run`). :mod:`.process` starts it detached and stops it; :mod:`.cli` is the command.
+"""
+
+from __future__ import annotations
+
+#: The shell levels a daemon can be given. There is no ``ask``: nobody is there to answer it.
+PERMISSIONS = ("deny", "safe", "full")
+
+__all__ = ["PERMISSIONS", "cli", "process", "run", "state"]

zettcode_sdk-0.3.4/src/zettcode/daemon/__main__.py

@@ -0,0 +1,10 @@
+"""``python -m zettcode.daemon``: what ``daemon spawn`` starts, and nothing a reader calls by hand."""
+
+from __future__ import annotations
+
+import sys
+
+from .cli import daemon_program
+
+if __name__ == "__main__":
+    raise SystemExit(daemon_program(sys.argv[1:]))