altcodepro-polydb-python 2.3.29__py3-none-any.whl → 2.3.31__py3-none-any.whl

{altcodepro_polydb_python-2.3.29.dist-info → altcodepro_polydb_python-2.3.31.dist-info}/METADATA

@@ -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.dist-info → altcodepro_polydb_python-2.3.31.dist-info}/RECORD

@@ -1,4 +1,4 @@
-altcodepro_polydb_python-2.3.29.dist-info/licenses/LICENSE,sha256=9X8GLocsBwy-5aR5JGOt2SAMDDPs9Qv-YnqmHBHOXrw,1067
+altcodepro_polydb_python-2.3.31.dist-info/licenses/LICENSE,sha256=9X8GLocsBwy-5aR5JGOt2SAMDDPs9Qv-YnqmHBHOXrw,1067
 polydb/PolyDB.py,sha256=MG7-nV59zDvrUQwXNEgV4eetHCeW9TYY9DQqtxu_r7k,23543
 polydb/__init__.py,sha256=d9KSz888A336904TPEjWPYBtyJLPB0lTdcaOnYp8byY,1535
 polydb/advanced_query.py,sha256=cxMB-EB-qT3bWXJlhmjnMCUtrzogORWyoEfS50Dy7go,4280
@@ -15,7 +15,7 @@ polydb/multitenancy.py,sha256=9kyY98RpKg8xDy9ejB_MyV_YzF7eZd4uxashw5S8vlg,6408
 polydb/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 polydb/query.py,sha256=3oWgRXIYLItmd_R-7u78hCdUgUaoiFmjVg38vi2-rVA,6600
 polydb/registry.py,sha256=RD_elvFXcmhTdCyZDm2f3ej0elxqhArnSJ2aO9k5VCU,2352
-polydb/retry.py,sha256=OfmNglrmL6AQlJPmXNdy9A9lRkH0P-vZ5BUuMiUM__4,3795
+polydb/retry.py,sha256=QduWwDyiU-dt1fHFQmm6ltbnaJY2460cDfQ7ZE8wjXs,4466
 polydb/schema.py,sha256=VrOayX6V6AD2Qh3-lm4ZVPTpI24e4V52IYheZf2rNQ4,5812
 polydb/security.py,sha256=9ju-hc6Y1sxobCoV_mZ3ZWroUD73LodyTLVMhY_HeKU,16360
 polydb/types.py,sha256=XB_85Un8_aWt4dSfpjIGotHbK3KBY2WurQGXr9EOxWY,2992
@@ -36,7 +36,7 @@ polydb/adapters/GCPFilestoreAdapter.py,sha256=yjFQQwsWYWc8mo8XwMViVTWb5_D--xAyTM
 polydb/adapters/GCPPubSubAdapter.py,sha256=7XNots2VA0ReEDku-rjg-OTYmftIpx5UgnXYDdXNkOo,8692
 polydb/adapters/GCPStorageAdapter.py,sha256=9yS1Jhcn5_rCRdZ5uOqcRW6Ba-UNb6VOYpwENP-C6Qk,7133
 polydb/adapters/MongoDBAdapter.py,sha256=Ak8q_qeAaUTe0Yc2oEefmAbzoODjTWVZQOirW-seBQU,7574
-polydb/adapters/PostgreSQLAdapter.py,sha256=lUe65kpJkTu6R1Tc1zgl63Fa1PI44UVbWRTKRUSSGak,36579
+polydb/adapters/PostgreSQLAdapter.py,sha256=9VI4-JOdDPeCDba8lRar4RkVMuF0bAymkvSTE3HILjs,38239
 polydb/adapters/S3Adapter.py,sha256=5R0zHAL2SkGFjp1L3bp-IU468bXYdSf6nKx974MN104,7586
 polydb/adapters/S3CompatibleAdapter.py,sha256=jpafqbAjA8-irdXBrfXa1QJySIzrcUQ6UrFt5h5FAEc,7006
 polydb/adapters/SQSAdapter.py,sha256=1vfbNoqIDy-b8t2xcxy91SoxSYBPFDfUh7yCQWxdS84,5778
@@ -60,7 +60,7 @@ polydb/observability/logging.py,sha256=gv1SshNjaSkmR98Uv7Qbwq3gkeQUzVCA4ichqHKL6
 polydb/services/__init__.py,sha256=nMolMXzmhejRSm7f42kU9fCHF0GIpqpejN2kywuBsUQ,241
 polydb/services/compliance_service.py,sha256=-0ncX7PrXy4-NuyWXIv65cLUsqz0jXzb3LtsD8rlrXE,4983
 polydb/services/security_service.py,sha256=q7GzK6sbMnBBsc4fuL4oXTd-ui2b-MYQyrWTBvdVNSk,5062
-altcodepro_polydb_python-2.3.29.dist-info/METADATA,sha256=7bWio-A4c46Q0twrvo3OX7m5s3wYBpfR0NajgheWDgQ,12359
-altcodepro_polydb_python-2.3.29.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-altcodepro_polydb_python-2.3.29.dist-info/top_level.txt,sha256=WgLFWJoYjUhwvyPxJFl6jYLrVFuBJDX3OABf4ocwk_E,7
-altcodepro_polydb_python-2.3.29.dist-info/RECORD,,
+altcodepro_polydb_python-2.3.31.dist-info/METADATA,sha256=mEh53S4z1JD9K0ZMj4b4L1EOPOZji-fSz4vCS5BHCjQ,12359
+altcodepro_polydb_python-2.3.31.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+altcodepro_polydb_python-2.3.31.dist-info/top_level.txt,sha256=WgLFWJoYjUhwvyPxJFl6jYLrVFuBJDX3OABf4ocwk_E,7
+altcodepro_polydb_python-2.3.31.dist-info/RECORD,,

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)
 

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"
             )