Skip to content

Commit 91e2f8c

Browse files
committed
fix: use aws in links
1 parent f7ba266 commit 91e2f8c

File tree

9 files changed

+111
-63
lines changed

9 files changed

+111
-63
lines changed

Maintenance.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
# Release Schedule
22

3-
| Release Date | Release |
4-
|-------------------|--------------------------------------------------------------------------------------------|
5-
| May 16, 2024 | [Release 1.0.0](https://github.com/awslabs/aws-advanced-python-wrapper/releases/tag/1.0.0) |
6-
| July 31, 2024 | [Release 1.1.0](https://github.com/awslabs/aws-advanced-python-wrapper/releases/tag/1.1.0) |
7-
| October 18, 2024 | [Release 1.1.1](https://github.com/awslabs/aws-advanced-python-wrapper/releases/tag/1.1.1) |
8-
| December 12, 2024 | [Release 1.2.0](https://github.com/awslabs/aws-advanced-python-wrapper/releases/tag/1.2.0) |
9-
| July 28, 2025 | [Release 1.3.0](https://github.com/awslabs/aws-advanced-python-wrapper/releases/tag/1.3.0) |
10-
| October 17, 2025 | [Release 1.4.0](https://github.com/awslabs/aws-advanced-python-wrapper/releases/tag/1.4.0) |
3+
| Release Date | Release |
4+
|-------------------|----------------------------------------------------------------------------------------|
5+
| May 16, 2024 | [Release 1.0.0](https://github.com/aws/aws-advanced-python-wrapper/releases/tag/1.0.0) |
6+
| July 31, 2024 | [Release 1.1.0](https://github.com/aws/aws-advanced-python-wrapper/releases/tag/1.1.0) |
7+
| October 18, 2024 | [Release 1.1.1](https://github.com/aws/aws-advanced-python-wrapper/releases/tag/1.1.1) |
8+
| December 12, 2024 | [Release 1.2.0](https://github.com/aws/aws-advanced-python-wrapper/releases/tag/1.2.0) |
9+
| July 28, 2025 | [Release 1.3.0](https://github.com/aws/aws-advanced-python-wrapper/releases/tag/1.3.0) |
10+
| October 17, 2025 | [Release 1.4.0](https://github.com/aws/aws-advanced-python-wrapper/releases/tag/1.4.0) |
1111

1212
`aws-advanced-python-wrapper` [follows semver](https://semver.org/#semantic-versioning-200) which means we will only
1313
release breaking changes in major versions. Generally speaking patches will be released to fix existing problems without

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Enhanced Failure Monitoring (EFM) is a feature available from the [Host Monitori
3030

3131
The AWS Advanced Python Driver also works with RDS provided databases that are not Aurora.
3232

33-
Please visit [this page](./docs/using-the-python-driver/UsingThePythonDriver.md#using-the-aws-python-driver-with-plain-rds-databases) for more information.
33+
Please visit [this page](./docs/using-the-python-driver/UsingThePythonDriver.md#using-the-aws-advanced-python-driver-with-plain-rds-databases) for more information.
3434

3535
## Getting Started
3636

@@ -195,11 +195,11 @@ Psycopg and MySQL Connector/Python do not provide client-side query timeouts. Wh
195195
## Getting Help and Opening Issues
196196

197197
If you encounter a bug with the AWS Advanced Python Driver, we would like to hear about it.
198-
Please search the [existing issues](https://github.com/awslabs/aws-advanced-python-wrapper/issues) to see if others are also experiencing the issue before reporting the problem in a new issue. GitHub issues are intended for bug reports and feature requests.
198+
Please search the [existing issues](https://github.com/aws/aws-advanced-python-wrapper/issues) to see if others are also experiencing the issue before reporting the problem in a new issue. GitHub issues are intended for bug reports and feature requests.
199199

200200
When opening a new issue, please fill in all required fields in the issue template to help expedite the investigation process.
201201

202-
For all other questions, please use [GitHub discussions](https://github.com/awslabs/aws-advanced-python-wrapper/discussions).
202+
For all other questions, please use [GitHub discussions](https://github.com/aws/aws-advanced-python-wrapper/discussions).
203203

204204
## How to Contribute
205205

benchmarks/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ The benchmarks do not measure the performance of target Python drivers nor the p
1111

1212
## Benchmark Results
1313

14-
Tests ran on commit [3d473f6c12f495762d3b7436a97a0e6bd76361d7](https://github.com/awslabs/aws-advanced-python-wrapper/commit/3d473f6c12f495762d3b7436a97a0e6bd76361d7)
14+
Tests ran on commit [3d473f6c12f495762d3b7436a97a0e6bd76361d7](https://github.com/aws/aws-advanced-python-wrapper/commit/3d473f6c12f495762d3b7436a97a0e6bd76361d7)
1515

1616
## Summary
1717
| Benchmark | Overhead |

docs/development-guide/DevelopmentGuide.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Make sure you have Python 3.8 - 3.11 (inclusive) installed, along with your choi
66
Clone the AWS Advanced Python Driver repository:
77

88
```bash
9-
git clone https://github.com/awslabs/aws-advanced-python-wrapper.git
9+
git clone https://github.com/aws/aws-advanced-python-wrapper.git
1010
```
1111

1212
You can now make changes in the repository.

docs/examples/MySQLFailover.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ def execute_queries_with_failover_handling(conn: Connection, sql: str, params: O
4040

4141
except FailoverSuccessError:
4242
# Query execution failed and AWS Advanced Python Driver successfully failed over to an available instance.
43-
# https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#FailoverFailedError---successful-failover
43+
# https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#failoversuccesserror
4444

4545
# The old cursor is no longer reusable and the application needs to reconfigure sessions states.
4646
configure_initial_session_states(conn)
@@ -51,12 +51,12 @@ def execute_queries_with_failover_handling(conn: Connection, sql: str, params: O
5151

5252
except FailoverFailedError as e:
5353
# User application should open a new connection, check the results of the failed transaction and re-run it if needed. See:
54-
# https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#FailoverFailedError---unable-to-establish-sql-connection
54+
# https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#failoverfailederror
5555
raise e
5656

5757
except TransactionResolutionUnknownError as e:
5858
# User application should check the status of the failed transaction and restart it if needed. See:
59-
# https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#TransactionResolutionUnknownError---transaction-resolution-unknown
59+
# https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#transactionresolutionunknownerror
6060
raise e
6161

6262

docs/examples/MySQLReadWriteSplitting.py

Lines changed: 22 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ def execute_queries_with_failover_handling(conn: Connection, sql: str, params: O
5858

5959
except FailoverSuccessError:
6060
# Query execution failed and AWS Advanced Python Driver successfully failed over to an available instance.
61-
# https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#FailoverFailedError---successful-failover
61+
# https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#failoversuccesserror
6262

6363
# The old cursor is no longer reusable and the application needs to reconfigure sessions states.
6464
configure_initial_session_states(conn)
@@ -69,12 +69,12 @@ def execute_queries_with_failover_handling(conn: Connection, sql: str, params: O
6969

7070
except FailoverFailedError as e:
7171
# User application should open a new connection, check the results of the failed transaction and re-run it if needed. See:
72-
# https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#FailoverFailedError---unable-to-establish-sql-connection
72+
# https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#failoverfailederror
7373
raise e
7474

7575
except TransactionResolutionUnknownError as e:
7676
# User application should check the status of the failed transaction and restart it if needed. See:
77-
# https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#TransactionResolutionUnknownError---transaction-resolution-unknown
77+
# https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#transactionresolutionunknownerror
7878
raise e
7979

8080

@@ -86,7 +86,7 @@ def execute_queries_with_failover_handling(conn: Connection, sql: str, params: O
8686
"password": "pwd",
8787
"plugins": "read_write_splitting,failover",
8888
"wrapper_dialect": "aurora-mysql",
89-
"autocommit": True
89+
"autocommit": True,
9090
}
9191

9292
"""
@@ -101,26 +101,38 @@ def execute_queries_with_failover_handling(conn: Connection, sql: str, params: O
101101
with AwsWrapperConnection.connect(mysql.connector.Connect, **params) as conn:
102102
configure_initial_session_states(conn)
103103
execute_queries_with_failover_handling(
104-
conn, "CREATE TABLE IF NOT EXISTS bank_test (id int primary key, name varchar(40), account_balance int)")
104+
conn,
105+
"CREATE TABLE IF NOT EXISTS bank_test (id int primary key, name varchar(40), account_balance int)",
106+
)
105107
execute_queries_with_failover_handling(
106-
conn, "INSERT INTO bank_test VALUES (%s, %s, %s)", (0, "Jane Doe", 200))
108+
conn, "INSERT INTO bank_test VALUES (%s, %s, %s)", (0, "Jane Doe", 200)
109+
)
107110
execute_queries_with_failover_handling(
108-
conn, "INSERT INTO bank_test VALUES (%s, %s, %s)", (1, "John Smith", 200))
111+
conn, "INSERT INTO bank_test VALUES (%s, %s, %s)", (1, "John Smith", 200)
112+
)
109113

110114
""" Example step: open connection and perform transaction """
111115
try:
112116
with AwsWrapperConnection.connect(mysql.connector.Connect, **params) as conn, conn.cursor() as cursor:
113117
configure_initial_session_states(conn)
114118

115119
execute_queries_with_failover_handling(
116-
conn, "UPDATE bank_test SET account_balance=account_balance - 100 WHERE name=%s", ("Jane Doe",))
120+
conn,
121+
"UPDATE bank_test SET account_balance=account_balance - 100 WHERE name=%s",
122+
("Jane Doe",),
123+
)
117124
execute_queries_with_failover_handling(
118-
conn, "UPDATE bank_test SET account_balance=account_balance + 100 WHERE name=%s", ("John Smith",))
125+
conn,
126+
"UPDATE bank_test SET account_balance=account_balance + 100 WHERE name=%s",
127+
("John Smith",),
128+
)
119129

120130
# Internally switch to a reader connection
121131
conn.read_only = True
122132
for i in range(2):
123-
cursor = execute_queries_with_failover_handling(conn, "SELECT * FROM bank_test WHERE id = %s", (i,))
133+
cursor = execute_queries_with_failover_handling(
134+
conn, "SELECT * FROM bank_test WHERE id = %s", (i,)
135+
)
124136
for record in cursor:
125137
print(record)
126138

docs/examples/MySQLSimpleReadWriteSplitting.py

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ def execute_queries_with_failover_handling(conn: Connection, sql: str, params: O
3939

4040
except FailoverSuccessError:
4141
# Query execution failed and AWS Advanced Python Driver successfully failed over to an available instance.
42-
# https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#FailoverFailedError---successful-failover
42+
# https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#failoversuccesserror
4343

4444
# The old cursor is no longer reusable and the application needs to reconfigure sessions states.
4545
configure_initial_session_states(conn)
@@ -50,53 +50,65 @@ def execute_queries_with_failover_handling(conn: Connection, sql: str, params: O
5050

5151
except FailoverFailedError as e:
5252
# User application should open a new connection, check the results of the failed transaction and re-run it if needed. See:
53-
# https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#FailoverFailedError---unable-to-establish-sql-connection
53+
# https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#failoverfailederror
5454
raise e
5555

5656
except TransactionResolutionUnknownError as e:
5757
# User application should check the status of the failed transaction and restart it if needed. See:
58-
# https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#TransactionResolutionUnknownError---transaction-resolution-unknown
58+
# https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md#transactionresolutionunknownerror
5959
raise e
6060

6161

6262
if __name__ == "__main__":
6363
params = {
64-
"host": "database.cluster-xyz.us-east-1.rds.amazonaws.com",
64+
"host": "rds-proxy-name.proxy-xyz.us-east-1.rds.amazonaws.com",
6565
"database": "mysql",
6666
"user": "admin",
6767
"password": "pwd",
6868
"plugins": "srw,failover",
69-
"srw_write_endpoint": "database.cluster-xyz.us-east-1.rds.amazonaws.com", # Replace with write endpoint
70-
"srw_read_endpoint": "database.cluster-ro-xyz.us-east-1.rds.amazonaws.com", # Replace with read endpoint
69+
"srw_write_endpoint": "rds-proxy-name.proxy-xyz.us-east-1.rds.amazonaws.com", # Replace with write endpoint
70+
"srw_read_endpoint": "rds-proxy-name-read-only.endpoint.proxy-xyz.us-east-1.rds.amazonaws.com", # Replace with read endpoint
7171
"srw_verify_new_connections": "True", # Enables role-verification for new endpoints
7272
"wrapper_dialect": "aurora-mysql",
73-
"autocommit": True
73+
"autocommit": True,
7474
}
7575

7676
""" Setup step: open connection and create tables """
7777
with AwsWrapperConnection.connect(mysql.connector.Connect, **params) as conn:
7878
configure_initial_session_states(conn)
7979
execute_queries_with_failover_handling(
80-
conn, "CREATE TABLE IF NOT EXISTS bank_test (id int primary key, name varchar(40), account_balance int)")
80+
conn,
81+
"CREATE TABLE IF NOT EXISTS bank_test (id int primary key, name varchar(40), account_balance int)",
82+
)
8183
execute_queries_with_failover_handling(
82-
conn, "INSERT INTO bank_test VALUES (%s, %s, %s)", (0, "Jane Doe", 200))
84+
conn, "INSERT INTO bank_test VALUES (%s, %s, %s)", (0, "Jane Doe", 200)
85+
)
8386
execute_queries_with_failover_handling(
84-
conn, "INSERT INTO bank_test VALUES (%s, %s, %s)", (1, "John Smith", 200))
87+
conn, "INSERT INTO bank_test VALUES (%s, %s, %s)", (1, "John Smith", 200)
88+
)
8589

8690
""" Example step: open connection and perform transaction """
8791
try:
8892
with AwsWrapperConnection.connect(mysql.connector.Connect, **params) as conn, conn.cursor() as cursor:
8993
configure_initial_session_states(conn)
9094

9195
execute_queries_with_failover_handling(
92-
conn, "UPDATE bank_test SET account_balance=account_balance - 100 WHERE name=%s", ("Jane Doe",))
96+
conn,
97+
"UPDATE bank_test SET account_balance=account_balance - 100 WHERE name=%s",
98+
("Jane Doe",),
99+
)
93100
execute_queries_with_failover_handling(
94-
conn, "UPDATE bank_test SET account_balance=account_balance + 100 WHERE name=%s", ("John Smith",))
101+
conn,
102+
"UPDATE bank_test SET account_balance=account_balance + 100 WHERE name=%s",
103+
("John Smith",),
104+
)
95105

96106
# Internally switch to a reader connection
97107
conn.read_only = True
98108
for i in range(2):
99-
cursor = execute_queries_with_failover_handling(conn, "SELECT * FROM bank_test WHERE id = %s", (i,))
109+
cursor = execute_queries_with_failover_handling(
110+
conn, "SELECT * FROM bank_test WHERE id = %s", (i,)
111+
)
100112
for record in cursor:
101113
print(record)
102114

0 commit comments

Comments
 (0)