wappa 0.1.9__py3-none-any.whl → 0.1.10__py3-none-any.whl

wappa/core/factory/wappa_builder.py

@@ -103,10 +103,10 @@ class WappaBuilder:
     def add_startup_hook(self, hook: Callable, priority: int = 50) -> "WappaBuilder":
         """
         Add a startup hook to unified lifespan management.
-        
+
         Hooks are executed during application startup in priority order.
         Lower priority numbers execute first.
-        
+
         Priority Guidelines:
         - 10: Core system initialization (logging, sessions)
         - 20: Infrastructure (databases, caches, external services)
@@ -120,11 +120,11 @@ class WappaBuilder:
 
         Returns:
             Self for method chaining
-            
+
         Example:
             async def my_startup(app: FastAPI):
                 print("Starting my service")
-                
+
             builder.add_startup_hook(my_startup, priority=30)
         """
         self.startup_hooks.append((hook, priority))
@@ -133,10 +133,10 @@ class WappaBuilder:
     def add_shutdown_hook(self, hook: Callable, priority: int = 50) -> "WappaBuilder":
         """
         Add a shutdown hook to unified lifespan management.
-        
+
         Hooks are executed during application shutdown in reverse priority order.
         Higher priority numbers execute first during shutdown.
-        
+
         Priority Guidelines:
         - 90: Core system cleanup (sessions, logging) - runs last
         - 70: Application services cleanup
@@ -146,16 +146,16 @@ class WappaBuilder:
         - 10: Early cleanup
 
         Args:
-            hook: Async callable that takes (app: FastAPI) -> None  
+            hook: Async callable that takes (app: FastAPI) -> None
             priority: Execution priority (higher = runs first in shutdown)
 
         Returns:
             Self for method chaining
-            
+
         Example:
             async def my_shutdown(app: FastAPI):
                 print("Cleaning up my service")
-                
+
             builder.add_shutdown_hook(my_shutdown, priority=30)
         """
         self.shutdown_hooks.append((hook, priority))
@@ -183,7 +183,7 @@ class WappaBuilder:
         2. Create FastAPI app with lifespan and config
         3. Add all middleware via app.add_middleware()
         4. Include all routers via app.include_router()
-        
+
         Only async operations happen in the lifespan (startup/shutdown hooks).
 
         Returns:
@@ -191,22 +191,21 @@ class WappaBuilder:
         """
         logger = get_app_logger()
         logger.debug(f"🏗️ Building FastAPI app with {len(self.plugins)} plugins")
-        
+
         # Step 1: Configure plugins (sync setup only - middleware/router registration)
         if self.plugins:
             logger.debug(f"⚙️ Configuring {len(self.plugins)} plugins synchronously...")
             for plugin in self.plugins:
                 plugin.configure(self)  # Synchronous configuration
-            
+
             logger.info(
                 f"✅ Plugin configuration complete - registered {len(self.middlewares)} middlewares, "
                 f"{len(self.routers)} routers, {len(self.startup_hooks)} startup hooks, "
                 f"{len(self.shutdown_hooks)} shutdown hooks"
             )
-        
+
         # Create unified lifespan (only for async startup/shutdown hooks)
-        from contextlib import asynccontextmanager
-        
+
         @asynccontextmanager
         async def unified_lifespan(app: FastAPI):
             try:
@@ -241,9 +240,11 @@ class WappaBuilder:
         sorted_middlewares = sorted(self.middlewares, key=lambda x: x[2], reverse=True)
         for middleware_class, kwargs, priority in sorted_middlewares:
             app.add_middleware(middleware_class, **kwargs)
-            logger.debug(f"Added middleware {middleware_class.__name__} (priority: {priority})")
+            logger.debug(
+                f"Added middleware {middleware_class.__name__} (priority: {priority})"
+            )
 
-        # Step 4: Include all routers via app.include_router()  
+        # Step 4: Include all routers via app.include_router()
         for router, kwargs in self.routers:
             app.include_router(router, **kwargs)
             logger.debug(f"Included router with config: {kwargs}")
@@ -258,7 +259,7 @@ class WappaBuilder:
     async def _execute_all_startup_hooks(self, app: FastAPI) -> None:
         """
         Execute all startup hooks in unified priority order.
