trovesuite 1.0.5__tar.gz → 1.0.7__tar.gz

{trovesuite-1.0.5/src/trovesuite.egg-info → trovesuite-1.0.7}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: trovesuite
-Version: 1.0.5
-Summary: TroveSuite services package providing authentication, authorization, notifications, and other enterprise services for TroveSuite applications
+Version: 1.0.7
+Summary: TroveSuite services package providing authentication, authorization, notifications, Azure Storage, and other enterprise services for TroveSuite applications
 Home-page: https://dev.azure.com/brightgclt/trovesuite/_git/packages
 Author: Bright Debrah Owusu
 Author-email: Bright Debrah Owusu <owusu.debrah@deladetech.com>
@@ -11,7 +11,7 @@ Project-URL: Homepage, https://dev.azure.com/brightgclt/trovesuite/_git/packages
 Project-URL: Repository, https://dev.azure.com/brightgclt/trovesuite/_git/packages
 Project-URL: Documentation, https://dev.azure.com/brightgclt/trovesuite/_git/packages
 Project-URL: Bug Tracker, https://dev.azure.com/brightgclt/trovesuite/_workitems/create
-Keywords: authentication,authorization,notifications,jwt,trovesuite,fastapi,security,tenant,permissions,enterprise,services
+Keywords: authentication,authorization,notifications,jwt,trovesuite,fastapi,security,tenant,permissions,enterprise,services,azure,storage,blob,cloud-storage
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -36,6 +36,8 @@ Requires-Dist: passlib[bcrypt]>=1.7.4
 Requires-Dist: passlib[argon2]<2.0.0,>=1.7.4
 Requires-Dist: uvicorn<0.39.0,>=0.38.0
 Requires-Dist: pyjwt<3.0.0,>=2.10.1
+Requires-Dist: azure-storage-blob>=12.19.0
+Requires-Dist: azure-identity>=1.15.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.4.2; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.1; extra == "dev"
@@ -119,6 +121,8 @@ poetry install --with dev
 
 ## Quick Start
 
+> **✅ Package Status**: All import issues have been resolved in version 1.0.5. The package now works correctly when installed from PyPI or wheel files.
+
 ### Import Patterns
 
 The package provides clean, simplified import patterns:
