aws-lambda-powertools 3.0.0.dev9__tar.gz → 3.0.0.dev11__tar.gz

{aws_lambda_powertools-3.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: aws-lambda-powertools
-Version: 3.0.0.dev9
+Version: 3.0.0.dev11
 Summary: Powertools for AWS Lambda (Python) is a developer toolkit to implement Serverless best practices and increase developer velocity.
 Home-page: https://github.com/aws-powertools/powertools-lambda-python
 License: MIT

aws_lambda_powertools-3.0.0.dev11/aws_lambda_powertools/event_handler/openapi/constants.py

@@ -0,0 +1,2 @@
+DEFAULT_API_VERSION = "1.0.0"
+DEFAULT_OPENAPI_VERSION = "3.1.0"

{aws_lambda_powertools-3.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/aws_lambda_powertools/event_handler/openapi/models.py

@@ -2,14 +2,13 @@
 from enum import Enum
 from typing import Any, Dict, List, Literal, Optional, Set, Union
 
-from pydantic import AnyUrl, BaseModel, Field
+from pydantic import AnyUrl, BaseModel, ConfigDict, Field
 from typing_extensions import Annotated
 
 from aws_lambda_powertools.event_handler.openapi.compat import model_rebuild
-from aws_lambda_powertools.event_handler.openapi.constants import (
-    MODEL_CONFIG_ALLOW,
-    MODEL_CONFIG_IGNORE,
-)
+
+MODEL_CONFIG_ALLOW = ConfigDict(extra="allow")
+MODEL_CONFIG_IGNORE = ConfigDict(extra="ignore")
 
 """
 The code defines Pydantic models for the various OpenAPI objects like OpenAPI, PathItem, Operation, Parameter etc.

{aws_lambda_powertools-3.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/aws_lambda_powertools/event_handler/openapi/swagger_ui/oauth2.py

@@ -4,7 +4,7 @@ from typing import Dict, Optional, Sequence
 
 from pydantic import BaseModel, Field, field_validator
 
-from aws_lambda_powertools.event_handler.openapi.constants import (
+from aws_lambda_powertools.event_handler.openapi.models import (
     MODEL_CONFIG_ALLOW,
 )
 from aws_lambda_powertools.shared.functions import powertools_dev_is_set

{aws_lambda_powertools-3.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/aws_lambda_powertools/event_handler/openapi/types.py

@@ -4,14 +4,13 @@ import types
 from enum import Enum
 from typing import TYPE_CHECKING, Any, Callable, Dict, Set, Type, TypedDict, Union
 
-from pydantic import BaseModel
-
 if TYPE_CHECKING:
+    from pydantic import BaseModel  # noqa: F401
     from typing_extensions import NotRequired
 
 CacheKey = Union[Callable[..., Any], None]
 IncEx = Union[Set[int], Set[str], Dict[int, Any], Dict[str, Any]]
-TypeModelOrEnum = Union[Type[BaseModel], Type[Enum]]
+TypeModelOrEnum = Union[Type["BaseModel"], Type[Enum]]
 ModelNameMap = Dict[TypeModelOrEnum, str]
 UnionType = getattr(types, "UnionType", Union)
 

{aws_lambda_powertools-3.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/aws_lambda_powertools/shared/version.py

@@ -1,3 +1,3 @@
 """Exposes version constant to avoid circular dependencies."""
 
-VERSION = "3.0.0.dev9"
+VERSION = "3.0.0.dev11"

{aws_lambda_powertools-3.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/aws_lambda_powertools/utilities/data_classes/api_gateway_authorizer_event.py

@@ -2,7 +2,10 @@ from __future__ import annotations
 
 import enum
 import re
-from typing import Any
+import warnings
+from typing import Any, overload
+
+from typing_extensions import deprecated
 
 from aws_lambda_powertools.utilities.data_classes.common import (
     BaseRequestContext,
@@ -10,6 +13,10 @@ from aws_lambda_powertools.utilities.data_classes.common import (
     CaseInsensitiveDict,
     DictWrapper,
 )
+from aws_lambda_powertools.utilities.data_classes.shared_functions import (
+    get_header_value,
+)
+from aws_lambda_powertools.warnings import PowertoolsDeprecationWarning
 
 
 class APIGatewayRouteArn:
@@ -162,6 +169,55 @@ class APIGatewayAuthorizerRequestEvent(DictWrapper):
     def request_context(self) -> BaseRequestContext:
         return BaseRequestContext(self._data)
 
+    @overload
+    def get_header_value(
+        self,
+        name: str,
+        default_value: str,
+        case_sensitive: bool = False,
+    ) -> str: ...
+
+    @overload
+    def get_header_value(
+        self,
+        name: str,
+        default_value: str | None = None,
+        case_sensitive: bool = False,
+    ) -> str | None: ...
+
+    @deprecated(
+        "`get_header_value` function is deprecated; Access headers directly using event.headers.get('HeaderName')",
+        category=None,
+    )
+    def get_header_value(
+        self,
+        name: str,
+        default_value: str | None = None,
+        case_sensitive: bool = False,
+    ) -> str | None:
+        """Get header value by name
+        Parameters
+        ----------
+        name: str
+            Header name
+        default_value: str, optional
+            Default value if no value was found by name
+        case_sensitive: bool
+            Whether to use a case-sensitive look up
+        Returns
+        -------
+        str, optional
+            Header value
+        """
+        warnings.warn(
+            "The `get_header_value` function is deprecated in V3 and the `case_sensitive` parameter "
+            "no longer has any effect. This function will be removed in the next major version. "
+            "Instead, access headers directly using event.headers.get('HeaderName'), which is case insensitive.",
+            category=PowertoolsDeprecationWarning,
+            stacklevel=2,
+        )
+        return get_header_value(self.headers, name, default_value, case_sensitive)
+
 
 class APIGatewayAuthorizerEventV2(DictWrapper):
     """API Gateway Authorizer Event Format 2.0
@@ -244,6 +300,50 @@ class APIGatewayAuthorizerEventV2(DictWrapper):
     def stage_variables(self) -> dict[str, str]:
         return self.get("stageVariables") or {}
 
+    @overload
+    def get_header_value(self, name: str, default_value: str, case_sensitive: bool = False) -> str: ...
+
+    @overload
+    def get_header_value(
+        self,
+        name: str,
+        default_value: str | None = None,
+        case_sensitive: bool = False,
+    ) -> str | None: ...
+
+    @deprecated(
+        "`get_header_value` function is deprecated; Access headers directly using event.headers.get('HeaderName')",
+        category=None,
+    )
+    def get_header_value(
+        self,
+        name: str,
+        default_value: str | None = None,
+        case_sensitive: bool = False,
+    ) -> str | None:
+        """Get header value by name
+        Parameters
+        ----------
+        name: str
+            Header name
+        default_value: str, optional
+            Default value if no value was found by name
+        case_sensitive: bool
+            Whether to use a case-sensitive look up
+        Returns
+        -------
+        str, optional
+            Header value
+        """
+        warnings.warn(
+            "The `get_header_value` function is deprecated in V3 and the `case_sensitive` parameter "
+            "no longer has any effect. This function will be removed in the next major version. "
+            "Instead, access headers directly using event.headers.get('HeaderName'), which is case insensitive.",
+            category=PowertoolsDeprecationWarning,
+            stacklevel=2,
+        )
+        return get_header_value(self.headers, name, default_value, case_sensitive)
+
 
 class APIGatewayAuthorizerResponseV2:
     """Api Gateway HTTP API V2 payload authorizer simple response helper

{aws_lambda_powertools-3.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/aws_lambda_powertools/utilities/data_classes/appsync_resolver_event.py

@@ -1,8 +1,15 @@
 from __future__ import annotations
 
-from typing import Any
+import warnings
+from typing import Any, overload
+
+from typing_extensions import deprecated
 
 from aws_lambda_powertools.utilities.data_classes.common import CaseInsensitiveDict, DictWrapper
+from aws_lambda_powertools.utilities.data_classes.shared_functions import (
+    get_header_value,
+)
+from aws_lambda_powertools.warnings import PowertoolsDeprecationWarning
 
 
 def get_identity_object(identity: dict | None) -> Any:
@@ -212,3 +219,52 @@ class AppSyncResolverEvent(DictWrapper):
         stash to pass arbitrary data across request and response mapping templates, and across functions in
         a pipeline resolver."""
         return self.get("stash") or {}
+
+    @overload
+    def get_header_value(
+        self,
+        name: str,
+        default_value: str,
+        case_sensitive: bool = False,
+    ) -> str: ...
+
+    @overload
+    def get_header_value(
+        self,
+        name: str,
+        default_value: str | None = None,
+        case_sensitive: bool = False,
+    ) -> str | None: ...
+
+    @deprecated(
+        "`get_header_value` function is deprecated; Access headers directly using event.headers.get('HeaderName')",
+        category=None,
+    )
+    def get_header_value(
+        self,
+        name: str,
+        default_value: str | None = None,
+        case_sensitive: bool = False,
+    ) -> str | None:
+        """Get header value by name
+        Parameters
+        ----------
+        name: str
+            Header name
+        default_value: str, optional
+            Default value if no value was found by name
+        case_sensitive: bool
+            Whether to use a case-sensitive look up
+        Returns
+        -------
+        str, optional
+            Header value
+        """
+        warnings.warn(
+            "The `get_header_value` function is deprecated in V3 and the `case_sensitive` parameter "
+            "no longer has any effect. This function will be removed in the next major version. "
+            "Instead, access headers directly using event.headers.get('HeaderName'), which is case insensitive.",
+            category=PowertoolsDeprecationWarning,
+            stacklevel=2,
+        )
+        return get_header_value(self.request_headers, name, default_value, case_sensitive)

{aws_lambda_powertools-3.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/aws_lambda_powertools/utilities/data_classes/common.py

@@ -2,12 +2,23 @@ from __future__ import annotations
 
 import base64
 import json
+import warnings
 from functools import cached_property
-from typing import TYPE_CHECKING, Any, Callable, Iterator, Mapping
+from typing import TYPE_CHECKING, Any, Callable, Iterator, Mapping, overload
+
+from typing_extensions import deprecated
+
+from aws_lambda_powertools.warnings import PowertoolsDeprecationWarning
 
 if TYPE_CHECKING:
     from aws_lambda_powertools.shared.headers_serializer import BaseHeadersSerializer
 
+from aws_lambda_powertools.utilities.data_classes.shared_functions import (
+    get_header_value,
+    get_multi_value_query_string_values,
+    get_query_string_value,
+)
+
 
 class CaseInsensitiveDict(dict):
     """Case insensitive dict implementation. Assumes string keys only."""
@@ -208,6 +219,108 @@ class BaseProxyEvent(DictWrapper):
         """The HTTP method used. Valid values include: DELETE, GET, HEAD, OPTIONS, PATCH, POST, and PUT."""
         return self["httpMethod"]
 
+    @overload
+    def get_query_string_value(self, name: str, default_value: str) -> str: ...
+
+    @overload
+    def get_query_string_value(self, name: str, default_value: str | None = None) -> str | None: ...
+
+    def get_query_string_value(self, name: str, default_value: str | None = None) -> str | None:
+        """Get query string value by name
+        Parameters
+        ----------
+        name: str
+            Query string parameter name
+        default_value: str, optional
+            Default value if no value was found by name
+        Returns
+        -------
+        str, optional
+            Query string parameter value
+        """
+        return get_query_string_value(
+            query_string_parameters=self.query_string_parameters,
+            name=name,
+            default_value=default_value,
+        )
+
+    def get_multi_value_query_string_values(
+        self,
+        name: str,
+        default_values: list[str] | None = None,
+    ) -> list[str]:
+        """Get multi-value query string parameter values by name
+        Parameters
+        ----------
+        name: str
+            Multi-Value query string parameter name
+        default_values: List[str], optional
+            Default values is no values are found by name
+        Returns
+        -------
+        List[str], optional
+            List of query string values
+        """
+        return get_multi_value_query_string_values(
+            multi_value_query_string_parameters=self.multi_value_query_string_parameters,
+            name=name,
+            default_values=default_values,
+        )
+
+    @overload
+    def get_header_value(
+        self,
+        name: str,
+        default_value: str,
+        case_sensitive: bool = False,
+    ) -> str: ...
+
+    @overload
+    def get_header_value(
+        self,
+        name: str,
+        default_value: str | None = None,
+        case_sensitive: bool = False,
+    ) -> str | None: ...
+
+    @deprecated(
+        "`get_header_value` function is deprecated; Access headers directly using event.headers.get('HeaderName')",
+        category=None,
+    )
+    def get_header_value(
+        self,
+        name: str,
+        default_value: str | None = None,
+        case_sensitive: bool = False,
+    ) -> str | None:
+        """Get header value by name
+        Parameters
+        ----------
+        name: str
+            Header name
+        default_value: str, optional
+            Default value if no value was found by name
+        case_sensitive: bool
+            Whether to use a case-sensitive look up. By default we make a case-insensitive lookup.
+        Returns
+        -------
+        str, optional
+            Header value
+        """
+        warnings.warn(
+            "The `get_header_value` function is deprecated in V3 and the `case_sensitive` parameter "
+            "no longer has any effect. This function will be removed in the next major version. "
+            "Instead, access headers directly using event.headers.get('HeaderName'), which is case insensitive.",
+            category=PowertoolsDeprecationWarning,
+            stacklevel=2,
+        )
+        return get_header_value(
+            headers=self.headers,
+            name=name,
+            default_value=default_value,
+            case_sensitive=case_sensitive,
+        )
+
     def header_serializer(self) -> BaseHeadersSerializer:
         raise NotImplementedError()
 

aws_lambda_powertools-3.0.0.dev11/aws_lambda_powertools/utilities/data_classes/shared_functions.py

@@ -0,0 +1,159 @@
+from __future__ import annotations
+
+import base64
+import warnings
+from typing import Any, overload
+
+from typing_extensions import deprecated
+
+from aws_lambda_powertools.warnings import PowertoolsDeprecationWarning
+
+
+def base64_decode(value: str) -> str:
+    """
+    Decodes a Base64-encoded string and returns the decoded value.
+
+    Parameters
+    ----------
+    value: str
+        The Base64-encoded string to decode.
+
+    Returns
+    -------
+    str
+        The decoded string value.
+    """
+    return base64.b64decode(value).decode("UTF-8")
+
+
+@overload
+def get_header_value(
+    headers: dict[str, Any],
+    name: str,
+    default_value: str,
+    case_sensitive: bool = False,
+) -> str: ...
+
+
+@overload
+def get_header_value(
+    headers: dict[str, Any],
+    name: str,
+    default_value: str | None = None,
+    case_sensitive: bool = False,
+) -> str | None: ...
+
+
+@deprecated(
+    "`get_header_value` function is deprecated; Access headers directly using event.headers.get('HeaderName')",
+    category=None,
+)
+def get_header_value(
+    headers: dict[str, Any],
+    name: str,
+    default_value: str | None = None,
+    case_sensitive: bool = False,
+) -> str | None:
+    """
+    Get the value of a header by its name.
+    Parameters
+    ----------
+    headers: Dict[str, str]
+        The dictionary of headers.
+    name: str
+        The name of the header to retrieve.
+    default_value: str, optional
+        The default value to return if the header is not found. Default is None.
+    case_sensitive: bool, optional
+        Indicates whether the header name should be case-sensitive. Default is False.
+    Returns
+    -------
+    str, optional
+        The value of the header if found, otherwise the default value or None.
+    """
+
+    warnings.warn(
+        "The `get_header_value` function is deprecated in V3 and the `case_sensitive` parameter "
+        "no longer has any effect. This function will be removed in the next major version. "
+        "Instead, access headers directly using event.headers.get('HeaderName'), which is case insensitive.",
+        category=PowertoolsDeprecationWarning,
+        stacklevel=2,
+    )
+
+    # If headers is NoneType, return default value
+    if not headers:
+        return default_value
+
+    if case_sensitive:
+        return headers.get(name, default_value)
+    name_lower = name.lower()
+
+    return next(
+        # Iterate over the dict and do a case-insensitive key comparison
+        (value for key, value in headers.items() if key.lower() == name_lower),
+        # Default value is returned if no matches was found
+        default_value,
+    )
+
+
+@overload
+def get_query_string_value(
+    query_string_parameters: dict[str, str] | None,
+    name: str,
+    default_value: str,
+) -> str: ...
+
+
+@overload
+def get_query_string_value(
+    query_string_parameters: dict[str, str] | None,
+    name: str,
+    default_value: str | None = None,
+) -> str | None: ...
+
+
+def get_query_string_value(
+    query_string_parameters: dict[str, str] | None,
+    name: str,
+    default_value: str | None = None,
+) -> str | None:
+    """
+    Retrieves the value of a query string parameter specified by the given name.
+    Parameters
+    ----------
+    name: str
+        The name of the query string parameter to retrieve.
+    default_value: str, optional
+        The default value to return if the parameter is not found. Defaults to None.
+    Returns
+    -------
+    str. optional
+        The value of the query string parameter if found, or the default value if not found.
+    """
+    params = query_string_parameters
+    return default_value if params is None else params.get(name, default_value)
+
+
+def get_multi_value_query_string_values(
+    multi_value_query_string_parameters: dict[str, list[str]] | None,
+    name: str,
+    default_values: list[str] | None = None,
+) -> list[str]:
+    """
+    Retrieves the values of a multi-value string parameters specified by the given name.
+    Parameters
+    ----------
+    name: str
+        The name of the query string parameter to retrieve.
+    default_value: list[str], optional
+        The default value to return if the parameter is not found. Defaults to None.
+    Returns
+    -------
+    List[str]. optional
+        The values of the query string parameter if found, or the default values if not found.
+    """
+
+    default = default_values or []
+    params = multi_value_query_string_parameters or {}
+
+    return params.get(name) or default

{aws_lambda_powertools-3.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/aws_lambda_powertools/utilities/data_classes/vpc_lattice.py

@@ -35,9 +35,7 @@ class VPCLatticeEventBase(BaseProxyEvent):
     def decoded_body(self) -> str:
         """Dynamically base64 decode body as a str"""
         body: str = self["body"]
-        if self.is_base64_encoded:
-            return base64_decode(body)
-        return body
+        return base64_decode(body) if self.is_base64_encoded else body
 
     @property
     def method(self) -> str:

{aws_lambda_powertools-3.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/aws_lambda_powertools/utilities/idempotency/persistence/datarecord.py

@@ -92,3 +92,24 @@ class DataRecord:
             previous response data deserialized
         """
         return json.loads(self.response_data) if self.response_data else None
+
+    def get_expiration_datetime(self) -> datetime.datetime | None:
+        """
+        Converts the expiry timestamp to a datetime object.
+
+        This method checks if an expiry timestamp exists and converts it to a
+        datetime object. If no timestamp is present, it returns None.
+
+        Returns:
+        -------
+        datetime.datetime | None
+            A datetime object representing the expiration time, or None if no expiry timestamp is set.
+
+        Note:
+        ----
+        The returned datetime object is timezone-naive and assumes the timestamp
+        is in the system's local timezone. Lambda default timezone is UTC.
+        """
+        if self.expiry_timestamp:
+            return datetime.datetime.fromtimestamp(int(self.expiry_timestamp))
+        return None

{aws_lambda_powertools-3.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "aws_lambda_powertools"
-version = "3.0.0.dev9"
+version = "3.0.0.dev11"
 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.0.0.dev9 → aws_lambda_powertools-3.0.0.dev11}/setup.py

@@ -62,7 +62,7 @@ extras_require = \
 
 setup_kwargs = {
     'name': 'aws-lambda-powertools',
-    'version': '3.0.0.dev9',
+    'version': '3.0.0.dev11',
     '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* [Capital One](https://www.capitalone.com/)\n* [CPQi (Exadel Financial Services)](https://cpqi.com/)\n* [CloudZero](https://www.cloudzero.com/)\n* [CyberArk](https://www.cyberark.com/)\n* [globaldatanet](https://globaldatanet.com/)\n* [IMS](https://ims.tech/)\n* [Jit Security](https://www.jit.io/)\n* [Propellor.ai](https://www.propellor.ai/)\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.0.0.dev9/aws_lambda_powertools/event_handler/openapi/constants.py

@@ -1,6 +0,0 @@
-from pydantic import ConfigDict
-
-DEFAULT_API_VERSION = "1.0.0"
-DEFAULT_OPENAPI_VERSION = "3.1.0"
-MODEL_CONFIG_ALLOW = ConfigDict(extra="allow")
-MODEL_CONFIG_IGNORE = ConfigDict(extra="ignore")

aws_lambda_powertools-3.0.0.dev9/aws_lambda_powertools/utilities/data_classes/shared_functions.py

@@ -1,18 +0,0 @@
-import base64
-
-
-def base64_decode(value: str) -> str:
-    """
-    Decodes a Base64-encoded string and returns the decoded value.
-
-    Parameters
-    ----------
-    value: str
-        The Base64-encoded string to decode.
-
-    Returns
-    -------
-    str
-        The decoded string value.
-    """
-    return base64.b64decode(value).decode("UTF-8")