velocity-python 0.1.1__tar.gz → 0.1.2__tar.gz

{velocity_python-0.1.1 → velocity_python-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.1.1
+Version: 0.1.2
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT
@@ -19,12 +19,16 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: boto3>=1.35.0
-Requires-Dist: requests>=2.32.0
-Requires-Dist: jinja2>=3.1.0
-Requires-Dist: xlrd>=2.0.1
-Requires-Dist: openpyxl>=3.1.0
 Requires-Dist: sqlparse>=0.5.0
+Provides-Extra: aws
+Requires-Dist: boto3>=1.35.0; extra == "aws"
+Requires-Dist: requests>=2.32.0; extra == "aws"
+Provides-Extra: excel
+Requires-Dist: openpyxl>=3.1.0; extra == "excel"
+Provides-Extra: templates
+Requires-Dist: jinja2>=3.1.0; extra == "templates"
+Provides-Extra: http
+Requires-Dist: requests>=2.32.0; extra == "http"
 Provides-Extra: mysql
 Requires-Dist: mysql-connector-python>=9.0.0; extra == "mysql"
 Provides-Extra: sqlserver
@@ -34,6 +38,8 @@ Requires-Dist: psycopg[binary]>=3.2.0; extra == "postgres"
 Provides-Extra: payment
 Requires-Dist: stripe>=12.0.0; extra == "payment"
 Requires-Dist: braintree>=4.30.0; extra == "payment"
+Provides-Extra: all
+Requires-Dist: velocity-python[aws,excel,http,payment,postgres,templates]; extra == "all"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=6.0.0; extra == "dev"

{velocity_python-0.1.1 → velocity_python-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "velocity-python"
-version = "0.1.1"
+version = "0.1.2"
 authors = [
   { name="Velocity Team", email="info@codeclubs.org" },
 ]
@@ -26,11 +26,6 @@ classifiers = [
     "Operating System :: OS Independent",
 ]
 dependencies = [
-  "boto3>=1.35.0",
-  "requests>=2.32.0",
-  "jinja2>=3.1.0",
-  "xlrd>=2.0.1",
-  "openpyxl>=3.1.0",
   "sqlparse>=0.5.0"
 ]
 
@@ -38,6 +33,19 @@ dependencies = [
 Homepage = "https://codeclubs.org/projects/velocity"
 
 [project.optional-dependencies]
+aws = [
+  "boto3>=1.35.0",
+  "requests>=2.32.0",
+]
+excel = [
+  "openpyxl>=3.1.0",
+]
+templates = [
+  "jinja2>=3.1.0",
+]
+http = [
+  "requests>=2.32.0",
+]
 mysql = [
   "mysql-connector-python>=9.0.0",
 ]
@@ -51,6 +59,9 @@ payment = [
   "stripe>=12.0.0",
   "braintree>=4.30.0",
 ]
+all = [
+  "velocity-python[postgres,aws,excel,templates,http,payment]",
+]
 dev = [
   "pytest>=8.0.0",
   "pytest-cov>=6.0.0",

velocity_python-0.1.2/src/velocity/__init__.py

@@ -0,0 +1,17 @@
+__version__ = version = "0.1.2"
+
+import importlib as _importlib
+
+from . import db
+from . import misc
+from . import app
+
+__all__ = ["aws", "db", "misc", "app"]
+
+_LAZY_SUBMODULES = {"aws"}
+
+
+def __getattr__(name: str):
+    if name in _LAZY_SUBMODULES:
+        return _importlib.import_module(f".{name}", __name__)
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

{velocity_python-0.1.1 → velocity_python-0.1.2}/src/velocity/aws/__init__.py

@@ -1,15 +1,5 @@
+import importlib as _importlib
 import os
-import requests
-
-from velocity.aws.amplify import AmplifyProject
-from velocity.aws.amplify_build import (
-    BackendDeploymentConfig,
-    build_environment_variables,
-    get_amplify_app_id_and_branch,
-    initialize_build_environment,
-    run_backend_deployment,
-    update_lambda_layers_to_latest,
-)
 
 DEBUG = (os.environ.get("ENV") != "production") or (os.environ.get("DEBUG") == "Y")
 
@@ -23,11 +13,31 @@ class AWS(object):
     # Get AWS EC2 Instance ID. Must run this from the EC2 instance itself to get the ID
     @staticmethod
     def instance_id(cls):
+        import requests
         response = requests.get("http://169.254.169.254/latest/meta-data/instance-id")
         instance_id = response.text
         return instance_id
 
 
+# Lazy-load heavy modules (boto3-dependent) on first access
+_LAZY_ATTRS = {
+    "AmplifyProject": "velocity.aws.amplify",
+    "BackendDeploymentConfig": "velocity.aws.amplify_build",
+    "build_environment_variables": "velocity.aws.amplify_build",
+    "get_amplify_app_id_and_branch": "velocity.aws.amplify_build",
+    "initialize_build_environment": "velocity.aws.amplify_build",
+    "run_backend_deployment": "velocity.aws.amplify_build",
+    "update_lambda_layers_to_latest": "velocity.aws.amplify_build",
+}
+
+
+def __getattr__(name: str):
+    if name in _LAZY_ATTRS:
+        module = _importlib.import_module(_LAZY_ATTRS[name])
+        return getattr(module, name)
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
 __all__ = [
     "AmplifyProject",
     "AWS",

{velocity_python-0.1.1 → velocity_python-0.1.2}/src/velocity/db/core/row.py

@@ -1,4 +1,5 @@
 import pprint
+import time as _time
 import warnings
 from collections.abc import MutableMapping
 from velocity.db.exceptions import DbColumnMissingError
@@ -8,6 +9,7 @@ from velocity.db.exceptions import DbColumnMissingError
 # intercepted by __getattr__ / __setattr__.
 _INTERNAL_ATTRS = frozenset({
     "table", "pk", "_cache", "_column_set", "_batching", "_pending",
+    "_cache_ttl", "_cache_time", "_no_cache",
 })
 
 
@@ -23,7 +25,7 @@ class Row(MutableMapping):
     write-through (immediate UPDATE) and also update the local cache.
     """
 
-    def __init__(self, table, key, lock=None):
+    def __init__(self, table, key, lock=None, cache_ttl=None, no_cache=False):
         if isinstance(table, str):
             raise Exception("Table parameter must be a `table` instance.")
         object.__setattr__(self, "table", table)
@@ -43,6 +45,9 @@ class Row(MutableMapping):
         object.__setattr__(self, "_column_set", None)
         object.__setattr__(self, "_batching", False)
         object.__setattr__(self, "_pending", {})
+        object.__setattr__(self, "_cache_ttl", cache_ttl)
+        object.__setattr__(self, "_cache_time", None)
+        object.__setattr__(self, "_no_cache", no_cache)
         if lock:
             self.lock()
 
@@ -51,10 +56,20 @@ class Row(MutableMapping):
     # ------------------------------------------------------------------
 
     def _ensure_cache(self):
-        """Populate the local cache from the database if not yet loaded."""
+        """Populate the local cache from the database if not yet loaded or expired."""
+        if self._no_cache:
+            # Always fetch fresh — never store in cache
+            data = self.table.select(where=self.pk).as_dict().one()
+            return data or {}
+        if self._cache is not None and self._cache_ttl is not None:
+            elapsed = _time.monotonic() - (self._cache_time or 0)
+            if elapsed > self._cache_ttl:
+                object.__setattr__(self, "_cache", None)
+                object.__setattr__(self, "_column_set", None)
         if self._cache is None:
             data = self.table.select(where=self.pk).as_dict().one()
             object.__setattr__(self, "_cache", data or {})
+            object.__setattr__(self, "_cache_time", _time.monotonic())
         return self._cache
 
     def _column_names_lower(self):
@@ -232,9 +247,9 @@ class Row(MutableMapping):
             data.update(kwds)
         if data:
             self.table.update_or_insert(data, pk=self.pk)
-            if self._cache is not None:
-                self._cache.update(data)
-                object.__setattr__(self, "_column_set", None)
+            # Invalidate cache so trigger-computed columns are re-fetched
+            object.__setattr__(self, "_cache", None)
+            object.__setattr__(self, "_column_set", None)
         return self
 
     def copy(self, lock=None):
@@ -366,6 +381,29 @@ class Row(MutableMapping):
         self.table.select(where=self.pk, lock=True)
         return self
 
+    def with_lock(self):
+        """SELECT ... FOR UPDATE and clear the cache so the next read is fresh.
+
+        Returns self for chaining::
+
+            row = row.with_lock()
+            balance = row["balance"]  # guaranteed fresh, locked
+        """
+        self.table.select(where=self.pk, lock=True)
+        object.__setattr__(self, "_cache", None)
+        object.__setattr__(self, "_column_set", None)
+        return self
+
+    def no_cache(self):
+        """Return a new Row that never caches — every read hits the database.
+
+        Useful for critical-path reads where staleness is unacceptable::
+
+            fresh_row = row.no_cache()
+            balance = fresh_row["balance"]  # always from DB
+        """
+        return Row(self.table, self.pk, no_cache=True)
+
     def notBlank(self, key, failobj=None):
         """
         Returns the value if it is not blank, else failobj.

{velocity_python-0.1.1 → velocity_python-0.1.2}/src/velocity/db/core/table.py

@@ -400,13 +400,13 @@ class Table:
         """
         return Column(self, name)
 
-    def row(self, key=None, lock=None):
+    def row(self, key=None, lock=None, cache_ttl=None, no_cache=False):
         """
         Retrieves a Row instance for the given primary key or conditions dict. If `key` is None, returns a new row.
         """
         if key is None:
             return self.new(lock=lock)
-        return Row(self, key, lock=lock)
+        return Row(self, key, lock=lock, cache_ttl=cache_ttl, no_cache=no_cache)
 
     def dict(self, key):
         """
@@ -415,14 +415,14 @@ class Table:
         r = self.find(key)
         return r.to_dict() if r else {}
 
-    def rows(self, where=None, orderby=None, qty=None, lock=None, skip_locked=None):
+    def rows(self, where=None, orderby=None, qty=None, lock=None, skip_locked=None, cache_ttl=None, no_cache=False):
         """
         Generator that yields Row objects matching `where`, up to `qty`.
         """
         for key in self.ids(
             where=where, orderby=orderby, qty=qty, lock=lock, skip_locked=skip_locked
         ):
-            yield Row(self, key, lock=lock)
+            yield Row(self, key, lock=lock, cache_ttl=cache_ttl, no_cache=no_cache)
 
     def ids(
         self,

{velocity_python-0.1.1 → velocity_python-0.1.2}/src/velocity/misc/export.py

@@ -1,13 +1,15 @@
+from __future__ import annotations
+
 from datetime import date, datetime, time, timedelta
 from decimal import Decimal
 from io import BytesIO
-from typing import Dict, List
+from typing import TYPE_CHECKING, Dict, List
 import base64
 import re
 
-import openpyxl
-from openpyxl.styles import Alignment, Border, Font, NamedStyle, Side
-from openpyxl.utils import get_column_letter
+if TYPE_CHECKING:  # pragma: no cover
+    import openpyxl
+    from openpyxl.styles import NamedStyle
 
 
 NUMBER_FORMAT_RE = re.compile(r"[#0?][#0?,]*(?:\.[#0?]+)?")
@@ -107,6 +109,8 @@ def _display_value(cell) -> str:
 
 def autosize_columns(ws, fixed: Dict[str, float] | None = None):
     """Autosize columns in the worksheet based on content length."""
+    from openpyxl.utils import get_column_letter
+
     fixed = fixed or {}
     for col in ws.columns:
         max_length = 0
@@ -135,6 +139,9 @@ def create_spreadsheet(
     auto_size: bool = True,
 ):
     """Create an Excel spreadsheet with specified headers, rows, and styles."""
+    import openpyxl
+    from openpyxl.styles import Alignment, Border, Font, NamedStyle, Side
+
     styles = styles or {}
     merge = merge or []
     formats = formats or {}

{velocity_python-0.1.1 → velocity_python-0.1.2}/src/velocity_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.1.1
+Version: 0.1.2
 Summary: A rapid application development library for interfacing with data storage
 Author-email: Velocity Team <info@codeclubs.org>
 License-Expression: MIT
@@ -19,12 +19,16 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: boto3>=1.35.0
-Requires-Dist: requests>=2.32.0
-Requires-Dist: jinja2>=3.1.0
-Requires-Dist: xlrd>=2.0.1
-Requires-Dist: openpyxl>=3.1.0
 Requires-Dist: sqlparse>=0.5.0
+Provides-Extra: aws
+Requires-Dist: boto3>=1.35.0; extra == "aws"
+Requires-Dist: requests>=2.32.0; extra == "aws"
+Provides-Extra: excel
+Requires-Dist: openpyxl>=3.1.0; extra == "excel"
+Provides-Extra: templates
+Requires-Dist: jinja2>=3.1.0; extra == "templates"
+Provides-Extra: http
+Requires-Dist: requests>=2.32.0; extra == "http"
 Provides-Extra: mysql
 Requires-Dist: mysql-connector-python>=9.0.0; extra == "mysql"
 Provides-Extra: sqlserver
@@ -34,6 +38,8 @@ Requires-Dist: psycopg[binary]>=3.2.0; extra == "postgres"
 Provides-Extra: payment
 Requires-Dist: stripe>=12.0.0; extra == "payment"
 Requires-Dist: braintree>=4.30.0; extra == "payment"
+Provides-Extra: all
+Requires-Dist: velocity-python[aws,excel,http,payment,postgres,templates]; extra == "all"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=6.0.0; extra == "dev"

{velocity_python-0.1.1 → velocity_python-0.1.2}/src/velocity_python.egg-info/SOURCES.txt

@@ -168,6 +168,7 @@ tests/test_prepared_statements.py
 tests/test_psycopg3_upgrade.py
 tests/test_query_cache.py
 tests/test_row_batch_update.py
+tests/test_row_cache_staleness.py
 tests/test_sqs_per_record_transactions.py
 tests/test_sys_modified_count_postgres_demo.py
 tests/test_table_alter.py

{velocity_python-0.1.1 → velocity_python-0.1.2}/src/velocity_python.egg-info/requires.txt

@@ -1,9 +1,11 @@
+sqlparse>=0.5.0
+
+[all]
+velocity-python[aws,excel,http,payment,postgres,templates]
+
+[aws]
 boto3>=1.35.0
 requests>=2.32.0
-jinja2>=3.1.0
-xlrd>=2.0.1
-openpyxl>=3.1.0
-sqlparse>=0.5.0
 
 [dev]
 pytest>=8.0.0
@@ -17,6 +19,12 @@ pre-commit>=4.0.0
 sphinx>=8.0.0
 sphinx-rtd-theme>=3.0.0
 
+[excel]
+openpyxl>=3.1.0
+
+[http]
+requests>=2.32.0
+
 [mysql]
 mysql-connector-python>=9.0.0
 
@@ -30,6 +38,9 @@ psycopg[binary]>=3.2.0
 [sqlserver]
 python-tds>=1.15.0
 
+[templates]
+jinja2>=3.1.0
+
 [test]
 pytest>=8.0.0
 pytest-cov>=6.0.0

{velocity_python-0.1.1 → velocity_python-0.1.2}/tests/test_row_batch_update.py

@@ -26,6 +26,9 @@ def _make_row(cache=None, pk=None):
     object.__setattr__(row, "_column_set", None)
     object.__setattr__(row, "_batching", False)
     object.__setattr__(row, "_pending", {})
+    object.__setattr__(row, "_cache_ttl", None)
+    object.__setattr__(row, "_cache_time", None)
+    object.__setattr__(row, "_no_cache", False)
     return row