altcodepro-polydb-python 2.3.29__tar.gz → 2.3.31__tar.gz

{altcodepro_polydb_python-2.3.29/src/altcodepro_polydb_python.egg-info → altcodepro_polydb_python-2.3.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: altcodepro-polydb-python
-Version: 2.3.29
+Version: 2.3.31
 Summary: Production-ready multi-cloud database abstraction layer with connection pooling, retry logic, and thread safety
 Author: AltCodePro
 Project-URL: Homepage, https://github.com/altcodepro/polydb-python

{altcodepro_polydb_python-2.3.29 → altcodepro_polydb_python-2.3.31}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "altcodepro-polydb-python"
-version = "2.3.29"
+version = "2.3.31"
 description = "Production-ready multi-cloud database abstraction layer with connection pooling, retry logic, and thread safety"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"

{altcodepro_polydb_python-2.3.29 → altcodepro_polydb_python-2.3.31/src/altcodepro_polydb_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: altcodepro-polydb-python
-Version: 2.3.29
+Version: 2.3.31
 Summary: Production-ready multi-cloud database abstraction layer with connection pooling, retry logic, and thread safety
 Author: AltCodePro
 Project-URL: Homepage, https://github.com/altcodepro/polydb-python

{altcodepro_polydb_python-2.3.29 → altcodepro_polydb_python-2.3.31}/src/polydb/adapters/PostgreSQLAdapter.py

@@ -76,7 +76,7 @@ class PostgreSQLAdapter:
     def _initialize_pool(self):
         try:
             import psycopg2.pool
-            from urllib.parse import urlparse, parse_qs, urlencode, urlunparse
+            from urllib.parse import urlparse, parse_qs, quote, urlencode, urlunparse
 
             dsn = self.connection_string
             if "postgresql://" in dsn:
@@ -87,8 +87,33 @@ class PostgreSQLAdapter:
                 query.setdefault("keepalives_idle", ["30"])
                 query.setdefault("keepalives_interval", ["10"])
                 query.setdefault("keepalives_count", ["5"])
+                # connect_timeout only bounds the initial handshake; keepalives
+                # only detect a dead *idle* connection. Neither bounds a query
+                # that's already in flight and stalls mid-response (packet
+                # loss / a silently-dropped connection somewhere on the path
+                # to a remote DB) -- that shows up as libpq's own "could not
+                # receive data from server: Operation timed out / SSL SYSCALL
+                # error", and without a bound the client can block on that
+                # recv() for a very long time (Python can't interrupt a
+                # blocking C-level syscall, so even Ctrl+C doesn't land until
+                # it returns). tcp_user_timeout bounds unacknowledged data at
+                # the OS/TCP level; statement_timeout bounds how long Postgres
+                # itself will run a query before cancelling it server-side.
+                query.setdefault(
+                    "tcp_user_timeout",
+                    [os.getenv("POSTGRES_TCP_USER_TIMEOUT_MS", "20000")],
+                )
+                query.setdefault(
+                    "options",
+                    [f"-c statement_timeout={os.getenv('POSTGRES_STATEMENT_TIMEOUT_MS', '20000')}"],
+                )
 
-                new_query = urlencode(query, doseq=True)
+                # quote_via=quote, not the default quote_plus: libpq's URI
+                # parser percent-decodes query values but treats "+" as a
+                # literal plus, so form-encoding the space in
+                # "-c statement_timeout=..." makes the server see the option
+                # name as "+statement_timeout" and reject the connection.
+                new_query = urlencode(query, doseq=True, quote_via=quote)
                 parsed = parsed._replace(query=new_query)
                 dsn = urlunparse(parsed)
 

{altcodepro_polydb_python-2.3.29 → altcodepro_polydb_python-2.3.31}/src/polydb/retry.py

@@ -3,6 +3,7 @@
 Retry logic with exponential backoff and metrics hooks
 """
 
+import os
 import time
 import logging
 from functools import wraps
@@ -74,7 +75,15 @@ def retry(
         @wraps(func)
         def wrapper(*args, **kwargs):
             attempt = 0
-            current_delay = delay
+            # POLYDB_RETRY_DELAY_SECONDS / POLYDB_RETRY_BACKOFF override every
+            # call site's hardcoded delay/backoff without touching them
+            # individually -- every adapter passes delay=1.0 explicitly, so a
+            # transient failure against a high-latency remote DB (e.g. a local
+            # dev box talking to a managed Postgres in a different region)
+            # costs a full 1s+2s of sleep on top of the already-elevated
+            # network round trip, per retry. Unset, behavior is unchanged.
+            current_delay = float(os.getenv("POLYDB_RETRY_DELAY_SECONDS", delay))
+            backoff_rate = float(os.getenv("POLYDB_RETRY_BACKOFF", backoff))
 
             logger = logging.getLogger(__name__)
 
@@ -110,7 +119,7 @@ def retry(
                         f"Retrying in {current_delay}s..."
                     )
                     time.sleep(current_delay)
-                    current_delay *= backoff
+                    current_delay *= backoff_rate
             raise RuntimeError(
                 f"{func.__name__} exhausted {max_attempts} attempts without returning"
             )