altcodepro-polydb-python 2.3.17__py3-none-any.whl → 2.3.20__py3-none-any.whl

{altcodepro_polydb_python-2.3.17.dist-info → altcodepro_polydb_python-2.3.20.dist-info}/METADATA

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

@@ -1,12 +1,12 @@
-altcodepro_polydb_python-2.3.17.dist-info/licenses/LICENSE,sha256=9X8GLocsBwy-5aR5JGOt2SAMDDPs9Qv-YnqmHBHOXrw,1067
+altcodepro_polydb_python-2.3.20.dist-info/licenses/LICENSE,sha256=9X8GLocsBwy-5aR5JGOt2SAMDDPs9Qv-YnqmHBHOXrw,1067
 polydb/PolyDB.py,sha256=MG7-nV59zDvrUQwXNEgV4eetHCeW9TYY9DQqtxu_r7k,23543
-polydb/__init__.py,sha256=UhUzfSvmMgKbV2tSME1ooIyfshIBi7_WyU4xl1tWWiA,1454
+polydb/__init__.py,sha256=e0tWk_og6VMgsTsoZbLc32yaIB0DBh7JpOt9t_jNTtk,1397
 polydb/advanced_query.py,sha256=cxMB-EB-qT3bWXJlhmjnMCUtrzogORWyoEfS50Dy7go,4280
 polydb/batch.py,sha256=_DjWZa1ZXYSk6MLKqFe0eT7SYVRZtYNqZb9bI8Y2sao,4566
 polydb/cache.py,sha256=JBXF1XEK-fY80ar8SDE893Z1Z116YtXAEG0PaJ0Nkcw,7658
 polydb/cloudDatabaseFactory.py,sha256=Gp6L__YtgrkGahD8B7ItzXMHCoj2ZUGDjXLS9w0TujY,17780
-polydb/databaseFactory.py,sha256=Lq74pDWX9NXnV3ABIcKIwsXNse3nhvtRbUDrcm1xSsU,43107
-polydb/decorators.py,sha256=Rzk8Bj8wHi8YFtc06HEYT5r_Vqqn7TGaCtR5qvHdY-E,420
+polydb/databaseFactory.py,sha256=u20sy8bA09A0jTO2vLxGznssdcaxChQf21FBpooL2oA,40265
+polydb/decorators.py,sha256=L_WP2uXP_k8Ac49SUm-mthbM4jWI-XYfHXEyKzumOww,43062
 polydb/errors.py,sha256=rcFeBH0cenjJ86v0cmDc2Yjj4R019pLCBcTeSC4qps4,1428
 polydb/json_safe.py,sha256=R5PrqAGirqjYKPyy-8KH-lSXjLH0FPr2TSGozy4eheU,149
 polydb/models.py,sha256=9uu_BaJ95194n-vnd0Rx9KLc6aPS-mxn10P4W5grUcI,8155
@@ -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=AWq-Ia5aLL2MnOmMB0dfNT5bSJLQySLveLfwZUTMQfs,3403
+polydb/retry.py,sha256=OfmNglrmL6AQlJPmXNdy9A9lRkH0P-vZ5BUuMiUM__4,3795
 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=vX3SAHDLbTnHABGesES9N-gYSQqPqdqFLJgd7pYWZzw,7471
-polydb/adapters/PostgreSQLAdapter.py,sha256=OTKC849cGoZM_DKZuLWZqI32arpOhODBlRHuSup7-3M,30491
+polydb/adapters/PostgreSQLAdapter.py,sha256=SUwtJ5GV1ec29Q5Ww6cehf3zlrhFhzP2b-TMFe7A0uM,31139
 polydb/adapters/S3Adapter.py,sha256=5R0zHAL2SkGFjp1L3bp-IU468bXYdSf6nKx974MN104,7586
 polydb/adapters/S3CompatibleAdapter.py,sha256=jpafqbAjA8-irdXBrfXa1QJySIzrcUQ6UrFt5h5FAEc,7006
 polydb/adapters/SQSAdapter.py,sha256=1vfbNoqIDy-b8t2xcxy91SoxSYBPFDfUh7yCQWxdS84,5778
