altcodepro-polydb-python 2.3.28__py3-none-any.whl → 2.3.30__py3-none-any.whl

{altcodepro_polydb_python-2.3.28.dist-info → altcodepro_polydb_python-2.3.30.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: altcodepro-polydb-python
-Version: 2.3.28
+Version: 2.3.30
 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.28.dist-info → altcodepro_polydb_python-2.3.30.dist-info}/RECORD

@@ -1,4 +1,4 @@
-altcodepro_polydb_python-2.3.28.dist-info/licenses/LICENSE,sha256=9X8GLocsBwy-5aR5JGOt2SAMDDPs9Qv-YnqmHBHOXrw,1067
+altcodepro_polydb_python-2.3.30.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
@@ -23,7 +23,7 @@ polydb/utils.py,sha256=tS_KI1vt-VZ6JftbFxbnVxC0xpie1-zYikTGf1nSoFw,3183
 polydb/validation.py,sha256=a1o1d02k3c6PWQwkBbw_0nEmIgrdB5RR8OcpNQMn4cA,4810
 polydb/adapters/AzureBlobStorageAdapter.py,sha256=4vD55Z8DBTzBK66jIJbo5bNMY-AQ61MlP0-P2Fv_JgQ,7083
 polydb/adapters/AzureFileStorageAdapter.py,sha256=VZNprqlBXCuWUgtqClNT-NrQmRf-XFYEiRA2BLbf-Sc,7046
-polydb/adapters/AzureQueueAdapter.py,sha256=-MLEEAt2yvYjlB5LqT2TwoRa3rVDHDVzXhm1gykqeDM,8052
+polydb/adapters/AzureQueueAdapter.py,sha256=LsNvrNHUgFF2UwXXTwlOiqK8VdP4htLaFnTu4oxZDlo,9468
 polydb/adapters/AzureTableStorageAdapter.py,sha256=FCWojIRyOQdDyga5sxbHXBfZMdb3T1xn3Q2VX5klebo,27824
 polydb/adapters/BlockchainBlobAdapter.py,sha256=D01Yua9mkKfaQrxKYApblIyI6DSP0dtNAh4Tav51HJ4,3299
 polydb/adapters/BlockchainFileAdapter.py,sha256=G749xOVpG20HuKS8zCgi6PMjoJNu-YXK7zitygjLdzM,8335
@@ -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=SOmaNYhbFnw_8MiQAJrM6SSQhEHc0dgrxIHjGpxqK9E,37853
 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.28.dist-info/METADATA,sha256=mCw1bRtSYL37sOtvm-Rn5fQdjfCwLZPcZkAiOk-PN68,12359
-altcodepro_polydb_python-2.3.28.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-altcodepro_polydb_python-2.3.28.dist-info/top_level.txt,sha256=WgLFWJoYjUhwvyPxJFl6jYLrVFuBJDX3OABf4ocwk_E,7
-altcodepro_polydb_python-2.3.28.dist-info/RECORD,,
+altcodepro_polydb_python-2.3.30.dist-info/METADATA,sha256=p1Tk2tEZiHimDJPShjvq38kJvXyCG44z3k7EdCrK9HU,12359
+altcodepro_polydb_python-2.3.30.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+altcodepro_polydb_python-2.3.30.dist-info/top_level.txt,sha256=WgLFWJoYjUhwvyPxJFl6jYLrVFuBJDX3OABf4ocwk_E,7
+altcodepro_polydb_python-2.3.30.dist-info/RECORD,,

polydb/adapters/AzureQueueAdapter.py

@@ -110,15 +110,38 @@ class AzureQueueAdapter(QueueAdapter):
         except Exception as e:
             raise QueueError(f"Azure Queue send failed: {e}")
 
+    # How long a delivered message stays invisible to other consumers before
+    # Azure hands it out again. The SDK's own default is 30s — far shorter
+    # than a real task (an LLM generation call alone can run 30-120s+), so
+    # a still-in-flight message was becoming visible again and getting
+    # picked up by a second worker mid-processing: two concurrent
+    # executions of the same task, one of which stomps/duplicates the
+    # other's result. 300s covers realistic worst-case processing; ack()
+    # deletes the message immediately on completion regardless; a genuinely
+    # crashed worker still recovers the message after this timeout.
+    DEFAULT_VISIBILITY_TIMEOUT = 300
+
     @retry(max_attempts=3, delay=1.0, exceptions=(QueueError,))
-    def receive(self, queue_name: str = "default", max_messages: int = 1) -> List[Dict[str, Any]]:
+    def receive(
+        self,
+        queue_name: str = "default",
+        max_messages: int = 1,
+        visibility_timeout: Optional[int] = None,
+    ) -> List[Dict[str, Any]]:
         """Receive messages"""
         try:
 
             queue_name = self._normalize_queue_name(queue_name)
             queue_client = self._get_queue(queue_name)
 
-            messages = queue_client.receive_messages(max_messages=max_messages)
+            messages = queue_client.receive_messages(
+                max_messages=max_messages,
+                visibility_timeout=(
+                    visibility_timeout
+                    if visibility_timeout is not None
+                    else self.DEFAULT_VISIBILITY_TIMEOUT
+                ),
+            )
 
             results = []
 
@@ -135,6 +158,12 @@ class AzureQueueAdapter(QueueAdapter):
                         # Azure's visibility timeout elapses — replaying the
                         # same task forever even after it already ran.
                         "receipt_handle": self._encode_receipt(msg.id, msg.pop_receipt),
+                        # How many times Azure has handed this same message
+                        # out (1 on first delivery). Lets a consumer (e.g.
+                        # WorkerPool) detect a poison message that keeps
+                        # failing to ack/process and dead-letter it instead
+                        # of retrying forever.
+                        "dequeue_count": msg.dequeue_count,
                         "body": payload,
                     }
                 )

polydb/adapters/PostgreSQLAdapter.py

@@ -87,6 +87,26 @@ 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)
                 parsed = parsed._replace(query=new_query)

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