chore: rename Session to Connection

Author: mpetazzoni

wherobots/db/session.py wherobots/db/connection.pywherobots/db/session.py renamed to wherobots/db/connection.py

@@ -2,11 +2,11 @@
 from wherobots.db.errors import NotSupportedError
 
 
-class Session:
+class Connection:
     """
-    A PEP-0249 compatible Session object for Wherobots DB.
+    A PEP-0249 compatible Connection object for Wherobots DB.
 
-    The session is backed by the WebSocket connection to the Wherobots SQL session.
+    The connection is backed by the WebSocket connected to the Wherobots SQL session instance.
     Transactions are not supported, so commit() and rollback() raise NotSupportedError.
     """
 

wherobots/db/driver.py

@@ -21,7 +21,7 @@
 )
 from .region import Region
 from .runtime import Runtime
-from .session import Session
+from .connection import Connection
 
 apilevel = "2.0"
 threadsafety = 1
@@ -35,7 +35,7 @@ def connect(
     runtime: Runtime = DEFAULT_RUNTIME,
     region: Region = DEFAULT_REGION,
     wait_timeout_seconds: int = DEFAULT_SESSION_WAIT_TIMEOUT_SECONDS,
-) -> Session:
+) -> Connection:
     if not token and not api_key:
         raise ValueError("At least one of `token` or `api_key` is required")
     if token and api_key:
@@ -113,11 +113,11 @@ def http_to_ws(uri: str) -> str:
     return str(urllib.parse.urlunparse(parsed))
 
 
-def connect_direct(uri: str, headers: dict[str, str] = None) -> Session:
+def connect_direct(uri: str, headers: dict[str, str] = None) -> Connection:
     logging.info("Connecting to SQL session at %s ...", uri)
     try:
-        connection = websockets.sync.client.connect(uri=uri, additional_headers=headers)
-        session = Session(ws=connection)
+        ws = websockets.sync.client.connect(uri=uri, additional_headers=headers)
+        session = Connection(ws)
         return session
     except Exception as e:
         raise InterfaceError("Failed to connect to SQL session!", e)