Release notes from aws-advanced-python-wrapper

AWS Advanced Python Wrapper - v2.1.0

2026-02-11T20:34:44Z

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

2026-01-15T03:53:02Z

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

2025-10-17T22:39:58Z

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

2025-07-29T11:47:32Z

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

2024-12-13T02:28:23Z

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

2024-10-18T22:12:45Z

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

2024-07-31T23:30:09Z

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

2024-05-23T17:04:37Z

[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