cloud-sql-python-connector 1.18.4__py3-none-any.whl → 1.19.0__py3-none-any.whl

{cloud_sql_python_connector-1.18.4.dist-info → cloud_sql_python_connector-1.19.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloud-sql-python-connector
-Version: 1.18.4
+Version: 1.19.0
 Summary: Google Cloud SQL Python Connector library
 Author-email: Google LLC <googleapis-packages@google.com>
 License-Expression: Apache-2.0
@@ -387,14 +387,27 @@ conn = connector.connect(
 )
 ```
 
-### Using DNS domain names to identify instances
+### Using Advanced Disaster Recovery and DNS domain names to identify instances
 
-The connector can be configured to use DNS to look up an instance. This would
-allow you to configure your application to connect to a database instance, and
-centrally configure which instance in your DNS zone.
+The connector can be configured to use DNS to look up an instance. 
+Use a DNS name managed by Cloud SQL [Advanced Disaster Recovery](https://docs.cloud.google.com/sql/docs/mysql/use-advanced-disaster-recovery), 
+or a domain name that you manage.
+
+#### Using Advanced Recovery Write Endpoint DNS Name
+
+[Advanced Disaster Recovery](https://docs.cloud.google.com/sql/docs/mysql/use-advanced-disaster-recovery)
+creates geographically distributed replicas of your Cloud SQL database instance. When you perform 
+switchover or failover on the database instance, the connector will gracefully disconnect from the
+old primary instance and reconnect to the new primary instance. 
+
+Follow the instructions in [Connect using Write Endpoint](https://docs.cloud.google.com/sql/docs/mysql/connect-to-instance-using-write-endpoint)
+to get the write endpoint DNS name for your primary instance. Then, use this write endpoint DNS
+name to configure the connector.
 
 #### Configure your DNS Records
 
+The connector may be configured to use DNS that you define as well.
+
 Add a DNS TXT record for the Cloud SQL instance to a **private** DNS server
 or a private Google Cloud DNS Zone used by your application.
 
@@ -605,7 +618,7 @@ from google.cloud.sql.connector import Connector, create_async_connector
 
 async def main():
     # initialize Connector object for connections to Cloud SQL
-    connector = create_async_connector()
+    connector = await create_async_connector()
 
     # creation function to generate asyncpg connections as the 'connect' arg
     async def getconn(instance_connection_name, **kwargs) -> asyncpg.Connection:

{cloud_sql_python_connector-1.18.4.dist-info → cloud_sql_python_connector-1.19.0.dist-info}/RECORD

@@ -1,10 +1,10 @@
-cloud_sql_python_connector-1.18.4.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+cloud_sql_python_connector-1.19.0.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
 google/cloud/sql/connector/__init__.py,sha256=w6w35V-m2QlpcL-ShKd2BvNF-xXOwJ2FoidE7npPE7c,1148
 google/cloud/sql/connector/asyncpg.py,sha256=v4ohOnSYjHTOvJPhTE761xP1KKo4FUJQW_WAnNW_2g4,1918
-google/cloud/sql/connector/client.py,sha256=QhxoCLn1KFKpBsLKU46GPvWI7GYuSo0oPXm_QGI-7fI,13076
+google/cloud/sql/connector/client.py,sha256=uVOMnRe1AxiSh6BnK4-SuSYrRID_jnm7SgMMN6s5jp4,13076
 google/cloud/sql/connector/connection_info.py,sha256=BSuW-ovtEUYTIvDzQkaE3GofCs3Xoi0TtztFaAq4Kvo,4868
 google/cloud/sql/connector/connection_name.py,sha256=bI4M3Qa2mtBHyD08oF41FF5W9FBOXWu4dGGg50Na_A4,2606
-google/cloud/sql/connector/connector.py,sha256=H2vDRZ-N8mz8oO_OnKCY-LODbsAnzaxEMGPl4zv10sc,24182
+google/cloud/sql/connector/connector.py,sha256=MJFRKBhwpWtwUo7EvwFggu2X5s2d5CgQdm8ZFZtnYV4,24720
 google/cloud/sql/connector/enums.py,sha256=dVBS9eEWNrHtzze0AJlmtbdUogG3EocNWOQcI_8qPd0,2937
 google/cloud/sql/connector/exceptions.py,sha256=QdQBzZ3t1RE5V744wW4sGaucWD2cEedB-dWNCkh8SAA,1974
 google/cloud/sql/connector/instance.py,sha256=jDEQf-OXFzqKO9a4bnzRQ0qUyO3_xKuiEIRWc_7wpyE,8694
@@ -15,11 +15,11 @@ google/cloud/sql/connector/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG
 google/cloud/sql/connector/pymysql.py,sha256=PrTQ1lB5EWAcN4BPX_5hb-WerncS4X76bBk4y0es0ks,1948
 google/cloud/sql/connector/pytds.py,sha256=KZxmJQQG9XfmsmUoEGX7RpMirWdoreJ2-_FuHO6Td-s,2280
 google/cloud/sql/connector/rate_limiter.py,sha256=zqZ9pVXHan4LWoGT8Bq6U3HpZcrdzKhlXVYwsX3ftA0,2928
-google/cloud/sql/connector/refresh_utils.py,sha256=fVyydw984S1UBHv3qY9ZbCZCagA-Wd25RLA5eKxMCLk,5152
+google/cloud/sql/connector/refresh_utils.py,sha256=jaYLHrKlJtqeZBM8gOrZtI-6mbh6-1PTi8o0aFGH5Yo,5151
 google/cloud/sql/connector/resolver.py,sha256=DUU7swlBjMJjlDqa_M4XtIctPiJBnz-OusFUk5GLc1Y,3290
 google/cloud/sql/connector/utils.py,sha256=AA_oBBxRuULb7-hHHK8HQJU5fttzBpzdIZwMNZ5kNCM,3473
-google/cloud/sql/connector/version.py,sha256=WMF0exkNMzlSFf4OUkUILFLiPsGLztn38GPenxqW684,598
-cloud_sql_python_connector-1.18.4.dist-info/METADATA,sha256=nuR7T_uxKLpVmugsXimXnBFbEJOmyisJSqbP_10Ngys,30340
-cloud_sql_python_connector-1.18.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cloud_sql_python_connector-1.18.4.dist-info/top_level.txt,sha256=_1QvSJIhFAGfxb79D6DhB7SUw2X6T4rwnz_LLrbcD3c,7
-cloud_sql_python_connector-1.18.4.dist-info/RECORD,,
+google/cloud/sql/connector/version.py,sha256=ubPc22if5qmly3cyzukeCbOaz4RIPktbPgIRVJToDUs,598
+cloud_sql_python_connector-1.19.0.dist-info/METADATA,sha256=mvSoakX7k3zRYjqEB1z9H7wIYbAuBi9iMHwiYEi3XhE,31181
+cloud_sql_python_connector-1.19.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cloud_sql_python_connector-1.19.0.dist-info/top_level.txt,sha256=_1QvSJIhFAGfxb79D6DhB7SUw2X6T4rwnz_LLrbcD3c,7
+cloud_sql_python_connector-1.19.0.dist-info/RECORD,,

google/cloud/sql/connector/client.py

@@ -22,9 +22,9 @@ from typing import Any, Optional, TYPE_CHECKING
 import aiohttp
 from cryptography.hazmat.backends import default_backend
 from cryptography.x509 import load_pem_x509_certificate
-
 from google.auth.credentials import TokenState
 from google.auth.transport import requests
+
 from google.cloud.sql.connector.connection_info import ConnectionInfo
 from google.cloud.sql.connector.connection_name import ConnectionName
 from google.cloud.sql.connector.exceptions import AutoIAMAuthNotSupported

google/cloud/sql/connector/connector.py

@@ -28,11 +28,13 @@ from typing import Any, Callable, Optional, Union
 import google.auth
 from google.auth.credentials import Credentials
 from google.auth.credentials import with_scopes_if_required
+
 import google.cloud.sql.connector.asyncpg as asyncpg
 from google.cloud.sql.connector.client import CloudSQLClient
 from google.cloud.sql.connector.enums import DriverMapping
 from google.cloud.sql.connector.enums import IPTypes
 from google.cloud.sql.connector.enums import RefreshStrategy
+from google.cloud.sql.connector.exceptions import ConnectorLoopError
 from google.cloud.sql.connector.instance import RefreshAheadCache
 from google.cloud.sql.connector.lazy import LazyRefreshCache
 from google.cloud.sql.connector.monitored_cache import MonitoredCache
@@ -280,6 +282,15 @@ class Connector:
             KeyError: Unsupported database driver Must be one of pymysql, asyncpg,
                 pg8000, and pytds.
         """
+        # check if event loop is running in current thread
+        if self._loop != asyncio.get_running_loop():
+            raise ConnectorLoopError(
+                "Running event loop does not match 'connector._loop'. "
+                "Connector.connect_async() must be called from the event loop "
+                "the Connector was initialized with. If you need to connect "
+                "across event loops, please use a new Connector object."
+            )
+
         if self._keys is None:
             self._keys = asyncio.create_task(generate_keys())
         if self._client is None:

google/cloud/sql/connector/refresh_utils.py

@@ -24,7 +24,6 @@ import random
 from typing import Any, Callable
 
 import aiohttp
-
 from google.auth.credentials import Credentials
 from google.auth.credentials import Scoped
 import google.auth.transport.requests

google/cloud/sql/connector/version.py

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-__version__ = "1.18.4"
+__version__ = "1.19.0"