trigora 1.0.0__py3-none-any.whl

trigora/__init__.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from .sdk import effect, gather, invoke, program, race, sleep, wait_for_event
+
+__all__ = [
+    "effect",
+    "gather",
+    "invoke",
+    "program",
+    "race",
+    "sleep",
+    "wait_for_event",
+]

trigora/sdk.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+from collections.abc import Callable
+from typing import TypeVar
+
+T = TypeVar("T")
+
+
+def _require_runtime() -> None:
+    raise RuntimeError(
+        "Durable primitives can only run inside a Trigora execution. Start the program with the Trigora client while `trigora dev` is running."
+    )
+
+
+def program(fn: T) -> T:
+    return fn
+
+
+def effect(name: str, fn: Callable[[], T]) -> T:
+    if not isinstance(name, str) or not name.strip():
+        raise ValueError("effect(name, fn) requires a non-empty string key.")
+    if not callable(fn):
+        raise TypeError("effect(name, fn) requires a function.")
+    _require_runtime()
+
+
+def wait_for_event(name: str) -> object:
+    if not isinstance(name, str) or not name.strip():
+        raise ValueError("wait_for_event(name) requires a non-empty string.")
+    _require_runtime()
+
+
+def sleep(duration: float | str) -> None:
+    del duration
+    _require_runtime()
+
+
+def invoke(name: str, input: object | None = None) -> object:
+    del input
+    if not isinstance(name, str) or not name.strip():
+        raise ValueError("invoke(name, input) requires a non-empty program name.")
+    _require_runtime()
+
+
+def gather(*awaitables: object) -> object:
+    if not awaitables:
+        raise ValueError("gather() requires at least one awaitable.")
+    _require_runtime()
+
+
+def race(*awaitables: object) -> object:
+    if not awaitables:
+        raise ValueError("race() requires at least one awaitable.")
+    _require_runtime()

trigora-1.0.0.dist-info/METADATA

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: trigora
+Version: 1.0.0
+Summary: Authoring package for Trigora durable programs
+Author: Trigora
+License: MIT
+Project-URL: Homepage, https://trigora.dev
+Project-URL: Repository, https://github.com/trigora-dev/trigora-python
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: tcc-engine==26.10.2
+Requires-Dist: trigora-cli==1.0.0
+
+# trigora
+
+Python authoring SDK for Trigora durable programs.
+
+Build long-running programs that can call external systems, wait for events, sleep durably, invoke child executions, and recover from committed continuation state.
+
+## Install
+
+```bash
+pip install trigora
+```
+
+## Quick example
+
+```python
+from trigora import effect, program, wait_for_event
+
+
+@program
+async def approval():
+    result = await effect("generate", lambda: 42)
+    review = await wait_for_event("approved")
+    return {"result": result, "review": review}
+```
+
+Run it locally with:
+
+```bash
+trigora dev
+trigora start approval
+```
+
+## Program entry
+
+Trigora discovers programs from the paths configured in `trigora.toml`:
+
+```toml
+[project]
+name = "my-project"
+programs = ["src/**/*.py"]
+```
+
+Each matching file has one `@program` async function. That function is the program entry. The program id is the file name, so `src/approval.py` starts with `trigora start approval`.
+
+```python
+@program
+async def research(topic, depth="full"):
+    return {"topic": topic, "depth": depth}
+```
+
+The Python frontend implements `py.subset.v1`.
+
+Program parameters are plain. A default must be a constant: `None`, a bool, a finite number, or a string. A missing argument uses that default. Extra arguments are rejected.
+
+`*args`, keyword-only parameters, and positional-only parameters are not supported.
+
+A bare `async def` is not a program entry.
+
+## Durable primitives
+
+- `effect(name, fn)` — run a durable external effect
+- `sleep(duration)` — suspend on a durable timer
+- `wait_for_event(name)` — wait for an external event
+- `invoke(program, input)` — invoke a durable child execution
+- `gather(*awaitables)` — wait for every durable branch
+- `race(*awaitables)` — wait for the first durable branch
+
+Effect keys and event names are string literals in the current Python subset.
+
+## Local development
+
+```bash
+trigora init
+trigora dev
+trigora start approval
+trigora send <execution> approved --payload '"ok"'
+trigora result <execution>
+```
+
+Programs execute through the Trigora runtime rather than by running the source file directly.
+
+## Learn more
+
+- [Quickstart](https://trigora.dev/docs/quickstart)
+- [Trigora documentation](https://trigora.dev/docs)
+- [TCC Python semantics](https://github.com/trigora-dev/tcc-engine/blob/main/spec/python-subset.md)
+
+## License
+
+MIT © 2026 Trigora, Inc.

trigora-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+trigora/__init__.py,sha256=XiG7-veFcDhmJ7RLMvJDc7X8q27gswaNODkUFzjqH1o,233
+trigora/sdk.py,sha256=eVGO_U49QNb33eFeupbAzsrTCK-n3sP5-T2ioSH81BI,1501
+trigora-1.0.0.dist-info/METADATA,sha256=l3spbZA6uRwjyY5RkWrR-G_26kg5lbjmqKkCXdZKwS8,2854
+trigora-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+trigora-1.0.0.dist-info/top_level.txt,sha256=LCCNkZ4F9lAMKCBEGO-s4EDBZbL-q_1Mm2u42TS2d5E,8
+trigora-1.0.0.dist-info/RECORD,,

trigora-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

trigora-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+trigora