feat(general): add support for Python 3.12 (aws-powertools#3304)

leandrodamascena · Cavalcante Damascena · rubenfonseca · web-flow · commit 228b7157bd3f · 2023-12-14T13:01:11.000+01:00
Co-authored-by: Cavalcante Damascena &lt;lcdama@b0be8355743f.ant.amazon.com&gt;
Co-authored-by: Ruben Fonseca &lt;rubefons@amazon.com&gt;
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -63,6 +63,7 @@ body:
         - "3.9"
         - "3.10"
         - "3.11"
+        - "3.12"
     validations:
       required: true
   - type: dropdown
diff --git a/.github/ISSUE_TEMPLATE/static_typing.yml b/.github/ISSUE_TEMPLATE/static_typing.yml
@@ -30,6 +30,7 @@ body:
         - "3.9"
         - "3.10"
         - "3.11"
+        - "3.12"
     validations:
       required: true
   - type: input
diff --git a/.github/workflows/publish_v2_layer.yml b/.github/workflows/publish_v2_layer.yml
@@ -107,7 +107,7 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c # v5.0.0
         with:
-          python-version: "3.11"
+          python-version: "3.12"
           cache: "pip"
       - name: Resolve and install project dependencies
         # CDK spawns system python when compiling stack
diff --git a/.github/workflows/quality_check.yml b/.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:
diff --git a/.github/workflows/quality_check_pydanticv2.yml b/.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:
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -133,7 +133,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c # v5.0.0
         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@0a5c61591373683505ea898e09a3ea4f39ef2b9c # v5.0.0
         with:
-          python-version: "3.11"
+          python-version: "3.12"
           cache: "poetry"
 
       - name: Build python package and wheel
diff --git a/.github/workflows/reusable_deploy_v2_layer_stack.yml b/.github/workflows/reusable_deploy_v2_layer_stack.yml
@@ -162,7 +162,7 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c # v5.0.0
         with:
-          python-version: "3.11"
+          python-version: "3.12"
           cache: "pip"
       - name: Resolve and install project dependencies
         # CDK spawns system python when compiling stack
diff --git a/.github/workflows/reusable_publish_docs.yml b/.github/workflows/reusable_publish_docs.yml
@@ -53,7 +53,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@0a5c61591373683505ea898e09a3ea4f39ef2b9c # v5.0.0
         with:
-          python-version: "3.11"
+          python-version: "3.12"
           cache: "poetry"
       - name: Install dependencies
         run: make dev
diff --git a/.github/workflows/run-e2e-tests.yml b/.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"
diff --git a/README.md b/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).
 
diff --git a/docs/tutorial/index.md b/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
diff --git a/examples/batch_processing/sam/dynamodb_batch_processing.yaml b/examples/batch_processing/sam/dynamodb_batch_processing.yaml
@@ -6,7 +6,7 @@ Globals:
   Function:
     Timeout: 5
     MemorySize: 256
-    Runtime: python3.11
+    Runtime: python3.12
     Tracing: Active
     Environment:
       Variables:
diff --git a/examples/batch_processing/sam/kinesis_batch_processing.yaml b/examples/batch_processing/sam/kinesis_batch_processing.yaml
@@ -6,7 +6,7 @@ Globals:
   Function:
     Timeout: 5
     MemorySize: 256
-    Runtime: python3.11
+    Runtime: python3.12
     Tracing: Active
     Environment:
       Variables:
diff --git a/examples/batch_processing/sam/sqs_batch_processing.yaml b/examples/batch_processing/sam/sqs_batch_processing.yaml
@@ -6,7 +6,7 @@ Globals:
   Function:
     Timeout: 5
     MemorySize: 256
-    Runtime: python3.11
+    Runtime: python3.12
     Tracing: Active
     Environment:
       Variables:
diff --git a/examples/event_handler_lambda_function_url/sam/template.yaml b/examples/event_handler_lambda_function_url/sam/template.yaml
@@ -5,7 +5,7 @@ Description: Hello world event handler Lambda Function URL
 Globals:
   Function:
     Timeout: 5
