aws-advanced-python-wrapper
Amazon Web Services (AWS) Advanced Python Wrapper
Decision gist · record as of 2026-08-14
Yes, if you run Aurora or RDS clusters and want faster failover with minimal code changes. The wrapper is production-stable, actively maintained, has low install friction, and carries a permissive Apache-2.0 license. Install it when failover latency or connection reliability is a concern; skip it if you use managed connection pooling that already handles failover or if you run single-instance RDS databases.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires an underlying database driver and Python 3.10 or later (supports 3.10, 3.11, 3.12, 3.13).
- Low install friction with a pure-Python wheel.
- Active maintenance with recent commits and production-stable status.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.
last release 2026-06-03 (72 days) · last repo commit 2026-08-14 · 95 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 85,121 downloads/mo, #13,948 on PyPI
Alternatives
Verify before relying
from aws_advanced_python_wrapper import AwsWrapperConnection
with AwsWrapperConnection.connect(
driver_connect_func,
"host=database.cluster-xyz.us-east-1.rds.amazonaws.com dbname=db user=john password=pwd",
plugins="failover",
wrapper_dialect="aurora-pg",
autocommit=True
) as awsconn:
cursor = awsconn.cursor()
cursor.execute("SELECT 1")
print(cursor.fetchone())- Whether the wrapper's topology caching and failover detection work reliably with non-Aurora RDS instances.
- Performance overhead of the wrapper layer and topology refresh operations under high-throughput workloads.
- Compatibility with database drivers other than those mentioned in documentation.
What it is and what it does
The AWS Advanced Python Wrapper is a middleware layer that sits between your Python application and database drivers, adding Aurora-specific failover and availability features. It maintains a cached view of your Aurora cluster topology and each instance's role, allowing it to detect and respond to primary instance failures faster than DNS resolution alone would permit. The wrapper also provides enhanced failure monitoring that can periodically check database host health and route connections away from unhealthy instances.
You use it by passing your existing driver's connect function to the wrapper's AwsWrapperConnection.connect() method, then interact with the returned connection object as you normally would. The wrapper handles failover coordination transparently—when a primary fails, it uses its topology cache to quickly identify and connect to the new primary replica, minimizing downtime. It works with both Aurora and plain RDS databases, though Aurora deployments benefit most from its features.
Use it for
- Reduce failover latency in Aurora clusters by bypassing DNS resolution delays during primary instance failures.
- Add automatic connection rerouting to healthy cluster members without rewriting existing database code.
- Monitor database host health proactively and abort connections to unhealthy instances before queries fail.
- Maintain consistent database availability in multi-tier applications using Aurora with minimal code changes.
- Implement topology-aware connection handling for RDS clusters without custom failover logic.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you run Aurora or RDS clusters and want faster failover with minimal code changes.
The wrapper is production-stable, actively maintained, has low install friction, and carries a permissive Apache-2.0 license. Install it when failover latency or connection reliability is a concern; skip it if you use managed connection pooling that already handles failover or if you run single-instance RDS databases.
Install
aws-advanced-python-wrapper on PyPI
Before you install
Low install friction with a pure-Python wheel. Active maintenance with recent commits and production-stable status. Requires Python 3.10 or later and nine runtime dependencies including boto3, opentelemetry-api, opentelemetry-sdk, and requests.
Requires an underlying database driver and Python 3.10 or later (supports 3.10, 3.11, 3.12, 3.13).
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.
Quickstart
from aws_advanced_python_wrapper import AwsWrapperConnection
with AwsWrapperConnection.connect(
driver_connect_func,
"host=database.cluster-xyz.us-east-1.rds.amazonaws.com dbname=db user=john password=pwd",
plugins="failover",
wrapper_dialect="aurora-pg",
autocommit=True
) as awsconn:
cursor = awsconn.cursor()
cursor.execute("SELECT 1")
print(cursor.fetchone())
Verify before relying
- Whether the wrapper's topology caching and failover detection work reliably with non-Aurora RDS instances.
- Performance overhead of the wrapper layer and topology refresh operations under high-throughput workloads.
- Compatibility with database drivers other than those mentioned in documentation.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release <4.0.0,>=3.10.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 9 packagesaws-xray-sdkboto3boto3-stubsopentelemetry-apiopentelemetry-sdkrequestsresourcebundletomltypes_aws_xray_sdk |
| Maintenance | Actively maintained 72 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 85,121 / month, #13,948 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseNatural Language :: EnglishProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13 |
Evidence: aws_advanced_python_wrapper-3.0.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “aurora database failover python”
- aws-advanced-python-wrapperWraps Python database drivers to add Aurora failover support,…
- cdk-aurora-globaldatabaseProvides AWS CDK constructs to deploy Amazon Aurora Global Databases…
- aurora-data-apiA DB-API 2.0 compatible client for AWS Aurora Serverless that tunnels…
Give your agent the search over MCP, or paste the wish link into any chat.
More Database packages
psycopg2-binary is a PostgreSQL database adapter for Python that implements the DB API 2.0 specification, enabling Python applications to connect to and query PostgreSQL databases with thread-safe concurrent operations.
Python client library for connecting to and executing commands against Redis key-value stores, supporting both synchronous and asynchronous operations.
Install it if your application needs to interact with Redis; the only prerequisite is a running Redis server instance.
YDB Python SDK is the official client library for connecting to and querying YDB databases from Python applications.
Install it if you need to connect Python applications to YDB databases.
Connects Python applications to Snowflake data warehouses using the DB API 2.0 specification, enabling SQL queries, data transfers, and warehouse operations.
sqlparse tokenizes SQL text into a tree of statements, clauses, and expressions, and provides functions to split scripts, format queries, and inspect parsed tokens without validating dialect or syntax.
Install it if you need to manipulate, format, or analyze SQL text programmatically.
Provides base adapter protocols and shared functionality that database adapters use to integrate with dbt-core, handling connections, dialect translation, relation caching, and core interface management.
See also aurora-data-api · sqlalchemy-aurora-data-api · cdk-aurora-globaldatabase · eniris · sqlalchemy-rdsiam · pyathenajdbc · cassandra-sigv4 · aws-cdk.aws-applicationautoscaling · mysql-connector · clickhouse-driver