Skip to content

Commit a36b204

Browse files
authored
chore: bump version to 1.0.0 (#551)
1 parent ce4829a commit a36b204

File tree

6 files changed

+34
-21
lines changed

6 files changed

+34
-21
lines changed

CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
## [1.0.0] - 2024-05-16
1+
## [1.0.0] - 2024-05-23
22
The Amazon Web Services (AWS) Advanced Python Wrapper allows an application to take advantage of the features of clustered Aurora databases.
33

44
### :magic_wand: Added

README.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Amazon Web Services (AWS) Advanced Python Driver
22

3-
[![Build Status](https://github.com/awslabs/aws-advanced-python-wrapper/actions/workflows/main.yml/badge.svg?branch=main)](https://github.com/awslabs/aws-advanced-python-wrapper/actions/workflows/main.yml)
4-
[![Integration Tests](https://github.com/awslabs/aws-advanced-python-wrapper/actions/workflows/integration_tests.yml/badge.svg?branch=main)](https://github.com/awslabs/aws-advanced-python-wrapper/actions/workflows/integration_tests.yml)
3+
[![Python Check and Unit Test](https://github.com/aws/aws-advanced-python-wrapper/actions/workflows/main.yml/badge.svg?branch=main)](https://github.com/aws/aws-advanced-python-wrapper/actions/workflows/main.yml)
4+
[![Integration Tests](https://github.com/aws/aws-advanced-python-wrapper/actions/workflows/integration_tests.yml/badge.svg)](https://github.com/aws/aws-advanced-python-wrapper/actions/workflows/integration_tests.yml)
55
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
66

77
## About the Driver
@@ -158,8 +158,15 @@ In the event of a network failure where the host can no longer be reached, the `
158158

159159
The official MySQL Connector/Python [offers a Python implementation and a C implementation](https://dev.mysql.com/doc/connector-python/en/connector-python-example-connecting.html#:~:text=Using%20the%20Connector/Python%20Python%20or%20C%20Extension) of the driver that can be toggled using the `use_pure` connection argument.
160160
The [IAM Authentication Plugin](./docs/using-the-python-driver/using-plugins/UsingTheIamAuthenticationPlugin.md) is incompatible with the Python implementation of the driver due to its 255-character password limit.
161-
The IAM Authentication Plugin generates a temporary AWS IAM token to authenticate users. Passing this token to the Python implementation of the driver will result in the following error:
162-
`struct.error: ubyte format requires 0 <= number <= 255`. To avoid this error, we recommend you set `use_pure` to `False` when using the IAM Authentication Plugin.
161+
The IAM Authentication Plugin generates a temporary AWS IAM token to authenticate users. Passing this token to the Python implementation of the driver will result in error messages similar to the following:
162+
```
163+
Error occurred while opening a connection: int1store requires 0 <= i <= 255
164+
```
165+
or
166+
```
167+
struct.error: ubyte format requires 0 <= number <= 255
168+
```
169+
To avoid this error, we recommend you set `use_pure` to `False` when using the IAM Authentication Plugin.
163170
However, as noted in the [MySQL Connector/Python C Extension](#mysql-connectorpython-c-extension) section, doing so may cause the application to indefinitely hang if there is a network failure.
164171
Unfortunately, due to conflicting limitations, you will need to decide if using the IAM plugin is worth this risk for your application.
165172

docs/README.md

Lines changed: 18 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,25 @@
44
- [Using the AWS Python Driver](./using-the-python-driver/UsingThePythonDriver.md)
55
- [Logging](./using-the-python-driver/UsingThePythonDriver.md#logging)
66
- [Python Wrapper Parameters](./using-the-python-driver/UsingThePythonDriver.md#aws-advanced-python-driver-parameters)
7+
- [Support For RDS Multi-AZ Database Cluster](./using-the-python-driver/SupportForRDSMultiAzDBCluster.md)
8+
- [Session State](./using-the-python-driver/SessionState.md)
79
- [Database Dialects](./using-the-python-driver/DatabaseDialects.md)
8-
- [Target Driver Dialects](./using-the-python-driver/DriverDialects.md)
9-
- [Plugins](./using-the-python-driver/UsingThePythonDriver.md#plugins)
10-
- [Failover Plugin](./using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md)
11-
- [Failover Configuration Guide](./using-the-python-driver/FailoverConfigurationGuide.md)
12-
- [Federated Authentication Plugin](./using-the-python-driver/using-plugins/UsingTheFederatedAuthenticationPlugin.md)
13-
- [Host Monitoring Plugin](./using-the-python-driver/using-plugins/UsingTheHostMonitoringPlugin.md)
14-
- [IAM Authentication Plugin](./using-the-python-driver/using-plugins/UsingTheIamAuthenticationPlugin.md)
15-
- [AWS Secrets Manager Plugin](./using-the-python-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md)
16-
- [Aurora Connection Tracker Plugin](./using-the-python-driver/using-plugins/UsingTheAuroraConnectionTrackerPlugin.md)
17-
- [Read Write Splitting Plugin](./using-the-python-driver/using-plugins/UsingTheReadWriteSplittingPlugin.md)
18-
- [Fastest Response Strategy Plugin](./using-the-python-driver/using-plugins/UsingTheFastestResponseStrategyPlugin.md)
19-
- [Host Availability Strategy](./using-the-python-driver/HostAvailabilityStrategy.md)
10+
- [Driver Dialects](./using-the-python-driver/DriverDialects.md)
11+
- [Telemetry](./using-the-python-driver/Telemetry.md)
12+
- [Plugins](./using-the-python-driver/UsingThePythonDriver.md#plugins)
13+
- [Failover Plugin](./using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md)
14+
- [Failover Configuration Guide](./using-the-python-driver/FailoverConfigurationGuide.md)
15+
- [Host Monitoring Plugin](./using-the-python-driver/using-plugins/UsingTheHostMonitoringPlugin.md)
16+
- [Aurora Connection Tracker Plugin](./using-the-python-driver/using-plugins/UsingTheAuroraConnectionTrackerPlugin.md)
17+
- [Aurora Initial Connection Strategy Plugin](./using-the-python-driver/using-plugins/UsingTheAuroraInitialConnectionStrategyPlugin.md)
18+
- [Host Availability Strategy](./using-the-python-driver/HostAvailabilityStrategy.md)
19+
- [IAM Authentication Plugin](./using-the-python-driver/using-plugins/UsingTheIamAuthenticationPlugin.md)
20+
- [AWS Secrets Manager Plugin](./using-the-python-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md)
21+
- [Federated Authentication Plugin](./using-the-python-driver/using-plugins/UsingTheFederatedAuthenticationPlugin.md)
22+
- [Read Write Splitting Plugin](./using-the-python-driver/using-plugins/UsingTheReadWriteSplittingPlugin.md)
23+
- [Reader Selection Strategies](./using-the-python-driver/ReaderSelectionStrategies.md)
24+
- [Fastest Response Strategy Plugin](./using-the-python-driver/using-plugins/UsingTheFastestResponseStrategyPlugin.md)
25+
- [Host Availability Strategy](./using-the-python-driver/HostAvailabilityStrategy.md)
2026
- [Development Guide](./development-guide/DevelopmentGuide.md)
2127
- [Setup](./development-guide/DevelopmentGuide.md#setup)
2228
- [Testing Overview](./development-guide/DevelopmentGuide.md#testing-overview)

docs/examples/MySQLReadWriteSplitting.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,8 +40,8 @@ def get_pool_key(host_info: HostInfo, props: Dict[str, Any]) -> str:
4040
# Include the URL, user, and database in the connection pool key so that a new
4141
# connection pool will be opened for each different instance-user-database combination.
4242
url = host_info.url
43-
user = props["username"]
44-
db = props["dbname"]
43+
user = props["user"]
44+
db = props["database"]
4545
return f"{url}{user}{db}"
4646

4747

docs/examples/PGReadWriteSplitting.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ def get_pool_key(host_info: HostInfo, props: Dict[str, Any]) -> str:
4040
# Include the URL, user, and database in the connection pool key so that a new
4141
# connection pool will be opened for each different instance-user-database combination.
4242
url = host_info.url
43-
user = props["username"]
43+
user = props["user"]
4444
db = props["dbname"]
4545
return f"{url}{user}{db}"
4646

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[tool.poetry]
22
name = "aws_advanced_python_wrapper"
3-
version = "1.0.0rc2"
3+
version = "1.0.0"
44
description = "Amazon Web Services (AWS) Advanced Python Wrapper"
55
authors = ["Amazon Web Services"]
66
readme = "README.md"

0 commit comments

Comments
 (0)