srx-lib-azure 0.1.3__tar.gz → 0.1.5__tar.gz

{srx_lib_azure-0.1.3 → srx_lib_azure-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: srx-lib-azure
-Version: 0.1.3
+Version: 0.1.5
 Summary: Azure helpers for SRX services: Blob, Email, Table
 Author-email: SRX <dev@srx.id>
 Requires-Python: >=3.12

{srx_lib_azure-0.1.3 → srx_lib_azure-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "srx-lib-azure"
-version = "0.1.3"
+version = "0.1.5"
 description = "Azure helpers for SRX services: Blob, Email, Table"
 readme = "README.md"
 requires-python = ">=3.12"

{srx_lib_azure-0.1.3 → srx_lib_azure-0.1.5}/src/srx_lib_azure/blob.py

@@ -1,4 +1,5 @@
 import os
+import tempfile
 from datetime import datetime, timedelta, timezone
 from typing import Optional, BinaryIO, Tuple
 
@@ -111,3 +112,77 @@ class AzureBlobService:
             logger.error(f"Failed to upload stream to {blob_path}: {e}")
             return None
 
+    async def download_file(self, blob_path: str) -> Optional[bytes]:
+        """Download a blob's content as bytes."""
+        if not self.connection_string:
+            logger.error("Azure Storage connection string not configured")
+            return None
+        try:
+            client = self._get_blob_service()
+            container = client.get_container_client(self.container_name)
+            blob_client = container.get_blob_client(blob_path)
+            download_stream = blob_client.download_blob()
+            content = download_stream.readall()
+            logger.info(f"Successfully downloaded {blob_path}")
+            return content
+        except Exception as e:
+            logger.error(f"Failed to download {blob_path}: {e}")
+            return None
+
+    async def download_to_temp_file(self, blob_path: str) -> Optional[str]:
+        """Download a blob to a temporary file and return its path."""
+        content = await self.download_file(blob_path)
+        if content is None:
+            return None
+        try:
+            with tempfile.NamedTemporaryFile(delete=False, suffix=os.path.splitext(blob_path)[1]) as tf:
+                tf.write(content)
+                path = tf.name
+            logger.info(f"Downloaded {blob_path} to temporary file: {path}")
+            return path
+        except Exception as e:
+            logger.error(f"Failed to create temporary file for {blob_path}: {e}")
+            return None
+
+    def get_blob_url(self, blob_path: str, generate_sas: bool = True) -> Optional[str]:
+        """Get a direct URL for a blob; optionally generate a SAS URL."""
+        if generate_sas:
+            try:
+                return self._generate_sas_url(blob_path)
+            except Exception as e:
+                logger.error(f"Failed to generate SAS URL for {blob_path}: {e}")
+                return None
+        if self.base_blob_url:
+            return f"{self.base_blob_url.rstrip('/')}/{blob_path}"
+        logger.error("Cannot generate blob URL without base URL")
+        return None
+
+    async def delete_file(self, blob_path: str) -> bool:
+        """Delete a blob and return True on success."""
+        if not self.connection_string:
+            logger.error("Azure Storage connection string not configured")
+            return False
+        try:
+            client = self._get_blob_service()
+            container = client.get_container_client(self.container_name)
+            blob_client = container.get_blob_client(blob_path)
+            blob_client.delete_blob()
+            logger.info(f"Successfully deleted {blob_path}")
+            return True
+        except Exception as e:
+            logger.error(f"Failed to delete {blob_path}: {e}")
+            return False
+
+    async def file_exists(self, blob_path: str) -> bool:
+        """Check if a blob exists in the container."""
+        if not self.connection_string:
+            logger.error("Azure Storage connection string not configured")
+            return False
+        try:
+            client = self._get_blob_service()
+            container = client.get_container_client(self.container_name)
+            blob_client = container.get_blob_client(blob_path)
+            return blob_client.exists()
+        except Exception as e:
+            logger.error(f"Failed to check existence of {blob_path}: {e}")
+            return False

{srx_lib_azure-0.1.3 → srx_lib_azure-0.1.5}/src/srx_lib_azure/email.py

@@ -1,22 +1,41 @@
 import os
-from azure.communication.email.aio import EmailClient
-
 import logging
+from typing import Dict, Any
+
+try:
+    from azure.communication.email.aio import EmailClient
+except Exception:  # pragma: no cover - optional dependency at import time
+    EmailClient = None  # type: ignore
 
 logger = logging.getLogger(__name__)
 
 
 class EmailService:
-    """Thin wrapper over Azure Communication Services EmailClient."""
+    """Thin wrapper over Azure Communication Services EmailClient.
+
+    Does not raise on missing configuration to keep the library optional.
+    If not configured, send calls are skipped with a warning and a 'skipped' status.
+    """
 
     def __init__(self):
         self.connection_string = os.getenv("ACS_CONNECTION_STRING")
         self.sender_address = os.getenv("EMAIL_SENDER")
-        if not self.connection_string or not self.sender_address:
-            raise ValueError("Missing ACS_CONNECTION_STRING or EMAIL_SENDER in environment variables")
-        self.email_client = EmailClient.from_connection_string(self.connection_string)
+        if not self.connection_string or not self.sender_address or EmailClient is None:
+            self.email_client = None
+            logger.warning(
+                "EmailService not configured (missing ACS_CONNECTION_STRING/EMAIL_SENDER or azure SDK). Calls will be skipped."
+            )
+        else:
+            try:
+                self.email_client = EmailClient.from_connection_string(self.connection_string)
+            except Exception as e:
+                self.email_client = None
+                logger.warning("EmailService initialization failed: %s", e)
 
-    async def send_notification(self, recipient: str, subject: str, body: str, html: bool = False):
+    async def send_notification(self, recipient: str, subject: str, body: str, html: bool = False) -> Dict[str, Any]:
+        if not self.email_client or not self.sender_address:
+            logger.warning("Email skipped: service not configured")
+            return {"status": "skipped", "message": "Email service not configured"}
         message = {
             "content": {"subject": subject},
             "recipients": {"to": [{"address": recipient}]},
@@ -38,4 +57,3 @@ class EmailService:
         except Exception as e:
             logger.error("Email send exception: %s", e)
             return {"status": "error", "message": str(e)}
-