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

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

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

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

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

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

{velocity_python-0.1.123 → 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.123 → 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.123
+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.123 → 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():