chore: lead with asyncpg pool usage over SQLAlchemy

Author: jackwotherspoon

README.md

@@ -502,6 +502,40 @@ The `create_async_connector` allows all the same input arguments as the
 Once a `Connector` object is returned by `create_async_connector` you can call
 its `connect_async` method, just as you would the `connect` method:
 
+#### Asyncpg Connection Pool
+
+```python
+import asyncpg
+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()
+
+    # creation function to generate asyncpg connections as the 'connect' arg
+    async def getconn(instance_connection_name, **kwargs) -> asyncpg.Connection:
+        return await connector.connect_async(
+            instance_connection_name,
+            "asyncpg",
+            user="my-user",
+            password="my-password",
+            db="my-db",
+            **kwargs, # ... additional asyncpg args
+        )
+
+    # initialize connection pool
+    pool = await asyncpg.create_pool(
+        "my-project:my-region:my-instance", connect=getconn
+    )
+
+    # acquire connection and query Cloud SQL database
+    async with pool.acquire() as conn:
+        res = await conn.fetch("SELECT NOW()")
+    
+    # close Connector
+    await connector.close_async()
+```
+
 #### SQLAlchemy Async Engine
 
 ```python
@@ -551,40 +585,6 @@ async def main():
     await pool.dispose()
 ```
 
-#### Asyncpg Connection Pool
-
-```python
-import asyncpg
-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()
-
-    # creation function to generate asyncpg connections as the 'connect' arg
-    async def getconn(instance_connection_name, **kwargs) -> asyncpg.Connection:
-        return await connector.connect_async(
-            instance_connection_name,
-            "asyncpg",
-            user="my-user",
-            password="my-password",
-            db="my-db",
-            **kwargs, # ... additional asyncpg args
-        )
-
-    # initialize connection pool
-    pool = await asyncpg.create_pool(
-        "my-project:my-region:my-instance", connect=getconn
-    )
-
-    # acquire connection and query Cloud SQL database
-    async with pool.acquire() as conn:
-        res = await conn.fetch("SELECT NOW()")
-    
-    # close Connector
-    await connector.close_async()
-```
-
 For more details on additional database arguments with an `asyncpg.Connection`
 , please visit the
 [official documentation](https://magicstack.github.io/asyncpg/current/api/index.html).
@@ -600,6 +600,38 @@ calls to `connector.close_async()` to cleanup resources.
 > This alternative requires that the running event loop be
 > passed in as the `loop` argument to `Connector()`.
 
+#### Asyncpg Connection Pool
+
+```python
+import asyncpg
+from google.cloud.sql.connector import Connector, create_async_connector
+
+async def main():
+    # initialize Connector object for connections to Cloud SQL
+    loop = asyncio.get_running_loop()
+    async with Connector(loop=loop) as connector:
+
+        # creation function to generate asyncpg connections as the 'connect' arg
+        async def getconn(instance_connection_name, **kwargs) -> asyncpg.Connection:
+            return await connector.connect_async(
+                instance_connection_name,
+                "asyncpg",
+                user="my-user",
+                password="my-password",
+                db="my-db",
+                **kwargs, # ... additional asyncpg args
+            )
+
+        # create connection pool
+        pool = await asyncpg.create_pool(
+            "my-project:my-region:my-instance", connect=getconn
+        )
+
+        # acquire connection and query Cloud SQL database
+        async with pool.acquire() as conn:
+            res = await conn.fetch("SELECT NOW()")
+```
+
 #### SQLAlchemy Async Engine
 
 ```python
@@ -647,38 +679,6 @@ async def main():
         await pool.dispose()
 ```
 
-#### Asyncpg Connection Pool
-
-```python
-import asyncpg
-from google.cloud.sql.connector import Connector, create_async_connector
-
-async def main():
-    # initialize Connector object for connections to Cloud SQL
-    loop = asyncio.get_running_loop()
-    async with Connector(loop=loop) as connector:
-
-        # creation function to generate asyncpg connections as the 'connect' arg
-        async def getconn(instance_connection_name, **kwargs) -> asyncpg.Connection:
-            return await connector.connect_async(
-                instance_connection_name,
-                "asyncpg",
-                user="my-user",
-                password="my-password",
-                db="my-db",
-                **kwargs, # ... additional asyncpg args
-            )
-
-        # create connection pool
-        pool = await asyncpg.create_pool(
-            "my-project:my-region:my-instance", connect=getconn
-        )
-
-        # acquire connection and query Cloud SQL database
-        async with pool.acquire() as conn:
-            res = await conn.fetch("SELECT NOW()")
-```
-
 ### Debug Logging
 
 The Cloud SQL Python Connector uses the standard [Python logging module][python-logging]