velocity-python 0.1.7__tar.gz → 0.1.9__tar.gz

{velocity_python-0.1.7/src/velocity_python.egg-info → velocity_python-0.1.9}/PKG-INFO

@@ -1,10 +1,12 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.1.7
+Version: 0.1.9
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT
 Project-URL: Homepage, https://codeclubs.org/projects/velocity
+Project-URL: Documentation, https://codeclubs.org/projects/velocity
+Project-URL: Bug Tracker, https://codeclubs.org/projects/velocity
 Keywords: database,orm,sql,rapid-development,data-storage
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -81,7 +83,7 @@ def create_order(tx, customer_email, items):
 No connection management, no cursor juggling, no commit/rollback boilerplate. Velocity handles it all.
 
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
 
 ---
 
@@ -208,25 +210,19 @@ def import_customers(tx, records):
 
 ## Documentation
 
-Detailed guides with real-world examples:
-
-| Guide | Description |
-|-------|-------------|
-| [Database ORM](docs/database.md) | Connections, transactions, tables, rows, results, queries, schema management |
-| [Performance & Optimization](docs/performance.md) | Connection pooling, batch operations, query caching, prepared statements, N+1 prevention, observability |
-| [Async Support](docs/async.md) | AsyncTransaction, AsyncTable, AsyncResult, parallel queries with gather() |
-| [Configuration Reference](docs/configuration.md) | All environment variables, engine options, and connection settings |
-| [AWS Lambda Handlers](docs/aws-handlers.md) | LambdaHandler, SqsHandler, auth modes, per-record transactions |
-| [Payment Processing](docs/payment.md) | Stripe and Braintree adapters, payment lifecycle |
-| [Utilities](docs/utilities.md) | Excel export, data conversion, formatting, timers, email parsing |
-
-### Additional Docs
-
-| Doc | Description |
-|-----|-------------|
-| [Testing Guide](docs/TESTING.md) | Running tests, markers, coverage |
-| [Security](docs/SECURITY.md) | Pre-commit hooks, credential scanning |
-| [AWS Auth Modes](docs/AWS_HANDLERS_AUTH.md) | Cognito auth, public endpoints, webhooks |
+Full documentation is included in the `docs/` directory of the source distribution.
+
+| Guide | File | Description |
+|-------|------|-------------|
+| Database ORM | `docs/database.md` | Connections, transactions, tables, rows, results, queries, schema management |
+| Performance & Optimization | `docs/performance.md` | Connection pooling, batch operations, query caching, prepared statements, N+1 prevention, observability |
+| Async Support | `docs/async.md` | AsyncTransaction, AsyncTable, AsyncResult, parallel queries with gather() |
+| Configuration Reference | `docs/configuration.md` | All environment variables, engine options, and connection settings |
+| AWS Lambda Handlers | `docs/aws-handlers.md` | LambdaHandler, SqsHandler, auth modes, per-record transactions |
+| Payment Processing | `docs/payment.md` | Stripe and Braintree adapters, payment lifecycle |
+| Utilities | `docs/utilities.md` | Excel export, data conversion, formatting, timers, email parsing |
+| Testing Guide | `docs/TESTING.md` | Running tests, markers, coverage |
+| Security | `docs/SECURITY.md` | Pre-commit hooks, credential scanning |
 
 ---
 

{velocity_python-0.1.7 → velocity_python-0.1.9}/README.md

@@ -21,7 +21,7 @@ def create_order(tx, customer_email, items):
 No connection management, no cursor juggling, no commit/rollback boilerplate. Velocity handles it all.
 
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
 
 ---
 
@@ -148,25 +148,19 @@ def import_customers(tx, records):
 
 ## Documentation
 
