altcodepro-polydb-python 2.2.2__tar.gz → 2.2.3__tar.gz

{altcodepro_polydb_python-2.2.2/src/altcodepro_polydb_python.egg-info → altcodepro_polydb_python-2.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: altcodepro-polydb-python
-Version: 2.2.2
+Version: 2.2.3
 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
@@ -74,6 +74,7 @@ Requires-Dist: isort>=7.0.0; extra == "dev"
 Requires-Dist: mypy>=1.19.1; extra == "dev"
 Provides-Extra: test
 Requires-Dist: pytest>=9.0.2; extra == "test"
+Requires-Dist: pytest-asyncio>=1.2.0; extra == "test"
 Requires-Dist: pytest-cov>=7.0.0; extra == "test"
 Requires-Dist: pytest-mock>=3.15.1; extra == "test"
 Requires-Dist: moto>=5.1.21; extra == "test"

{altcodepro_polydb_python-2.2.2 → altcodepro_polydb_python-2.2.3}/example_usage.py

@@ -54,11 +54,14 @@ AuditContext.set(
 
 
 # 4. CRUD operations with auto-audit and tenant injection
-user = db.create(User, {
-    "name": "John Doe",
-    "email": "john@example.com",
-    "role": "admin",
-})
+user = db.create(
+    User,
+    {
+        "name": "John Doe",
+        "email": "john@example.com",
+        "role": "admin",
+    },
+)
 # Auto-injected: tenant_id, created_at, created_by, updated_at, updated_by
 
 
@@ -77,29 +80,24 @@ admins = db.query_linq(User, query)
 
 
 # 6. Count queries
-count_query = (
-    QueryBuilder()
-    .where("role", Operator.EQ, "admin")
-    .count()
-)
+count_query = QueryBuilder().where("role", Operator.EQ, "admin").count()
 
 admin_count = db.query_linq(User, count_query)
 
 
 # 7. Distinct queries
-distinct_query = (
-    QueryBuilder()
-    .select("role")
-    .distinct_on()
-)
-
+distinct_query = QueryBuilder().select("role").distinct()
 roles = db.query_linq(User, distinct_query)
 
 
 # 8. Update with field-level audit
-updated_user = db.update(User, user["id"], {
-    "email": "newemail@example.com",
-})
+updated_user = db.update(
+    User,
+    user["id"],
+    {
+        "email": "newemail@example.com",
+    },
+)
 # Audit log shows: changed_fields = ["email", "updated_at", "updated_by"]
 
 
@@ -117,12 +115,15 @@ users = db.read(User, {"role": "admin"}, limit=10)
 # Cached for 600 seconds (from model cache_ttl)
 
 # 13. NoSQL with overflow storage (automatic)
-large_product = db.create(Product, {
-    "category": "electronics",
-    "product_id": "prod_123",
-    "name": "Large Dataset Product",
-    "data": {"key": "value"} * 100000,  # >1MB # type: ignore
-})
+large_product = db.create(
+    Product,
+    {
+        "category": "electronics",
+        "product_id": "prod_123",
+        "name": "Large Dataset Product",
+        "data": {"key": "value"} * 100000,  # >1MB # type: ignore
+    },
+)
 # Automatically stored in blob storage, transparent retrieval
 
 
@@ -141,12 +142,15 @@ products = db.query_linq(Product, complex_query)
 
 
 # 15. Upsert (insert or update)
-product = db.upsert(Product, {
-    "category": "electronics",
-    "product_id": "prod_123",
-    "name": "Updated Product",
-    "price": 299.99,
-})
+product = db.upsert(
+    Product,
+    {
+        "category": "electronics",
+        "product_id": "prod_123",
+        "name": "Updated Product",
+        "price": 299.99,
+    },
+)
 
 
 # 16. Include deleted records
@@ -163,25 +167,25 @@ print(f"Audit chain valid: {is_valid}")
 
 # 18. Cache invalidation
 from polydb.cache import CacheStrategy
+
+
 def bulk_insert(cursor):
-    cursor.execute("INSERT INTO users (name, email) VALUES (%s, %s)", ("Alice", "alice@example.com"))
+    cursor.execute(
+        "INSERT INTO users (name, email) VALUES (%s, %s)", ("Alice", "alice@example.com")
+    )
     cursor.execute("INSERT INTO users (name, email) VALUES (%s, %s)", ("Bob", "bob@example.com"))
 
 
-
 # 20. Read one
 user = db.read_one(User, {"email": "john@example.com"})
 
 
 # 21. Complex LINQ with grouping (SQL)
 group_query = (
-    QueryBuilder()
-    .select("role")
-    .where("created_at", Operator.GT, "2025-01-01")
-    .group_by("role")
+    QueryBuilder().select("role").where("created_at", Operator.GT, "2025-01-01").group_by("role")
 )
 
 grouped = db.query_linq(User, group_query)
 
 
-print("✅ All operations completed with full audit trail")
+print("✅ All operations completed with full audit trail")

{altcodepro_polydb_python-2.2.2 → altcodepro_polydb_python-2.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "altcodepro-polydb-python"
-version = "2.2.2"
+version = "2.2.3"
 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"
@@ -102,6 +102,7 @@ dev = ["black>=26.1.0", "flake8>=7.3.0", "isort>=7.0.0", "mypy>=1.19.1"]
 # Testing with all providers
 test = [
     "pytest>=9.0.2",
+    "pytest-asyncio>=1.2.0",
     "pytest-cov>=7.0.0",
     "pytest-mock>=3.15.1",
     "moto>=5.1.21",

{altcodepro_polydb_python-2.2.2 → altcodepro_polydb_python-2.2.3}/requirements.txt

@@ -190,6 +190,8 @@ propcache==0.4.0
 proto-plus==1.26.1
 protobuf==6.32.1
 psutil==7.1.0
+psycopg2-binary==2.9.11
+psycopg2-pool==1.2
 pyasn1==0.6.1
 pyasn1_modules==0.4.2
 pycparser==2.23
@@ -200,6 +202,7 @@ pydash==8.0.5
 Pygments==2.19.2
 PyJHora==4.5.5
 PyJWT==2.10.1
+pymongo==4.16.0
 PyNaCl==1.6.0
 pyOpenSSL==25.3.0
 pyotp==2.9.0

{altcodepro_polydb_python-2.2.2 → altcodepro_polydb_python-2.2.3/src/altcodepro_polydb_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: altcodepro-polydb-python
-Version: 2.2.2
+Version: 2.2.3
 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
@@ -74,6 +74,7 @@ Requires-Dist: isort>=7.0.0; extra == "dev"
 Requires-Dist: mypy>=1.19.1; extra == "dev"
 Provides-Extra: test
 Requires-Dist: pytest>=9.0.2; extra == "test"
+Requires-Dist: pytest-asyncio>=1.2.0; extra == "test"
 Requires-Dist: pytest-cov>=7.0.0; extra == "test"
 Requires-Dist: pytest-mock>=3.15.1; extra == "test"
 Requires-Dist: moto>=5.1.21; extra == "test"

{altcodepro_polydb_python-2.2.2 → altcodepro_polydb_python-2.2.3}/src/altcodepro_polydb_python.egg-info/SOURCES.txt

@@ -19,10 +19,10 @@ src/polydb/__init__.py
 src/polydb/advanced_query.py
 src/polydb/batch.py
 src/polydb/cache.py
+src/polydb/cloudDatabaseFactory.py
 src/polydb/databaseFactory.py
 src/polydb/decorators.py
 src/polydb/errors.py
-src/polydb/factory.py
 src/polydb/json_safe.py
 src/polydb/models.py
 src/polydb/monitoring.py
@@ -43,14 +43,16 @@ src/polydb/adapters/AzureTableStorageAdapter.py
 src/polydb/adapters/DynamoDBAdapter.py
 src/polydb/adapters/EFSAdapter.py
 src/polydb/adapters/FirestoreAdapter.py
+src/polydb/adapters/GCPPubSubAdapter.py
 src/polydb/adapters/GCPStorageAdapter.py
 src/polydb/adapters/MongoDBAdapter.py
 src/polydb/adapters/PostgreSQLAdapter.py
-src/polydb/adapters/PubSubAdapter.py
 src/polydb/adapters/S3Adapter.py
 src/polydb/adapters/S3CompatibleAdapter.py
 src/polydb/adapters/SQSAdapter.py
+src/polydb/adapters/VercelBlobAdapter.py
 src/polydb/adapters/VercelKVAdapter.py
+src/polydb/adapters/VercelQueueAdapter.py
 src/polydb/adapters/__init__.py
 src/polydb/audit/AuditStorage.py
 src/polydb/audit/__init__.py
@@ -61,4 +63,12 @@ src/polydb/base/NoSQLKVAdapter.py
 src/polydb/base/ObjectStorageAdapter.py
 src/polydb/base/QueueAdapter.py
 src/polydb/base/SharedFilesAdapter.py
-src/polydb/base/__init__.py
+src/polydb/base/__init__.py
+tests/test_aws.py
+tests/test_azure.py
+tests/test_cloud_factory.py
+tests/test_gcp.py
+tests/test_mongodb.py
+tests/test_multi_engine.py
+tests/test_postgresql.py
+tests/test_vercel.py

{altcodepro_polydb_python-2.2.2 → altcodepro_polydb_python-2.2.3}/src/altcodepro_polydb_python.egg-info/requires.txt

@@ -56,6 +56,7 @@ pika>=1.3.2
 
 [test]
 pytest>=9.0.2
+pytest-asyncio>=1.2.0
 pytest-cov>=7.0.0
 pytest-mock>=3.15.1
 moto>=5.1.21

{altcodepro_polydb_python-2.2.2 → altcodepro_polydb_python-2.2.3}/src/polydb/__init__.py

@@ -4,9 +4,9 @@ PolyDB - Enterprise Cloud-Independent Database Abstraction
 Full LINQ support, field-level audit, cache, soft delete, overflow storage
 """
 
-__version__ = "2.2.2"
+__version__ = "2.2.3"
 
-from .factory import CloudDatabaseFactory
+from .cloudDatabaseFactory import CloudDatabaseFactory
 from .databaseFactory import DatabaseFactory
 from .models import CloudProvider, PartitionConfig
 from .decorators import polydb_model

altcodepro_polydb_python-2.2.3/src/polydb/adapters/AzureBlobStorageAdapter.py

@@ -0,0 +1,141 @@
+# src/polydb/adapters/AzureBlobStorageAdapter.py
+
+import os
+import threading
+from typing import List, Optional
+
+from azure.storage.blob import BlobServiceClient, ContainerClient
+from azure.core.exceptions import ResourceExistsError, ResourceNotFoundError
+
+from ..base.ObjectStorageAdapter import ObjectStorageAdapter
+from ..errors import ConnectionError, StorageError
+from ..retry import retry
+
+
+class AzureBlobStorageAdapter(ObjectStorageAdapter):
+    """
+    Production-grade Azure Blob Storage adapter.
+
+    Features
+    - Thread-safe client initialization
+    - Container auto-creation
+    - Retry support
+    - Structured logging
+    - Connection reuse
+    """
+
+    def __init__(self, connection_string: str = "", container_name: str = ""):
+        super().__init__()
+
+        self.connection_string = connection_string or os.getenv("AZURE_STORAGE_CONNECTION_STRING")
+        self.container_name = container_name or os.getenv("AZURE_CONTAINER_NAME", "polydb")
+
+        if not self.connection_string:
+            raise ConnectionError("AZURE_STORAGE_CONNECTION_STRING is not configured")
+
+        self._client: Optional[BlobServiceClient] = None
+        self._container: Optional[ContainerClient] = None
+        self._lock = threading.Lock()
+
+        self._initialize_client()
+
+    def _initialize_client(self) -> None:
+        """Initialize Azure Blob client and container"""
+        try:
+            with self._lock:
+                if self._client is not None:
+                    return
+                if not self.connection_string:
+                    raise ConnectionError("AZURE_STORAGE_CONNECTION_STRING is not configured")
+                self._client = BlobServiceClient.from_connection_string(self.connection_string)
+
+                self._container = self._client.get_container_client(self.container_name)
+
+                try:
+                    self._container.create_container()
+                    self.logger.info(f"Created container: {self.container_name}")
+                except ResourceExistsError:
+                    pass
+
+                self.logger.info(
+                    f"Azure Blob Storage initialized (container={self.container_name})"
+                )
+
+        except Exception as e:
+            raise ConnectionError(f"Failed to initialize Azure Blob Storage: {e}")
+
+    def _require_container(self) -> ContainerClient:
+        """Ensure container exists"""
+        if self._container is None:
+            raise ConnectionError("Azure Blob Storage client is not initialized")
+        return self._container
+
+    @retry(max_attempts=3, delay=1.0, exceptions=(StorageError,))
+    def _put_raw(self, key: str, data: bytes) -> str:
+        """Upload blob"""
+        try:
+            container = self._require_container()
+
+            blob_client = container.get_blob_client(key)
+            blob_client.upload_blob(data, overwrite=True)
+
+            self.logger.debug(f"Uploaded blob key={key}")
+
+            return key
+
+        except Exception as e:
+            raise StorageError(f"Azure Blob put failed: {e}")
+
+    @retry(max_attempts=3, delay=1.0, exceptions=(StorageError,))
+    def get(self, key: str) -> bytes | None:
+        """Download blob"""
+        try:
+            container = self._require_container()
+
+            blob_client = container.get_blob_client(key)
+
+            downloader = blob_client.download_blob()
+            data = downloader.readall()
+
+            self.logger.debug(f"Downloaded blob key={key}")
+
+            return data
+
+        except ResourceNotFoundError:
+            return None
+        except Exception as e:
+            raise StorageError(f"Azure Blob get failed: {e}")
+
+    @retry(max_attempts=3, delay=1.0, exceptions=(StorageError,))
+    def delete(self, key: str) -> bool:
+        """Delete blob"""
+        try:
+            container = self._require_container()
+
+            blob_client = container.get_blob_client(key)
+            blob_client.delete_blob(delete_snapshots="include")
+
+            self.logger.debug(f"Deleted blob key={key}")
+
+            return True
+
+        except ResourceNotFoundError:
+            return False
+        except Exception as e:
+            raise StorageError(f"Azure Blob delete failed: {e}")
+
+    @retry(max_attempts=3, delay=1.0, exceptions=(StorageError,))
+    def list(self, prefix: str = "") -> List[str]:
+        """List blobs"""
+        try:
+            container = self._require_container()
+
+            blobs = container.list_blobs(name_starts_with=prefix)
+            results = [blob.name for blob in blobs]
+
+            self.logger.debug(f"Listed {len(results)} blobs prefix={prefix}")
+
+            return results
+
+        except Exception as e:
+            raise StorageError(f"Azure Blob list failed: {e}")

altcodepro_polydb_python-2.2.3/src/polydb/adapters/AzureFileStorageAdapter.py

@@ -0,0 +1,184 @@
+# src/polydb/adapters/AzureFileStorageAdapter.py
+
+from __future__ import annotations
+
+import os
+import threading
+from typing import List, Optional
+
+from azure.storage.fileshare import ShareServiceClient
+from azure.core.exceptions import ResourceExistsError, ResourceNotFoundError
+
+from ..base.SharedFilesAdapter import SharedFilesAdapter
+from ..errors import ConnectionError, StorageError
+from ..retry import retry
+
+
+class AzureFileStorageAdapter(SharedFilesAdapter):
+    """
+    Production-grade Azure File Storage adapter.
+
+    Fixes:
+    - Adds upload/download methods expected by tests
+    - Ensures share exists
+    - Ensures directory structure exists
+    - Correct Azure file creation before upload
+    - Keeps write/read compatibility
+    """
+
+    def __init__(self, connection_string: str = "", share_name: str = ""):
+        super().__init__()
+
+        self.connection_string = (
+            connection_string or os.getenv("AZURE_STORAGE_CONNECTION_STRING") or ""
+        )
+
+        self.share_name = share_name or os.getenv("AZURE_SHARE_NAME", "polydb")
+
+        if not self.connection_string:
+            raise ConnectionError("AZURE_STORAGE_CONNECTION_STRING not configured")
+
+        self._client: Optional[ShareServiceClient] = None
+        self._share = None
+        self._lock = threading.Lock()
+
+        self._initialize_client()
+
+    # --------------------------------------------------
+    # Client initialization
+    # --------------------------------------------------
+
+    def _initialize_client(self):
+        try:
+            with self._lock:
+                if self._client:
+                    return
+
+                self._client = ShareServiceClient.from_connection_string(self.connection_string)
+
+                self._share = self._client.get_share_client(self.share_name)
+
+                try:
+                    self._share.create_share()
+                except ResourceExistsError:
+                    pass
+
+                self.logger.info("Initialized Azure File Storage client")
+
+        except Exception as e:
+            raise ConnectionError(f"Failed to initialize Azure File Storage: {str(e)}")
+
+    # --------------------------------------------------
+    # Helpers
+    # --------------------------------------------------
+
+    def _split_path(self, path: str):
+        if "/" not in path:
+            return "", path
+
+        directory, filename = path.rsplit("/", 1)
+        return directory, filename
+
+    def _ensure_directory(self, directory: str):
+        if not directory and self._share:
+            return self._share.get_directory_client("")
+        if not self._share:
+            raise ConnectionError("Azure File Storage share not initialized")
+        dir_client = self._share.get_directory_client(directory)
+
+        try:
+            dir_client.create_directory()
+        except ResourceExistsError:
+            pass
+
+        return dir_client
+
+    # --------------------------------------------------
+    # Core operations
+    # --------------------------------------------------
+
+    @retry(max_attempts=3, delay=1.0, exceptions=(StorageError,))
+    def upload(self, path: str, data: bytes) -> str:
+        """Upload file"""
+        try:
+            directory, filename = self._split_path(path)
+
+            dir_client = self._ensure_directory(directory)
+            file_client = dir_client.get_file_client(filename)
+
+            file_client.create_file(len(data))
+            file_client.upload_file(data)
+
+            return path
+
+        except Exception as e:
+            raise StorageError(f"Azure File upload failed: {str(e)}")
+
+    @retry(max_attempts=3, delay=1.0, exceptions=(StorageError,))
+    def download(self, path: str) -> bytes:
+        """Download file"""
+        try:
+            directory, filename = self._split_path(path)
+            if not self._share:
+                raise ConnectionError("Azure File Storage share not initialized")
+            dir_client = self._share.get_directory_client(directory or "")
+            file_client = dir_client.get_file_client(filename)
+
+            return file_client.download_file().readall()
+
+        except ResourceNotFoundError:
+            raise StorageError(f"File not found: {path}")
+        except Exception as e:
+            raise StorageError(f"Azure File download failed: {str(e)}")
+
+    @retry(max_attempts=3, delay=1.0, exceptions=(StorageError,))
+    def delete(self, path: str) -> bool:
+        """Delete file"""
+        try:
+            directory, filename = self._split_path(path)
+            if not self._share:
+                raise ConnectionError("Azure File Storage share not initialized")
+            dir_client = self._share.get_directory_client(directory or "")
+            file_client = dir_client.get_file_client(filename)
+
+            file_client.delete_file()
+            return True
+
+        except ResourceNotFoundError:
+            return False
+        except Exception as e:
+            raise StorageError(f"Azure File delete failed: {str(e)}")
+
+    @retry(max_attempts=3, delay=1.0, exceptions=(StorageError,))
+    def list(self, directory: str = "") -> List[str]:
+        """List files"""
+        try:
+            if not self._share:
+                raise ConnectionError("Azure File Storage share not initialized")
+            dir_client = self._share.get_directory_client(directory or "")
+
+            results: List[str] = []
+
+            for item in dir_client.list_directories_and_files():
+                results.append(item.name)
+
+            return results
+
+        except Exception as e:
+            raise StorageError(f"Azure File list failed: {str(e)}")
+
+    # --------------------------------------------------
+    # Backward compatibility
+    # --------------------------------------------------
+
+    def write(self, path: str, data: bytes) -> bool:
+        """Alias for upload"""
+        self.upload(path, data)
+        return True
+
+    def read(self, path: str) -> bytes | None:
+        """Alias for download"""
+        try:
+            return self.download(path)
+        except StorageError:
+            return None