velocity-python 0.1.122__tar.gz → 0.1.124__tar.gz

{velocity_python-0.1.122 → velocity_python-0.1.124}/PKG-INFO

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

{velocity_python-0.1.122 → velocity_python-0.1.124}/pyproject.toml

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

{velocity_python-0.1.122 → velocity_python-0.1.124}/src/velocity/__init__.py

@@ -1,4 +1,4 @@
-__version__ = version = "0.1.122"
+__version__ = version = "0.1.124"
 
 import importlib as _importlib
 

{velocity_python-0.1.122 → velocity_python-0.1.124}/src/velocity/aws/capabilities/provisioning.py

@@ -102,8 +102,15 @@ def provision(tx, stage: str, entries, *, now=None) -> list:
 
 
 def _seed_flag_defaults(tx, stage, cap):
-    """Ensure the knob columns exist and fill only the ones that are unset."""
-    tx.table(FLAGS_TABLE).ensure_schema({key: "TEXT" for key in cap.defaults})
+    """Ensure the knob columns exist and fill only the ones that are unset.
+
+    The key column rides along: on a fresh site database this call is what
+    CREATES sys_feature_flags, and without ``applied_system`` the get() below
+    would 42703 (swallowed by @return_default, so it looked like the normal
+    missing-row case and warned on every deploy — dance/demo 2026-09-26)."""
+    tx.table(FLAGS_TABLE).ensure_schema(
+        {feature_flags.SYSTEM_COLUMN: "TEXT", **{key: "TEXT" for key in cap.defaults}}
+    )
     row = feature_flags.get(tx, stage)
     if not row:
         return  # the app's own seed creates the stage row; nothing to fill yet

{velocity_python-0.1.122 → velocity_python-0.1.124}/src/velocity/aws/facets.py

@@ -34,6 +34,9 @@ Facets AND together; the values of one facet OR together. Kinds:
 ``since``     a period ending now: ``today``, ``Nd`` (``7d``, ``30d`` …, up to
               3660 days), ``year`` (this calendar year). Evaluated in the
               database's session time zone.
+``before``    strictly before a day (``YYYY-MM-DD``) or older than a period
+              (``Nd``): ``{"field": "sys_created", "kind": "before", "value":
+              "2026-09-01"}``. With ``since`` it brackets a range.
 ``text``      a write-in, case-insensitive, against ``field::text``:
               ``match`` is ``contains`` (default), ``equals``, ``starts`` or
               ``words`` — every whitespace-separated word of the term must
@@ -72,7 +75,7 @@ from velocity.db.servers.tablehelper import TableHelper
 
 PARAM_KEY = "facets"
 
-KINDS = ("values", "contains", "presence", "since", "text", "domain")
+KINDS = ("values", "contains", "presence", "since", "before", "text", "domain")
 MATCHES = ("contains", "equals", "starts", "words")
 PRESENCE = ("present", "absent")
 
@@ -199,6 +202,27 @@ def _kind_since(column: str, entry: Dict[str, Any], field: str) -> Optional[Pred
     return f"{column} >= now() - make_interval(days => %s)", (days,)
 
 
+_ISO_DATE = re.compile(r"^\d{4}-\d{2}-\d{2}$")
+
+
+def _kind_before(column: str, entry: Dict[str, Any], field: str) -> Optional[Predicate]:
+    """Rows strictly before a day (``YYYY-MM-DD``: anything earlier than that
+    day's midnight) or older than a period (``Nd``: before N days ago). The
+    complement of ``since`` — together they bracket a date range."""
+    value = _one(entry, field).lower()
+    if not value:
+        return None
+    if _ISO_DATE.match(value):
+        return f"{column} < %s::date", (value,)
+    match = _DAYS.match(value)
+    if not match:
+        raise FacetError(f"facet {field}: before must be YYYY-MM-DD or <N>d")
+    days = int(match.group(1))
+    if not 1 <= days <= MAX_DAYS:
+        raise FacetError(f"facet {field}: period must be 1 to {MAX_DAYS} days")
+    return f"{column} < now() - make_interval(days => %s)", (days,)
+
+
 def _columns(entry: Dict[str, Any], column: str, field: str) -> List[str]:
     """The column(s) a text facet matches: ``fields`` when given, else the field."""
     fields = entry.get("fields")
@@ -282,6 +306,7 @@ _BUILDERS = {
     "contains": _kind_contains,
     "presence": _kind_presence,
     "since": _kind_since,
+    "before": _kind_before,
     "text": _kind_text,
     "domain": _kind_domain,
 }

{velocity_python-0.1.122 → velocity_python-0.1.124}/src/velocity_python.egg-info/PKG-INFO

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

{velocity_python-0.1.122 → velocity_python-0.1.124}/tests/test_capabilities.py

@@ -194,8 +194,13 @@ def test_provision_first_run_materialises_everything(no_flags, monkeypatch):
         "sys_capabilities"
     ).ensured
 