-Detailed guides with real-world examples:
-
-| Guide | Description |
-|-------|-------------|
-| [Database ORM](docs/database.md) | Connections, transactions, tables, rows, results, queries, schema management |
-| [Performance & Optimization](docs/performance.md) | Connection pooling, batch operations, query caching, prepared statements, N+1 prevention, observability |
-| [Async Support](docs/async.md) | AsyncTransaction, AsyncTable, AsyncResult, parallel queries with gather() |
-| [Configuration Reference](docs/configuration.md) | All environment variables, engine options, and connection settings |
-| [AWS Lambda Handlers](docs/aws-handlers.md) | LambdaHandler, SqsHandler, auth modes, per-record transactions |
-| [Payment Processing](docs/payment.md) | Stripe and Braintree adapters, payment lifecycle |
-| [Utilities](docs/utilities.md) | Excel export, data conversion, formatting, timers, email parsing |
-
-### Additional Docs
-
-| Doc | Description |
-|-----|-------------|
-| [Testing Guide](docs/TESTING.md) | Running tests, markers, coverage |
-| [Security](docs/SECURITY.md) | Pre-commit hooks, credential scanning |
-| [AWS Auth Modes](docs/AWS_HANDLERS_AUTH.md) | Cognito auth, public endpoints, webhooks |
+Full documentation is included in the `docs/` directory of the source distribution.
+
+| Guide | File | Description |
+|-------|------|-------------|
+| Database ORM | `docs/database.md` | Connections, transactions, tables, rows, results, queries, schema management |
+| Performance & Optimization | `docs/performance.md` | Connection pooling, batch operations, query caching, prepared statements, N+1 prevention, observability |
+| Async Support | `docs/async.md` | AsyncTransaction, AsyncTable, AsyncResult, parallel queries with gather() |
+| Configuration Reference | `docs/configuration.md` | All environment variables, engine options, and connection settings |
+| AWS Lambda Handlers | `docs/aws-handlers.md` | LambdaHandler, SqsHandler, auth modes, per-record transactions |
+| Payment Processing | `docs/payment.md` | Stripe and Braintree adapters, payment lifecycle |
+| Utilities | `docs/utilities.md` | Excel export, data conversion, formatting, timers, email parsing |
+| Testing Guide | `docs/TESTING.md` | Running tests, markers, coverage |
+| Security | `docs/SECURITY.md` | Pre-commit hooks, credential scanning |
 
 ---
 