@@ -55,7 +55,7 @@ polydb/base/ObjectStorageAdapter.py,sha256=VeJ3qXET6H0xd3lJpE8-WSsKs8EyK9S0-9VNR
 polydb/base/QueueAdapter.py,sha256=jFgyG-SUK4nhRNxm2NbzUbwnA9b_5iAC-ikLSUpXRwk,799
 polydb/base/SharedFilesAdapter.py,sha256=kXbJmtn_cwEyAZ-1AvFrmesCLSwu43ycTV3S4BmwrO4,853
 polydb/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-altcodepro_polydb_python-2.3.17.dist-info/METADATA,sha256=zCoiUeNmpAzzle_t888sv5nCP3-Kp1V9HX3AidPDaGM,12359
-altcodepro_polydb_python-2.3.17.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-altcodepro_polydb_python-2.3.17.dist-info/top_level.txt,sha256=WgLFWJoYjUhwvyPxJFl6jYLrVFuBJDX3OABf4ocwk_E,7
-altcodepro_polydb_python-2.3.17.dist-info/RECORD,,
+altcodepro_polydb_python-2.3.20.dist-info/METADATA,sha256=UwAAWPqWOC9nVRjTXS_3_8n1QqRpZ-bKIhKc_55fEXo,12359
+altcodepro_polydb_python-2.3.20.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+altcodepro_polydb_python-2.3.20.dist-info/top_level.txt,sha256=WgLFWJoYjUhwvyPxJFl6jYLrVFuBJDX3OABf4ocwk_E,7
+altcodepro_polydb_python-2.3.20.dist-info/RECORD,,

polydb/__init__.py

@@ -9,7 +9,6 @@ __version__ = "2.2.3"
 from .cloudDatabaseFactory import CloudDatabaseFactory
 from .databaseFactory import DatabaseFactory
 from .models import CloudProvider, PartitionConfig
-from .decorators import polydb_model
 from .query import QueryBuilder, Operator
 from .audit.context import AuditContext
 from .cache import RedisCacheEngine as CacheEngine
