velocity-python 0.0.176__tar.gz → 0.0.178__tar.gz

{velocity_python-0.0.176 → velocity_python-0.0.178}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.0.176
+Version: 0.0.178
 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.176 → velocity_python-0.0.178}/pyproject.toml

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

{velocity_python-0.0.176 → velocity_python-0.0.178}/src/velocity/__init__.py

@@ -1,4 +1,4 @@
-__version__ = version = "0.0.176"
+__version__ = version = "0.0.178"
 
 from . import aws
 from . import db

{velocity_python-0.0.176 → velocity_python-0.0.178}/src/velocity/aws/handlers/lambda_handler.py

@@ -22,6 +22,7 @@ class LambdaHandler(BaseHandler):
         aws_context, 
         context_class: Type[context.Context] = context.Context
     ):
+        self.start = time.time()
         super().__init__(aws_event, aws_context, context_class)
 
         # LambdaHandler-specific initialization
@@ -63,7 +64,7 @@ class LambdaHandler(BaseHandler):
             return 
         logger.debug("starting LamdaHandler.beforeAction")
 
-        self.start = time.time()
+        
         self.cognito_user = context.get_cognito_user(self.aws_event)
         self.current_user = {}
 

{velocity_python-0.0.176 → velocity_python-0.0.178}/src/velocity/aws/handlers/mixins/__init__.py

@@ -7,6 +7,6 @@ This package provides mixins for common Lambda handler patterns:
 """
 
 from .web_handler import WebHandler
-from .data_service import DataServiceMixin
+from .data_service import DataServiceMixin, RWXHookSystem, apply_sys_modified_by
 
-__all__ = ['WebHandler', 'DataServiceMixin']
+__all__ = ['WebHandler', 'DataServiceMixin', 'RWXHookSystem', 'apply_sys_modified_by']

{velocity_python-0.0.176 → velocity_python-0.0.178}/src/velocity/aws/handlers/mixins/data_service.py

@@ -7,6 +7,7 @@ that uses velocity.db for database access.
 
 import base64
 import datetime
+import importlib
 from io import BytesIO
 
 from velocity.misc import export
@@ -528,3 +529,115 @@ class DataServiceMixin:
                     "OnActionGetTableSchema",
                 )
             raise Exception(f"Failed to retrieve table schema: {str(e)}")
+
+
+class RWXHookSystem:
+    """
+    RWX (Read/Write/eXecute) hook system for table-specific business logic.
+    
+    This class provides a way to dynamically load and execute table-specific
+    hooks (before_read, after_write, etc.) from an rwx package.
+    
+    Usage:
+        from velocity.aws.handlers.mixins import RWXHookSystem
+        
+        class MyRWXSystem(RWXHookSystem):
+            hook_module_name = 'rwx'  # Your rwx package
+        
+        class HttpEventHandler(DataServiceMixin, LambdaHandler):
+            def read_hook(self, tx, table_name, sys_id, row, context):
+                MyRWXSystem.call_hooks(
+                    'read', tx, table_name, sys_id, row, context
+                )
+    """
+    
+    hook_module_name = None  # Override in subclass (e.g., 'rwx')
+    
+    @classmethod
+    def _get_table_module(cls, table):
+        """Load table-specific hook module if it exists"""
+        if not cls.hook_module_name:
+            return None
+        try:
+            return importlib.import_module(f".{table}", cls.hook_module_name)
+        except ImportError:
+            return None
+    
+    @classmethod
+    def _call_hook(cls, hook_name, table, *args, **kwargs):
+        """Call a hook on table-specific module if it exists"""
+        module = cls._get_table_module(table)
+        if module and hasattr(module, hook_name):
+            return getattr(module, hook_name)(*args, **kwargs)
+        return None
+    
+    @classmethod
+    def call_hooks(cls, operation, tx, table_name, *args, context=None):
+        """
+        Call before/after hooks for an operation.
+        
+        Args:
+            operation: 'read', 'write', 'delete', 'query'
+            tx: Database transaction
+            table_name: Name of the table
+            *args: Operation-specific arguments
+            context: Request context (keyword only)
+        """
+        # Call before hook
+        cls._call_hook(f'before_{operation}', table_name, tx, table_name, *args, context)
+        
+        # Note: after hooks should be called by the application after the operation
+        # This method is just for the before hook pattern
+    
+    @classmethod
+    def call_after_hook(cls, operation, tx, table_name, *args, context=None):
+        """Call after hook for an operation"""
+        cls._call_hook(f'after_{operation}', table_name, tx, table_name, *args, context)
+
+
+def apply_sys_modified_by(incoming, context):
+    """
+    Strip sys_* fields and set sys_modified_by from context.
+    
+    Common pattern for applications that track who modified records.
+    Call this from your write_hook implementation.
+    
+    Args:
+        incoming: Dictionary of data being written
+        context: Request context with session/payload
+    """
+    payload = context.payload()
+    
+    # Strip system fields from incoming data
+    for key in list(incoming.keys()):
+        if "sys_" in key:
+            incoming.pop(key)
+    
+    # Extract email from session
+    session = context.session() if hasattr(context, "session") else None
+    email_address = None
+    
+    if isinstance(session, dict):
+        email_address = session.get("cognito_user_email")
+        if not email_address:
+            cognito_user = session.get("cognito_user")
+            if isinstance(cognito_user, dict):
+                email_address = cognito_user.get("email") or (
+                    cognito_user.get("attributes") or {}
+                ).get("email")
+        if not email_address:
+            email_address = session.get("email_address")
+    
+    if not email_address and isinstance(payload, dict):
+        payload_user = payload.get("cognito_user")
+        if isinstance(payload_user, dict):
+            email_address = payload_user.get("email") or (
+                payload_user.get("attributes") or {}
+            ).get("email")
+    
+    incoming["sys_modified_by"] = (
+        email_address.lower()
+        if isinstance(email_address, str)
+        else incoming.get("sys_modified_by", "unknown")
+    )
+    incoming["sys_dirty"] = True

{velocity_python-0.0.176 → velocity_python-0.0.178}/src/velocity_python.egg-info/PKG-INFO

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