-    # flag knob column ensured and the unset default filled (never clobbering)
-    assert {"purge_default_days": "TEXT"} in tx.table("sys_feature_flags").ensured
+    # flag knob column ensured — WITH the applied_system key column, which is
+    # what creates the table correctly on a fresh site DB (dance/demo
+    # 2026-09-26: without it the get() 42703'd behind @return_default and
+    # every deploy warned) — and the unset default filled (never clobbering)
+    assert {"applied_system": "TEXT", "purge_default_days": "TEXT"} in tx.table(
+        "sys_feature_flags"
+    ).ensured
     assert (
         tx.table("sys_feature_flags").find({"applied_system": "production"})[
             "purge_default_days"
@@ -214,6 +219,23 @@ def test_provision_first_run_materialises_everything(no_flags, monkeypatch):
     assert "'action': 'purge'" in prog["source_code"]
 
 
+def test_flag_schema_always_carries_the_system_column(no_flags):
+    """Fresh site DB: the flags table must be born WITH its key column, and a
+    missing stage row stays the app seed's job (no row invented here)."""
+    tx = FakeTx()
+    prov.provision(
+        tx,
+        "demo",
+        [{"name": "retention", "config": {"tables": {"aws_api_activity": 90}}}],
+        now=NOW,
+    )
+    flags = tx.table("sys_feature_flags")
+    assert flags.ensured, "flag schema was never ensured"
+    for ensured in flags.ensured:
+        assert feature_flags.SYSTEM_COLUMN in ensured
+    assert flags.rows == []  # row creation stays with the app's own seed
+
+
 def test_provision_is_idempotent_and_keeps_run_state(no_flags):
     tx = FakeTx()
     entries = [{"name": "retention"}]

{velocity_python-0.1.122 → velocity_python-0.1.124}/tests/test_facets.py

@@ -47,6 +47,34 @@ def test_presence_treats_null_and_empty_alike_for_any_column_type():
         facets.predicate({"field": "x", "kind": "presence", "value": "maybe"})
 
 
+def test_before_day_or_period():
+    assert facets.predicate(
+        {"field": "sys_created", "kind": "before", "value": "2026-09-01"}
+    ) == ("sys_created < %s::date", ("2026-09-01",))
+    assert facets.predicate(
+        {"field": "sys_created", "kind": "before", "value": "30d"}
+    ) == ("sys_created < now() - make_interval(days => %s)", (30,))
+    assert (
+        facets.predicate({"field": "sys_created", "kind": "before", "value": ""})
+        is None
+    )
+    for bad in ("2026-9-1", "yesterday", "0d", "9999d", "2026-09-01; drop"):
+        with pytest.raises(facets.FacetError):
+            facets.predicate({"field": "sys_created", "kind": "before", "value": bad})
+
+
+def test_since_and_before_bracket_a_range():
+    sql, params = facets.build_where(
+        [
+            {"field": "sys_created", "kind": "since", "value": "60d"},
+            {"field": "sys_created", "kind": "before", "value": "2026-09-01"},
+        ]
+    )
+    assert "sys_created >= now() - make_interval(days => %s)" in sql
+    assert "sys_created < %s::date" in sql
+    assert params == (60, "2026-09-01")
+
+
 def test_since_periods():
     assert facets.predicate(
         {"field": "internal_date", "kind": "since", "value": "today"}
@@ -173,7 +201,10 @@ def test_domain_refuses_an_address_or_whitespace_and_ignores_blanks():
     for bad in ("user@example.com", "two words.com", "a\tb.com"):
         with pytest.raises(facets.FacetError):
             facets.predicate({"field": "d", "kind": "domain", "values": [bad]})
-    assert facets.predicate({"field": "d", "kind": "domain", "values": ["", ".", "  "]}) is None
+    assert (
+        facets.predicate({"field": "d", "kind": "domain", "values": ["", ".", "  "]})
+        is None
+    )
 
 
 def test_exclude_negates_null_safely_for_any_kind():