-        
+
         This replaces the old plugin-specific startup execution with a unified
         approach where all hooks (from plugins and user code) are executed
         in a single priority-ordered sequence.
@@ -276,17 +277,23 @@ class WappaBuilder:
                 logger.debug("No startup hooks registered")
                 return
 
-            logger.debug(f"Executing {len(sorted_hooks)} startup hooks in priority order...")
+            logger.debug(
+                f"Executing {len(sorted_hooks)} startup hooks in priority order..."
+            )
 
             for hook, priority in sorted_hooks:
                 hook_name = getattr(hook, "__name__", "anonymous_hook")
-                logger.debug(f"⚡ Executing startup hook: {hook_name} (priority: {priority})")
+                logger.debug(
+                    f"⚡ Executing startup hook: {hook_name} (priority: {priority})"
+                )
 
                 try:
                     await hook(app)
                     logger.debug(f"✅ Startup hook {hook_name} completed")
                 except Exception as e:
-                    logger.error(f"❌ Startup hook {hook_name} failed: {e}", exc_info=True)
+                    logger.error(
+                        f"❌ Startup hook {hook_name} failed: {e}", exc_info=True
+                    )
                     raise  # Re-raise to fail fast
 
         except Exception as e:
@@ -296,7 +303,7 @@ class WappaBuilder:
     async def _execute_all_shutdown_hooks(self, app: FastAPI) -> None:
         """
         Execute all shutdown hooks in reverse priority order.
-        
+
         This replaces the old plugin-specific shutdown execution with a unified
         approach where all hooks are executed in reverse priority order,
         with error isolation to prevent shutdown cascading failures.
@@ -313,14 +320,20 @@ class WappaBuilder:
             logger.debug("No shutdown hooks registered")
             return
 
-        logger.debug(f"Executing {len(sorted_hooks)} shutdown hooks in reverse priority order...")
+        logger.debug(
+            f"Executing {len(sorted_hooks)} shutdown hooks in reverse priority order..."
+        )
 
         for hook, priority in sorted_hooks:
             hook_name = getattr(hook, "__name__", "anonymous_hook")
             try:
-                logger.debug(f"🛑 Executing shutdown hook: {hook_name} (priority: {priority})")
+                logger.debug(
+                    f"🛑 Executing shutdown hook: {hook_name} (priority: {priority})"
+                )
                 await hook(app)
                 logger.debug(f"✅ Shutdown hook {hook_name} completed")
             except Exception as e:
                 # Don't re-raise in shutdown - log and continue with other hooks
-                logger.error(f"❌ Error in shutdown hook {hook_name}: {e}", exc_info=True)
+                logger.error(
+                    f"❌ Error in shutdown hook {hook_name}: {e}", exc_info=True
+                )

wappa/core/plugins/redis_plugin.py

@@ -120,9 +120,7 @@ class RedisPlugin:
             max_conn = self.max_connections or settings.redis_max_connections
 
             logger.info("=== REDIS CACHE INITIALIZATION ===")
-            logger.info(
-                f"🔴 Redis URL: {redis_url} (max_connections: {max_conn})"
-            )
+            logger.info(f"🔴 Redis URL: {redis_url} (max_connections: {max_conn})")
 
             # Initialize Redis pools with explicit settings
             await RedisManager.initialize(

wappa/core/plugins/wappa_core_plugin.py

@@ -152,16 +152,17 @@ class WappaCorePlugin:
             # Create persistent HTTP session with optimized connection pooling
             logger.info("🌐 Creating persistent HTTP session...")
             connector = aiohttp.TCPConnector(
-                limit=100,                    # Max connections
-                keepalive_timeout=30,         # Keep alive timeout
-                enable_cleanup_closed=True    # Auto cleanup closed connections
+                limit=100,  # Max connections
+                keepalive_timeout=30,  # Keep alive timeout
+                enable_cleanup_closed=True,  # Auto cleanup closed connections
             )
             session = aiohttp.ClientSession(
-                connector=connector,
-                timeout=aiohttp.ClientTimeout(total=30)
+                connector=connector, timeout=aiohttp.ClientTimeout(total=30)
             )
             app.state.http_session = session
-            logger.info("✅ Persistent HTTP session created - connections: 100, keepalive: 30s")
+            logger.info(
+                "✅ Persistent HTTP session created - connections: 100, keepalive: 30s"
+            )
 
             # Log available endpoints
             base_url = (

wappa/core/types.py

@@ -11,7 +11,7 @@ from typing import Literal
 class CacheType(Enum):
     """
     Supported cache types for Wappa applications.