-    Runtime: python3.11
+    Runtime: python3.12
     Tracing: Active
     Environment:
       Variables:
diff --git a/examples/event_handler_rest/sam/micro_function_template.yaml b/examples/event_handler_rest/sam/micro_function_template.yaml
@@ -19,7 +19,7 @@ Globals:
 
     Function:
         Timeout: 5
-        Runtime: python3.11
+        Runtime: python3.12
 
 Resources:
     # Lambda Function Solely For /users endpoint
diff --git a/examples/event_handler_rest/sam/template.yaml b/examples/event_handler_rest/sam/template.yaml
@@ -18,7 +18,7 @@ Globals:
 
   Function:
     Timeout: 5
-    Runtime: python3.11
+    Runtime: python3.12
     Tracing: Active
     Environment:
       Variables:
diff --git a/examples/idempotency/templates/sam.yaml b/examples/idempotency/templates/sam.yaml
@@ -17,7 +17,7 @@ Resources:
   HelloWorldFunction:
     Type: AWS::Serverless::Function
     Properties:
-      Runtime: python3.11
+      Runtime: python3.12
       Handler: app.py
       Policies:
         - Statement:
diff --git a/examples/idempotency/templates/terraform.tf b/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"
 
diff --git a/examples/logger/sam/template.yaml b/examples/logger/sam/template.yaml
@@ -5,7 +5,7 @@ Description: Powertools for AWS Lambda (Python) version
 Globals:
   Function:
     Timeout: 5
-    Runtime: python3.11
+    Runtime: python3.12
     Tracing: Active
     Environment:
       Variables:
diff --git a/examples/metrics/sam/template.yaml b/examples/metrics/sam/template.yaml
@@ -5,7 +5,7 @@ Description: Powertools for AWS Lambda (Python) version
 Globals:
   Function:
     Timeout: 5
-    Runtime: python3.11
+    Runtime: python3.12
     Tracing: Active
     Environment:
       Variables:
diff --git a/examples/metrics_datadog/sam/template.yaml b/examples/metrics_datadog/sam/template.yaml
@@ -5,7 +5,7 @@ Description: Powertools for AWS Lambda (Python) version
 Globals:
   Function:
     Timeout: 5
-    Runtime: python3.11
+    Runtime: python3.12
     Tracing: Active
     Environment:
       Variables:
diff --git a/examples/middleware_factory/sam/combining_powertools_utilities_template.yaml b/examples/middleware_factory/sam/combining_powertools_utilities_template.yaml
@@ -5,7 +5,7 @@ Description: Middleware-powertools-utilities example
 Globals:
   Function:
     Timeout: 5
-    Runtime: python3.9
+    Runtime: python3.12
     Tracing: Active
     Architectures:
       - x86_64
diff --git a/examples/tracer/sam/template.yaml b/examples/tracer/sam/template.yaml
@@ -5,7 +5,7 @@ Description: Powertools for AWS Lambda (Python) version
 Globals:
   Function:
     Timeout: 5
-    Runtime: python3.11
+    Runtime: python3.12
     Tracing: Active
     Environment:
       Variables:
diff --git a/layer/poetry.lock b/layer/poetry.lock
diff --git a/layer/pyproject.toml b/layer/pyproject.toml
diff --git a/layer/sar/template.txt b/layer/sar/template.txt
diff --git a/package-lock.json b/package-lock.json
diff --git a/poetry.lock b/poetry.lock
diff --git a/pyproject.toml b/pyproject.toml
diff --git a/tests/e2e/utils/infrastructure.py b/tests/e2e/utils/infrastructure.py
diff --git a/tests/performance/data_masking/load_test_data_masking/pt-load-test-stack/template.yaml b/tests/performance/data_masking/load_test_data_masking/pt-load-test-stack/template.yaml