@@ -673,12 +677,62 @@ poetry install
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+## Troubleshooting
+
+### Import Issues
+
+If you encounter import errors, make sure you're using the correct import patterns:
+
+```python
+# ✅ Correct imports
+from trovesuite import AuthService, NotificationService
+from trovesuite.auth import AuthServiceWriteDto
+from trovesuite.notification import NotificationEmailServiceWriteDto
+
+# ❌ Incorrect imports (will fail)
+from trovesuite.auth.auth_write_dto import AuthServiceWriteDto  # Too specific
+from trovesuite.notification.notification_write_dto import NotificationEmailServiceWriteDto  # Too specific
+```
+
+### Package Installation
+
+If you're having issues with the package installation:
+
+1. **Make sure you have the latest version**:
+   ```bash
+   pip install --upgrade trovesuite
+   ```
+
+2. **Force reinstall if needed**:
+   ```bash
+   pip install --force-reinstall trovesuite
+   ```
+
+3. **Check your Python environment**:
+   ```bash
+   python -c "import trovesuite; print('Package installed successfully')"
+   ```
+
+### Common Issues
+
+- **ImportError: No module named 'src'**: This was fixed in version 1.0.5. Update to the latest version.
+- **AttributeError: module has no attribute 'AuthServiceWriteDto'**: Use `from trovesuite.auth import AuthServiceWriteDto` instead of importing from the main package.
+
 ## Support
 
 For support, email brightgclt@gmail.com or create a work item in the [Azure DevOps repository](https://dev.azure.com/brightgclt/trovesuite/_workitems/create).
 
 ## Changelog
 
+### 1.0.5
+- Fixed all import issues across auth, notification, and entities modules
+- Changed absolute imports (`from src.trovesuite.`) to relative imports (`from .` and `from ..`)
+- Ensured package works correctly when installed from PyPI or wheel
+- Added service write DTOs to module exports for easier usage
+- Updated documentation with simplified import patterns
+- All services and DTOs now import correctly in clean environments
+- Package builds and installs without import errors
+
 ### 1.0.8
 - Restructured package for direct service imports
 - Added comprehensive notification services with email support

{trovesuite-1.0.5 → trovesuite-1.0.7}/README.md

@@ -66,6 +66,8 @@ poetry install --with dev
 
 ## Quick Start
 
+> **✅ Package Status**: All import issues have been resolved in version 1.0.5. The package now works correctly when installed from PyPI or wheel files.
+
 ### Import Patterns
 
 The package provides clean, simplified import patterns:
@@ -620,12 +622,62 @@ poetry install
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+## Troubleshooting
+
+### Import Issues
+
+If you encounter import errors, make sure you're using the correct import patterns:
+
+```python
+# ✅ Correct imports
+from trovesuite import AuthService, NotificationService
+from trovesuite.auth import AuthServiceWriteDto
+from trovesuite.notification import NotificationEmailServiceWriteDto
+
+# ❌ Incorrect imports (will fail)
+from trovesuite.auth.auth_write_dto import AuthServiceWriteDto  # Too specific
+from trovesuite.notification.notification_write_dto import NotificationEmailServiceWriteDto  # Too specific
+```
+
+### Package Installation
+
+If you're having issues with the package installation:
+
+1. **Make sure you have the latest version**:
+   ```bash
+   pip install --upgrade trovesuite
+   ```
+
+2. **Force reinstall if needed**:
+   ```bash
+   pip install --force-reinstall trovesuite
+   ```
+
+3. **Check your Python environment**:
+   ```bash
+   python -c "import trovesuite; print('Package installed successfully')"
+   ```
+
+### Common Issues
+
+- **ImportError: No module named 'src'**: This was fixed in version 1.0.5. Update to the latest version.
+- **AttributeError: module has no attribute 'AuthServiceWriteDto'**: Use `from trovesuite.auth import AuthServiceWriteDto` instead of importing from the main package.
+
 ## Support
 
 For support, email brightgclt@gmail.com or create a work item in the [Azure DevOps repository](https://dev.azure.com/brightgclt/trovesuite/_workitems/create).
 
 ## Changelog
 
+### 1.0.5
+- Fixed all import issues across auth, notification, and entities modules
+- Changed absolute imports (`from src.trovesuite.`) to relative imports (`from .` and `from ..`)
+- Ensured package works correctly when installed from PyPI or wheel
+- Added service write DTOs to module exports for easier usage
+- Updated documentation with simplified import patterns
+- All services and DTOs now import correctly in clean environments
+- Package builds and installs without import errors
+
 ### 1.0.8
 - Restructured package for direct service imports
 - Added comprehensive notification services with email support

{trovesuite-1.0.5 → trovesuite-1.0.7}/pyproject.toml

@@ -4,15 +4,15 @@ build-backend = "setuptools.build_meta"
 
 [tool.poetry]
 name = "trovesuite"
-version = "1.0.5"
-description = "TroveSuite services package providing authentication, authorization, notifications, and other enterprise services for TroveSuite applications"
+version = "1.0.7"
+description = "TroveSuite services package providing authentication, authorization, notifications, Azure Storage, and other enterprise services for TroveSuite applications"
 authors = ["brightgclt <brightgclt@gmail.com>"]
 license = "MIT"
 readme = "README.md"
 homepage = "https://dev.azure.com/brightgclt/trovesuite/_git/packages"
 repository = "https://dev.azure.com/brightgclt/trovesuite/_git/packages"
 documentation = "https://dev.azure.com/brightgclt/trovesuite/_git/packages"
-keywords = ["authentication", "authorization", "notifications", "jwt", "trovesuite", "fastapi", "security", "tenant", "permissions", "enterprise", "services"]
+keywords = ["authentication", "authorization", "notifications", "jwt", "trovesuite", "fastapi", "security", "tenant", "permissions", "enterprise", "services", "azure", "storage", "blob", "cloud-storage"]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
@@ -36,6 +36,8 @@ python-dotenv = "^1.0.0"
 python-multipart = "^0.0.6"
 python-jose = {extras = ["cryptography"], version = "^3.3.0"}
 passlib = {extras = ["bcrypt"], version = "^1.7.4"}
+azure-storage-blob = "^12.19.0"
+azure-identity = "^1.15.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.4.2"
@@ -56,8 +58,8 @@ Documentation = "https://dev.azure.com/brightgclt/trovesuite/_git/packages"
 
 [project]
 name = "trovesuite"
-version = "1.0.5"
-description = "TroveSuite services package providing authentication, authorization, notifications, and other enterprise services for TroveSuite applications"
+version = "1.0.7"
+description = "TroveSuite services package providing authentication, authorization, notifications, Azure Storage, and other enterprise services for TroveSuite applications"
 readme = "README.md"
 license = {text = "MIT"}
 authors = [
@@ -66,7 +68,7 @@ authors = [
 maintainers = [
     {name = "Bright Debrah Owusu", email = "owusu.debrah@deladetech.com"}
 ]
-keywords = ["authentication", "authorization", "notifications", "jwt", "trovesuite", "fastapi", "security", "tenant", "permissions", "enterprise", "services"]
+keywords = ["authentication", "authorization", "notifications", "jwt", "trovesuite", "fastapi", "security", "tenant", "permissions", "enterprise", "services", "azure", "storage", "blob", "cloud-storage"]
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
@@ -91,7 +93,9 @@ dependencies = [
     "passlib[bcrypt]>=1.7.4",
     "passlib[argon2] (>=1.7.4,<2.0.0)",
     "uvicorn (>=0.38.0,<0.39.0)",
-    "pyjwt (>=2.10.1,<3.0.0)"
+    "pyjwt (>=2.10.1,<3.0.0)",
+    "azure-storage-blob>=12.19.0",
+    "azure-identity>=1.15.0"
 
 ]
 

{trovesuite-1.0.5 → trovesuite-1.0.7}/setup.py

@@ -15,7 +15,7 @@ with open("pyproject.toml", "r", encoding="utf-8") as fh:
 
 setup(
     name="trovesuite",
-    version="1.0.5",
+    version="1.0.7",
     author="Bright Debrah Owusu",
     author_email="owusu.debrah@deladetech.com",
     description="TroveSuite services package providing authentication, authorization, notifications, and other enterprise services for TroveSuite applications",

{trovesuite-1.0.5 → trovesuite-1.0.7}/src/trovesuite/__init__.py

@@ -1,18 +1,21 @@
 """
 TroveSuite Package
 
-A comprehensive authentication, authorization, and notification service for ERP systems.
-Provides JWT token validation, user authorization, permission checking, and notification capabilities.
+A comprehensive authentication, authorization, notification, and storage service for ERP systems.
+Provides JWT token validation, user authorization, permission checking, notification capabilities,
+and Azure Storage blob management.
 """
 
 from .auth import AuthService
 from .notification import NotificationService
+from .storage import StorageService
 
-__version__ = "1.0.8"
+__version__ = "1.0.7"
 __author__ = "Bright Debrah Owusu"
 __email__ = "owusu.debrah@deladetech.com"
 
 __all__ = [
     "AuthService",
-    "NotificationService"
+    "NotificationService",
+    "StorageService"
 ]

trovesuite-1.0.7/src/trovesuite/auth/auth_controller.py

@@ -0,0 +1,11 @@
+from fastapi import APIRouter
+from .auth_write_dto import AuthControllerWriteDto
+from .auth_read_dto import AuthControllerReadDto
+from .auth_service import AuthService
+from ..entities.sh_response import Respons
+
+auth_router = APIRouter(tags=["Auth"])
+
+@auth_router.post("/auth", response_model=Respons[AuthControllerReadDto])
+async def authorize(data: AuthControllerWriteDto):
+    return AuthService.authorize(data=data)

{trovesuite-1.0.5 → trovesuite-1.0.7}/src/trovesuite/configs/database.py

@@ -17,20 +17,25 @@ _connection_pool: Optional[psycopg2.pool.ThreadedConnectionPool] = None
 
 class DatabaseConfig:
     """Database configuration and connection management"""
-    
+
     def __init__(self):
         self.settings = db_settings
         self.database_url = self.settings.database_url
         self.pool_size = 5
         self.max_overflow = 10
-        
+
     def get_connection_params(self) -> dict:
         """Get database connection parameters"""
         if self.settings.DATABASE_URL:
             # Use full DATABASE_URL if available
             return {
                 "dsn": self.settings.DATABASE_URL,
-                "cursor_factory": RealDictCursor
+                "cursor_factory": RealDictCursor,
+                "keepalives": 1,
+                "keepalives_idle": 30,
+                "keepalives_interval": 10,
+                "keepalives_count": 5,
+                "connect_timeout": 10
             }
 
         # fallback to individual DB_* variables
@@ -41,9 +46,14 @@ class DatabaseConfig:
             "user": self.settings.DB_USER,
             "password": self.settings.DB_PASSWORD,
             "cursor_factory": RealDictCursor,
-            "application_name": f"{self.settings.APP_NAME}_{self.settings.ENVIRONMENT}"
+            "application_name": f"{self.settings.APP_NAME}_{self.settings.ENVIRONMENT}",
+            "keepalives": 1,
+            "keepalives_idle": 30,
+            "keepalives_interval": 10,
+            "keepalives_count": 5,
+            "connect_timeout": 10
         }
-    
+
     def create_connection_pool(self) -> psycopg2.pool.ThreadedConnectionPool:
         """Create a connection pool for psycopg2"""
         try:
@@ -57,7 +67,7 @@ class DatabaseConfig:
         except Exception as e:
             logger.error(f"Failed to create database connection pool: {str(e)}")
             raise
-    
+
     def test_connection(self) -> bool:
         """Test database connection"""
         try:
@@ -81,17 +91,17 @@ db_config = DatabaseConfig()
 def initialize_database():
     """Initialize database connections and pool"""
     global _connection_pool
-    
+
     try:
         # Test connection first
         if not db_config.test_connection():
             raise Exception("Database connection test failed")
-        
+
         # Create connection pool
         _connection_pool = db_config.create_connection_pool()
-        
+
         logger.info("Database initialization completed successfully")
-        
+
     except Exception as e:
         logger.error(f"Database initialization failed: {str(e)}")
         raise
@@ -114,6 +124,17 @@ def get_connection_pool() -> psycopg2.pool.ThreadedConnectionPool:
     return _connection_pool
 
 
+def _validate_connection(conn) -> bool:
+    """Validate if a connection is still alive"""
+    try:
+        # Test if connection is alive with a simple query
+        with conn.cursor() as cursor:
+            cursor.execute("SELECT 1")
+        return True
+    except (psycopg2.OperationalError, psycopg2.InterfaceError):
+        return False
+
+
 @contextmanager
 def get_db_connection():
     """Get a database connection from the pool (context manager)"""
@@ -121,52 +142,79 @@ def get_db_connection():
     conn = None
     try:
         conn = pool.getconn()
+
+        # Validate connection before using it
+        if not _validate_connection(conn):
+            logger.warning("Stale connection detected, getting new connection")
+            pool.putconn(conn, close=True)
+            conn = pool.getconn()
+
         logger.debug("Database connection acquired from pool")
         yield conn
     except Exception as e:
         logger.error(f"Database connection error: {str(e)}")
         if conn:
-            conn.rollback()
+            try:
+                # Only rollback if connection is still open
+                if not conn.closed:
+                    conn.rollback()
+            except (psycopg2.OperationalError, psycopg2.InterfaceError) as rollback_error:
+                logger.warning(f"Could not rollback closed connection: {str(rollback_error)}")
         raise
     finally:
         if conn:
-            pool.putconn(conn)
-            logger.debug("Database connection returned to pool")
+            try:
+                # If connection is broken, close it instead of returning to pool
+                if conn.closed:
+                    pool.putconn(conn, close=True)
+                else:
+                    pool.putconn(conn)
+                logger.debug("Database connection returned to pool")
+            except Exception as put_error:
+                logger.error(f"Error returning connection to pool: {str(put_error)}")
 
 
 @contextmanager
 def get_db_cursor():
     """Get a database cursor (context manager)"""
     with get_db_connection() as conn:
-        cursor = conn.cursor()
+        cursor = conn.cursor(cursor_factory=RealDictCursor)
         try:
             yield cursor
-            conn.commit()
+            if not conn.closed:
+                conn.commit()
         except Exception as e:
-            conn.rollback()
+            if not conn.closed:
+                try:
+                    conn.rollback()
+                except (psycopg2.OperationalError, psycopg2.InterfaceError) as rollback_error:
+                    logger.warning(f"Could not rollback transaction on closed connection: {str(rollback_error)}")
             logger.error(f"Database cursor error: {str(e)}")
             raise
         finally:
-            cursor.close()
+            try:
+                cursor.close()
+            except Exception as close_error:
+                logger.warning(f"Error closing cursor: {str(close_error)}")
 
 
 class DatabaseManager:
     """Database manager for common operations"""
-    
+
     @staticmethod
     def execute_query(query: str, params: tuple = None) -> list:
         """Execute a SELECT query and return results"""
         with get_db_cursor() as cursor:
             cursor.execute(query, params)
             return cursor.fetchall()
-    
+
     @staticmethod
     def execute_update(query: str, params: tuple = None) -> int:
         """Execute an INSERT/UPDATE/DELETE query and return affected rows"""
         with get_db_cursor() as cursor:
             cursor.execute(query, params)
             return cursor.rowcount
-    
+
     @staticmethod
     def execute_scalar(query: str, params: tuple = None):
         """Execute a query and return a single value"""
@@ -182,7 +230,41 @@ class DatabaseManager:
                     # Handle tuple result
                     return result[0] if len(result) > 0 else None
             return None
-    
+
+    @staticmethod
+    @contextmanager
+    def transaction():
+        """
+        Context manager for database transactions.
+        Wraps multiple operations in a single transaction.
+
+        Usage:
+            with DatabaseManager.transaction() as cursor:
+                cursor.execute("INSERT INTO table1 ...")
+                cursor.execute("INSERT INTO table2 ...")
+                # Auto-commits on success, auto-rollbacks on exception
+        """
+        with get_db_connection() as conn:
+            cursor = conn.cursor(cursor_factory=RealDictCursor)
+            try:
+                yield cursor
+                if not conn.closed:
+                    conn.commit()
+                    logger.debug("Transaction committed successfully")
+            except Exception as e:
+                if not conn.closed:
+                    try:
+                        conn.rollback()
+                        logger.warning(f"Transaction rolled back due to error: {str(e)}")
+                    except (psycopg2.OperationalError, psycopg2.InterfaceError) as rollback_error:
+                        logger.error(f"Could not rollback transaction: {str(rollback_error)}")
+                raise
+            finally:
+                try:
+                    cursor.close()
+                except Exception as close_error:
+                    logger.warning(f"Error closing transaction cursor: {str(close_error)}")
+
     @staticmethod
     def health_check() -> dict:
         """Perform database health check"""
@@ -190,7 +272,7 @@ class DatabaseManager:
             with get_db_cursor() as cursor:
                 cursor.execute("SELECT version(), current_database(), current_user")
                 result = cursor.fetchone()
-                
+
                 if result:
                     # Handle RealDictRow (dictionary-like) result
                     if hasattr(result, 'get'):

{trovesuite-1.0.5 → trovesuite-1.0.7}/src/trovesuite/entities/health.py

@@ -1,8 +1,8 @@
 from fastapi import APIRouter
-from src.entities.shared.shared_response import Respons
-from src.configs.settings import db_settings
-from src.configs.database import DatabaseManager
-from src.configs.logging import get_logger
+from .sh_response import Respons
+from ..configs.settings import db_settings
+from ..configs.database import DatabaseManager
+from ..configs.logging import get_logger
 
 health_check_router = APIRouter(tags=["Health Path"])
 logger = get_logger("health")

{trovesuite-1.0.5 → trovesuite-1.0.7}/src/trovesuite/notification/notification_controller.py

@@ -1,16 +1,16 @@
-from src.trovesuite.notification.notification_write_dto import (
+from .notification_write_dto import (
     NotificationEmailControllerWriteDto,
     NotificationSMSControllerWriteDto
 )
-from src.trovesuite.notification.notification_read_dto import (
+from .notification_read_dto import (
     NotificationEmailControllerReadDto,
     NotificationSMSControllerReadDto
 )
-from src.trovesuite.notification.notification_service import NotificationService
-from src.trovesuite.entities.sh_response import Respons
+from .notification_service import NotificationService
+from ..entities.sh_response import Respons
 from fastapi import APIRouter
 
-notification_router = APIRouter()
+notification_router = APIRouter(tags=["Notification"])
 
 @notification_router.post("/send_email", response_model=Respons[NotificationEmailControllerReadDto])
 async def send_email(data: NotificationEmailControllerWriteDto):

{trovesuite-1.0.5 → trovesuite-1.0.7}/src/trovesuite/notification/notification_read_dto.py

@@ -1,4 +1,4 @@
-from src.trovesuite.notification.notification_base import (
+from .notification_base import (
     NotificationEmailBase,
     NotificationSMSBase
 )

{trovesuite-1.0.5 → trovesuite-1.0.7}/src/trovesuite/notification/notification_service.py

@@ -1,12 +1,12 @@
 import smtplib
 from email.mime.text import MIMEText
 from email.mime.multipart import MIMEMultipart
-from src.trovesuite.entities.sh_response import Respons
-from src.trovesuite.notification.notification_read_dto import (
+from ..entities.sh_response import Respons
+from .notification_read_dto import (
     NotificationEmailServiceReadDto,
     NotificationSMSServiceReadDto
 )
-from src.trovesuite.notification.notification_write_dto import (
+from .notification_write_dto import (
     NotificationEmailServiceWriteDto,
     NotificationSMSServiceWriteDto
 )

{trovesuite-1.0.5 → trovesuite-1.0.7}/src/trovesuite/notification/notification_write_dto.py

@@ -1,5 +1,5 @@
 from pydantic import BaseModel
-from src.trovesuite.notification.notification_base import (
+from .notification_base import (
     NotificationEmailBase,
     NotificationSMSBase
 )

trovesuite-1.0.7/src/trovesuite/storage/__init__.py

@@ -0,0 +1,42 @@
+"""
+TroveSuite Storage Service
+
+Provides Azure Storage blob management capabilities for TroveSuite applications.
+Includes container creation, file upload/download/update/delete, and presigned URL generation.
+"""
+
+from .storage_service import StorageService
+from .storage_write_dto import (
+    StorageContainerCreateServiceWriteDto,
+    StorageFileUploadServiceWriteDto,
+    StorageFileUpdateServiceWriteDto,
+    StorageFileDeleteServiceWriteDto,
+    StorageFileDownloadServiceWriteDto,
+    StorageFileUrlServiceWriteDto
+)
+from .storage_read_dto import (
+    StorageContainerCreateServiceReadDto,
+    StorageFileUploadServiceReadDto,
+    StorageFileUpdateServiceReadDto,
+    StorageFileDeleteServiceReadDto,
+    StorageFileDownloadServiceReadDto,
+    StorageFileUrlServiceReadDto
+)
+
+__all__ = [
+    "StorageService",
+    # Write DTOs
+    "StorageContainerCreateServiceWriteDto",
+    "StorageFileUploadServiceWriteDto",
+    "StorageFileUpdateServiceWriteDto",
+    "StorageFileDeleteServiceWriteDto",
+    "StorageFileDownloadServiceWriteDto",
+    "StorageFileUrlServiceWriteDto",
+    # Read DTOs
+    "StorageContainerCreateServiceReadDto",
+    "StorageFileUploadServiceReadDto",
+    "StorageFileUpdateServiceReadDto",
+    "StorageFileDeleteServiceReadDto",
+    "StorageFileDownloadServiceReadDto",
+    "StorageFileUrlServiceReadDto",
+]