-    
+
     This enum defines the cache backends that Wappa can use for state management,
     user data caching, and message logging.
     """
@@ -43,20 +43,20 @@ Example:
 def validate_cache_type(cache_type: str) -> CacheType:
     """
     Validate and convert a cache type string to CacheType enum.
-    
+
     Args:
         cache_type: String representation of cache type
-        
+
     Returns:
         Validated CacheType enum value
-        
+
     Raises:
         ValueError: If cache_type is not supported
-        
+
     Example:
         >>> validate_cache_type("redis")
         CacheType.REDIS
-        
+
         >>> validate_cache_type("invalid")
         ValueError: Unsupported cache type: invalid. Supported types: memory, redis, json
     """
@@ -73,10 +73,10 @@ def validate_cache_type(cache_type: str) -> CacheType:
 def get_supported_cache_types() -> list[str]:
     """
     Get list of all supported cache type strings.
-    
+
     Returns:
         List of supported cache type strings
-        
+
     Example:
         >>> get_supported_cache_types()
         ['memory', 'redis', 'json']
@@ -87,17 +87,17 @@ def get_supported_cache_types() -> list[str]:
 def is_cache_type_supported(cache_type: str) -> bool:
     """
     Check if a cache type string is supported.
-    
+
     Args:
         cache_type: String to check
-        
+
     Returns:
         True if cache type is supported, False otherwise
-        
+
     Example:
         >>> is_cache_type_supported("redis")
         True
-        
+
         >>> is_cache_type_supported("invalid")
         False
     """

wappa/core/wappa_app.py

@@ -167,7 +167,7 @@ class Wappa:
         Return a FastAPI ASGI application, building synchronously if needed.
 
         This property enables uvicorn reload compatibility by providing a synchronous
-        way to access the FastAPI app. Plugin configuration is deferred to lifespan 
+        way to access the FastAPI app. Plugin configuration is deferred to lifespan
         hooks to maintain async initialization while keeping this property sync.
 
         Returns:
@@ -205,7 +205,7 @@ class Wappa:
             redoc_url="/redoc" if settings.is_development else None,
         )
 
-        # Use WappaBuilder.build() - creates app with lifespan, 
+        # Use WappaBuilder.build() - creates app with lifespan,
         # defers plugin configuration to startup hooks
         app = self._builder.build()
 
@@ -329,10 +329,12 @@ class Wappa:
 
         return self
 
-    def add_middleware(self, middleware_class: type, priority: int = 50, **kwargs) -> "Wappa":
+    def add_middleware(
+        self, middleware_class: type, priority: int = 50, **kwargs
+    ) -> "Wappa":
         """
         Add middleware to the application with priority ordering.
-        
+
         This provides access to the underlying WappaBuilder's middleware system.
         Priority determines execution order:
         - Lower numbers run first (outer middleware)
@@ -349,7 +351,7 @@ class Wappa:
 
         Example:
             from fastapi.middleware.cors import CORSMiddleware
-            
+
             app = Wappa(cache="redis")
             app.add_middleware(CORSMiddleware, allow_origins=["*"], priority=30)
             app.set_event_handler(MyHandler())
@@ -379,9 +381,9 @@ class Wappa:
 
         Example:
             from fastapi import APIRouter
-            
+
             custom_router = APIRouter()
-            
+
             app = Wappa(cache="redis")
             app.add_router(custom_router, prefix="/api/v1", tags=["custom"])
             app.set_event_handler(MyHandler())
@@ -411,7 +413,7 @@ class Wappa:
             app = Wappa(cache="redis")
             app.configure(
                 title="My WhatsApp Bot",
-                version="2.0.0", 
+                version="2.0.0",
                 description="Custom bot with advanced features"
             )
             app.set_event_handler(MyHandler())

wappa/database/__init__.py

@@ -1,7 +1,7 @@
 """
 Wappa Database Components
 
