chore: bump driver version and update changelog

Author: aaron-congo

CHANGELOG.md

@@ -3,6 +3,26 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/#semantic-versioning-200).
 
+## [1.3.0] - 2025-07-28
+### :magic_wand: Added
+* [Blue/Green Plugin](https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheBlueGreenPlugin.md), which adds support for blue/green deployments ([PR #911](https://github.com/aws/aws-advanced-python-wrapper/pull/911)).
+* Limitless Plugin, which adds support for limitless deployments ([PR #912](https://github.com/aws/aws-advanced-python-wrapper/pull/912)).
+* Add weighted random host selection strategy ([PR #907](https://github.com/aws/aws-advanced-python-wrapper/pull/907)).
+* Add expiration time for secrets cache in the Secrets Manager Plugin ([PR #906](https://github.com/aws/aws-advanced-python-wrapper/pull/906)).
+* Allow custom secret keys for database credentials retrieval ([PR #843](https://github.com/aws/aws-advanced-python-wrapper/pull/843)).
+
+### :bug: Fixed
+* Separate plugin chain cache based on whether a plugin needs to be skipped or not ([PR #916](https://github.com/aws/aws-advanced-python-wrapper/pull/916)).
+* Check the cached token and exception type before retrying connection in the auth plugins ([PR #902](https://github.com/aws/aws-advanced-python-wrapper/pull/902)).
+* Set the default SSL Secure setting to True ([PR #848](https://github.com/aws/aws-advanced-python-wrapper/pull/848)).
+
+### :crab: Changed
+* Use poetry version compatible with Python 3.8 ([PR #913](https://github.com/aws/aws-advanced-python-wrapper/pull/913)).
+* Port over PluginService API changes from JDBC ([PR #901](https://github.com/aws/aws-advanced-python-wrapper/pull/901)).
+* Verify links in markdown documentation ([PR #909](https://github.com/aws/aws-advanced-python-wrapper/pull/909)).
+* Replace poetry installation with bash for GitHub actions ([PR #903](https://github.com/aws/aws-advanced-python-wrapper/pull/903)).
+* Update python requirement and environment variable information in documentation([PR #900](https://github.com/aws/aws-advanced-python-wrapper/pull/900)).
+
 ## [1.2.0] - 2024-12-12
 ### :magic_wand: Added
 * [Custom endpoint plugin](https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheCustomEndpointPlugin.md), which adds support for RDS custom endpoints.
@@ -26,6 +46,7 @@ The Amazon Web Services (AWS) Advanced Python Wrapper allows an application to t
 * Support for PostgreSQL
 * Support for MySQL
 
+[1.3.0]: https://github.com/aws/aws-advanced-python-wrapper/compare/1.2.0...1.3.0
 [1.2.0]: https://github.com/aws/aws-advanced-python-wrapper/compare/1.1.1...1.2.0
 [1.1.1]: https://github.com/aws/aws-advanced-python-wrapper/compare/1.1.0...1.1.1
 [1.1.0]: https://github.com/aws/aws-advanced-python-wrapper/compare/1.0.0...1.1.0

Maintenance.md

@@ -33,7 +33,7 @@ to releases, so you should be able to upgrade to the latest minor version of tha
 software without encountering incompatible changes (e.g., 1.1.0 → 1.3.x).
 
 Sometimes an incompatible change is unavoidable. When this happens, the software’s maintainers will increment
-the major version number (e.g., increment from `aws-advanced-python-wrapper` 1.2.0 to `aws-advanced-python-wrapper` 2.0.0).
+the major version number (e.g., increment from `aws-advanced-python-wrapper` 1.3.0 to `aws-advanced-python-wrapper` 2.0.0).
 The last minor version of the previous major version of the software will then enter a maintenance window
 (e.g., 1.3.x). During the maintenance window, the software will continue to receive bug fixes and security patches,
 but no new features.
@@ -57,4 +57,4 @@ from the updated source after the PRs are merged.
 
 | Major Version | Latest Minor Version | Status  | Initial Release | Maintenance Window Start | Maintenance Window End |
 |---------------|----------------------|---------|-----------------|--------------------------|------------------------|
-| 1             | 1.2.0                | Current | May 16, 2024    | May 16, 2024             | N/A                    | 
+| 1             | 1.3.0                | Current | May 16, 2024    | May 16, 2024             | N/A                    | 

README.md

@@ -146,35 +146,23 @@ To find all the documentation and concrete examples on how to use the AWS Advanc
 
 #### Amazon RDS Blue/Green Deployments
 
-Although the AWS Advanced Python Wrapper is not compatible with [AWS Blue/Green Deployments](https://docs.aws.amazon.com/whitepapers/latest/overview-deployment-options/bluegreen-deployments.html) and does not officially support them, the combination of the AWS Advanced Python Wrapper and the Failover Plugin has been validated for use with clusters that employ Blue/Green Deployments. While general basic connectivity to both Blue and Green clusters is always in place, some failover cases are not fully supported.
-The current limitations are:
-- After a Blue/Green switchover, the wrapper may not be able to properly detect the new topology and handle failover, as there are discrepancies between the metadata and the available endpoints.
-- The specific database version requirements for different database deployments may vary, as the internal systems used by the wrapper can differ.
+The AWS Advanced Python Wrapper **versions 1.3.0 and above** now include enhanced full support for Blue/Green Deployments. This support requires a minimum database version that includes a specific metadata table. This constraint **does not** apply to RDS MySQL.
 
-The development team is aware of these limitations and is working to improve the wrapper's awareness and handling of Blue/Green switchovers.
+**No action is required** if your database does not include the new metadata table -- the driver will continue to operate as before with no special blue/green functionality. If you have questions or encounter issues, please open an issue in this repository.
 
-> [!WARNING]\
-> The AWS Advanced Python Wrapper now includes support for Blue/Green Deployments according to the description below:
->
-> Currently Supported Database Deployments:
-> - Aurora MySQL and PostgreSQL clusters
-> - RDS MySQL and PostgreSQL instances
->
-> Unsupported Database Deployments and Configurations:
-> - RDS MySQL and PostgreSQL Multi-AZ clusters
-> - Aurora Global Database for MySQL and PostgreSQL
-> 
-> Supported RDS PostgreSQL Versions: `rds_tools v1.7 (17.1, 16.5, 15.9, 14.14, 13.17, 12.21)`.<br>
-> Supported Aurora PostgreSQL Versions: Engine Release `17.5, 16.9, 15.13, 14.18, 13.21`.<br>
-> Supported Aurora MySQL Versions: Engine Release `3.07` and above.
-> 
-> For RDS Postgres, you will also need to manually install the `rds_tools` extension using the following DDL so that the metadata required by the driver is available:
->
-> ```sql
-> CREATE EXTENSION rds_tools;
-> ```
->
-> If your database version does **not** match the supported versions listed above, the driver will automatically fallback to its previous behaviour. In this fallback mode, Blue/Green handling is subject to the same limitations listed above. If you have questions or encounter issues, please open an issue in this repository.
+Supported RDS PostgreSQL Versions: `rds_tools v1.7 (17.1, 16.5, 15.9, 14.14, 13.17, 12.21)` and above.<br>
+Supported Aurora PostgreSQL Versions: Engine Release `17.5, 16.9, 15.13, 14.18, 13.21` and above.<br>
+Supported Aurora MySQL Versions: Engine Release `3.07` and above.
+
+If your database version does **not** support this table, the driver will automatically detect its absence and fallback to its previous behaviour in wrapper versions <1.3.0. In this fallback mode, Blue/Green handling is subject to the same limitations listed below.
+
+AWS Advanced Python Wrapper **versions earlier than 1.3.0** are not compatible with [AWS Blue/Green Deployments](https://docs.aws.amazon.com/whitepapers/latest/overview-deployment-options/bluegreen-deployments.html) and do not officially support them. However, the combination of the AWS Advanced Python Wrapper and the Failover Plugin has been validated for use with clusters that employ Blue/Green Deployments for these versions. While general basic connectivity to both Blue and Green clusters is always in place, some failover cases are not fully supported.
+
+The limitations for versions earlier than 1.3.0 are:
+- After a Blue/Green switchover, the wrapper may not be able to properly detect the new topology and handle failover, as there are discrepancies between the metadata and the available endpoints.
+- The specific version requirements for Aurora MySQL versus Aurora PostgreSQL may vary, as the internal systems used by the wrapper can differ[^1].
+
+[^1]: Aurora MySQL requires v3.07 or later.
 
 #### MySQL Connector/Python C Extension
 

aws_advanced_python_wrapper/driver_info.py

@@ -15,4 +15,4 @@
 
 class DriverInfo:
     DRIVER_NAME = "aws_advanced_python_wrapper"
-    DRIVER_VERSION = "1.2.0"
+    DRIVER_VERSION = "1.3.0"

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "aws_advanced_python_wrapper"
-version = "1.2.0"
+version = "1.3.0"
 description = "Amazon Web Services (AWS) Advanced Python Wrapper"
 authors = ["Amazon Web Services"]
 readme = "README.md"