@@ -36,7 +35,6 @@ __all__ = [
     # Models & Config
     "CloudProvider",
     "PartitionConfig",
-    "polydb_model",
     # Query
     "QueryBuilder",
     "Operator",

polydb/adapters/PostgreSQLAdapter.py

@@ -1,15 +1,15 @@
 # src/polydb/adapters/postgres.py
-import datetime
-from decimal import Decimal
 import os
 import threading
 from typing import Any, Iterator, List, Optional, Tuple, Union
 import hashlib
 from contextlib import contextmanager
 import json
+from decimal import Decimal
 from datetime import datetime, date
 
 import psycopg2.extensions
+from psycopg2.extras import Json
 
 from ..errors import DatabaseError, ConnectionError
 from ..retry import retry
@@ -158,7 +158,7 @@ class PostgreSQLAdapter:
             if self._pool:
                 try:
                     self._pool.closeall()
-                except:
+                except Exception:
                     pass
                 self._pool = None
             self._initialize_pool()
@@ -194,8 +194,9 @@ class PostgreSQLAdapter:
     # ---------------------------------------------------------------------
     def _json_safe(self, obj: Any):
         """
-        Ensure JSON serialization never fails.
-        Used only for Json() wrapping.
+        Ensure JSON serialization never fails. Used only for Json() wrapping.
+        Recurses into dicts, lists, AND tuples so nested datetime/Decimal
+        values are made safe at any depth.
         """
         if isinstance(obj, datetime):
             return obj.isoformat()
@@ -205,66 +206,68 @@ class PostgreSQLAdapter:
             return str(obj)
         if isinstance(obj, dict):
             return {k: self._json_safe(v) for k, v in obj.items()}
-        if isinstance(obj, list):
+        if isinstance(obj, (list, tuple)):
             return [self._json_safe(v) for v in obj]
         return obj
 
     def _serialize_value(self, v: Any) -> Any:
         """
-        Make outgoing values safe for psycopg2 across mixed column types.
-
-        Rules:
-        None / empty list / empty dict   -> None  (becomes NULL on any column)
-        list of primitives (str/int/...) -> native list (psycopg2 maps to TEXT[]/INT[])
-        list containing dicts            -> Json(list)  (for JSONB columns)
-        dict                             -> Json(dict)
-        datetime/date                    -> native
-        Decimal                          -> float
-        everything else                  -> as-is
+        Serialize a value being WRITTEN to a column (insert / update SET /
+        upsert data values).
+
+        This platform provisions every ARRAY and OBJECT field as a JSONB
+        column (SchemaProvisioner._FIELD_TO_SQL_TYPE never emits a native
+        text[]/int[] column), so dicts AND lists/tuples are ALWAYS
+        JSON-encoded via psycopg2's Json adapter.
+
+        Json() handles empty {} and [] correctly ('{}'::jsonb / '[]'::jsonb),
+        handles nesting, and never produces a quoted string — which is what
+        broke the earlier native-list, json.dumps, and NULL-ify-empties
+        attempts. Empties are NOT turned into NULL: an empty JSONB array/
+        object is a valid, meaningful value.
         """
-        # NULL-ify empties so they're valid for TEXT[], JSONB, and plain columns alike.
-        from psycopg2.extras import Json
-
         if v is None:
             return None
-        if isinstance(v, (list, tuple)) and len(v) == 0:
-            return None
-        if isinstance(v, dict) and len(v) == 0:
-            return None
+        if isinstance(v, (dict, list, tuple)):
+            return Json(self._json_safe(v))
+        if isinstance(v, (datetime, date)):
+            return v
+        if isinstance(v, Decimal):
+            return float(v)
+        return v
 
-        # Dict -> JSONB
+    def _serialize_param(self, v: Any) -> Any:
+        """
+        Serialize a value used as a QUERY PARAMETER (WHERE values, IN / ANY
+        lists, LIMIT/OFFSET, raw execute() params).
+
+        Unlike _serialize_value, primitive lists/tuples are kept NATIVE so
+        that ``IN %s`` / ``= ANY(%s)`` parameters expand correctly. A dict
+        (or a list that contains dicts) is JSON-encoded so it can be compared
+        against a JSONB column.
+        """
+        if v is None:
+            return None
         if isinstance(v, dict):
             return Json(self._json_safe(v))
-
-        # List: route by element type.
         if isinstance(v, (list, tuple)):
-            v = list(v)
-            # If ANY element is a dict, treat as JSON payload (for JSONB columns).
-            if any(isinstance(x, dict) for x in v):
-                return Json(v)
-            # If ALL elements are primitives, send as native list for TEXT[]/INT[].
-            if all(isinstance(x, (str, int, float, bool, type(None))) for x in v):
-                return v
-            # Mixed / nested -> safest is JSONB
-            return Json(v)
-
-        # Datetime / date
+            seq = list(v)
+            if any(isinstance(x, dict) for x in seq):
+                return Json(self._json_safe(seq))
+            return seq  # native -> psycopg2 expands for IN / ANY
         if isinstance(v, (datetime, date)):
             return v
-
-        # Decimal
         if isinstance(v, Decimal):
             return float(v)
-
         return v
 
     def _serialize_params(self, params: List[Any]) -> List[Any]:
-        return [self._serialize_value(p) for p in params]
+        return [self._serialize_param(p) for p in params]
 
     def _deserialize_row(self, row: JsonDict) -> JsonDict:
         """
-        Postgres JSON/JSONB often comes back as dict already depending on driver config.
-        If it comes as a string, try json.loads safely.
+        Postgres JSON/JSONB often comes back as dict/list already depending on
+        driver config. If it comes as a string, try json.loads safely.
         """
         for k, v in list(row.items()):
             if isinstance(v, str):
@@ -444,6 +447,7 @@ class PostgreSQLAdapter:
             cursor = conn.cursor()
 
             set_clause = ", ".join([f"{k} = %s" for k in data.keys()])
+            # SET values are written into columns -> write serializer (JSONB).
             params: List[Any] = [self._serialize_value(v) for v in data.values()]
 
             if isinstance(entity_id, dict):
@@ -454,7 +458,8 @@ class PostgreSQLAdapter:
                         where_parts.append(f"{k} IS NULL")
                     else:
                         where_parts.append(f"{k} = %s")
-                        params.append(self._serialize_value(v))
+                        # WHERE values are query params -> param serializer.
+                        params.append(self._serialize_param(v))
                 where_clause = " AND ".join(where_parts)
             else:
                 where_clause = "id = %s"
@@ -580,7 +585,8 @@ class PostgreSQLAdapter:
                         where_parts.append(f"{k} IS NULL")
                     else:
                         where_parts.append(f"{k} = %s")
-                        params.append(self._serialize_value(v))
+                        # WHERE values are query params -> param serializer.
+                        params.append(self._serialize_param(v))
                 where_clause = " AND ".join(where_parts)
             else:
                 where_clause = "id = %s"

polydb/databaseFactory.py

@@ -35,6 +35,7 @@ from .audit.context import AuditContext
 from .query import Operator, QueryBuilder
 from .cloudDatabaseFactory import CloudDatabaseFactory
 import re as _re
+
 logger = logging.getLogger(__name__)
 
 _DEFAULT_RETRY = retry(
@@ -44,12 +45,12 @@ _DEFAULT_RETRY = retry(
 )
 
 _UNIQUE_VIOLATION_MARKERS = (
-    "23505",                                 # Postgres SQLSTATE
-    "duplicate key value violates",          # Postgres message
-    "unique constraint",                      # Postgres, generic
-    "UniqueViolation",                        # psycopg / SQLAlchemy class name
-    "Duplicate entry",                        # MySQL
-    "UNIQUE constraint failed",               # SQLite
+    "23505",  # Postgres SQLSTATE
+    "duplicate key value violates",  # Postgres message
+    "unique constraint",  # Postgres, generic
+    "UniqueViolation",  # psycopg / SQLAlchemy class name
+    "Duplicate entry",  # MySQL
+    "UNIQUE constraint failed",  # SQLite
 )
 _UNIQUE_KEY_RE = _re.compile(r"Key \(([^)]+)\)=")
 
@@ -69,6 +70,8 @@ def _parse_unique_violation_columns(exc: BaseException) -> list[str]:
     if not m:
         return []
     return [c.strip() for c in m.group(1).split(",") if c.strip()]
+
+
 # ═══════════════════════════════════════════════════════════════════════════════
 # ENGINE CONFIG
 # ═══════════════════════════════════════════════════════════════════════════════
@@ -347,42 +350,6 @@ class DatabaseFactory:
         result.setdefault("deleted_at", None)
         return result
 
-    def _audit_safe(
-        self,
-        *,
-        action: str,
-        model: Union[type, str],
-        entity_id: Optional[Any],
-        meta: ModelMeta,
-        success: bool,
-        before: Optional[JsonDict],
-        after: Optional[JsonDict],
-        error: Optional[str],
-        engine_name: Optional[str] = None,
-    ) -> None:
-        if not self._audit:
-            return
-        try:
-            changed = None
-            if before and after:
-                changed = [
-                    k for k in set(before) | set(after) if before.get(k) != after.get(k)
-                ] or None
-            self._audit.record(
-                action=action,
-                model=_model_name(model),
-                entity_id=str(entity_id) if entity_id else None,
-                storage_type=meta.storage,
-                provider=engine_name or self._provider_name,
-                success=success,
-                before=before,
-                after=after,
-                changed_fields=changed,
-                error=error,
-            )
-        except Exception as exc:
-            logger.error("Audit recording failed: %s", exc)
-
     def _run(self, fn: Callable[[], Any]) -> Any:
         return fn()
 
@@ -437,7 +404,8 @@ class DatabaseFactory:
                     where = {c: data[c] for c in conflict_cols}
                     logger.warning(
                         "insert %s hit unique violation on %s — falling through to update",
-                        meta.table, conflict_cols,
+                        meta.table,
+                        conflict_cols,
                     )
                     # Drop the conflict columns from the UPDATE SET clause — they're
                     # already the matching key.
@@ -445,8 +413,11 @@ class DatabaseFactory:
                     result = adapters.sql.update(meta.table, where, update_data)
             else:
                 result = adapters.nosql.put(
-                    model if isinstance(model, type)
-                        else type(name, (), {"__polydb__": meta.__dict__}),
+                    (
+                        model
+                        if isinstance(model, type)
+                        else type(name, (), {"__polydb__": meta.__dict__})
+                    ),
                     data,
                 )
             entity_id = result.get("id")
@@ -457,6 +428,7 @@ class DatabaseFactory:
             if self._enable_cache and self._cache:
                 self._cache.invalidate(name)
             return after_plain
+
         try:
             monitor = (
                 PerformanceMonitor(self.metrics, "create", name, None) if self.metrics else None
@@ -467,21 +439,8 @@ class DatabaseFactory:
                     m.rows_affected = 1
                     return result
             return self._run(_op)
-        except Exception as exc:
-            error = str(exc)
+        except Exception:
             raise
-        finally:
-            self._audit_safe(
-                action="create",
-                model=model,
-                entity_id=entity_id,
-                meta=meta,
-                success=success,
-                before=None,
-                after=after_plain,
-                error=error,
-                engine_name=adapters.engine_name,
-            )
 
     # ──────────────────────────────────────────────────────────────────────
     # READ
@@ -645,21 +604,8 @@ class DatabaseFactory:
                     m.rows_affected = 1
                     return result
             return self._run(_op)
-        except Exception as exc:
-            error = str(exc)
+        except Exception:
             raise
-        finally:
-            self._audit_safe(
-                action="update",
-                model=model,
-                entity_id=entity_id if not isinstance(entity_id, dict) else None,
-                meta=meta,
-                success=success,
-                before=before,
-                after=after_plain,
-                error=error,
-                engine_name=adapters.engine_name,
-            )
 
     # ──────────────────────────────────────────────────────────────────────
     # UPSERT
@@ -715,21 +661,8 @@ class DatabaseFactory:
                     m.rows_affected = 1
                     return result
             return self._run(_op)
-        except Exception as exc:
-            error = str(exc)
+        except Exception:
             raise
-        finally:
-            self._audit_safe(
-                action="upsert",
-                model=model,
-                entity_id=None,
-                meta=meta,
-                success=success,
-                before=None,
-                after=after_plain,
-                error=error,
-                engine_name=adapters.engine_name,
-            )
 
     # ──────────────────────────────────────────────────────────────────────
     # DELETE
@@ -795,21 +728,8 @@ class DatabaseFactory:
                     m.rows_affected = 1
                     return result
             return self._run(_op)
-        except Exception as exc:
-            error = str(exc)
+        except Exception:
             raise
-        finally:
-            self._audit_safe(
-                action="delete",
-                model=model,
-                entity_id=entity_id if not isinstance(entity_id, dict) else None,
-                meta=meta,
-                success=success,
-                before=before,
-                after=None,
-                error=error,
-                engine_name=adapters.engine_name,
-            )
 
     # ──────────────────────────────────────────────────────────────────────
     # QUERY (LINQ-style)