aws-durable-execution-sdk-python 1.1.2__tar.gz → 1.3.0__tar.gz

{aws_durable_execution_sdk_python-1.1.2 → aws_durable_execution_sdk_python-1.3.0}/.github/workflows/scorecard.yml

@@ -75,6 +75,6 @@ jobs:
       # Upload the results to GitHub's code scanning dashboard (optional).
       # Commenting out will disable upload of results to your repo's Code Scanning dashboard
       - name: "Upload to code-scanning"
-        uses: github/codeql-action/upload-sarif@19b2f06db2b6f5108140aeb04014ef02b648f789 # v4.31.11
+        uses: github/codeql-action/upload-sarif@b20883b0cd1f46c72ae0ba6d1090936928f9fa30 # v4.32.0
         with:
           sarif_file: results.sarif

{aws_durable_execution_sdk_python-1.1.2 → aws_durable_execution_sdk_python-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aws-durable-execution-sdk-python
-Version: 1.1.2
+Version: 1.3.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

{aws_durable_execution_sdk_python-1.1.2 → aws_durable_execution_sdk_python-1.3.0}/docs/core/logger.md

@@ -14,6 +14,7 @@ The Durable Execution SDK automatically enriches your logs with execution contex
 - [Integration with Powertools for AWS Lambda (Python)](#integration-with-powertools-for-aws-lambda-python)
 - [Replay behavior and log deduplication](#replay-behavior-and-log-deduplication)
 - [Best practices](#best-practices)
+- [Enabling debug logging](#enabling-debug-logging)
 - [FAQ](#faq)
 - [Testing logger integration](#testing-logger-integration)
 - [See also](#see-also)
@@ -485,6 +486,79 @@ context.logger.info("User authenticated", extra={"password": password})
 
 [↑ Back to top](#table-of-contents)
 
+## Enabling debug logging
+
+The SDK logs internally using Python's standard `logging` module. To see these logs, set `ApplicationLogLevel: DEBUG` in [Advanced logging controls](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs-advanced.html).
+
+Advanced logging controls filters logs before they reach CloudWatch. If you set DEBUG level in code but leave Advanced logging controls at INFO, your debug logs will be dropped. You must configure the level in Advanced logging controls - it auto-patches all loggers, so you don't need to configure log levels in code.
+
+```mermaid
+flowchart LR
+    A[Logger emits DEBUG] --> B{Advanced Logging Controls}
+    B -->|ApplicationLogLevel = DEBUG| C[CloudWatch ✓]
+    B -->|ApplicationLogLevel = INFO| D[Dropped ✗]
+```
+
+**Important:** DEBUG level applies to all libraries including botocore. Since the SDK uses boto3 internally, this will flood your logs with HTTP request/response details. Silence botocore in your code:
+
+```python
+import logging
+
+# Silence botocore/urllib3 noise
+logging.getLogger("botocore").setLevel(logging.WARNING)
+logging.getLogger("urllib3").setLevel(logging.WARNING)
+```
+
+Configure ALC via SAM/CloudFormation:
+
+```yaml
+# SAM template
+Resources:
+  MyFunction:
+    Type: AWS::Serverless::Function
+    Properties:
+      LoggingConfig:
+        LogFormat: JSON
+        ApplicationLogLevel: DEBUG
+```
+
+Or in the Lambda console under Configuration → Monitoring and operations tools → Logging configuration.
+
+### Selective logging
+
+Python loggers are hierarchical. Silencing `aws_durable_execution_sdk_python` silences all SDK modules. To keep some modules at DEBUG while silencing others:
+
+```python
+import logging
+
+# Silence all SDK logs
+logging.getLogger("aws_durable_execution_sdk_python").setLevel(logging.WARNING)
+
+# Or silence specific modules only
+logging.getLogger("aws_durable_execution_sdk_python.state").setLevel(logging.WARNING)
+logging.getLogger("aws_durable_execution_sdk_python.concurrency").setLevel(logging.WARNING)
+```
+
+SDK logger namespaces:
+
+| Namespace | Description |
+|-----------|-------------|
+| `aws_durable_execution_sdk_python` | Root - silences all SDK logs |
+| `aws_durable_execution_sdk_python.state` | Checkpoint and replay state management |
+| `aws_durable_execution_sdk_python.execution` | Durable execution lifecycle |
+| `aws_durable_execution_sdk_python.context` | DurableContext operations |
+| `aws_durable_execution_sdk_python.lambda_service` | Lambda API calls |
+| `aws_durable_execution_sdk_python.serdes` | Serialization/deserialization |
+| `aws_durable_execution_sdk_python.concurrency` | Parallel and map execution |
+| `aws_durable_execution_sdk_python.operation.step` | Step operations |
+| `aws_durable_execution_sdk_python.operation.wait` | Wait operations |
+| `aws_durable_execution_sdk_python.operation.invoke` | Invoke operations |
+| `aws_durable_execution_sdk_python.operation.child` | Child context operations |
+| `aws_durable_execution_sdk_python.operation.parallel` | Parallel operations |
+| `aws_durable_execution_sdk_python.operation.map` | Map operations |
+
+[↑ Back to top](#table-of-contents)
+
 ## FAQ
 
 **Q: Does logging work during replays?**

{aws_durable_execution_sdk_python-1.1.2 → aws_durable_execution_sdk_python-1.3.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.1.2"
+__version__ = "1.3.0"

{aws_durable_execution_sdk_python-1.1.2 → aws_durable_execution_sdk_python-1.3.0}/src/aws_durable_execution_sdk_python/__init__.py

@@ -2,6 +2,8 @@
 
 # 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.context import (
     DurableContext,
     durable_step,
@@ -20,7 +22,7 @@ from aws_durable_execution_sdk_python.exceptions import (
 from aws_durable_execution_sdk_python.execution import durable_execution
 
 # Essential context types - passed to user functions
-from aws_durable_execution_sdk_python.types import BatchResult, StepContext
+from aws_durable_execution_sdk_python.types import StepContext
 
 __all__ = [
     "BatchResult",

{aws_durable_execution_sdk_python-1.1.2 → aws_durable_execution_sdk_python-1.3.0}/src/aws_durable_execution_sdk_python/context.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import hashlib
 import logging
+from dataclasses import dataclass
 from typing import TYPE_CHECKING, Any, Concatenate, Generic, ParamSpec, TypeVar
 
 from aws_durable_execution_sdk_python.config import (
@@ -74,6 +75,20 @@ logger = logging.getLogger(__name__)
 PASS_THROUGH_SERDES: SerDes[Any] = PassThroughSerDes()
 
 
+@dataclass(frozen=True)
+class ExecutionContext:
+    """Readonly metadata about the current durable execution context.
+
+    This class provides immutable access to execution-level metadata.
+
+    Attributes:
+        durable_execution_arn: The Amazon Resource Name (ARN) of the current
+            durable execution.
+    """
+
+    durable_execution_arn: str
+
+
 def durable_step(
     func: Callable[Concatenate[StepContext, Params], T],
 ) -> Callable[Params, Callable[[StepContext], T]]:
@@ -218,11 +233,13 @@ class DurableContext(DurableContextProtocol):
     def __init__(
         self,
         state: ExecutionState,
+        execution_context: ExecutionContext,
         lambda_context: LambdaContext | None = None,
         parent_id: str | None = None,
         logger: Logger | None = None,
     ) -> None:
         self.state: ExecutionState = state
+        self.execution_context: ExecutionContext = execution_context
         self.lambda_context = lambda_context
         self._parent_id: str | None = parent_id
         self._step_counter: OrderedCounter = OrderedCounter()
@@ -245,6 +262,9 @@ class DurableContext(DurableContextProtocol):
     ):
         return DurableContext(
             state=state,
+            execution_context=ExecutionContext(
+                durable_execution_arn=state.durable_execution_arn
+            ),
             lambda_context=lambda_context,
             parent_id=None,
         )
@@ -254,6 +274,7 @@ class DurableContext(DurableContextProtocol):
         logger.debug("Creating child context for parent %s", parent_id)
         return DurableContext(
             state=self.state,
+            execution_context=self.execution_context,
             lambda_context=self.lambda_context,
             parent_id=parent_id,
             logger=self.logger.with_log_info(

{aws_durable_execution_sdk_python-1.1.2 → aws_durable_execution_sdk_python-1.3.0}/src/aws_durable_execution_sdk_python/logger.py

@@ -72,7 +72,7 @@ class Logger(LoggerInterface):
             # Use 'operation_name' instead of 'name' as key because the stdlib LogRecord internally reserved 'name' parameter
             extra["operationName"] = info.name
         if info.attempt is not None:
-            extra["attempt"] = info.attempt + 1
+            extra["attempt"] = info.attempt
         if info.operation_id:
             extra["operationId"] = info.operation_id
         return cls(

{aws_durable_execution_sdk_python-1.1.2 → aws_durable_execution_sdk_python-1.3.0}/src/aws_durable_execution_sdk_python/operation/step.py

@@ -202,9 +202,10 @@ class StepOperationExecutor(OperationExecutor[T]):
             ExecutionError: For fatal errors that should not be retried
             May raise other exceptions that will be handled by retry_handler
         """
-        attempt: int = 0
+        # Get current attempt - checkpointed attempts + 1
+        attempt: int = 1
         if checkpointed_result.operation and checkpointed_result.operation.step_details:
-            attempt = checkpointed_result.operation.step_details.attempt
+            attempt = checkpointed_result.operation.step_details.attempt + 1
 
         step_context: StepContext = StepContext(
             logger=self.context_logger.with_log_info(

{aws_durable_execution_sdk_python-1.1.2 → aws_durable_execution_sdk_python-1.3.0}/src/aws_durable_execution_sdk_python/operation/wait_for_condition.py

@@ -170,10 +170,11 @@ class WaitForConditionOperationExecutor(OperationExecutor[T]):
         else:
             current_state = self.config.initial_state
 
-        # Get attempt number
+        # Get attempt number - current attempt is checkpointed attempts + 1
+        # The checkpoint stores completed attempts, so the current attempt being executed is one more
         attempt: int = 1
         if checkpointed_result.operation and checkpointed_result.operation.step_details:
-            attempt = checkpointed_result.operation.step_details.attempt
+            attempt = checkpointed_result.operation.step_details.attempt + 1
 
         try:
             # Execute the check function with the injected logger

{aws_durable_execution_sdk_python-1.1.2 → aws_durable_execution_sdk_python-1.3.0}/src/aws_durable_execution_sdk_python/state.py

@@ -45,12 +45,12 @@ class CheckpointBatcherConfig:
     Attributes:
         max_batch_size_bytes: Maximum batch size in bytes (default: 750KB)
         max_batch_time_seconds: Maximum time to wait before flushing batch (default: 1.0 second)
-        max_batch_operations: Maximum number of operations per batch (default: unlimited)
+        max_batch_operations: Maximum number of operations per batch (default: 250)
     """
 
-    max_batch_size_bytes: int = 750 * 1024  # 750KB - private readonly MAX_PAYLOAD_SIZE
-    max_batch_time_seconds: float = 1.0  # 1 second default
-    max_batch_operations: int | float = float("inf")  # No operation limit by default
+    max_batch_size_bytes: int = 750 * 1024  # 750KB
+    max_batch_time_seconds: float = 1.0
+    max_batch_operations: int = 250
 
 
 @dataclass(frozen=True)