Adding support for Python 3.12

Author: leandrodamascena

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -63,6 +63,7 @@ body:
         - "3.9"
         - "3.10"
         - "3.11"
+        - "3.12"
     validations:
       required: true
   - type: dropdown

.github/ISSUE_TEMPLATE/static_typing.yml

@@ -30,6 +30,7 @@ body:
         - "3.9"
         - "3.10"
         - "3.11"
+        - "3.12"
     validations:
       required: true
   - type: input

.github/workflows/publish_v2_layer.yml

@@ -107,7 +107,7 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@65d7f2d534ac1bc67fcd62888c5f4f3d2cb2b236 # v4.7.1
         with:
-          python-version: "3.11"
+          python-version: "3.12"
           cache: "pip"
       - name: Resolve and install project dependencies
         # CDK spawns system python when compiling stack

.github/workflows/quality_check.yml

@@ -44,7 +44,7 @@ jobs:
     strategy:
       max-parallel: 4
       matrix:
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12"]
     env:
       PYTHON: "${{ matrix.python-version }}"
     permissions:

.github/workflows/quality_check_pydanticv2.yml

@@ -44,7 +44,7 @@ jobs:
     strategy:
       max-parallel: 4
       matrix:
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12"]
     env:
       PYTHON: "${{ matrix.python-version }}"
     permissions:

.github/workflows/release.yml

@@ -133,7 +133,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@65d7f2d534ac1bc67fcd62888c5f4f3d2cb2b236 # v4.7.1
         with:
-          python-version: "3.11"
+          python-version: "3.12"
           cache: "poetry"
       - name: Install dependencies
         run: make dev
@@ -171,7 +171,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@65d7f2d534ac1bc67fcd62888c5f4f3d2cb2b236 # v4.7.1
         with:
-          python-version: "3.11"
+          python-version: "3.12"
           cache: "poetry"
 
       - name: Build python package and wheel

.github/workflows/reusable_deploy_v2_layer_stack.yml

@@ -162,7 +162,7 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@65d7f2d534ac1bc67fcd62888c5f4f3d2cb2b236 # v4.7.1
         with:
-          python-version: "3.11"
+          python-version: "3.12"
           cache: "pip"
       - name: Resolve and install project dependencies
         # CDK spawns system python when compiling stack

.github/workflows/reusable_publish_docs.yml

@@ -53,7 +53,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@65d7f2d534ac1bc67fcd62888c5f4f3d2cb2b236 # v4.7.1
         with:
-          python-version: "3.11"
+          python-version: "3.12"
           cache: "poetry"
       - name: Install dependencies
         run: make dev

.github/workflows/run-e2e-tests.yml

@@ -47,7 +47,7 @@ jobs:
     strategy:
       fail-fast: false # needed so if a version fails, the others will still be able to complete and cleanup
       matrix:
-        version: ["3.7", "3.8", "3.9", "3.10", "3.11"]
+        version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12"]
     if: ${{ github.actor != 'dependabot[bot]' && github.repository == 'aws-powertools/powertools-lambda-python' }}
     steps:
       - name: "Checkout"

README.md

@@ -3,7 +3,7 @@
 
 [![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)
 [![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)
-![PythonSupport](https://img.shields.io/static/v1?label=python&message=%203.7|%203.8|%203.9|%203.10|%203.11&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)](https://discord.gg/B8zZKbbyET)
+![PythonSupport](https://img.shields.io/static/v1?label=python&message=%203.7|%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)](https://discord.gg/B8zZKbbyET)
 
 Powertools 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).
 

docs/tutorial/index.md

@@ -20,11 +20,11 @@ Let's clone our sample project before we add one feature at a time.
     Bootstrap directly via SAM CLI:
 
     ```shell
-    sam init --app-template hello-world-powertools-python --name sam-app --package-type Zip --runtime python3.11 --no-tracing
+    sam init --app-template hello-world-powertools-python --name sam-app --package-type Zip --runtime python3.12 --no-tracing
     ```
 
 ```bash title="Use SAM CLI to initialize the sample project"
-sam init --runtime python3.11 --dependency-manager pip --app-template hello-world --name powertools-quickstart
+sam init --runtime python3.12 --dependency-manager pip --app-template hello-world --name powertools-quickstart
 ```
 
 ### Project structure

examples/idempotency/templates/terraform.tf

@@ -28,7 +28,7 @@ resource "aws_dynamodb_table" "IdempotencyTable" {
 resource "aws_lambda_function" "IdempotencyFunction" {
   function_name = "IdempotencyFunction"
   role          = aws_iam_role.IdempotencyFunctionRole.arn
-  runtime       = "python3.11"
+  runtime       = "python3.12"
   handler       = "app.lambda_handler"
   filename      = "lambda.zip"
 

layer/sar/template.txt

@@ -14,7 +14,7 @@ Metadata:
     SourceCodeUrl: https://github.com/aws-powertools/powertools-lambda-python
 
 Transform: AWS::Serverless-2016-10-31
-Description: AWS Lambda Layer for aws-lambda-powertools with python 3.11, 3.10, 3.9, 3.8 or 3.7
+Description: AWS Lambda Layer for aws-lambda-powertools with python 3.12, 3.11, 3.10, 3.9, 3.8 or 3.7
 
 Resources:
   LambdaLayer:
@@ -24,6 +24,7 @@ Resources:
       LayerName: <SAR_APP_NAME>
       ContentUri: <LAYER_CONTENT_PATH>
       CompatibleRuntimes:
+        - python3.12
         - python3.11
         - python3.10
         - python3.9

pyproject.toml

@@ -14,6 +14,7 @@ classifiers = [
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
 ]
 repository = "https://github.com/aws-powertools/powertools-lambda-python"
 documentation = "https://docs.powertools.aws.dev/lambda/python/"

tests/e2e/utils/infrastructure.py

@@ -97,12 +97,12 @@ def create_lambda_functions(
         self.create_lambda_functions()
         ```
 
-        Creating Lambda functions and override runtime to Python 3.11
+        Creating Lambda functions and override runtime to Python 3.12
 
         ```python
         from aws_cdk.aws_lambda import Runtime
 
-        self.create_lambda_functions(function_props={"runtime": Runtime.PYTHON_3_11)
+        self.create_lambda_functions(function_props={"runtime": Runtime.PYTHON_3_12)
         ```
         """
         if not self._handlers_dir.exists():
@@ -119,6 +119,7 @@ def create_lambda_functions(
                 Runtime.PYTHON_3_9,
                 Runtime.PYTHON_3_10,
                 Runtime.PYTHON_3_11,
+                Runtime.PYTHON_3_12,
             ],
             compatible_architectures=[architecture],
             code=Code.from_asset(path=layer_build),
@@ -260,6 +261,8 @@ def _determine_runtime_version(self) -> Runtime:
             return Runtime.PYTHON_3_10
         elif version.major == 3 and version.minor == 11:
             return Runtime.PYTHON_3_11
+        elif version.major == 3 and version.minor == 12:
+            return Runtime.PYTHON_3_12
         else:
             raise Exception(f"Unsupported Python version: {version}")