velocity-python 0.0.183__tar.gz → 0.0.185__tar.gz

{velocity_python-0.0.183 → velocity_python-0.0.185}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.0.183
+Version: 0.0.185
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT

{velocity_python-0.0.183 → velocity_python-0.0.185}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "velocity-python"
-version = "0.0.183"
+version = "0.0.185"
 authors = [
   { name="Velocity Team", email="info@codeclubs.org" },
 ]

{velocity_python-0.0.183 → velocity_python-0.0.185}/src/velocity/__init__.py

@@ -1,4 +1,4 @@
-__version__ = version = "0.0.183"
+__version__ = version = "0.0.185"
 
 from . import aws
 from . import db

{velocity_python-0.0.183 → velocity_python-0.0.185}/src/velocity/aws/handlers/lambda_handler.py

@@ -24,13 +24,15 @@ class LambdaHandler(BaseHandler):
     ):
         self.start = time.time()
         super().__init__(aws_event, aws_context, context_class)
-
-        # LambdaHandler-specific initialization
+        self.session = self.create_session(aws_event, aws_context)
+            
+    def create_session(self, aws_event, aws_context):
+           # LambdaHandler-specific initialization
         requestContext = aws_event.get("requestContext") or {}
         identity = requestContext.get("identity") or {}
         headers = aws_event.get("headers") or {}
         auth = identity.get("cognitoAuthenticationProvider")
