wherobots-python-dbapi 0.17.0__tar.gz → 0.18.0__tar.gz

{wherobots_python_dbapi-0.17.0 → wherobots_python_dbapi-0.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wherobots-python-dbapi
-Version: 0.17.0
+Version: 0.18.0
 Summary: Python DB-API driver for Wherobots DB
 Project-URL: Homepage, https://github.com/wherobots/wherobots-python-dbapi-driver
 Project-URL: Tracker, https://github.com/wherobots/wherobots-python-dbapi-driver/issues
@@ -118,12 +118,16 @@ users may find useful:
     client application. The default is EWKT (string) and the most
     convenient for human inspection while still being usable by
     libraries like Shapely.
-* `session_type`: `"single"` or `"multi"`; if set to `"single"`, then each call
-    to `connect()` establishes an exclusive connection to a distinct and dedicated
-    Wherobots runtime; if set to "multi", then multiple `connect()` calls with the
-    same arguments and credentials will connect to the same shared Wherobots runtime;
-    `"single"` is the default.
-
-    Consider multi-session for potential cost savings, but be mindful of
-    performance impacts from shared resources. You might need to adjust
-    cluster size if slowdowns occur, which could affect overall cost.
+* `version`: one of the WherobotsDB runtime versions that is available
+    to you, if you need to pin your usage to a particular, supported
+    WherobotsDB version. Defaults to `"latest"`.
+* `session_type`: `"single"` or `"multi"`; if set to `"single"`, then
+   each call to `connect()` establishes an exclusive connection to a
+   distinct and dedicated Wherobots runtime; if set to "multi", then
+   multiple `connect()` calls with the same arguments and credentials
+   will connect to the same shared Wherobots runtime; `"multi"` is the
+   default.
+
+   Consider multi-session for potential cost savings, but be mindful of
+   performance impacts from shared resources. You might need to adjust
+   cluster size if slowdowns occur, which could affect overall cost.

{wherobots_python_dbapi-0.17.0 → wherobots_python_dbapi-0.18.0}/README.md

@@ -94,12 +94,16 @@ users may find useful:
     client application. The default is EWKT (string) and the most
     convenient for human inspection while still being usable by
     libraries like Shapely.
-* `session_type`: `"single"` or `"multi"`; if set to `"single"`, then each call
-    to `connect()` establishes an exclusive connection to a distinct and dedicated
-    Wherobots runtime; if set to "multi", then multiple `connect()` calls with the
-    same arguments and credentials will connect to the same shared Wherobots runtime;
-    `"single"` is the default.
-
-    Consider multi-session for potential cost savings, but be mindful of
-    performance impacts from shared resources. You might need to adjust
-    cluster size if slowdowns occur, which could affect overall cost.
+* `version`: one of the WherobotsDB runtime versions that is available
+    to you, if you need to pin your usage to a particular, supported
+    WherobotsDB version. Defaults to `"latest"`.
+* `session_type`: `"single"` or `"multi"`; if set to `"single"`, then
+   each call to `connect()` establishes an exclusive connection to a
+   distinct and dedicated Wherobots runtime; if set to "multi", then
+   multiple `connect()` calls with the same arguments and credentials
+   will connect to the same shared Wherobots runtime; `"multi"` is the
+   default.
+
+   Consider multi-session for potential cost savings, but be mindful of
+   performance impacts from shared resources. You might need to adjust
+   cluster size if slowdowns occur, which could affect overall cost.

{wherobots_python_dbapi-0.17.0 → wherobots_python_dbapi-0.18.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "wherobots-python-dbapi"
-version = "0.17.0"
+version = "0.18.0"
 description = "Python DB-API driver for Wherobots DB"
 authors = [{ name = "Maxime Petazzoni", email = "max@wherobots.com" }]
 requires-python = "~=3.8"

{wherobots_python_dbapi-0.17.0 → wherobots_python_dbapi-0.18.0}/wherobots/db/constants.py

@@ -12,6 +12,7 @@ STAGING_ENDPOINT: str = "api.staging.wherobots.com"  # "api.staging.wherobots.co
 
 DEFAULT_RUNTIME: Runtime = Runtime.TINY
 DEFAULT_REGION: Region = Region.AWS_US_WEST_2
+DEFAULT_VERSION: str = "latest"
 DEFAULT_SESSION_TYPE: SessionType = SessionType.MULTI
 DEFAULT_READ_TIMEOUT_SECONDS: float = 0.25
 DEFAULT_SESSION_WAIT_TIMEOUT_SECONDS: float = 900

{wherobots_python_dbapi-0.17.0 → wherobots_python_dbapi-0.18.0}/wherobots/db/driver.py

@@ -24,6 +24,7 @@ from .constants import (
     DEFAULT_READ_TIMEOUT_SECONDS,
     DEFAULT_SESSION_TYPE,
     DEFAULT_SESSION_WAIT_TIMEOUT_SECONDS,
+    DEFAULT_VERSION,
     MAX_MESSAGE_SIZE,
     PARAM_STYLE,
     PROTOCOL_VERSION,
@@ -63,6 +64,7 @@ def connect(
     api_key: Union[str, None] = None,
     runtime: Union[Runtime, None] = None,
     region: Union[Region, None] = None,
+    version: Union[str, None] = None,
     wait_timeout: float = DEFAULT_SESSION_WAIT_TIMEOUT_SECONDS,
     read_timeout: float = DEFAULT_READ_TIMEOUT_SECONDS,
     session_type: Union[SessionType, None] = None,
@@ -85,11 +87,13 @@ def connect(
     host = host or DEFAULT_ENDPOINT
     runtime = runtime or DEFAULT_RUNTIME
     region = region or DEFAULT_REGION
+    version = version or DEFAULT_VERSION
     session_type = session_type or DEFAULT_SESSION_TYPE
 
     logging.info(
-        "Requesting %s runtime in %s from %s ...",
+        "Requesting %s runtime running %s in %s from %s ...",
         runtime.value,
+        version,
         region.value,
         host,
     )
@@ -105,6 +109,7 @@ def connect(
             json={
                 "runtimeId": runtime.value,
                 "shutdownAfterInactiveSeconds": shutdown_after_inactive_seconds,
+                "version": version,
                 "sessionType": session_type.value,
             },
             headers=headers,