AWS Advanced Python Wrapper - v3.0.0

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[3.0.0] - 2026-06-02

🦀 Breaking Changes

Warning

3.0.0 changes the default cluster_id behavior. Applications connecting to multiple database clusters must now explicitly set a unique cluster_id for each cluster. See the Cluster ID documentation for details.

Migration

Scenario	Action Required
Single database cluster	No changes required
Multiple database clusters	Review all connection strings and add a unique cluster_id parameter per cluster. See the Cluster ID documentation for configuration guidance.

🪄 Added

• SQLAlchemy ORM support.

🐛 Fixed

• New pooled connections created with stale credentials, and PostgreSQL error handler unable to correctly handle auth errors nested in connection errors (PR #1231).
• Read/Write Splitting plugins not subscribed to the execute pipeline, causing idle connections to not be correctly closed during failover (PR #1117).

🦀 Changed

• Updated the default plugin list:
  • Added the Aurora Initial Connection Strategy Plugin for both PostgreSQL and MySQL driver dialects.
  • Removed the Host Monitoring Plugin V2 from the default plugins for MySQL driver dialect. Prior to this change, users need to manually remove it from the plugins connection parameter.

AWS Advanced Python Wrapper - v2.1.0

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.1.0] - 2026-02-11

🪄 Added

• Failover v2 Plugin, an improved version of the failover plugin with enhanced reliability (PR #1079).
• Django support for MySQL (PR #1077).

🐛 Fixed

• Properly handling nested errors in auth plugins (PR #1092).
• Populate opened connection queue with url (PR #1094).
• Spawning unnecessary threads due to ClassVars (PR #1090).
• Incorrect cleanup thread sleep time issue (PR #1090).
• Aurora connection tracker and writer host comparison (PR #1081).
• Sliding expiration cache concurrent access exceptions (PR #1089).
• Stale DNS plugin when connected to reader (PR #1086).
• Read/write splitting + custom endpoint plugin issue when switching to writer (PR #1080).
• Move conn.release_resources() to close method instead of __del__ to avoid relying on GC to release resources (PR #1078).

🦀 Changed

• Performance optimization for auth plugins by caching clients and sessions (PR #1084).
• Update documentation for AWS credentials requirements for plugins using the AWS SDK (PR #1093).

AWS Advanced Python Wrapper - v2.0.0

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.0.0] - 2026-01-14

🦀 Breaking Changes

Warning

• 2.0 removes support for Python 3.8 and 3.9.

🪄 Added

• Python 3.12 and 3.13 support (PR #1052).
• Simple Read/Write Splitting Plugin (srw). This plugin adds functionality to switch between endpoints via calls to the Connection#setReadOnly method. It does not rely on cluster topology. It relies purely on the provided endpoints and their DNS resolution (PR #1048).
• Wrapper resource cleanup method aws_advanced_python_wrapper.release_resources(). This method should be called at program exit to properly clean up background threads and resources (PR #1066).

🐛 Fixed

• Sliding expiration cache bug which causes delay upon exit (PR #1043).
• Unnecessary boto3 call to verify region in IAM plugin which causes performance issues (PR #1042).
• MySQL connections hanging during garbage collection (PR #1063).
• Incorrect MySQL host alias query (PR #1051).
• ImportError when MySQL Connector/Python C Extension isn't available (PR #1038).
• Background threads being created at import time (PR #1066).

🦀 Changed

• Refactor host list provider (PR #1065).
• Performance optimizations (PR #1072).
• Update documentation with required db user permissions for Multi-AZ DB Cluster and Blue/Green support (PR #1061).

AWS Advanced Python Wrapper - v1.4.0

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.4.0] - 2025-10-17

🪄 Added

• EFM v2, an improved alternate version of the efm plugin which addresses issues such as garbage collection and monitoring stability, is now live!

🐛 Fixed

• Update subscribed methods to explicit methods (PR #960)
• Limitless Connection Plugin to properly round the load metric values for Limitless transaction routers (PR #988).

🦀 Changed

• Update documentation for Limitless Plugin (PR #914).
• Update documentation for Blue/Green Support (PR #995).
• Add qualifiers to PostgreSQL SQL statements (PR #1007).

AWS Advanced Python Wrapper - v1.3.0

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.3.0] - 2025-07-28

🪄 Added

• Blue/Green Plugin, which adds support for blue/green deployments (PR #911).
• Limitless Plugin, which adds support for limitless deployments (PR #912).
• Add weighted random host selection strategy (PR #907).
• Add expiration time for secrets cache in the Secrets Manager Plugin (PR #906).
• Allow custom secret keys for database credentials retrieval (PR #843).

🐛 Fixed

• Separate plugin chain cache based on whether a plugin needs to be skipped or not (PR #916).
• Check the cached token and exception type before retrying connection in the auth plugins (PR #902).
• Set the default SSL Secure setting to True (PR #848).

🦀 Changed

• Use poetry version compatible with Python 3.8 (PR #913).
• Port over PluginService API changes from JDBC (PR #901).
• Verify links in markdown documentation (PR #909).
• Replace poetry installation with bash for GitHub actions (PR #903).
• Update python requirement and environment variable information in documentation(PR #900).

AWS Advanced Python Wrapper - v1.2.0

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.2.0] - 2024-12-12

🪄 Added

• Custom endpoint plugin, which adds support for RDS custom endpoints.

AWS Advanced Python Wrapper - v1.1.1

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.1.1] - 2024-10-18

🪄 Added

• Support for MySQL version 9+ (PR #713).

🐛 Fixed

• Extended support for China endpoints (Issue #700).
• Removed unused SQLAlchemy dialect from documentation (PR #714).

AWS Advanced Python Wrapper - v1.1.0

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.1.0] - 2024-07-31

🪄 Added

• Okta authentication support. See the documentation for more details and sample code.

AWS Advanced Python Wrapper - v1.0.0

[1.0.0] - 2024-05-23

The Amazon Web Services (AWS) Advanced Python Wrapper allows an application to take advantage of the features of clustered Aurora databases.

🪄 Added

• Support for PostgreSQL
• Support for MySQL