-        self.session = {
+        session = {
             "authentication_provider": identity.get("cognitoAuthenticationProvider"),
             "authentication_type": identity.get("cognitoAuthenticationType"),
             "cognito_user": identity.get("user"),
@@ -45,16 +47,17 @@ class LambdaHandler(BaseHandler):
             "user_agent": identity.get("userAgent"),
             "sub": auth.split(":")[-1] if auth else None,
         }
-        if self.session.get("is_mobile"):
-            self.session["device_type"] = "mobile"
-        elif self.session.get("is_desktop"):
-            self.session["device_type"] = "desktop"
-        elif self.session.get("is_tablet"):
-            self.session["device_type"] = "tablet"
-        elif self.session.get("is_smart_tv"):
-            self.session["device_type"] = "smart_tv"
+        if session.get("is_mobile"):
+            session["device_type"] = "mobile"
+        elif session.get("is_desktop"):
+            session["device_type"] = "desktop"
+        elif session.get("is_tablet"):
+            session["device_type"] = "tablet"
+        elif session.get("is_smart_tv"):
+            session["device_type"] = "smart_tv"
         else:
-            self.session["device_type"] = "unknown"
+            session["device_type"] = "unknown"
+        return session
 
 
     def beforeAction(self, tx, context):

{velocity_python-0.0.183 → velocity_python-0.0.185}/src/velocity/aws/handlers/mixins/__init__.py

@@ -3,10 +3,11 @@ Mixins for AWS Lambda handlers.
 
 This package provides mixins for common Lambda handler patterns:
 - WebHandler: Activity tracking, logging, and error handling
+- ButtonHandler: Dynamic button action handler loading
 - DataServiceMixin: Generic CRUD operations for database-backed APIs
 """
 
-from .web_handler import WebHandler
+from .web_handler import WebHandler, ButtonHandler
 from .data_service import DataServiceMixin, RWXHookSystem, apply_sys_modified_by
 
-__all__ = ['WebHandler', 'DataServiceMixin', 'RWXHookSystem', 'apply_sys_modified_by']
+__all__ = ['WebHandler', 'ButtonHandler', 'DataServiceMixin', 'RWXHookSystem', 'apply_sys_modified_by']

{velocity_python-0.0.183 → velocity_python-0.0.185}/src/velocity/aws/handlers/mixins/web_handler.py

@@ -7,6 +7,7 @@ onError implementations in handlers.
 """
 
 import copy
+import importlib
 import json
 import os
 import pprint
@@ -15,6 +16,7 @@ from abc import ABC
 from datetime import date, datetime
 from typing import Any, Dict, List
 
+from velocity.aws.handlers.exceptions import AlertError
 
 class WebHandler(ABC):
     """
@@ -380,4 +382,112 @@ Request Details:
 
         if not getattr(self, "_handles_own_error_notifications", False):
             if self._should_notify_error(exc):
-                self.send_error_notification(tx, context, exc, tb)
+                self.send_error_notification(tx, context, exc, tb)
+                
+                
+                
+class ButtonHandler:
+    """
+    Button handler mixin for dynamically loading and executing button action handlers.
+    
+    This class provides a way to dynamically load button handler modules and execute
+    actions defined within them, similar to the RWXHookSystem pattern.
+    
+    Usage:
+        from velocity.aws.handlers.mixins import ButtonHandler
+        
+        class LocalButtonHandler(ButtonHandler):
+            module_name = 'buttons'  # Your buttons package
+        
+        class HttpEventHandler(LocalButtonHandler, WebHandler, LambdaHandler):
+            # Handler will automatically have OnActionButtonClick available
+            pass
+    
+    The OnActionButtonClick method expects the context.dataset() to contain:
+        - handler: Name of the module in the buttons package
+        - action: Action name (e.g., "refresh-data" becomes "RefreshData")
+    """
+    
+    module_name = None  # Override in subclass (e.g., 'buttons')
+    
+    @classmethod
+    def _get_button_module(cls, handler):
+        """
+        Load button-specific handler module if it exists.
+        
+        Args:
+            handler: Name of the handler module to load
+            
+        Returns:
+            The loaded module or None if not found
+        """
+        if not cls.module_name:
+            raise AlertError("ButtonHandler.module_name not set in subclass. This is a configuration issue that needs to be handled by the developer.")
+        try:
+            return importlib.import_module(f".{handler}", cls.module_name)
+        except ImportError:
+            raise AlertError(f"Unable to import ButtonHandler module `{handler}`. Please ensure the code has been deployed.")
+    
+    @classmethod
+    def _get_button_function(cls, handler, action):
+        """
+        Get a specific function from a button handler module.
+        
+        Args:
+            handler: Name of the handler module
+            action: Action name to convert to function name
+            
+        Returns:
+            The function object or None if not found
+        """
+        module = cls._get_button_module(handler)
+        
+        # Convert action name: "refresh-data" -> "RefreshData"
+        func_name = action.replace("-", " ").title().replace(" ", "")
+        
+        if hasattr(module, func_name):
+            return getattr(module, func_name)
+        
+        raise AlertError(f"Function `{func_name}` not found in handler `{handler}`. Please ensure the code has been deployed.")
+    
+    def OnActionButtonClick(self, tx, context):
+        """
+        Handle button click actions by dynamically loading and executing handlers.
+        
+        This method:
+        1. Extracts handler and action from the dataset
+        2. Dynamically loads the appropriate button handler module
+        3. Converts the action name to a function name
+        4. Executes the function with proper error handling
+        
+        The button handler functions should modify context.response() directly
+        and should not return values (to avoid triggering base handler warnings).
+        
+        Args:
+            tx: Database transaction
+            context: Request context containing dataset with 'handler' and 'action'
+            
+        Raises:
+            AlertError: If handler or action not found, or if module/function missing
+        """
+        
+        
+        dataset = context.dataset()
+        
+        # Validate required fields
+        if "handler" not in dataset:
+            raise AlertError("Handler not found in payload")
+        if "action" not in dataset:
+            raise AlertError("Action not found in payload")
+        
+        handler = dataset["handler"]
+        action = dataset["action"]
+        
+        # Resolve the function using the helper
+        func = self._get_button_function(handler, action)
+       
+        # Execute the button handler
+        # Don't return its result to avoid triggering base handler warnings
+        func(self, tx, context)
+        
+        # Handler methods should modify context.response() directly

{velocity_python-0.0.183 → velocity_python-0.0.185}/src/velocity_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.0.183
+Version: 0.0.185
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT