aws-durable-execution-sdk-python 1.6.0__tar.gz → 2.0.0__tar.gz

{aws_durable_execution_sdk_python-1.6.0 → aws_durable_execution_sdk_python-2.0.0}/.gitignore

@@ -33,5 +33,7 @@ dist/
 
 **/build/
 **/*.zip
+.aws-sam/
+**/template.generated.json
 
-.env
+.env

{aws_durable_execution_sdk_python-1.6.0 → aws_durable_execution_sdk_python-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: aws-durable-execution-sdk-python
-Version: 1.6.0
+Version: 2.0.0
 Summary: AWS Durable Execution SDK for Python
 Project-URL: Documentation, https://github.com/aws/aws-durable-execution-sdk-python#readme
 Project-URL: Issues, https://github.com/aws/aws-durable-execution-sdk-python/issues
@@ -48,6 +48,56 @@ Build reliable, long-running AWS Lambda workflows with checkpointed steps, waits
 | `aws-durable-execution-sdk-python` | Execution SDK for Lambda durable functions | [![PyPI - Version](https://img.shields.io/pypi/v/aws-durable-execution-sdk-python.svg)](https://pypi.org/project/aws-durable-execution-sdk-python) |
 | `aws-durable-execution-sdk-python-testing` | Local/cloud test runner and pytest helpers | [![PyPI - Version](https://img.shields.io/pypi/v/aws-durable-execution-sdk-python-testing.svg)](https://pypi.org/project/aws-durable-execution-sdk-python-testing) |
 
+## Dynamic instrumentation plugins
+
+Instrumentation plugins can be selected at Lambda cold start without importing
+them in the function artifact. Install a provider package in the function or a
+Lambda layer, then set an ordered allow-list:
+
+```text
+DURABLE_EXECUTION_PLUGINS=otel-invocation,example_audit
+```
+
+The SDK resolves those names from the `aws_durable_execution.plugins` Python
+entry-point group when the decorated handler is initialized. An unset or blank
+variable preserves the existing behavior. The decorator's `plugins` argument
+remains supported; explicit plugins run first and take precedence when a
+dynamic provider creates the same concrete plugin type.
+
+Provider packages expose a versioned factory:
+
+```python
+from aws_durable_execution_sdk_python.plugin import (
+    DurableInstrumentationPlugin,
+    DurableInstrumentationPluginProvider,
+)
+
+
+class AuditPlugin(DurableInstrumentationPlugin):
+    pass
+
+
+AUDIT_PLUGIN_PROVIDER = DurableInstrumentationPluginProvider(
+    plugin_type=AuditPlugin,
+    factory=AuditPlugin,
+    plugin_api_version=1,
+)
+```
+
+Register the provider in the package's `pyproject.toml`:
+
+```toml
+[project.entry-points."aws_durable_execution.plugins"]
+example_audit = "example_audit:AUDIT_PLUGIN_PROVIDER"
+```
+
+Set `plugin_api_version` to the literal API version the provider implements.
+Update it only after verifying the provider against that API version.
+
+Provider names must be unique across installed distributions. Missing,
+ambiguous, incompatible, or invalid providers raise `PluginLoadError` during
+handler initialization with the provider and distribution details.
+
 ## 🚀 Quick Start
 
 Install the execution SDK:

{aws_durable_execution_sdk_python-1.6.0 → aws_durable_execution_sdk_python-2.0.0}/README.md

@@ -27,6 +27,56 @@ Build reliable, long-running AWS Lambda workflows with checkpointed steps, waits
 | `aws-durable-execution-sdk-python` | Execution SDK for Lambda durable functions | [![PyPI - Version](https://img.shields.io/pypi/v/aws-durable-execution-sdk-python.svg)](https://pypi.org/project/aws-durable-execution-sdk-python) |
 | `aws-durable-execution-sdk-python-testing` | Local/cloud test runner and pytest helpers | [![PyPI - Version](https://img.shields.io/pypi/v/aws-durable-execution-sdk-python-testing.svg)](https://pypi.org/project/aws-durable-execution-sdk-python-testing) |
 
+## Dynamic instrumentation plugins
+
+Instrumentation plugins can be selected at Lambda cold start without importing
+them in the function artifact. Install a provider package in the function or a
+Lambda layer, then set an ordered allow-list:
+
+```text
+DURABLE_EXECUTION_PLUGINS=otel-invocation,example_audit
+```
+
+The SDK resolves those names from the `aws_durable_execution.plugins` Python
+entry-point group when the decorated handler is initialized. An unset or blank
+variable preserves the existing behavior. The decorator's `plugins` argument
+remains supported; explicit plugins run first and take precedence when a
+dynamic provider creates the same concrete plugin type.
+
+Provider packages expose a versioned factory:
+
+```python
+from aws_durable_execution_sdk_python.plugin import (
+    DurableInstrumentationPlugin,
+    DurableInstrumentationPluginProvider,
+)
+
+
+class AuditPlugin(DurableInstrumentationPlugin):
+    pass
+
+
+AUDIT_PLUGIN_PROVIDER = DurableInstrumentationPluginProvider(
+    plugin_type=AuditPlugin,
+    factory=AuditPlugin,
+    plugin_api_version=1,
+)
+```
+
+Register the provider in the package's `pyproject.toml`:
+
+```toml
+[project.entry-points."aws_durable_execution.plugins"]
+example_audit = "example_audit:AUDIT_PLUGIN_PROVIDER"
+```
+
+Set `plugin_api_version` to the literal API version the provider implements.
+Update it only after verifying the provider against that API version.
+
+Provider names must be unique across installed distributions. Missing,
+ambiguous, incompatible, or invalid providers raise `PluginLoadError` during
+handler initialization with the provider and distribution details.
+
 ## 🚀 Quick Start
 
 Install the execution SDK:

{aws_durable_execution_sdk_python-1.6.0 → aws_durable_execution_sdk_python-2.0.0}/pyproject.toml

@@ -63,7 +63,7 @@ target-version = "py311"
 
 [tool.ruff.lint]
 preview = true
-select = ["TID252"]  # Enforce absolute imports (ban relative imports)
+select = ["E4", "E7", "E9", "F", "TID252"]  # pycodestyle (E4/E7/E9) + Pyflakes + absolute imports
 
 [tool.ruff.lint.isort]
 known-first-party = ["aws_durable_execution_sdk_python"]

{aws_durable_execution_sdk_python-1.6.0 → aws_durable_execution_sdk_python-2.0.0}/src/aws_durable_execution_sdk_python/__about__.py

@@ -1,4 +1,4 @@
 # SPDX-FileCopyrightText: 2025-present Amazon.com, Inc. or its affiliates.
 #
 # SPDX-License-Identifier: Apache-2.0
-__version__ = "1.6.0"
+__version__ = "2.0.0"

{aws_durable_execution_sdk_python-1.6.0 → aws_durable_execution_sdk_python-2.0.0}/src/aws_durable_execution_sdk_python/__init__.py

@@ -6,8 +6,20 @@ from aws_durable_execution_sdk_python.__about__ import __version__
 # Main context - used in every durable function
 # Helper decorators - commonly used for step functions
 # Concurrency
-from aws_durable_execution_sdk_python.concurrency.models import BatchResult
-from aws_durable_execution_sdk_python.config import ParallelBranch
+from aws_durable_execution_sdk_python.concurrency.models import (
+    BatchCompletionError,
+    BatchResult,
+)
+from aws_durable_execution_sdk_python.config import (
+    BatchItemStatus,
+    CompletionDecision,
+    CompletionItemStatus,
+    CompletionOutcome,
+    CompletionStatus,
+    ParallelBranch,
+    complete_batch,
+    continue_batch,
+)
 from aws_durable_execution_sdk_python.context import (
     DurableContext,
     durable_parallel_branch,
@@ -18,9 +30,22 @@ from aws_durable_execution_sdk_python.context import (
 
 # Most common exceptions - users need to handle these exceptions
 from aws_durable_execution_sdk_python.exceptions import (
+    CallbackError,
+    CallbackExternalError,
+    CallbackSubmitterError,
+    CallbackTimeoutError,
+    ChildContextError,
     DurableExecutionsError,
+    DurableOperationError,
+    ExecutionError,
     InvocationError,
+    InvokeError,
+    PluginLoadError,
+    RetryableSerDesError,
+    SerDesError,
+    StepError,
     ValidationError,
+    WaitForConditionError,
 )
 
 # Core decorator - used in every durable function
@@ -32,15 +57,36 @@ from aws_durable_execution_sdk_python.types import StepContext
 
 
 __all__ = [
+    "BatchCompletionError",
+    "BatchItemStatus",
     "BatchResult",
+    "CallbackError",
+    "CallbackExternalError",
+    "CallbackSubmitterError",
+    "CallbackTimeoutError",
+    "ChildContextError",
+    "CompletionDecision",
+    "CompletionItemStatus",
+    "CompletionOutcome",
+    "CompletionStatus",
     "DurableContext",
     "DurableExecutionsError",
+    "DurableOperationError",
+    "ExecutionError",
     "InvocationError",
+    "InvokeError",
     "ParallelBranch",
+    "PluginLoadError",
+    "RetryableSerDesError",
+    "SerDesError",
     "StepContext",
+    "StepError",
     "ValidationError",
+    "WaitForConditionError",
     "WithRetryConfig",
     "__version__",
+    "complete_batch",
+    "continue_batch",
     "durable_execution",
     "durable_parallel_branch",
     "durable_step",