Add Python 3.12 and 3.13 support

- Add Python 3.12 and 3.13 to package classifiers
- Update CI/CD workflows to test against Python 3.12 and 3.13
- Add Gradle test tasks for Python 3.12 and 3.13 (MySQL and PostgreSQL)
- Update Java and Python enum types to include 3.12 and 3.13
- Add Docker image mappings for Python 3.12 and 3.13
- Update documentation to reflect Python 3.8-3.13 support

Resolves #967

Author: Dhanush010

.github/workflows/integration_tests_codebuild.yml

@@ -13,7 +13,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [ "3.8", "3.11" ]
+        python-version: [ "3.8", "3.11", "3.12", "3.13" ]
         environment: [ "mysql", "pg" ]
 
     runs-on: ubuntu-latest

.github/workflows/main.yml

@@ -32,7 +32,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
         poetry-version: ["1.8.2"]
 
     steps:

README.md

@@ -205,7 +205,7 @@ For all other questions, please use [GitHub discussions](https://github.com/awsl
 
 1. Set up your environment by following the directions in the [Development Guide](./docs/development-guide/DevelopmentGuide.md).
 2. To contribute, first make a fork of this project. 
-3. Make any changes on your fork. Make sure you are aware of the requirements for the project (e.g. do not require Python 3.7 if we are supporting Python 3.8 - 3.11 (inclusive)).
+3. Make any changes on your fork. Make sure you are aware of the requirements for the project (e.g. do not require Python 3.7 if we are supporting Python 3.8 - 3.13 (inclusive)).
 4. Create a pull request from your fork. 
 5. Pull requests need to be approved and merged by maintainers into the main branch. <br />
 

docs/GettingStarted.md

@@ -4,7 +4,7 @@
 
 Before using the AWS Advanced Python Driver, you must install:
 
-- Python 3.8 - 3.11 (inclusive).
+- Python 3.8 - 3.13 (inclusive).
 - The AWS Advanced Python Driver.
 - Your choice of underlying Python driver. 
   - To use the wrapper with Aurora with PostgreSQL compatibility, install [Psycopg](https://github.com/psycopg/psycopg).

docs/development-guide/DevelopmentGuide.md

@@ -1,7 +1,7 @@
 # Development Guide
 
 ### Setup
-Make sure you have Python 3.8 - 3.11 (inclusive) installed, along with your choice of underlying Python driver (see [minimum requirements](../GettingStarted.md#minimum-requirements)).
+Make sure you have Python 3.8 - 3.13 (inclusive) installed, along with your choice of underlying Python driver (see [minimum requirements](../GettingStarted.md#minimum-requirements)).
 
 Clone the AWS Advanced Python Driver repository:
 

pyproject.toml

@@ -18,6 +18,8 @@ classifiers = [
     "Programming Language :: Python :: 3 :: Only",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
 ]
 
 [tool.poetry.dependencies]

tests/integration/container/utils/target_python_version.py

@@ -17,3 +17,5 @@
 
 class TargetPythonVersion(Enum):
     PYTHON_3_11 = "PYTHON_3_11"
+    PYTHON_3_12 = "PYTHON_3_12"
+    PYTHON_3_13 = "PYTHON_3_13"

tests/integration/host/build.gradle.kts

@@ -68,6 +68,8 @@ tasks.register<Test>("test-python-3.11-mysql") {
     filter.includeTestsMatching("integration.host.TestRunner.runTests")
     doFirst {
         systemProperty("exclude-performance", "true")
+        systemProperty("exclude-python-312", "true")
+        systemProperty("exclude-python-313", "true")
         systemProperty("exclude-multi-az-cluster", "true")
         systemProperty("exclude-multi-az-instance", "true")
         systemProperty("exclude-bg", "true")
@@ -83,6 +85,76 @@ tasks.register<Test>("test-python-3.11-pg") {
     filter.includeTestsMatching("integration.host.TestRunner.runTests")
     doFirst {
         systemProperty("exclude-performance", "true")
+        systemProperty("exclude-python-312", "true")
+        systemProperty("exclude-python-313", "true")
+        systemProperty("exclude-multi-az-cluster", "true")
+        systemProperty("exclude-multi-az-instance", "true")
+        systemProperty("exclude-bg", "true")
+        systemProperty("exclude-mysql-driver", "true")
+        systemProperty("exclude-mysql-engine", "true")
+        systemProperty("exclude-mariadb-driver", "true")
+        systemProperty("exclude-mariadb-engine", "true")
+    }
+}
+
+tasks.register<Test>("test-python-3.12-mysql") {
+    group = "verification"
+    filter.includeTestsMatching("integration.host.TestRunner.runTests")
+    doFirst {
+        systemProperty("exclude-performance", "true")
+        systemProperty("exclude-python-311", "true")
+        systemProperty("exclude-python-313", "true")
+        systemProperty("exclude-multi-az-cluster", "true")
+        systemProperty("exclude-multi-az-instance", "true")
+        systemProperty("exclude-traces-telemetry", "true")
+        systemProperty("exclude-metrics-telemetry", "true")
+        systemProperty("exclude-bg", "true")
+        systemProperty("exclude-pg-driver", "true")
+        systemProperty("exclude-pg-engine", "true")
+    }
+}
+
+tasks.register<Test>("test-python-3.12-pg") {
+    group = "verification"
+    filter.includeTestsMatching("integration.host.TestRunner.runTests")
+    doFirst {
+        systemProperty("exclude-performance", "true")
+        systemProperty("exclude-python-311", "true")
+        systemProperty("exclude-python-313", "true")
+        systemProperty("exclude-multi-az-cluster", "true")
+        systemProperty("exclude-multi-az-instance", "true")
+        systemProperty("exclude-bg", "true")
+        systemProperty("exclude-mysql-driver", "true")
+        systemProperty("exclude-mysql-engine", "true")
+        systemProperty("exclude-mariadb-driver", "true")
+        systemProperty("exclude-mariadb-engine", "true")
+    }
+}
+
+tasks.register<Test>("test-python-3.13-mysql") {
+    group = "verification"
+    filter.includeTestsMatching("integration.host.TestRunner.runTests")
+    doFirst {
+        systemProperty("exclude-performance", "true")
+        systemProperty("exclude-python-311", "true")
+        systemProperty("exclude-python-312", "true")
+        systemProperty("exclude-multi-az-cluster", "true")
+        systemProperty("exclude-multi-az-instance", "true")
+        systemProperty("exclude-bg", "true")
+        systemProperty("exclude-traces-telemetry", "true")
+        systemProperty("exclude-metrics-telemetry", "true")
+        systemProperty("exclude-pg-driver", "true")
+        systemProperty("exclude-pg-engine", "true")
+    }
+}
+
+tasks.register<Test>("test-python-3.13-pg") {
+    group = "verification"
+    filter.includeTestsMatching("integration.host.TestRunner.runTests")
+    doFirst {
+        systemProperty("exclude-performance", "true")
+        systemProperty("exclude-python-311", "true")
+        systemProperty("exclude-python-312", "true")
         systemProperty("exclude-multi-az-cluster", "true")
         systemProperty("exclude-multi-az-instance", "true")
         systemProperty("exclude-bg", "true")

tests/integration/host/src/test/java/integration/TargetPythonVersion.java

@@ -17,5 +17,7 @@
 package integration;
 
 public enum TargetPythonVersion {
-  PYTHON_3_11
+  PYTHON_3_11,
+  PYTHON_3_12,
+  PYTHON_3_13
 }

tests/integration/host/src/test/java/integration/host/TestEnvironment.java

@@ -1145,6 +1145,10 @@ private static String getContainerBaseImageName(TestEnvironmentRequest request)
         return "python:3.8.18";
       case PYTHON_3_11:
         return "python:3.11.5";
+      case PYTHON_3_12:
+        return "python:3.12";
+      case PYTHON_3_13:
+        return "python:3.13";
       default:
         throw new NotImplementedException(request.getTargetPythonVersion().toString());
     }