python-saga-orchestrator 0.1.2__tar.gz → 0.1.4__tar.gz

{python_saga_orchestrator-0.1.2/python_saga_orchestrator.egg-info → python_saga_orchestrator-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-saga-orchestrator
-Version: 0.1.2
+Version: 0.1.4
 Summary: Lightweight embedded saga orchestrator for asyncio Python services
 Author-email: Maxim Vasilyev <mayxis@inbox.ru>
 License-Expression: MIT
@@ -51,6 +51,7 @@ Unlike external workflow platforms, this library runs inside your service and st
 - persisted saga state through `SagaStateMixin`
 - runtime execution through `SagaOrchestrator` and `SagaEngine`
 - retry, timeout, recovery, and compensation
+- async queue-style steps through `StepAwaitEvent` and `notify(...)`
 - administrative operations through `SagaAdmin`
 - PostgreSQL-first reliability using `SELECT ... FOR UPDATE`
 
@@ -277,6 +278,23 @@ token = await orchestrator.await_event(
 
 The event payload is stored in saga context and can be used by root-step `input_map` functions through `InputContext`.
 
+For distributed consumers, use transactional inbox ingestion first, then process inbox rows:
+
+```python
+stored = await orchestrator.ingest_event(
+    aggregation_id="order-123",
+    event={
+        "event_id": "evt-123",
+        "event_type": "payment.completed",
+        "correlation_id": "corr-123",
+        "payload": {"payment_id": "pay-1"},
+    },
+)
+
+if stored:
+    await orchestrator.run_inbox_due(limit=100)
+```
+
 ## Administrative operations
 
 Get the full persisted state:
@@ -334,6 +352,7 @@ A runnable end-to-end example is available in:
 - [`examples/retry_recovery.py`](./examples/retry_recovery.py)
 - [`examples/compensation_flow.py`](./examples/compensation_flow.py)
 - [`examples/admin_skip.py`](./examples/admin_skip.py)
+- [`examples/http_and_queue.py`](./examples/http_and_queue.py)
 
 These examples demonstrate:
 - basic model deployment

{python_saga_orchestrator-0.1.2 → python_saga_orchestrator-0.1.4}/README.md

@@ -17,6 +17,7 @@ Unlike external workflow platforms, this library runs inside your service and st
 - persisted saga state through `SagaStateMixin`
 - runtime execution through `SagaOrchestrator` and `SagaEngine`
 - retry, timeout, recovery, and compensation
+- async queue-style steps through `StepAwaitEvent` and `notify(...)`
 - administrative operations through `SagaAdmin`
 - PostgreSQL-first reliability using `SELECT ... FOR UPDATE`
 
@@ -243,6 +244,23 @@ token = await orchestrator.await_event(
 
 The event payload is stored in saga context and can be used by root-step `input_map` functions through `InputContext`.
 
+For distributed consumers, use transactional inbox ingestion first, then process inbox rows:
+
+```python
+stored = await orchestrator.ingest_event(
+    aggregation_id="order-123",
+    event={
+        "event_id": "evt-123",
+        "event_type": "payment.completed",
+        "correlation_id": "corr-123",
+        "payload": {"payment_id": "pay-1"},
+    },
+)
+
+if stored:
+    await orchestrator.run_inbox_due(limit=100)
+```
+
 ## Administrative operations
 
 Get the full persisted state:
@@ -300,6 +318,7 @@ A runnable end-to-end example is available in:
 - [`examples/retry_recovery.py`](./examples/retry_recovery.py)
 - [`examples/compensation_flow.py`](./examples/compensation_flow.py)
 - [`examples/admin_skip.py`](./examples/admin_skip.py)
+- [`examples/http_and_queue.py`](./examples/http_and_queue.py)
 
 These examples demonstrate:
 - basic model deployment

{python_saga_orchestrator-0.1.2 → python_saga_orchestrator-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-saga-orchestrator"
-version = "0.1.2"
+version = "0.1.4"
 description = "Lightweight embedded saga orchestrator for asyncio Python services"
 readme = "README.md"
 requires-python = ">=3.12"

{python_saga_orchestrator-0.1.2 → python_saga_orchestrator-0.1.4/python_saga_orchestrator.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-saga-orchestrator
-Version: 0.1.2
+Version: 0.1.4
 Summary: Lightweight embedded saga orchestrator for asyncio Python services
 Author-email: Maxim Vasilyev <mayxis@inbox.ru>
 License-Expression: MIT
@@ -51,6 +51,7 @@ Unlike external workflow platforms, this library runs inside your service and st
 - persisted saga state through `SagaStateMixin`
 - runtime execution through `SagaOrchestrator` and `SagaEngine`
 - retry, timeout, recovery, and compensation
+- async queue-style steps through `StepAwaitEvent` and `notify(...)`
 - administrative operations through `SagaAdmin`
 - PostgreSQL-first reliability using `SELECT ... FOR UPDATE`
 
@@ -277,6 +278,23 @@ token = await orchestrator.await_event(
 
 The event payload is stored in saga context and can be used by root-step `input_map` functions through `InputContext`.
 
+For distributed consumers, use transactional inbox ingestion first, then process inbox rows:
+
+```python
+stored = await orchestrator.ingest_event(
+    aggregation_id="order-123",
+    event={
+        "event_id": "evt-123",
+        "event_type": "payment.completed",
+        "correlation_id": "corr-123",
+        "payload": {"payment_id": "pay-1"},
+    },
+)
+
+if stored:
+    await orchestrator.run_inbox_due(limit=100)
+```
+
 ## Administrative operations
 
 Get the full persisted state:
@@ -334,6 +352,7 @@ A runnable end-to-end example is available in:
 - [`examples/retry_recovery.py`](./examples/retry_recovery.py)
 - [`examples/compensation_flow.py`](./examples/compensation_flow.py)
 - [`examples/admin_skip.py`](./examples/admin_skip.py)
+- [`examples/http_and_queue.py`](./examples/http_and_queue.py)
 
 These examples demonstrate:
 - basic model deployment

{python_saga_orchestrator-0.1.2 → python_saga_orchestrator-0.1.4}/python_saga_orchestrator.egg-info/SOURCES.txt

@@ -27,8 +27,18 @@ saga_orchestrator/domain/models/saga_snapshot.py
 saga_orchestrator/domain/models/step.py
 saga_orchestrator/domain/models/enums/__init__.py
 saga_orchestrator/domain/models/enums/saga_status.py
+saga_orchestrator/inbox/__init__.py
+saga_orchestrator/inbox/contracts.py
+saga_orchestrator/inbox/dispatcher.py
+saga_orchestrator/inbox/models.py
+saga_orchestrator/inbox/repository.py
+saga_orchestrator/inbox/retry.py
 saga_orchestrator/outbox/__init__.py
+saga_orchestrator/outbox/contracts.py
 saga_orchestrator/outbox/dispatcher.py
 saga_orchestrator/outbox/event.py
+saga_orchestrator/outbox/factory.py
 saga_orchestrator/outbox/models.py
-saga_orchestrator/outbox/repository.py
+saga_orchestrator/outbox/repository.py
+saga_orchestrator/outbox/retry.py
+saga_orchestrator/outbox/serialization.py

{python_saga_orchestrator-0.1.2 → python_saga_orchestrator-0.1.4}/saga_orchestrator/__init__.py

@@ -24,37 +24,82 @@ from .domain.models import (
     SagaAdminSnapshot,
     SagaDefinition,
     SagaSnapshot,
+    StepAwaitEvent,
     StepDefinition,
     StepInputMap,
     StepRef,
 )
 from .domain.models.enums import SagaStatus
+from .inbox import (
+    ClaimedInboxMessage,
+    FixedInboxRetry,
+    InboxDispatcher,
+    InboxMessageMixin,
+    InboxProcessor,
+    InboxProcessOutcome,
+    InboxProcessStatus,
+    InboxRepository,
+    InboxRetryPolicy,
+    InboxStatus,
+    InboxWriteMessage,
+    InboxWriter,
+)
 from .outbox import (
+    ClaimedOutboxMessage,
+    DefaultOutboxMessageFactory,
+    FixedOutboxDispatchRetry,
+    JsonOutboxSerializer,
     OutboxDispatcher,
+    OutboxDispatchRetryPolicy,
     OutboxEvent,
+    OutboxMessageFactory,
     OutboxMessageMixin,
     OutboxPublisher,
     OutboxRepository,
+    OutboxSerializer,
     OutboxStatus,
+    OutboxWriteMessage,
+    OutboxWriter,
 )
 
 __all__ = [
     "ActiveSagaAlreadyExistsError",
     "AwaitingEvent",
     "BaseStep",
+    "ClaimedInboxMessage",
+    "ClaimedOutboxMessage",
+    "DefaultOutboxMessageFactory",
     "ExponentialRetry",
+    "FixedInboxRetry",
+    "FixedOutboxDispatchRetry",
     "FixedRetry",
+    "InboxDispatcher",
+    "InboxMessageMixin",
+    "InboxProcessOutcome",
+    "InboxProcessStatus",
+    "InboxProcessor",
+    "InboxRepository",
+    "InboxRetryPolicy",
+    "InboxStatus",
+    "InboxWriteMessage",
+    "InboxWriter",
     "InputContext",
+    "JsonOutboxSerializer",
     "NotifyEvent",
     "NotifyResult",
     "NoRetry",
     "OutboxDispatcher",
+    "OutboxDispatchRetryPolicy",
     "OutboxEvent",
+    "OutboxMessageFactory",
     "OutboxMap",
     "OutboxMessageMixin",
     "OutboxPublisher",
     "OutboxRepository",
+    "OutboxSerializer",
     "OutboxStatus",
+    "OutboxWriteMessage",
+    "OutboxWriter",
     "RetryPolicy",
     "SagaAdmin",
     "SagaAdminSnapshot",
@@ -70,6 +115,7 @@ __all__ = [
     "SagaStateMixin",
     "SagaStatus",
     "StepDefinition",
+    "StepAwaitEvent",
     "StepInputMap",
     "StepRef",
     "TypeValidationError",