velocity-python 0.0.132__py3-none-any.whl → 0.0.135__py3-none-any.whl

velocity/aws/tests/test_response.py

@@ -0,0 +1,163 @@
+import unittest
+import sys
+from unittest.mock import patch, MagicMock
+
+# Mock the support module before importing the module that depends on it
+sys.modules["support"] = MagicMock()
+sys.modules["support.app"] = MagicMock()
+sys.modules["support.app"].DEBUG = True
+
+from velocity.aws.handlers.response import Response  # Replace with actual module path
+
+
+class TestResponse(unittest.TestCase):
+
+    def setUp(self):
+        self.response = Response()
+
+    def test_initial_status_code(self):
+        self.assertEqual(self.response.status(), 200)
+
+    def test_set_status_code(self):
+        self.response.set_status(404)
+        self.assertEqual(self.response.status(), 404)
+
+    def test_initial_headers(self):
+        headers = self.response.headers()
+        self.assertIn("Content-Type", headers)
+        self.assertEqual(headers["Content-Type"], "application/json")
+
+    def test_set_headers(self):
+        custom_headers = {"x-custom-header": "value"}
+        self.response.set_headers(custom_headers)
+        headers = self.response.headers()
+        self.assertEqual(headers["X-Custom-Header"], "value")  # Ensures capitalization
+        self.assertIn("Content-Type", headers)
+
+    def test_alert_action(self):
+        self.response.alert("Test message", "Alert Title")
+        self.assertEqual(len(self.response.actions), 1)
+        self.assertEqual(self.response.actions[0]["action"], "alert")
+        self.assertEqual(self.response.actions[0]["payload"]["title"], "Alert Title")
+        self.assertEqual(self.response.actions[0]["payload"]["message"], "Test message")
+
+    def test_toast_action_valid_variant(self):
+        self.response.toast("Toast message", "warning")
+        self.assertEqual(len(self.response.actions), 1)
+        self.assertEqual(self.response.actions[0]["action"], "toast")
+        self.assertEqual(
+            self.response.actions[0]["payload"]["options"]["variant"], "warning"
+        )
+
+    def test_toast_action_invalid_variant(self):
+        with self.assertRaises(ValueError) as context:
+            self.response.toast("Invalid toast", "invalid_variant")
+        self.assertIn(
+            "Notistack variant 'invalid_variant' not in", str(context.exception)
+        )
+
+    def test_load_object_action(self):
+        payload = {"key": "value"}
+        self.response.load_object(payload)
+        self.assertEqual(len(self.response.actions), 1)
+        self.assertEqual(self.response.actions[0]["action"], "load-object")
+        self.assertEqual(self.response.actions[0]["payload"], payload)
+
+    def test_update_store_action(self):
+        payload = {"key": "value"}
+        self.response.update_store(payload)
+        self.assertEqual(len(self.response.actions), 1)
+        self.assertEqual(self.response.actions[0]["action"], "update-store")
+        self.assertEqual(self.response.actions[0]["payload"], payload)
+
+    def test_file_download_action(self):
+        payload = {"file": "file.txt"}
+        self.response.file_download(payload)
+        self.assertEqual(len(self.response.actions), 1)
+        self.assertEqual(self.response.actions[0]["action"], "file-download")
+        self.assertEqual(self.response.actions[0]["payload"], payload)
+
+    def test_redirect_action(self):
+        self.response.redirect("https://example.com")
+        self.assertEqual(len(self.response.actions), 1)
+        self.assertEqual(self.response.actions[0]["action"], "redirect")
+        self.assertEqual(
+            self.response.actions[0]["payload"]["location"], "https://example.com"
+        )
+
+    def test_signout_action(self):
+        self.response.signout()
+        self.assertEqual(len(self.response.actions), 1)
+        self.assertEqual(self.response.actions[0]["action"], "signout")
+
+    def test_set_table_action(self):
+        payload = {"table": "data"}
+        self.response.set_table(payload)
+        self.assertEqual(len(self.response.actions), 1)
+        self.assertEqual(self.response.actions[0]["action"], "set-table")
+        self.assertEqual(self.response.actions[0]["payload"], payload)
+
+    def test_set_repo_action(self):
+        payload = {"repo": "data"}
+        self.response.set_repo(payload)
+        self.assertEqual(len(self.response.actions), 1)
+        self.assertEqual(self.response.actions[0]["action"], "set-repo")
+        self.assertEqual(self.response.actions[0]["payload"], payload)
+
+    def test_exception_handling_debug_on(self):
+        with patch("your_module.DEBUG", True), patch(
+            "traceback.format_exc", return_value="formatted traceback"
+        ):
+            try:
+                raise ValueError("Test exception")
+            except ValueError:
+                self.response.exception()
+
+        self.assertEqual(self.response.status(), 500)
+        exception_info = self.response.body["python_exception"]
+        self.assertEqual(exception_info["value"], "Test exception")
+        self.assertEqual(exception_info["traceback"], "formatted traceback")
+
+    def test_exception_handling_debug_off(self):
+        with patch("your_module.DEBUG", False), patch(
+            "traceback.format_exc", return_value="formatted traceback"
+        ):
+            try:
+                raise ValueError("Test exception")
+            except ValueError:
+                self.response.exception()
+
+        self.assertEqual(self.response.status(), 500)
+        exception_info = self.response.body["python_exception"]
+        self.assertEqual(exception_info["value"], "Test exception")
+        self.assertIsNone(exception_info["traceback"])
+
+    def test_chaining_methods(self):
+        response = (
+            self.response.set_status(201)
+            .alert("Chain Alert")
+            .toast("Chain Toast", "info")
+            .redirect("https://chained-example.com")
+        )
+        self.assertEqual(response.status(), 201)
+        self.assertEqual(len(response.actions), 3)
+        self.assertEqual(
+            response.actions[2]["payload"]["location"], "https://chained-example.com"
+        )
+
+    def test_render(self):
+        self.response.set_body({"key": "value"})
+        rendered_response = self.response.render()
+        self.assertEqual(rendered_response["statusCode"], 200)
+        self.assertEqual(
+            rendered_response["headers"]["Content-Type"], "application/json"
+        )
+        self.assertIn('"key": "value"', rendered_response["body"])
+
+    def test_format_header_key(self):
+        result = Response._format_header_key("x-custom-header")
+        self.assertEqual(result, "X-Custom-Header")
+
+
+if __name__ == "__main__":
+    unittest.main()