{velocity_python-0.1.7 → velocity_python-0.1.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "velocity-python"
-version = "0.1.7"
+version = "0.1.9"
 authors = [
   { name="Velocity Team", email="info@codeclubs.org" },
 ]
@@ -31,6 +31,8 @@ dependencies = [
 
 [project.urls]
 Homepage = "https://codeclubs.org/projects/velocity"
+Documentation = "https://codeclubs.org/projects/velocity"
+"Bug Tracker" = "https://codeclubs.org/projects/velocity"
 
 [project.optional-dependencies]
 aws = [

{velocity_python-0.1.7 → velocity_python-0.1.9}/src/velocity/__init__.py

@@ -1,4 +1,4 @@
-__version__ = version = "0.1.7"
+__version__ = version = "0.1.9"
 
 import importlib as _importlib
 

{velocity_python-0.1.7 → velocity_python-0.1.9}/src/velocity/db/core/decorators.py

@@ -171,6 +171,11 @@ def create_missing(func):
 
             # Check if schema is locked
             if self.tx.engine.schema_locked:
+                logger.warning(
+                    "@create_missing triggered on locked schema: table=%s error=%s",
+                    self.name, e,
+                    extra={"table_name": self.name, "operation": "create_missing_column", "schema_locked": True},
+                )
                 raise exceptions.DbSchemaLockedError(
                     f"Cannot create missing column: schema is locked. Original error: {e}"
                 ) from e
@@ -205,6 +210,11 @@ def create_missing(func):
 
             # Check if schema is locked
             if self.tx.engine.schema_locked:
+                logger.warning(
+                    "@create_missing triggered on locked schema: table=%s error=%s",
+                    self.name, e,
+                    extra={"table_name": self.name, "operation": "create_missing_table", "schema_locked": True},
+                )
                 raise exceptions.DbSchemaLockedError(
                     f"Cannot create missing table: schema is locked. Original error: {e}"
                 ) from e

{velocity_python-0.1.7 → velocity_python-0.1.9/src/velocity_python.egg-info}/PKG-INFO

@@ -1,10 +1,12 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.1.7
+Version: 0.1.9
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT
 Project-URL: Homepage, https://codeclubs.org/projects/velocity
+Project-URL: Documentation, https://codeclubs.org/projects/velocity
+Project-URL: Bug Tracker, https://codeclubs.org/projects/velocity
 Keywords: database,orm,sql,rapid-development,data-storage
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -81,7 +83,7 @@ def create_order(tx, customer_email, items):
 No connection management, no cursor juggling, no commit/rollback boilerplate. Velocity handles it all.
 
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
 
 ---
 
@@ -208,25 +210,19 @@ def import_customers(tx, records):
 
 ## Documentation
 
-Detailed guides with real-world examples:
-
-| Guide | Description |
-|-------|-------------|
-| [Database ORM](docs/database.md) | Connections, transactions, tables, rows, results, queries, schema management |
-| [Performance & Optimization](docs/performance.md) | Connection pooling, batch operations, query caching, prepared statements, N+1 prevention, observability |
-| [Async Support](docs/async.md) | AsyncTransaction, AsyncTable, AsyncResult, parallel queries with gather() |
-| [Configuration Reference](docs/configuration.md) | All environment variables, engine options, and connection settings |
-| [AWS Lambda Handlers](docs/aws-handlers.md) | LambdaHandler, SqsHandler, auth modes, per-record transactions |
-| [Payment Processing](docs/payment.md) | Stripe and Braintree adapters, payment lifecycle |
-| [Utilities](docs/utilities.md) | Excel export, data conversion, formatting, timers, email parsing |
-
-### Additional Docs
-
-| Doc | Description |
-|-----|-------------|
-| [Testing Guide](docs/TESTING.md) | Running tests, markers, coverage |
-| [Security](docs/SECURITY.md) | Pre-commit hooks, credential scanning |
-| [AWS Auth Modes](docs/AWS_HANDLERS_AUTH.md) | Cognito auth, public endpoints, webhooks |
+Full documentation is included in the `docs/` directory of the source distribution.
+
+| Guide | File | Description |
+|-------|------|-------------|
+| Database ORM | `docs/database.md` | Connections, transactions, tables, rows, results, queries, schema management |
+| Performance & Optimization | `docs/performance.md` | Connection pooling, batch operations, query caching, prepared statements, N+1 prevention, observability |
+| Async Support | `docs/async.md` | AsyncTransaction, AsyncTable, AsyncResult, parallel queries with gather() |
+| Configuration Reference | `docs/configuration.md` | All environment variables, engine options, and connection settings |
+| AWS Lambda Handlers | `docs/aws-handlers.md` | LambdaHandler, SqsHandler, auth modes, per-record transactions |
+| Payment Processing | `docs/payment.md` | Stripe and Braintree adapters, payment lifecycle |
+| Utilities | `docs/utilities.md` | Excel export, data conversion, formatting, timers, email parsing |
+| Testing Guide | `docs/TESTING.md` | Running tests, markers, coverage |
+| Security | `docs/SECURITY.md` | Pre-commit hooks, credential scanning |
 
 ---
 

{velocity_python-0.1.7 → velocity_python-0.1.9}/tests/test_concurrency_safety.py

@@ -292,6 +292,40 @@ class TestCreateMissingRaceHandling:
         with pytest.raises(exceptions.DbSchemaLockedError):
             fake_insert(table, {"foo": "bar"})
 
+    def test_schema_locked_logs_warning_on_missing_table(self, caplog):
+        """When schema is locked, should log WARNING before raising."""
+        table = self._make_table()
+        table.tx.engine.schema_locked = True
+
+        @create_missing
+        def fake_insert(self_, data):
+            raise exceptions.DbTableMissingError("table missing")
+
+        import logging
+        with caplog.at_level(logging.WARNING, logger="velocity.db"):
+            with pytest.raises(exceptions.DbSchemaLockedError):
+                fake_insert(table, {"foo": "bar"})
+
+        assert any("@create_missing triggered on locked schema" in r.message for r in caplog.records)
+        assert any(r.operation == "create_missing_table" for r in caplog.records if hasattr(r, "operation"))
+
+    def test_schema_locked_logs_warning_on_missing_column(self, caplog):
+        """When schema is locked, should log WARNING for missing column."""
+        table = self._make_table()
+        table.tx.engine.schema_locked = True
+
+        @create_missing
+        def fake_insert(self_, data):
+            raise exceptions.DbColumnMissingError("column missing")
+
+        import logging
+        with caplog.at_level(logging.WARNING, logger="velocity.db"):
+            with pytest.raises(exceptions.DbSchemaLockedError):
+                fake_insert(table, {"foo": "bar"})
+
+        assert any("@create_missing triggered on locked schema" in r.message for r in caplog.records)
+        assert any(r.operation == "create_missing_column" for r in caplog.records if hasattr(r, "operation"))
+
     def test_advisory_lock_failure_is_nonfatal(self):
         """If advisory_lock raises, DDL should still proceed."""
         table = self._make_table()