docs: implement docstring feedback

Author: colinchambachan

google/cloud/sql/connector/asyncpg.py

@@ -32,11 +32,12 @@ async def connect(
         ip_address (str): A string containing an IP address for the Cloud SQL
             instance.
         ctx (ssl.SSLContext): An SSLContext object created from the Cloud SQL
+            server CA cert and ephemeral cert.
         kwargs: Keyword arguments for establishing asyncpg connection
             object to Cloud SQL instance.
     
     Returns:
-        asyncpg.Connection: A asyncpg Connection object for the Cloud SQL
+        asyncpg.Connection: An asyncpg connection to the Cloud SQL
             instance.
     Raises:
         ImportError: The asyncpg module cannot be imported.

google/cloud/sql/connector/client.py

@@ -194,8 +194,9 @@ async def _get_ephemeral(
                  authentication for Postgres or MySQL instances.
 
         Returns:
-            An ephemeral certificate from the Cloud SQL instance that allows
-            authorized connections to the instance.
+            A tuple containing an ephemeral certificate from 
+            the Cloud SQL instance as well as a datetime object 
+            representing the expiration time of the certificate.
         """
         headers = {
             "Authorization": f"Bearer {self._credentials.token}",

google/cloud/sql/connector/pg8000.py

@@ -34,7 +34,7 @@ def connect(
         kwargs: Additional arguments to pass to the pg8000 connect method.
         
     Returns:
-        pg8000.dbapi.Connection: A pg8000 Connection object for the Cloud SQL
+        pg8000.dbapi.Connection: A pg8000 connection to the Cloud SQL
             instance.
         
     Raises:

google/cloud/sql/connector/pymysql.py

@@ -33,7 +33,7 @@ def connect(
             server CA cert and ephemeral cert.
 
     Returns:
-        pymysql.connections.Connection: A pymysql Connection object for the Cloud SQL
+        pymysql.connections.Connection: A pymysql connection to the Cloud SQL
             instance.
     
     Raises:

google/cloud/sql/connector/pytds.py

@@ -34,7 +34,7 @@ def connect(ip_address: str, sock: ssl.SSLSocket, **kwargs: Any) -> "pytds.Conne
             server CA cert and ephemeral cert.
     
     Returns:
-        pytds.Connection: A pytds Connection object for the Cloud SQL
+        pytds.Connection: A pytds connection to the Cloud SQL
             instance.
     
     Raises:

google/cloud/sql/connector/rate_limiter.py

@@ -24,8 +24,8 @@ class AsyncRateLimiter(object):
     of function calls over a time interval using an event queue.
 
     Args:
-        max_capacity (int): The maximum capacity of tokens the bucket will store at any one time.
-            Default: 1
+        max_capacity (int): The maximum capacity of tokens the bucket 
+            will store at any one time. Default: 1
         rate (float): The number of tokens that should be added per second.
         loop (asyncio.AbstractEventLoop): The event loop to use. 
             If not provided, the default event loop will be used.

google/cloud/sql/connector/refresh_utils.py

@@ -85,8 +85,10 @@ def _downscope_credentials(
     """Generate a down-scoped credential.
 
     Args:
-        credentials (google.auth.credentials.Credentials): Credentials object used to generate down-scoped credentials.
-        scopes (list[str]): List of Google scopes to include in down-scoped credentials object.
+        credentials (google.auth.credentials.Credentials): 
+            Credentials object used to generate down-scoped credentials.
+        scopes (list[str]): List of Google scopes to 
+            include in down-scoped credentials object.
     
     Returns:
         google.auth.credentials.Credentials: Down-scoped credentials object.