velocity/db/core/decorators.py

@@ -99,7 +99,8 @@ def return_default(
 
 def create_missing(func):
     """
-    If the function call fails with DbColumnMissingError or DbTableMissingError, tries to create them and re-run.
+    If the function call fails with DbColumnMissingError or DbTableMissingError, 
+    tries to create them and re-run (only if schema is not locked).
     """
 
     @wraps(func)
@@ -109,8 +110,16 @@ def create_missing(func):
             result = func(self, *args, **kwds)
             self.tx.release_savepoint(sp, cursor=self.cursor())
             return result
-        except exceptions.DbColumnMissingError:
+        except exceptions.DbColumnMissingError as e:
             self.tx.rollback_savepoint(sp, cursor=self.cursor())
+            
+            # Check if schema is locked
+            if self.tx.engine.schema_locked:
+                raise exceptions.DbSchemaLockedError(
+                    f"Cannot create missing column: schema is locked. Original error: {e}"
+                ) from e
+                
+            # Existing logic for automatic creation
             data = {}
             if "pk" in kwds:
                 data.update(kwds["pk"])
@@ -121,8 +130,16 @@ def create_missing(func):
                     data.update(arg)
             self.alter(data)
             return func(self, *args, **kwds)
-        except exceptions.DbTableMissingError:
+        except exceptions.DbTableMissingError as e:
             self.tx.rollback_savepoint(sp, cursor=self.cursor())
+            
+            # Check if schema is locked
+            if self.tx.engine.schema_locked:
+                raise exceptions.DbSchemaLockedError(
+                    f"Cannot create missing table: schema is locked. Original error: {e}"
+                ) from e
+                
+            # Existing logic for automatic creation
             data = {}
             if "pk" in kwds:
                 data.update(kwds["pk"])

velocity/db/core/engine.py

@@ -1,5 +1,7 @@
 import inspect
 import re
+import os
+from contextlib import contextmanager
 from functools import wraps
 from velocity.db import exceptions
 from velocity.db.core.transaction import Transaction
@@ -17,11 +19,12 @@ class Engine:
 
     MAX_RETRIES = 100
 
-    def __init__(self, driver, config, sql, connect_timeout=5):
+    def __init__(self, driver, config, sql, connect_timeout=5, schema_locked=False):
         self.__config = config
         self.__sql = sql
         self.__driver = driver
         self.__connect_timeout = connect_timeout
+        self.__schema_locked = schema_locked
 
     def __str__(self):
         return f"[{self.sql.server}] engine({self.config})"
@@ -205,6 +208,29 @@ class Engine:
     def sql(self):
         return self.__sql
 
+    @property
+    def schema_locked(self):
+        """Returns True if schema modifications are locked."""
+        return self.__schema_locked
+
+    def lock_schema(self):
+        """Lock schema to prevent automatic modifications."""
+        self.__schema_locked = True
+
+    def unlock_schema(self):
+        """Unlock schema to allow automatic modifications."""
+        self.__schema_locked = False
+
+    @contextmanager
+    def unlocked_schema(self):
+        """Temporarily unlock schema for automatic creation."""
+        original_state = self.__schema_locked
+        self.__schema_locked = False
+        try:
+            yield self
+        finally:
+            self.__schema_locked = original_state
+
     @property
     def version(self):
         """
@@ -353,12 +379,12 @@ class Engine:
         if sql:
             formatted_sql_info = f" sql={self._format_sql_with_params(sql, parameters)}"
 
-        logger.warning(
-            "Database error caught. Attempting to transform: code=%s message=%s%s",
-            error_code,
-            error_message,
-            formatted_sql_info,
-        )
+        # logger.warning(
+        #     "Database error caught. Attempting to transform: code=%s message=%s%s",
+        #     error_code,
+        #     error_message,
+        #     formatted_sql_info,
+        # )
 
         # Direct error code mapping
         if error_code in self.sql.ApplicationErrorCodes:

velocity/db/exceptions.py

@@ -93,6 +93,12 @@ class DbTransactionError(DbException):
     pass
 
 
+class DbSchemaLockedError(DbApplicationError):
+    """Raised when attempting to modify schema while schema is locked."""
+
+    pass
+
+
 class DuplicateRowsFoundError(Exception):
     """Multiple rows found when expecting single result."""
 
@@ -125,5 +131,6 @@ __all__ = [
     "DbDataIntegrityError",
     "DbQueryError",
     "DbTransactionError",
+    "DbSchemaLockedError",
     "DuplicateRowsFoundError",
 ]

velocity/db/servers/base/initializer.py

@@ -16,12 +16,13 @@ class BaseInitializer(ABC):
 
     @staticmethod
     @abstractmethod
-    def initialize(config: Optional[Dict[str, Any]] = None, **kwargs) -> engine.Engine:
+    def initialize(config: Optional[Dict[str, Any]] = None, schema_locked: bool = False, **kwargs) -> engine.Engine:
         """
         Initialize a database engine with the appropriate driver and configuration.
         
         Args:
             config: Configuration dictionary (can be None)
+            schema_locked: Boolean to lock schema modifications (default: False)
             **kwargs: Additional configuration parameters
             
         Returns:

velocity/db/servers/mysql/__init__.py

@@ -8,12 +8,13 @@ class MySQLInitializer(BaseInitializer):
     """MySQL database initializer."""
 
     @staticmethod
-    def initialize(config=None, **kwargs):
+    def initialize(config=None, schema_locked=False, **kwargs):
         """
         Initialize MySQL engine with mysql.connector driver.
         
         Args:
             config: Configuration dictionary
+            schema_locked: Boolean to lock schema modifications
             **kwargs: Additional configuration parameters
             
         Returns:
@@ -55,10 +56,18 @@ class MySQLInitializer(BaseInitializer):
         required_keys = ["database", "host", "user"]
         MySQLInitializer._validate_required_config(final_config, required_keys)
         
-        return engine.Engine(mysql.connector, final_config, SQL)
+        # Check for environment variable override for schema locking
+        if os.environ.get("VELOCITY_SCHEMA_LOCKED", "").lower() in ('true', '1', 'yes'):
+            schema_locked = True
+        
+        return engine.Engine(mysql.connector, final_config, SQL, schema_locked=schema_locked)
 
 
 # Maintain backward compatibility
-def initialize(config=None, **kwargs):
+def initialize(config=None, schema_locked=False, **kwargs):
     """Backward compatible initialization function."""
-    return MySQLInitializer.initialize(config, **kwargs)
+    # Check for environment variable override for schema locking
+    if os.environ.get("VELOCITY_SCHEMA_LOCKED", "").lower() in ('true', '1', 'yes'):
+        schema_locked = True
+        
+    return MySQLInitializer.initialize(config, schema_locked, **kwargs)

velocity/db/servers/postgres/__init__.py

@@ -9,12 +9,13 @@ class PostgreSQLInitializer(BaseInitializer):
     """PostgreSQL database initializer."""
 
     @staticmethod
-    def initialize(config=None, **kwargs):
+    def initialize(config=None, schema_locked=False, **kwargs):
         """
         Initialize PostgreSQL engine with psycopg2 driver.
         
         Args:
             config: Configuration dictionary
+            schema_locked: Boolean to lock schema modifications
             **kwargs: Additional configuration parameters
             
         Returns:
@@ -39,11 +40,15 @@ class PostgreSQLInitializer(BaseInitializer):
         required_keys = ["database", "host", "user", "password"]
         PostgreSQLInitializer._validate_required_config(final_config, required_keys)
         
-        return engine.Engine(psycopg2, final_config, SQL)
+        # Check for environment variable override for schema locking
+        if os.environ.get("VELOCITY_SCHEMA_LOCKED", "").lower() in ('true', '1', 'yes'):
+            schema_locked = True
+        
+        return engine.Engine(psycopg2, final_config, SQL, schema_locked=schema_locked)
 
 
 # Maintain backward compatibility
-def initialize(config=None, **kwargs):
+def initialize(config=None, schema_locked=False, **kwargs):
     """Backward compatible initialization function - matches original behavior exactly."""
     konfig = {
         "database": os.environ["DBDatabase"],
@@ -54,4 +59,9 @@ def initialize(config=None, **kwargs):
     }
     konfig.update(config or {})
     konfig.update(kwargs)
-    return engine.Engine(psycopg2, konfig, SQL)
+    
+    # Check for environment variable override for schema locking
+    if os.environ.get("VELOCITY_SCHEMA_LOCKED", "").lower() in ('true', '1', 'yes'):
+        schema_locked = True
+        
+    return engine.Engine(psycopg2, konfig, SQL, schema_locked=schema_locked)

velocity/db/servers/sqlite/__init__.py

@@ -9,12 +9,13 @@ class SQLiteInitializer(BaseInitializer):
     """SQLite database initializer."""
 
     @staticmethod
-    def initialize(config=None, **kwargs):
+    def initialize(config=None, schema_locked=False, **kwargs):
         """
         Initialize SQLite engine with sqlite3 driver.
         
         Args:
             config: Configuration dictionary
+            schema_locked: Boolean to lock schema modifications
             **kwargs: Additional configuration parameters
             
         Returns:
@@ -43,10 +44,18 @@ class SQLiteInitializer(BaseInitializer):
         required_keys = ["database"]
         SQLiteInitializer._validate_required_config(final_config, required_keys)
         
-        return engine.Engine(sqlite3, final_config, SQL)
+        # Check for environment variable override for schema locking
+        if os.environ.get("VELOCITY_SCHEMA_LOCKED", "").lower() in ('true', '1', 'yes'):
+            schema_locked = True
+        
+        return engine.Engine(sqlite3, final_config, SQL, schema_locked=schema_locked)
 
 
 # Maintain backward compatibility
-def initialize(config=None, **kwargs):
+def initialize(config=None, schema_locked=False, **kwargs):
     """Backward compatible initialization function."""
-    return SQLiteInitializer.initialize(config, **kwargs)
+    # Check for environment variable override for schema locking
+    if os.environ.get("VELOCITY_SCHEMA_LOCKED", "").lower() in ('true', '1', 'yes'):
+        schema_locked = True
+        
+    return SQLiteInitializer.initialize(config, schema_locked, **kwargs)

velocity/db/servers/sqlserver/__init__.py

@@ -8,12 +8,13 @@ class SQLServerInitializer(BaseInitializer):
     """SQL Server database initializer."""
 
     @staticmethod
-    def initialize(config=None, **kwargs):
+    def initialize(config=None, schema_locked=False, **kwargs):
         """
         Initialize SQL Server engine with pytds driver.
         
         Args:
             config: Configuration dictionary
+            schema_locked: Boolean to lock schema modifications
             **kwargs: Additional configuration parameters
             
         Returns:
@@ -55,10 +56,18 @@ class SQLServerInitializer(BaseInitializer):
         required_keys = ["database", "server", "user"]
         SQLServerInitializer._validate_required_config(final_config, required_keys)
         
-        return engine.Engine(pytds, final_config, SQL)
+        # Check for environment variable override for schema locking
+        if os.environ.get("VELOCITY_SCHEMA_LOCKED", "").lower() in ('true', '1', 'yes'):
+            schema_locked = True
+        
+        return engine.Engine(pytds, final_config, SQL, schema_locked=schema_locked)
 
 
 # Maintain backward compatibility
-def initialize(config=None, **kwargs):
+def initialize(config=None, schema_locked=False, **kwargs):
     """Backward compatible initialization function."""
-    return SQLServerInitializer.initialize(config, **kwargs)
+    # Check for environment variable override for schema locking
+    if os.environ.get("VELOCITY_SCHEMA_LOCKED", "").lower() in ('true', '1', 'yes'):
+        schema_locked = True
+        
+    return SQLServerInitializer.initialize(config, schema_locked, **kwargs)

velocity/db/tests/__init__.py

@@ -0,0 +1 @@
+# Database module tests

velocity/db/tests/postgres/__init__.py

@@ -0,0 +1 @@
+# PostgreSQL tests

velocity/db/tests/postgres/common.py

@@ -0,0 +1,49 @@
+import unittest
+from velocity.db.servers import postgres
+import env
+env.set()
+
+test_db = "test_db_postgres"
+engine = postgres.initialize(database=test_db)
+
+
+class CommonPostgresTest(unittest.TestCase):
+    """
+    Base test class for PostgreSQL tests following the common pattern.
+    All PostgreSQL tests should inherit from this class.
+    """
+
+    @classmethod
+    def setUpClass(cls):
+        """Set up the test database and create any common tables."""
+        @engine.transaction
+        def setup(tx):
+            tx.switch_to_database("postgres")
+            tx.execute(f"drop database if exists {test_db}", single=True)
+            
+            # Create the test database
+            db = tx.database(test_db)
+            if not db.exists():
+                db.create()
+            db.switch()
+
+            # Call subclass-specific table creation with commit
+            if hasattr(cls, 'create_test_tables'):
+                cls.create_test_tables(tx)
+        
+        setup()
+
+    @classmethod
+    def tearDownClass(cls):
+        """Clean up the test database."""
+        @engine.transaction
+        def cleanup(tx):
+            tx.switch_to_database("postgres")
+            tx.execute(f"drop database if exists {test_db}", single=True)
+        
+        cleanup()
+
+    @classmethod
+    def create_test_tables(cls, tx):
+        """Override this method in subclasses to create test-specific tables."""
+        pass

velocity/db/tests/postgres/test_column.py

@@ -0,0 +1,29 @@
+import unittest
+from velocity.db.core.column import Column
+from velocity.db.exceptions import DbColumnMissingError
+from .common import CommonPostgresTest, engine, test_db
+
+
+@engine.transaction
+@engine.transaction
+class TestColumn(CommonPostgresTest):
+    
+    @classmethod
+    def create_test_tables(cls, tx):
+        """Create test tables for column tests."""
+        tx.table("mock_table").create(
+            columns={
+                "column1": int,
+                "column2": str,
+                "column3": str,
+            }
+        )
+    
+    def test_init(self, tx):
+        column = tx.table("mock_table").column("column1")
+        self.assertIsInstance(column, Column)
+        self.assertEqual(column.name, "column1")
+
+
+if __name__ == "__main__":
+    unittest.main()

velocity/db/tests/postgres/test_connections.py

@@ -0,0 +1,25 @@
+import unittest
+from .common import CommonPostgresTest, engine, test_db
+
+
+@engine.transaction
+@engine.transaction
+class TestConnections(CommonPostgresTest):
+    
+    @classmethod
+    def create_test_tables(cls, tx):
+        """Create test tables for connection tests."""
+        tx.table("mock_table").create(
+            columns={
+                "column1": int,
+                "column2": str,
+                "column3": str,
+            }
+        )
+    def test_init(self, tx):
+        # Test the initialization of the Database object
+        assert tx.table("mock_table").exists()
+
+
+if __name__ == "__main__":
+    unittest.main()

velocity/db/tests/postgres/test_database.py

@@ -0,0 +1,21 @@
+import unittest
+from velocity.db.core.database import Database
+from .common import CommonPostgresTest, engine, test_db
+
+
+@engine.transaction
+@engine.transaction
+class TestDatabase(CommonPostgresTest):
+
+    @classmethod
+    def create_test_tables(cls, tx):
+        """No special tables needed for database tests."""
+        pass
+
+    def test_init(self, tx):
+        # Test the initialization of the Database object
+        tx.database
+
+
+if __name__ == "__main__":
+    unittest.main()