altcodepro-polydb-python 2.2.4__tar.gz → 2.2.5__tar.gz

{altcodepro_polydb_python-2.2.4/src/altcodepro_polydb_python.egg-info → altcodepro_polydb_python-2.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: altcodepro-polydb-python
-Version: 2.2.4
+Version: 2.2.5
 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.2.4 → altcodepro_polydb_python-2.2.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "altcodepro-polydb-python"
-version = "2.2.4"
+version = "2.2.5"
 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.8"

{altcodepro_polydb_python-2.2.4 → altcodepro_polydb_python-2.2.5/src/altcodepro_polydb_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: altcodepro-polydb-python
-Version: 2.2.4
+Version: 2.2.5
 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.2.4 → altcodepro_polydb_python-2.2.5}/src/altcodepro_polydb_python.egg-info/SOURCES.txt

@@ -62,6 +62,7 @@ src/polydb/audit/__init__.py
 src/polydb/audit/context.py
 src/polydb/audit/manager.py
 src/polydb/audit/models.py
+src/polydb/base/DataAccessRuntime.py
 src/polydb/base/NoSQLKVAdapter.py
 src/polydb/base/ObjectStorageAdapter.py
 src/polydb/base/QueueAdapter.py

altcodepro_polydb_python-2.2.5/src/polydb/base/DataAccessRuntime.py

@@ -0,0 +1,101 @@
+from typing import Protocol, Any, Dict, List, Optional, Tuple, Union
+
+
+# -------------------------------
+# SQL ADAPTER CONTRACT
+# -------------------------------
+class SQLAdapter(Protocol):
+    def insert(self, table: str, data: Dict[str, Any]) -> Dict[str, Any]: ...
+    def select(
+        self,
+        table: str,
+        query: Dict[str, Any],
+        limit: Optional[int] = None,
+        offset: Optional[int] = None,
+    ) -> List[Dict[str, Any]]: ...
+    def select_page(
+        self, table: str, query: Dict[str, Any], page_size: int, continuation_token: Optional[str]
+    ) -> Tuple[List[Dict[str, Any]], Optional[str]]: ...
+    def update(self, table: str, entity_id: Any, data: Dict[str, Any]) -> Dict[str, Any]: ...
+    def delete(self, table: str, entity_id: Any) -> Dict[str, Any]: ...
+    def upsert(self, table: str, data: Dict[str, Any]) -> Dict[str, Any]: ...
+    def query_linq(self, table: str, builder: Any) -> Union[List[Dict[str, Any]], int]: ...
+    def execute(self, sql: str, params: Optional[List[Any]] = None) -> Any: ...
+
+
+# -------------------------------
+# NOSQL ADAPTER CONTRACT
+# -------------------------------
+class NoSQLAdapter(Protocol):
+    def put(self, model: type, data: Dict[str, Any]) -> Dict[str, Any]: ...
+    def query(
+        self, model: type, query: Dict[str, Any], limit: Optional[int] = None
+    ) -> List[Dict[str, Any]]: ...
+    def query_page(
+        self, model: type, query: Dict[str, Any], page_size: int, continuation_token: Optional[str]
+    ) -> Tuple[List[Dict[str, Any]], Optional[str]]: ...
+    def patch(self, model: type, entity_id: Any, data: Dict[str, Any]) -> Dict[str, Any]: ...
+    def delete(self, model: type, entity_id: Any) -> Dict[str, Any]: ...
+    def upsert(self, model: type, data: Dict[str, Any]) -> Dict[str, Any]: ...
+    def query_linq(self, model: type, builder: Any) -> Union[List[Dict[str, Any]], int]: ...
+
+
+# -------------------------------
+# OBJECT STORAGE
+# -------------------------------
+class ObjectStorage(Protocol):
+    def put(self, key: str, data: bytes, **kwargs) -> str: ...
+    def get(self, key: str) -> Optional[bytes]: ...
+    def delete(self, key: str) -> bool: ...
+    def list(self, prefix: str = "") -> List[str]: ...
+
+
+# -------------------------------
+# QUEUE (FIXED)
+# -------------------------------
+class QueueService(Protocol):
+    def publish(
+        self, queue_name: str, message: Dict[str, Any], delay: Optional[int] = None
+    ) -> None: ...
+    def consume(
+        self, queue_name: str, max_messages: int, wait_seconds: int
+    ) -> List[Dict[str, Any]]: ...
+    def ack(self, queue_name: str, receipt_handle: str) -> None: ...
+    def nack(self, queue_name: str, receipt_handle: str, delay: Optional[int] = None) -> None: ...
+
+
+# -------------------------------
+# CACHE
+# -------------------------------
+class CacheService(Protocol):
+    def set(self, key: str, value: Any, ttl: int) -> None: ...
+    def get(self, key: str) -> Optional[Any]: ...
+    def delete(self, key: str) -> None: ...
+
+
+# -------------------------------
+# FINAL RUNTIME CONTRACT
+# -------------------------------
+class DataAccessRuntime(Protocol):
+
+    # high-level CRUD (used by UDL)
+    def create(self, model: Any, data: Dict[str, Any]) -> Dict[str, Any]: ...
+    def read(
+        self,
+        model: Any,
+        query: Dict[str, Any],
+        limit: Optional[int] = None,
+        offset: Optional[int] = None,
+    ) -> List[Dict[str, Any]]: ...
+    def read_one(self, model: Any, query: Dict[str, Any]) -> Optional[Dict[str, Any]]: ...
+    def update(self, model: Any, entity_id: Any, data: Dict[str, Any]) -> Dict[str, Any]: ...
+    def delete(self, model: Any, entity_id: Any) -> Any: ...
+    def upsert(self, model: Any, data: Dict[str, Any]) -> Dict[str, Any]: ...
+    def query_linq(self, model: Any, builder: Any) -> Union[List[Dict[str, Any]], int]: ...
+
+    # adapters (CRITICAL)
+    def get_sql(self) -> SQLAdapter: ...
+    def get_nosql_kv(self) -> NoSQLAdapter: ...
+    def get_object_storage(self) -> ObjectStorage: ...
+    def get_queue(self) -> QueueService: ...
+    def get_cache(self) -> CacheService: ...

{altcodepro_polydb_python-2.2.4 → altcodepro_polydb_python-2.2.5}/src/polydb/base/NoSQLKVAdapter.py

@@ -6,6 +6,7 @@ import json
 import threading
 from typing import Any, Dict, List, Optional, Tuple, Union, TYPE_CHECKING, cast
 
+
 from ..json_safe import json_safe
 
 from ..errors import NoSQLError, StorageError
@@ -20,7 +21,10 @@ if TYPE_CHECKING:
 class NoSQLKVAdapter:
     """Base with auto-overflow and LINQ support"""
 
-    def __init__(self, partition_config: Optional[PartitionConfig] = None):
+    def __init__(
+        self,
+        partition_config: Optional[PartitionConfig] = None,
+    ):
         from ..utils import setup_logger
 
         self.logger = setup_logger(self.__class__.__name__)

{altcodepro_polydb_python-2.2.4 → altcodepro_polydb_python-2.2.5}/src/polydb/cloudDatabaseFactory.py

@@ -4,6 +4,13 @@ import os
 import threading
 from typing import Dict, List, Optional
 
+from .adapters.PostgreSQLAdapter import PostgreSQLAdapter
+from .adapters.AzureBlobStorageAdapter import AzureBlobStorageAdapter
+from .adapters.BlockchainBlobAdapter import BlockchainBlobAdapter
+from .adapters.GCPStorageAdapter import GCPStorageAdapter
+from .adapters.S3CompatibleAdapter import S3CompatibleAdapter
+from .adapters.VercelBlobAdapter import VercelBlobAdapter
+
 from .models import (
     AzureStorageConfig,
     BlockchainStorageConfig,
@@ -46,7 +53,15 @@ class CloudDatabaseFactory:
             for cfg in storage_configs:
                 self.configs[cfg.name] = cfg
 
-        self.instances: Dict[str, object] = {}
+        self.instances: Dict[
+            str,
+            PostgreSQLAdapter
+            | AzureBlobStorageAdapter
+            | S3CompatibleAdapter
+            | GCPStorageAdapter
+            | VercelBlobAdapter
+            | BlockchainBlobAdapter,
+        ] = {}
         self._lock = threading.Lock()
 
         self.logger.info(f"Factory initialized (default provider={self.provider.value})")
@@ -76,7 +91,16 @@ class CloudDatabaseFactory:
     # --------------------------------------------------------
     # OBJECT STORAGE
     # --------------------------------------------------------
-    def get_object_storage(self, name: str = "default"):
+    def get_object_storage(
+        self, name: str = "default"
+    ) -> (
+        PostgreSQLAdapter
+        | AzureBlobStorageAdapter
+        | S3CompatibleAdapter
+        | GCPStorageAdapter
+        | VercelBlobAdapter
+        | BlockchainBlobAdapter
+    ):
         with self._lock:
             if name in self.instances:
                 return self.instances[name]