aws-lambda-powertools 3.5.1a3__tar.gz → 3.5.1a4__tar.gz

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: aws_lambda_powertools
-Version: 3.5.1a3
+Version: 3.5.1a4
 Summary: Powertools for AWS Lambda (Python) is a developer toolkit to implement Serverless best practices and increase developer velocity.
 License: MIT
 Keywords: aws_lambda_powertools,aws,tracing,logging,lambda,powertools,feature_flags,idempotency,middleware

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/event_handler/openapi/params.py

@@ -932,7 +932,8 @@ def analyze_param(
     ModelField | None
         The type annotation and the Pydantic field representing the parameter
     """
-    field_info, type_annotation = get_field_info_and_type_annotation(annotation, value, is_path_param)
+    field_info, type_annotation = \
+        get_field_info_and_type_annotation(annotation, value, is_path_param, is_response_param)
 
     # If the value is a FieldInfo, we use it as the FieldInfo for the parameter
     if isinstance(value, FieldInfo):
@@ -962,7 +963,9 @@ def analyze_param(
     return field
 
 
-def get_field_info_and_type_annotation(annotation, value, is_path_param: bool) -> tuple[FieldInfo | None, Any]:
+def get_field_info_and_type_annotation(
+    annotation, value, is_path_param: bool, is_response_param: bool
+) -> tuple[FieldInfo | None, Any]:
     """
     Get the FieldInfo and type annotation from an annotation and value.
     """
@@ -976,6 +979,10 @@ def get_field_info_and_type_annotation(annotation, value, is_path_param: bool) -
         # If the annotation is a Response type, we recursively call this function with the inner type
         elif get_origin(annotation) is Response:
             field_info, type_annotation = get_field_info_response_type(annotation, value)
+        # If the response param is a tuple with two elements, we use the first element as the type annotation,
+        # just like we did in the APIGateway._to_response
+        elif is_response_param and get_origin(annotation) is tuple and len(get_args(annotation)) == 2:
+            field_info, type_annotation = get_field_info_tuple_type(annotation, value)
         # If the annotation is not an Annotated type, we use it as the type annotation
         else:
             type_annotation = annotation
@@ -983,12 +990,22 @@ def get_field_info_and_type_annotation(annotation, value, is_path_param: bool) -
     return field_info, type_annotation
 
 
+def get_field_info_tuple_type(annotation, value) -> tuple[FieldInfo | None, Any]:
+    (inner_type, _) = get_args(annotation)
+
+    # If the inner type is an Annotated type, we need to extract the type annotation and the FieldInfo
+    if get_origin(inner_type) is Annotated:
+        return get_field_info_annotated_type(inner_type, value, False)
+
+    return None, inner_type
+
+
 def get_field_info_response_type(annotation, value) -> tuple[FieldInfo | None, Any]:
     # Example: get_args(Response[inner_type]) == (inner_type,)  # noqa: ERA001
     (inner_type,) = get_args(annotation)
 
     # Recursively resolve the inner type
-    return get_field_info_and_type_annotation(inner_type, value, False)
+    return get_field_info_and_type_annotation(inner_type, value, False, True)
 
 
 def get_field_info_annotated_type(annotation, value, is_path_param: bool) -> tuple[FieldInfo | None, Any]:

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/logging/__init__.py

@@ -1,5 +1,4 @@
-"""Logging utility
-"""
+"""Logging utility"""
 
 from .logger import Logger
 

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/metrics/__init__.py

@@ -1,5 +1,4 @@
-"""CloudWatch Embedded Metric Format utility
-"""
+"""CloudWatch Embedded Metric Format utility"""
 
 from aws_lambda_powertools.metrics.base import MetricResolution, MetricUnit, single_metric
 from aws_lambda_powertools.metrics.exceptions import (

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/metrics/metrics.py

@@ -1,7 +1,7 @@
 # NOTE: keeps for compatibility
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, Callable
 
 from aws_lambda_powertools.metrics.provider.cloudwatch_emf.cloudwatch import AmazonCloudWatchEMFProvider
 
@@ -149,8 +149,8 @@ class Metrics:
         capture_cold_start_metric: bool = False,
         raise_on_empty_metrics: bool = False,
         default_dimensions: dict[str, str] | None = None,
-        **kwargs,
-    ):
+        **kwargs: dict[str, Any],
+    ) -> Callable[..., Any]:
         return self.provider.log_metrics(
             lambda_handler=lambda_handler,
             capture_cold_start_metric=capture_cold_start_metric,

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/middleware_factory/__init__.py

@@ -1,4 +1,4 @@
-""" Utilities to enhance middlewares """
+"""Utilities to enhance middlewares"""
 
 from .factory import lambda_handler_decorator
 

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/shared/version.py

@@ -1,3 +1,3 @@
 """Exposes version constant to avoid circular dependencies."""
 
-VERSION = "3.5.1a3"
+VERSION = "3.5.1a4"

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/tracing/__init__.py

@@ -1,5 +1,4 @@
-"""Tracing utility
-"""
+"""Tracing utility"""
 
 from .extensions import aiohttp_trace_config
 from .tracer import Tracer

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/batch/base.py

@@ -1,5 +1,7 @@
 """
 Batch processing utilities
+!!! abstract "Usage Documentation"
+    [`Batch processing`](../../utilities/batch.md)
 """
 
 from __future__ import annotations

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/batch/decorators.py

@@ -51,9 +51,8 @@ def async_batch_processor(
     processor: AsyncBatchProcessor
         Batch Processor to handle partial failure cases
 
-    Examples
+    Example
     --------
-    **Processes Lambda's event with a BasePartialProcessor**
         >>> from aws_lambda_powertools.utilities.batch import async_batch_processor, AsyncBatchProcessor
         >>> from aws_lambda_powertools.utilities.data_classes.sqs_event import SQSRecord
         >>>
@@ -119,7 +118,7 @@ def batch_processor(
     processor: BatchProcessor
         Batch Processor to handle partial failure cases
 
-    Examples
+    Example
     --------
     **Processes Lambda's event with a BatchProcessor**
 
@@ -180,7 +179,7 @@ def process_partial_response(
     result: PartialItemFailureResponse
         Lambda Partial Batch Response
 
-    Examples
+    Example
     --------
     **Processes Lambda's SQS event**
 
@@ -244,7 +243,7 @@ def async_process_partial_response(
     result: PartialItemFailureResponse
         Lambda Partial Batch Response
 
-    Examples
+    Example
     --------
     **Processes Lambda's SQS event**
 

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/batch/sqs_fifo_partial_processor.py

@@ -21,7 +21,7 @@ class SqsFifoPartialProcessor(BatchProcessor):
     Stops processing records when the first record fails. The remaining records are reported as failed items.
 
     Example
-    _______
+    -------
 
     ## Process batch triggered by a FIFO SQS
 

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/data_classes/common.py

@@ -1,3 +1,9 @@
+"""
+Base class for Event Source Data Classes
+!!! abstract "Usage Documentation"
+    [`Data classes`](../utilities/data_classes.md)
+"""
+
 from __future__ import annotations
 
 import base64

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/data_masking/base.py

@@ -1,3 +1,9 @@
+"""
+Base class for Data Masking
+!!! abstract "Usage Documentation"
+    [`Data masking`](../../utilities/data_masking.md)
+"""
+
 from __future__ import annotations
 
 import functools
@@ -24,8 +30,9 @@ class DataMasking:
     The DataMasking class orchestrates erasing, encrypting, and decrypting
     for the base provider.
 
-    Example:
-    ```
+    Example
+    -------
+    ```python
     from aws_lambda_powertools.utilities.data_masking.base import DataMasking
 
     def lambda_handler(event, context):

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/data_masking/provider/base.py

@@ -11,9 +11,9 @@ class BaseProvider:
     """
     The BaseProvider class serves as an abstract base class for data masking providers.
 
-    Examples
+    Example
     --------
-    ```
+    ```python
     from aws_lambda_powertools.utilities._data_masking.provider import BaseProvider
     from aws_lambda_powertools.utilities.data_masking import DataMasking
 

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/data_masking/provider/kms/aws_encryption_sdk.py

@@ -48,9 +48,9 @@ class AWSEncryptionSDKProvider(BaseProvider):
     """
     The AWSEncryptionSDKProvider is used as a provider for the DataMasking class.
 
-    Usage
+    Example
     -------
-    ```
+    ```python
     from aws_lambda_powertools.utilities.data_masking import DataMasking
     from aws_lambda_powertools.utilities.data_masking.providers.kms.aws_encryption_sdk import (
         AWSEncryptionSDKProvider,
@@ -142,17 +142,17 @@ class KMSKeyProvider:
 
         Parameters
         -------
-            data : Any
-                The data to be encrypted.
-            provider_options : dict
-                Additional options for the aws_encryption_sdk.EncryptionSDKClient
-            **encryption_context : str
-                Additional keyword arguments collected into a dictionary.
+        data: Any
+            The data to be encrypted.
+        provider_options: dict
+            Additional options for the aws_encryption_sdk.EncryptionSDKClient
+        **encryption_context: str
+            Additional keyword arguments collected into a dictionary.
 
         Returns
         -------
-            ciphertext : str
-                The encrypted data, as a base64-encoded string.
+        ciphertext: str
+            The encrypted data, as a base64-encoded string.
         """
         provider_options = provider_options or {}
         self._validate_encryption_context(encryption_context)
@@ -179,15 +179,15 @@ class KMSKeyProvider:
 
         Parameters
         -------
-            data : str
-                The encrypted data, as a base64-encoded string
-            provider_options
-                Additional options for the aws_encryption_sdk.EncryptionSDKClient
+        data: str
+            The encrypted data, as a base64-encoded string
+        provider_options
+            Additional options for the aws_encryption_sdk.EncryptionSDKClient
 
         Returns
         -------
-            ciphertext : bytes
-                The decrypted data in bytes
+        ciphertext: bytes
+            The decrypted data in bytes
         """
         provider_options = provider_options or {}
         self._validate_encryption_context(encryption_context)

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/feature_flags/appconfig.py

@@ -1,3 +1,8 @@
+"""Advanced feature flags utility
+!!! abstract "Usage Documentation"
+    [`Feature Flags`](../../utilities/feature_flags.md)
+"""
+
 from __future__ import annotations
 
 import logging

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/feature_flags/base.py

@@ -28,7 +28,8 @@ class StoreProvider(ABC):
         dict[str, Any]
             parsed JSON dictionary
 
-            **Example**
+        Example
+        -------
 
         ```python
         {

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/feature_flags/comparators.py

@@ -56,6 +56,8 @@ def compare_time_range(context_value: Any, condition_value: dict) -> bool:
     end_time = current_time.replace(hour=int(end_hour), minute=int(end_min))
 
     if int(end_hour) < int(start_hour):
+        # In normal circumstances, we need to assert **both** conditions
+        """
         # When the end hour is smaller than start hour, it means we are crossing a day's boundary.
         # In this case we need to assert that current_time is **either** on one side or the other side of the boundary
         #
@@ -69,10 +71,9 @@ def compare_time_range(context_value: Any, condition_value: dict) -> bool:
         #                                             │ │                                        │
         #    └ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─  │ └ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─
         #                                               │
-
+        """
         return (start_time <= current_time) or (current_time <= end_time)
     else:
-        # In normal circumstances, we need to assert **both** conditions
         return start_time <= current_time <= end_time
 
 

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/feature_flags/feature_flags.py

@@ -179,7 +179,8 @@ class FeatureFlags:
         dict[str, dict]
             parsed JSON dictionary
 
-            **Example**
+        Example
+        -------
 
         ```python
         {
@@ -251,7 +252,7 @@ class FeatureFlags:
             Can be boolean or any JSON values for non-boolean features.
 
 
-        Examples
+        Example
         --------
 
         ```python
@@ -343,7 +344,8 @@ class FeatureFlags:
         list[str]
             list of all feature names that either matches context or have True as default
 
-            **Example**
+        Example
+        -------
 
         ```python
         ["premium_features", "my_feature_two", "always_true_feature"]
@@ -400,8 +402,8 @@ class FeatureFlags:
         exc_class : Exception | list[Exception]
             One or more exceptions to catch
 
-        Examples
-        --------
+        Example
+        -------
 
         ```python
         feature_flags = FeatureFlags(store=app_config)

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/idempotency/base.py

@@ -1,3 +1,9 @@
+"""
+Base for Idempotency utility
+!!! abstract "Usage Documentation"
+    [`Idempotency`](../../utilities/idempotency.md)
+"""
+
 from __future__ import annotations
 
 import datetime

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/idempotency/idempotency.py

@@ -61,20 +61,20 @@ def idempotent(
     key_prefix: str | Optional
         Custom prefix for idempotency key: key_prefix#hash
 
-    Examples
+    Example
     --------
     **Processes Lambda's event in an idempotent manner**
 
-        >>> from aws_lambda_powertools.utilities.idempotency import (
-        >>>    idempotent, DynamoDBPersistenceLayer, IdempotencyConfig
-        >>> )
-        >>>
-        >>> idem_config=IdempotencyConfig(event_key_jmespath="body")
-        >>> persistence_layer = DynamoDBPersistenceLayer(table_name="idempotency_store")
-        >>>
-        >>> @idempotent(config=idem_config, persistence_store=persistence_layer)
-        >>> def handler(event, context):
-        >>>     return {"StatusCode": 200}
+        from aws_lambda_powertools.utilities.idempotency import (
+           idempotent, DynamoDBPersistenceLayer, IdempotencyConfig
+        )
+
+        idem_config=IdempotencyConfig(event_key_jmespath="body")
+        persistence_layer = DynamoDBPersistenceLayer(table_name="idempotency_store")
+
+        @idempotent(config=idem_config, persistence_store=persistence_layer)
+        def handler(event, context):
+            return {"StatusCode": 200}
     """
 
     # Skip idempotency controls when POWERTOOLS_IDEMPOTENCY_DISABLED has a truthy value
@@ -136,7 +136,7 @@ def idempotent_function(
     key_prefix: str | Optional
         Custom prefix for idempotency key: key_prefix#hash
 
-    Examples
+    Example
     --------
     **Processes an order in an idempotent manner**
 

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/idempotency/persistence/dynamodb.py

@@ -76,7 +76,7 @@ class DynamoDBPersistenceLayer(BasePersistenceLayer):
         boto3_client : DynamoDBClient, optional
             Boto3 DynamoDB Client to use, boto3_session and boto_config will be ignored if both are provided
 
-        Examples
+        Example
         --------
         **Create a DynamoDB persistence layer with custom settings**
 

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/idempotency/persistence/redis.py

@@ -112,7 +112,7 @@ class RedisConnection:
         ssl: bool, optional: default True
             set whether to use ssl for Redis connection
 
-        Examples
+        Example
         --------
 
         ```python

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/jmespath_utils/__init__.py

@@ -1,3 +1,9 @@
+"""
+Built-in JMESPath Functions to easily deserialize common encoded JSON payloads in Lambda functions.
+!!! abstract "Usage Documentation"
+    [`JMESPath Functions`](../utilities/jmespath_functions.md)
+"""
+
 from __future__ import annotations
 
 import base64
@@ -42,7 +48,7 @@ def query(data: dict | str, envelope: str, jmespath_options: dict | None = None)
 
     Built-in JMESPath functions include: powertools_json, powertools_base64, powertools_base64_gzip
 
-    Examples
+    Example
     --------
 
     **Deserialize JSON string and extracts data from body key**

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/parameters/base.py

@@ -1,5 +1,7 @@
 """
 Base for Parameter providers
+!!! abstract "Usage Documentation"
+    [`Parameters`](../../utilities/parameters.md)
 """
 
 from __future__ import annotations

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/parser/__init__.py

@@ -1,5 +1,4 @@
-"""Advanced event_parser utility
-"""
+"""Advanced event_parser utility"""
 
 from pydantic import BaseModel, Field, ValidationError, field_validator, model_validator
 

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/parser/parser.py

@@ -1,3 +1,10 @@
+"""
+The Parser utility simplifies data parsing and validation using Pydantic. It allows you to define data models
+in pure Python classes, parse and validate incoming events, and extract only the data you need.
+!!! abstract "Usage Documentation"
+    [`Parser`](../utilities/parser.md)
+"""
+
 from __future__ import annotations
 
 import logging

aws_lambda_powertools-3.5.1a4/aws_lambda_powertools/utilities/streaming/__init__.py

@@ -0,0 +1,9 @@
+"""
+The streaming utility handles datasets larger than the available memory as streaming data.
+!!! abstract "Usage Documentation"
+    [`Streaming`](../utilities/streaming.md)
+"""
+
+from aws_lambda_powertools.utilities.streaming.s3_object import S3Object
+
+__all__ = ["S3Object"]

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/aws_lambda_powertools/utilities/typing/__init__.py

@@ -1,5 +1,7 @@
 """
 Typing for developer ease in the IDE
+!!! abstract "Usage Documentation"
+    [`Typing`](../utilities/typing.md)
 """
 
 from .lambda_context import LambdaContext

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "aws_lambda_powertools"
-version = "3.5.1a3"
+version = "3.5.1a4"
 description = "Powertools for AWS Lambda (Python) is a developer toolkit to implement Serverless best practices and increase developer velocity."
 authors = ["Amazon Web Services"]
 include = ["aws_lambda_powertools/py.typed", "THIRD-PARTY-LICENSES"]

{aws_lambda_powertools-3.5.1a3 → aws_lambda_powertools-3.5.1a4}/setup.py

@@ -64,7 +64,7 @@ extras_require = \
 
 setup_kwargs = {
     'name': 'aws_lambda_powertools',
-    'version': '3.5.1a3',
+    'version': '3.5.1a4',
     'description': 'Powertools for AWS Lambda (Python) is a developer toolkit to implement Serverless best practices and increase developer velocity.',
     'long_description': '<!-- markdownlint-disable MD013 MD041 MD043  -->\n# Powertools for AWS Lambda (Python)\n\n[![Build](https://github.com/aws-powertools/powertools-lambda-python/actions/workflows/quality_check.yml/badge.svg)](https://github.com/aws-powertools/powertools-lambda-python/actions/workflows/python_build.yml)\n[![codecov.io](https://codecov.io/github/aws-powertools/powertools-lambda-python/branch/develop/graphs/badge.svg)](https://app.codecov.io/gh/aws-powertools/powertools-lambda-python)\n![PythonSupport](https://img.shields.io/static/v1?label=python&message=%203.8|%203.9|%203.10|%203.11|%203.12&color=blue?style=flat-square&logo=python) ![PyPI version](https://badge.fury.io/py/aws-lambda-powertools.svg) ![PyPi monthly downloads](https://img.shields.io/pypi/dm/aws-lambda-powertools) [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/aws-powertools/powertools-lambda-python/badge)](https://api.securityscorecards.dev/projects/github.com/aws-powertools/powertools-lambda-python) [![Join our Discord](https://dcbadge.vercel.app/api/server/B8zZKbbyET?style=flat-square)](https://discord.gg/B8zZKbbyET)\n\nPowertools for AWS Lambda (Python) is a developer toolkit to implement Serverless [best practices and increase developer velocity](https://docs.powertools.aws.dev/lambda/python/latest/#features).\n\n> Also available in [Java](https://github.com/aws-powertools/powertools-lambda-java), [Typescript](https://github.com/aws-powertools/powertools-lambda-typescript), and [.NET](https://github.com/aws-powertools/powertools-lambda-dotnet).\n\n**[📜Documentation](https://docs.powertools.aws.dev/lambda/python/)** | **[🐍PyPi](https://pypi.org/project/aws-lambda-powertools/)** | **[Roadmap](https://docs.powertools.aws.dev/lambda/python/latest/roadmap/)** | **[Detailed blog post](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-lambda-powertools/)**\n\n![hero-image](https://user-images.githubusercontent.com/3340292/198254617-d0fdb672-86a6-4988-8a40-adf437135e0a.png)\n\n## Features\n\n* **[Tracing](https://docs.powertools.aws.dev/lambda/python/latest/core/tracer/)** - Decorators and utilities to trace Lambda function handlers, and both synchronous and asynchronous functions\n* **[Logging](https://docs.powertools.aws.dev/lambda/python/latest/core/logger/)** - Structured logging made easier, and decorator to enrich structured logging with key Lambda context details\n* **[Metrics](https://docs.powertools.aws.dev/lambda/python/latest/core/metrics/)** - Custom Metrics created asynchronously via CloudWatch Embedded Metric Format (EMF)\n* **[Event handler: AppSync](https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/appsync/)** - AWS AppSync event handler for Lambda Direct Resolver and Amplify GraphQL Transformer function\n* **[Event handler: API Gateway and ALB](https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/api_gateway/)** - Amazon API Gateway REST/HTTP API and ALB event handler for Lambda functions invoked using Proxy integration\n* **[Event handler: Agents for Amazon Bedrock](https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/bedrock_agents/)** - Create Agents for Amazon Bedrock, automatically generating OpenAPI schemas\n* **[Bring your own middleware](https://docs.powertools.aws.dev/lambda/python/latest/utilities/middleware_factory/)** - Decorator factory to create your own middleware to run logic before, and after each Lambda invocation\n* **[Parameters utility](https://docs.powertools.aws.dev/lambda/python/latest/utilities/parameters/)** - Retrieve and cache parameter values from Parameter Store, Secrets Manager, or DynamoDB\n* **[Batch processing](https://docs.powertools.aws.dev/lambda/python/latest/utilities/batch/)** - Handle partial failures for AWS SQS batch processing\n* **[Typing](https://docs.powertools.aws.dev/lambda/python/latest/utilities/typing/)** - Static typing classes to speedup development in your IDE\n* **[Validation](https://docs.powertools.aws.dev/lambda/python/latest/utilities/validation/)** - JSON Schema validator for inbound events and responses\n* **[Event source data classes](https://docs.powertools.aws.dev/lambda/python/latest/utilities/data_classes/)** - Data classes describing the schema of common Lambda event triggers\n* **[Parser](https://docs.powertools.aws.dev/lambda/python/latest/utilities/parser/)** - Data parsing and deep validation using Pydantic\n* **[Idempotency](https://docs.powertools.aws.dev/lambda/python/latest/utilities/idempotency/)** - Convert your Lambda functions into idempotent operations which are safe to retry\n* **[Data Masking](https://docs.powertools.aws.dev/lambda/python/latest/utilities/data_masking/)** -  Protect confidential data with easy removal or encryption\n* **[Feature Flags](https://docs.powertools.aws.dev/lambda/python/latest/utilities/feature_flags/)** - A simple rule engine to evaluate when one or multiple features should be enabled depending on the input\n* **[Streaming](https://docs.powertools.aws.dev/lambda/python/latest/utilities/streaming/)** - Streams datasets larger than the available memory as streaming data.\n\n### Installation\n\nWith [pip](https://pip.pypa.io/en/latest/index.html) installed, run: ``pip install aws-lambda-powertools``\n\n## Tutorial and Examples\n\n* [Tutorial](https://docs.powertools.aws.dev/lambda/python/latest/tutorial)\n* [Serverless Shopping cart](https://github.com/aws-samples/aws-serverless-shopping-cart)\n* [Serverless Airline](https://github.com/aws-samples/aws-serverless-airline-booking)\n* [Serverless E-commerce platform](https://github.com/aws-samples/aws-serverless-ecommerce-platform)\n* [Serverless GraphQL Nanny Booking Api](https://github.com/trey-rosius/babysitter_api)\n\n## How to support Powertools for AWS Lambda (Python)?\n\n### Becoming a reference customer\n\nKnowing which companies are using this library is important to help prioritize the project internally. If your company is using Powertools for AWS Lambda (Python), you can request to have your name and logo added to the README file by raising a [Support Powertools for AWS Lambda (Python) (become a reference)](https://github.com/aws-powertools/powertools-lambda-python/issues/new?assignees=&labels=customer-reference&template=support_powertools.yml&title=%5BSupport+Lambda+Powertools%5D%3A+%3Cyour+organization+name%3E) issue.\n\nThe following companies, among others, use Powertools:\n\n* [Alma Media](https://www.almamedia.fi/en/)\n* [Banxware](https://www.banxware.com/)\n* [Brsk](https://www.brsk.co.uk/)\n* [BusPatrol](https://buspatrol.com/)\n* [Capital One](https://www.capitalone.com/)\n* [Caylent](https://caylent.com/)\n* [CHS Inc.](https://www.chsinc.com/)\n* [CPQi (Exadel Financial Services)](https://cpqi.com/)\n* [CloudZero](https://www.cloudzero.com/)\n* [CyberArk](https://www.cyberark.com/)\n* [Flyweight](https://flyweight.io/)\n* [globaldatanet](https://globaldatanet.com/)\n* [IMS](https://ims.tech/)\n* [Jit Security](https://www.jit.io/)\n* [LocalStack](https://www.localstack.cloud/)\n* [Propellor.ai](https://www.propellor.ai/)\n* [Pushpay](https://pushpay.com/)\n* [Recast](https://getrecast.com/)\n* [TopSport](https://www.topsport.com.au/)\n* [Transformity](https://transformity.tech/)\n* [Trek10](https://www.trek10.com/)\n* [Vertex Pharmaceuticals](https://www.vrtx.com/)\n\n### Sharing your work\n\nShare what you did with Powertools for AWS Lambda (Python) 💞💞. Blog post, workshops, presentation, sample apps and others. Check out what the community has already shared about Powertools for AWS Lambda (Python) [here](https://docs.powertools.aws.dev/lambda/python/latest/we_made_this/).\n\n### Using Lambda Layer or SAR\n\nThis helps us understand who uses Powertools for AWS Lambda (Python) in a non-intrusive way, and helps us gain future investments for other Powertools for AWS Lambda languages. When [using Layers](https://docs.powertools.aws.dev/lambda/python/latest/#lambda-layer), you can add Powertools for AWS Lambda (Python) as a dev dependency (or as part of your virtual env) to not impact the development process.\n\n## Credits\n\n* Structured logging initial implementation from [aws-lambda-logging](https://gitlab.com/hadrien/aws_lambda_logging)\n* Powertools for AWS Lambda (Python) idea [DAZN Powertools](https://github.com/getndazn/dazn-lambda-powertools/)\n\n## Connect\n\n* **Powertools for AWS Lambda on Discord**: `#python` - **[Invite link](https://discord.gg/B8zZKbbyET)**\n* **Email**: <aws-powertools-maintainers@amazon.com>\n\n## Security disclosures\n\nIf you think you’ve found a potential security issue, please do not post it in the Issues.  Instead, please follow the instructions [here](https://aws.amazon.com/security/vulnerability-reporting/) or [email AWS security directly](mailto:aws-security@amazon.com).\n\n## License\n\nThis library is licensed under the MIT-0 License. See the LICENSE file.\n',
     'author': 'Amazon Web Services',

aws_lambda_powertools-3.5.1a3/aws_lambda_powertools/utilities/streaming/__init__.py

@@ -1,3 +0,0 @@
-from aws_lambda_powertools.utilities.streaming.s3_object import S3Object
-
-__all__ = ["S3Object"]