-Provides database abstraction and adapters for SQLModel/SQLAlchemy async 
+Provides database abstraction and adapters for SQLModel/SQLAlchemy async
 connections. Supports multiple database engines with a unified interface.
 
 Clean Architecture: Infrastructure layer database adapters.
@@ -9,7 +9,7 @@ Clean Architecture: Infrastructure layer database adapters.
 Usage:
     # Base adapter
     from wappa.database import DatabaseAdapter
-    
+
     # Specific database adapters
     from wappa.database import PostgreSQLAdapter, MySQLAdapter, SQLiteAdapter
 """
@@ -22,9 +22,8 @@ from .adapters.sqlite_adapter import SQLiteAdapter
 __all__ = [
     # Base Adapter
     "DatabaseAdapter",
-    
     # Database Adapters (Clean Architecture: Infrastructure implementations)
     "PostgreSQLAdapter",
-    "MySQLAdapter", 
+    "MySQLAdapter",
     "SQLiteAdapter",
 ]

wappa/domain/enums/messenger_platform.py

@@ -36,8 +36,7 @@ def create_messenger_platform_enum() -> type[Enum]:
 
     # Create enum members dynamically based on enabled platforms
     enum_members = {
-        platform_name.upper(): platform_name
-        for platform_name in enabled_platforms.keys()
+        platform_name.upper(): platform_name for platform_name in enabled_platforms
     }
 
     # Create the enum class

wappa/domain/factories/media_factory.py

@@ -195,10 +195,7 @@ class WhatsAppMediaFactory(MediaFactory):
         }
 
         # Create media object based on reference type
-        if is_url:
-            media_obj = {"link": media_reference}
-        else:
-            media_obj = {"id": media_reference}
+        media_obj = {"link": media_reference} if is_url else {"id": media_reference}
 
         # Add optional caption
         if caption:
@@ -232,10 +229,7 @@ class WhatsAppMediaFactory(MediaFactory):
         }
 
         # Create media object based on reference type
-        if is_url:
-            media_obj = {"link": media_reference}
-        else:
-            media_obj = {"id": media_reference}
+        media_obj = {"link": media_reference} if is_url else {"id": media_reference}
 
         # Add optional caption
         if caption:
@@ -269,10 +263,7 @@ class WhatsAppMediaFactory(MediaFactory):
         }
 
         # Create media object based on reference type
-        if is_url:
-            media_obj = {"link": media_reference}
-        else:
-            media_obj = {"id": media_reference}
+        media_obj = {"link": media_reference} if is_url else {"id": media_reference}
 
         payload["audio"] = media_obj
 
@@ -302,10 +293,7 @@ class WhatsAppMediaFactory(MediaFactory):
         }
 
         # Create media object based on reference type
-        if is_url:
-            media_obj = {"link": media_reference}
-        else:
-            media_obj = {"id": media_reference}
+        media_obj = {"link": media_reference} if is_url else {"id": media_reference}
 
         # Add optional filename
         if filename:
@@ -339,10 +327,7 @@ class WhatsAppMediaFactory(MediaFactory):
         }
 
         # Create media object based on reference type
-        if is_url:
-            media_obj = {"link": media_reference}
-        else:
-            media_obj = {"id": media_reference}
+        media_obj = {"link": media_reference} if is_url else {"id": media_reference}
 
         payload["sticker"] = media_obj
 

wappa/domain/factories/message_factory.py

@@ -279,10 +279,7 @@ class WhatsAppMessageFactory(MessageFactory):
         }
 
         # Create media object based on reference type
-        if is_url:
-            media_obj = {"link": media_reference}
-        else:
-            media_obj = {"id": media_reference}
+        media_obj = {"link": media_reference} if is_url else {"id": media_reference}
 
         # Add optional caption
         if caption:
@@ -313,10 +310,7 @@ class WhatsAppMessageFactory(MessageFactory):
         }
 
         # Create media object based on reference type
-        if is_url:
-            media_obj = {"link": media_reference}
-        else:
-            media_obj = {"id": media_reference}
+        media_obj = {"link": media_reference} if is_url else {"id": media_reference}
 
         # Add optional caption
         if caption:
@@ -346,10 +340,7 @@ class WhatsAppMessageFactory(MessageFactory):
         }
 
         # Create media object based on reference type
-        if is_url:
-            media_obj = {"link": media_reference}
-        else:
-            media_obj = {"id": media_reference}
+        media_obj = {"link": media_reference} if is_url else {"id": media_reference}
 
         payload["audio"] = media_obj
 
@@ -376,10 +367,7 @@ class WhatsAppMessageFactory(MessageFactory):
         }
 
         # Create media object based on reference type
-        if is_url:
-            media_obj = {"link": media_reference}
-        else:
-            media_obj = {"id": media_reference}
+        media_obj = {"link": media_reference} if is_url else {"id": media_reference}
 
         # Add optional filename
         if filename:
@@ -409,10 +397,7 @@ class WhatsAppMessageFactory(MessageFactory):
         }
 
         # Create media object based on reference type
-        if is_url:
-            media_obj = {"link": media_reference}
-        else:
-            media_obj = {"id": media_reference}
+        media_obj = {"link": media_reference} if is_url else {"id": media_reference}
 
         payload["sticker"] = media_obj
 

wappa/domain/factories/messenger_factory.py

@@ -210,7 +210,7 @@ class MessengerFactory:
             # Clear all messengers for a platform
             to_remove = [
                 key
-                for key in self._messenger_cache.keys()
+                for key in self._messenger_cache
                 if key.startswith(f"{platform.value}:")
             ]
             for key in to_remove:
@@ -219,9 +219,7 @@ class MessengerFactory:
         elif tenant_id:
             # Clear all messengers for a tenant
             to_remove = [
-                key
-                for key in self._messenger_cache.keys()
-                if key.endswith(f":{tenant_id}")
+                key for key in self._messenger_cache if key.endswith(f":{tenant_id}")
             ]
             for key in to_remove:
                 del self._messenger_cache[key]

wappa/domain/interfaces/cache_interface.py

@@ -169,31 +169,31 @@ class ICache(ABC):
             True if successful, False otherwise
         """
         pass
