---
id: aws-advanced-python-wrapper
version: "3.0.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-advanced-python-wrapper — Amazon Web Services (AWS) Advanced Python Wrapper

License: permissive · Maintenance: active · Downloads: 85.1K/mo

## 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 above — verify before relying.

Wraps Python database drivers to add Aurora failover support, topology caching, and enhanced failure monitoring without changing existing application code.

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

pip install aws-advanced-python-wrapper
uv add aws-advanced-python-wrapper
poetry add aws-advanced-python-wrapper

## Installing aws-advanced-python-wrapper

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.

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())

Requires an underlying database driver and Python 3.10 or later (supports 3.10, 3.11, 3.12, 3.13).

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_current
- Install friction: low
- Maintenance: active
- Downloads: 85.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aurora database failover python, rds connection wrapper, database failover handling, aurora cluster topology caching, python database driver wrapper, enhanced database failure detection, aws rds python driver, aws-rds, failover-handling, database-wrapper

[View on SkillFed](https://skillfed.io/packages/aws-advanced-python-wrapper) · [View on PyPI](https://pypi.org/project/aws-advanced-python-wrapper/)