python-saga-orchestrator 0.2.4__tar.gz → 0.3.0__tar.gz

{python_saga_orchestrator-0.2.4 → python_saga_orchestrator-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-saga-orchestrator
-Version: 0.2.4
+Version: 0.3.0
 Summary: Lightweight embedded saga orchestrator for asyncio Python services
 Author-email: Maxim Vasilyev <mayxis@inbox.ru>
 License-Expression: MIT

{python_saga_orchestrator-0.2.4 → python_saga_orchestrator-0.3.0}/python_saga_orchestrator.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-saga-orchestrator
-Version: 0.2.4
+Version: 0.3.0
 Summary: Lightweight embedded saga orchestrator for asyncio Python services
 Author-email: Maxim Vasilyev <mayxis@inbox.ru>
 License-Expression: MIT

{python_saga_orchestrator-0.2.4 → python_saga_orchestrator-0.3.0}/python_saga_orchestrator.egg-info/SOURCES.txt

@@ -43,6 +43,7 @@ saga_orchestrator/domain/models/retry.py
 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/base_str_enum.py
 saga_orchestrator/domain/models/enums/saga_status.py
 saga_orchestrator/domain/models/enums/saga_step_phase.py
 saga_orchestrator/domain/models/enums/saga_step_status.py

{python_saga_orchestrator-0.2.4 → python_saga_orchestrator-0.3.0}/saga_orchestrator/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.2.4'
-__version_tuple__ = version_tuple = (0, 2, 4)
+__version__ = version = '0.3.0'
+__version_tuple__ = version_tuple = (0, 3, 0)
 
 __commit_id__ = commit_id = None

python_saga_orchestrator-0.3.0/saga_orchestrator/domain/models/enums/base_str_enum.py

@@ -0,0 +1,10 @@
+from enum import StrEnum
+
+
+class BaseStrEnum(StrEnum):
+    @staticmethod
+    def _generate_next_value_(name, start, count, last_values) -> str:
+        """
+        Return the upper-cased version of the member name.
+        """
+        return name.upper()

python_saga_orchestrator-0.3.0/saga_orchestrator/domain/models/enums/saga_status.py

@@ -0,0 +1,17 @@
+from enum import auto
+
+from .base_str_enum import BaseStrEnum
+
+
+class SagaStatus(BaseStrEnum):
+    RUNNING = auto()
+    SUSPENDED = auto()
+    FAILED = auto()
+    COMPENSATING = auto()
+    COMPLETED = auto()
+    COMPENSATING_SUSPENDED = auto()
+    COMPENSATED = auto()
+
+    @property
+    def is_terminal(self) -> bool:
+        return self in {self.FAILED, self.COMPLETED, self.COMPENSATED}

python_saga_orchestrator-0.3.0/saga_orchestrator/domain/models/enums/saga_step_phase.py

@@ -0,0 +1,9 @@
+from enum import auto
+
+from .base_str_enum import BaseStrEnum
+
+
+class SagaStepPhase(BaseStrEnum):
+    COMPENSATE = auto()
+    SUCCESS = auto()
+    EXECUTE = auto()

python_saga_orchestrator-0.3.0/saga_orchestrator/domain/models/enums/saga_step_status.py

@@ -0,0 +1,9 @@
+from enum import auto
+
+from .base_str_enum import BaseStrEnum
+
+
+class SagaStepStatus(BaseStrEnum):
+    SUCCESS = auto()
+    ERROR = auto()
+    WAITING = auto()

{python_saga_orchestrator-0.2.4 → python_saga_orchestrator-0.3.0}/saga_orchestrator/domain/models/step.py

@@ -119,19 +119,24 @@ class BaseStep(Generic[InputModelT, OutputModelT]):
 
         concrete_args = get_args(generic_base)
         if not concrete_args or any(isinstance(arg, TypeVar) for arg in concrete_args):
-            raise TypeValidationError(f"Step '{cls.__name__}' inherits from a generic Step "
-                                      "but was not parameterized with concrete Input/Output models.")
+            raise TypeValidationError(
+                f"Step '{cls.__name__}' inherits from a generic Step "
+                "but was not parameterized with concrete Input/Output models."
+            )
 
         concrete_input_model, concrete_output_model = concrete_args
         try:
-            hints = get_type_hints(cls.execute, globalns=inspect.getmodule(cls).__dict__, include_extras=True)
+            hints = get_type_hints(
+                cls.execute,
+                globalns=inspect.getmodule(cls).__dict__,
+                include_extras=True,
+            )
         except (AttributeError, NameError) as e:
-             raise TypeValidationError(
+            raise TypeValidationError(
                 f"Could not resolve type hints for '{cls.__name__}.execute'. "
                 f"Ensure all types are correctly imported. Original error: {e}"
             )
 
-
         if "inp" not in hints or "return" not in hints:
             raise TypeValidationError(
                 f"Step '{cls.__name__}' must type annotate execute(inp) and return type"
@@ -144,7 +149,9 @@ class BaseStep(Generic[InputModelT, OutputModelT]):
             input_model = input_annotation
 
         return_annotation = hints["return"]
-        output_model = cls._resolve_output_model(return_annotation, concrete_output_model)
+        output_model = cls._resolve_output_model(
+            return_annotation, concrete_output_model
+        )
         if not (inspect.isclass(input_model) and issubclass(input_model, BaseModel)):
             raise TypeValidationError(
                 f"Step '{cls.__name__}' input must inherit from pydantic BaseModel"
@@ -153,7 +160,9 @@ class BaseStep(Generic[InputModelT, OutputModelT]):
         cls.output_model = output_model
 
     @staticmethod
-    def _resolve_output_model(annotation: Any, concrete_model: type[BaseModel] | None = None) -> type[BaseModel]:
+    def _resolve_output_model(
+        annotation: Any, concrete_model: type[BaseModel] | None = None
+    ) -> type[BaseModel]:
         def find_model_in_args(args_tuple: tuple) -> list[type[BaseModel]]:
             candidates = []
             for arg in args_tuple:

{python_saga_orchestrator-0.2.4 → python_saga_orchestrator-0.3.0}/tests/integration/test_admin_api.py

@@ -58,7 +58,7 @@ async def test_admin_retry_rejects_failed_saga_after_compensation(session_maker)
     )
     state = await admin.get_saga(saga_id)
     assert state.status == SagaStatus.COMPENSATED
-    assert any(entry.phase == "compensate" for entry in state.step_history)
+    assert any(entry.phase == "COMPENSATE" for entry in state.step_history)
 
     with pytest.raises(SagaStateError):
         await admin.retry_step(saga_id)
@@ -150,7 +150,7 @@ async def test_admin_compensate_rolls_back_suspended_saga(session_maker):
     state_after = await admin.get_saga(saga_id)
     assert state_after.status == SagaStatus.COMPENSATED
     assert compensating_step.compensated is True
-    assert any(entry.phase == "compensate" for entry in state_after.step_history)
+    assert any(entry.phase == "COMPENSATE" for entry in state_after.step_history)
 
 
 @pytest.mark.asyncio
@@ -225,7 +225,7 @@ async def test_get_admin_snapshot_returns(session_maker):
     assert isinstance(admin_snapshot.step_history, list)
     assert len(admin_snapshot.step_history) == 1
     assert admin_snapshot.step_history[0].step_name == "AddOneStep"
-    assert admin_snapshot.step_history[0].status == "success"
+    assert admin_snapshot.step_history[0].status == "SUCCESS"
 
 
 @pytest.mark.asyncio

{python_saga_orchestrator-0.2.4 → python_saga_orchestrator-0.3.0}/tests/unit/test_input_context.py

@@ -81,6 +81,6 @@ def test_input_context_properties_parametrized(
     )
 
     assert input_ctx.latest_event_type == expected_type, f"Failed on test: {test_id}"
-    assert (
-        input_ctx.latest_event_payload == expected_payload
-    ), f"Failed on test: {test_id}"
+    assert input_ctx.latest_event_payload == expected_payload, (
+        f"Failed on test: {test_id}"
+    )

{python_saga_orchestrator-0.2.4 → python_saga_orchestrator-0.3.0}/tests/unit/test_step_type_resolution.py

@@ -40,7 +40,6 @@ class StepAwaitEvent:
     event_types: tuple[str, ...] | None = None
 
 
-
 IntermediateInputT = TypeVar("IntermediateInputT", bound=BaseModel)
 IntermediateOutputT = TypeVar("IntermediateOutputT", bound=BaseModel)
 
@@ -48,18 +47,19 @@ IntermediateOutputT = TypeVar("IntermediateOutputT", bound=BaseModel)
 class AbstractIntermediateStep(
     BaseStep[IntermediateInputT, IntermediateOutputT],
     ABC,
-    Generic[IntermediateInputT, IntermediateOutputT]
+    Generic[IntermediateInputT, IntermediateOutputT],
 ):
     @abstractmethod
     def some_abstract_method(self):
         pass
 
-    async def execute(self, inp: IntermediateInputT) -> IntermediateOutputT | StepAwaitEvent:
+    async def execute(
+        self, inp: IntermediateInputT
+    ) -> IntermediateOutputT | StepAwaitEvent:
         pass
 
 
 class TestTypeResolution:
-
     def test_indirect_inheritance_resolves_types_correctly(self):
         """
         GIVEN a concrete step class inheriting from a generic abstract step
@@ -97,6 +97,7 @@ class TestTypeResolution:
         THEN TypeValidationError should be raised.
         """
         with pytest.raises(TypeValidationError, match="must type annotate execute"):
+
             class FaultyStep(BaseStep[InputModelA, OutputModelA]):
                 # `inp` не аннотирован
                 async def execute(self, inp) -> OutputModelA:
@@ -114,6 +115,7 @@ class TestTypeResolution:
             pass
 
         with pytest.raises(TypeValidationError, match="Could not resolve type hints"):
+
             class FaultyStep(BaseStep[InputModelA, OutputModelA]):
                 async def execute(self, inp: NotAModel) -> OutputModelA:
                     pass
@@ -124,7 +126,11 @@ class TestTypeResolution:
         WHEN the class is defined
         THEN TypeValidationError should be raised by our custom logic.
         """
-        with pytest.raises(TypeValidationError, match="inherits from a generic Step but was not parameterized with concrete Input/Output models"):
+        with pytest.raises(
+            TypeValidationError,
+            match="inherits from a generic Step but was not parameterized with concrete Input/Output models",
+        ):
+
             class UnparameterizedStep(AbstractIntermediateStep):
                 def some_abstract_method(self):
                     pass

python_saga_orchestrator-0.2.4/saga_orchestrator/domain/models/enums/saga_status.py

@@ -1,15 +0,0 @@
-from enum import StrEnum
-
-
-class SagaStatus(StrEnum):
-    RUNNING = "RUNNING"
-    SUSPENDED = "SUSPENDED"
-    FAILED = "FAILED"
-    COMPENSATING = "COMPENSATING"
-    COMPLETED = "COMPLETED"
-    COMPENSATING_SUSPENDED = "COMPENSATING_SUSPENDED"
-    COMPENSATED = "COMPENSATED"
-
-    @property
-    def is_terminal(self) -> bool:
-        return self in {self.FAILED, self.COMPLETED, self.COMPENSATED}

python_saga_orchestrator-0.2.4/saga_orchestrator/domain/models/enums/saga_step_phase.py

@@ -1,7 +0,0 @@
-from enum import StrEnum, auto
-
-
-class SagaStepPhase(StrEnum):
-    COMPENSATE = auto()
-    SUCCESS = auto()
-    EXECUTE = auto()

python_saga_orchestrator-0.2.4/saga_orchestrator/domain/models/enums/saga_step_status.py

@@ -1,7 +0,0 @@
-from enum import StrEnum, auto
-
-
-class SagaStepStatus(StrEnum):
-    SUCCESS = auto()
-    ERROR = auto()
-    WAITING = auto()