-    
+
     @staticmethod
     def create_table_key(table_name: str, pkid: str) -> str:
         """
         Create a properly formatted table cache key.
-        
+
         This is a static utility method available on all cache implementations
         to ensure consistent key formatting across cache backends.
-        
+
         Args:
             table_name: Name of the table (e.g., "user_profiles", "message_logs")
             pkid: Primary key ID (e.g., user_id, message_id)
-            
+
         Returns:
             Formatted key string for use with cache methods
-            
+
         Example:
             key = ICache.create_table_key("user_profiles", "12345")
             # Returns: "user_profiles:12345"
         """
         if not table_name or not pkid:
             raise ValueError("Both table_name and pkid must be provided and non-empty")
-        
+
         # Sanitize inputs to avoid conflicts
         safe_table_name = str(table_name).replace(":", "_")
         safe_pkid = str(pkid).replace(":", "_")
-        
+
         return f"{safe_table_name}:{safe_pkid}"

wappa/domain/interfaces/media_interface.py

@@ -14,9 +14,8 @@ and WhatsApp Cloud API 2025 specifications for the 4 core endpoints:
 
 from abc import ABC, abstractmethod
 from collections.abc import AsyncIterator
-from contextlib import asynccontextmanager
 from pathlib import Path
-from typing import BinaryIO, AsyncContextManager
+from typing import AsyncContextManager, BinaryIO
 
 from wappa.domain.models.media_result import (
     MediaDeleteResult,
@@ -257,9 +256,7 @@ class IMediaHandler(ABC):
         pass
 
     @abstractmethod
-    async def get_media_as_bytes(
-        self, media_id: str
-    ) -> MediaDownloadResult:
+    async def get_media_as_bytes(self, media_id: str) -> MediaDownloadResult:
         """
         Download media as bytes without creating any files.
 

wappa/domain/models/media_result.py

@@ -6,10 +6,8 @@ messaging platforms, providing consistent response structures while
 maintaining compatibility with platform-specific response formats.
 """
 
-import os
 from datetime import datetime
 from pathlib import Path
-from typing import AsyncContextManager, Optional
 
 from pydantic import BaseModel, Field
 
@@ -125,7 +123,7 @@ class MediaDownloadResult(BaseModel):
 
     def mark_as_temp_file(self, cleanup_on_exit: bool = True):
         """Mark this result as containing a temporary file for cleanup.
-        
+
         Args:
             cleanup_on_exit: Whether to automatically delete the temp file when context exits
         """

wappa/domain/models/platforms/platform_config.py

@@ -51,9 +51,7 @@ class PlatformCredentials(BaseModel):
     def is_configured(self) -> bool:
         """Check if minimum required credentials are present."""
         # For WhatsApp, we need access_token and phone_id
-        if self.access_token and self.phone_id:
-            return True
-        return False
+        return bool(self.access_token and self.phone_id)
 
 
 class PlatformLimits(BaseModel):

wappa/messaging/__init__.py

@@ -9,11 +9,11 @@ Clean Architecture: Application services and infrastructure implementations.
 Usage (User Request: Quick access to WhatsApp messaging components):
     # Core messaging interface
     from wappa.messaging import IMessenger
-    
+
     # WhatsApp client and messenger
     from wappa.messaging.whatsapp import WhatsAppClient, WhatsAppMessenger
-    
-    # WhatsApp specialized handlers  
+
+    # WhatsApp specialized handlers
     from wappa.messaging.whatsapp import (
         WhatsAppMediaHandler,
         WhatsAppInteractiveHandler,
@@ -26,32 +26,29 @@ Usage (User Request: Quick access to WhatsApp messaging components):
 from wappa.domain.interfaces.messaging_interface import IMessenger
 
 # WhatsApp Client & Messenger (User Request: Quick access)
-from .whatsapp.client import WhatsAppClient, WhatsAppUrlBuilder, WhatsAppFormDataBuilder
-from .whatsapp.messenger import WhatsAppMessenger
+from .whatsapp.client import WhatsAppClient, WhatsAppFormDataBuilder, WhatsAppUrlBuilder
 
 # WhatsApp Specialized Handlers (User Request: Quick access)
 from .whatsapp.handlers import (
+    WhatsAppInteractiveHandler,
     WhatsAppMediaHandler,
-    WhatsAppInteractiveHandler, 
-    WhatsAppTemplateHandler,
     WhatsAppSpecializedHandler,
+    WhatsAppTemplateHandler,
 )
+from .whatsapp.messenger import WhatsAppMessenger
 
 __all__ = [
     # Core Interface
     "IMessenger",
-    
     # WhatsApp Client & Utilities
     "WhatsAppClient",
     "WhatsAppUrlBuilder",
-    "WhatsAppFormDataBuilder", 
-    
+    "WhatsAppFormDataBuilder",
     # WhatsApp Messenger
     "WhatsAppMessenger",
-    
     # WhatsApp Handlers (User Request: Clean access to all handlers)
     "WhatsAppMediaHandler",
     "WhatsAppInteractiveHandler",
-    "WhatsAppTemplateHandler", 
+    "WhatsAppTemplateHandler",
     "WhatsAppSpecializedHandler",
 ]