velocity-python 0.1.107__tar.gz → 0.1.108__tar.gz

{velocity_python-0.1.107 → velocity_python-0.1.108}/PKG-INFO

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

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

{velocity_python-0.1.107 → velocity_python-0.1.108}/src/velocity/__init__.py

@@ -1,4 +1,4 @@
-__version__ = version = "0.1.107"
+__version__ = version = "0.1.108"
 
 import importlib as _importlib
 

{velocity_python-0.1.107 → velocity_python-0.1.108}/src/velocity/aws/capabilities/__init__.py

@@ -20,6 +20,7 @@ from .base import (  # noqa: F401
     load_config,
     policy_field,
     resolve_config,
+    summarize_policy,
     validate_policy,
 )
 from .dispatch import (  # noqa: F401
@@ -52,6 +53,7 @@ __all__ = [
     "provision",
     "resolve_config",
     "run_capability",
+    "summarize_policy",
     "trigger_key",
     "validate_policy",
     "NIGHTLY",

{velocity_python-0.1.107 → velocity_python-0.1.108}/src/velocity/aws/capabilities/base.py

@@ -161,6 +161,54 @@ def load_config(raw) -> dict:
     return value
 
 
+def summarize_policy(name, config, *, max_items=3) -> str:
+    """One line a list can show for a row's policy — "Tables: aws_api_activity
+    7d, filebuffer 14d · IP deny list: 2" — built from the declared fields so
+    it reads the same for every capability. Empty string for an empty policy;
+    undeclared keys are counted, not shown."""
+    cap = REGISTRY.get(name)
+    try:
+        config = load_config(config)
+    except ValueError:
+        return "invalid JSON"
+    if cap is None or not config:
+        return ""
+    parts = []
+    declared = set()
+    for field in cap.policy:
+        declared.add(field["name"])
+        value = config.get(field["name"])
+        if value in (None, "", [], {}):
+            continue
+        parts.append(f"{field['label']}: {_brief(field, value, max_items)}")
+    extra = len([key for key in config if key not in declared])
+    if extra:
+        parts.append(f"+{extra} other key{'s' if extra > 1 else ''}")
+    return " · ".join(parts)
+
+
+def _brief(field, value, max_items):
+    kind = field["kind"]
+    if kind == TABLE_DAYS and isinstance(value, dict):
+        items = [
+            f"{table} {days}d" if days not in (None, "", 0) else f"{table} (default)"
+            for table, days in value.items()
+        ]
+        return _clip(items, max_items)
+    if kind in (CIDR_LIST, COUNTRY_LIST, LIST) and isinstance(value, (list, tuple)):
+        return _clip([str(v) for v in value], max_items)
+    if kind == BOOLEAN:
+        return "on" if str(value).lower() in ("true", "1", "yes", "on") else "off"
+    text = str(value)
+    return text if len(text) <= 40 else text[:37] + "..."
+
+
+def _clip(items, max_items):
+    if len(items) <= max_items:
+        return ", ".join(items)
+    return ", ".join(items[:max_items]) + f" (+{len(items) - max_items} more)"
+
+
 def validate_policy(name, config) -> list:
     """Check a site's ``config`` against the capability's declared policy.
 

{velocity_python-0.1.107 → velocity_python-0.1.108}/src/velocity_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.1.107
+Version: 0.1.108
 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.107 → velocity_python-0.1.108}/tests/test_capability_catalog.py

@@ -157,6 +157,38 @@ def test_validate_number_boolean_and_choice():
     ]
 
 
+def test_summarize_policy_reads_the_same_for_every_capability():
+    assert caps.summarize_policy("retention", None) == ""
+    assert caps.summarize_policy("retention", "{}") == ""
+    assert (
+        caps.summarize_policy(
+            "retention", {"tables": {"aws_api_activity": 90, "filebuffer": None}}
+        )
+        == "Tables to prune: aws_api_activity 90d, filebuffer (default)"
+    )
+    summary = caps.summarize_policy(
+        "security",
+        {
+            "ip_denylist": ["203.0.113.0/24", "198.51.100.1", "198.51.100.2", "198.51.100.3"],
+            "blocked_countries": ["KP"],
+            "legacy": 1,
+        },
+    )
+    assert summary == (
+        "IP deny list: 203.0.113.0/24, 198.51.100.1, 198.51.100.2 (+1 more)"
+        " · Blocked countries: KP · +1 other key"
+    )
+    assert (
+        caps.summarize_policy("security_headers", {"enabled": "false", "csp": "x" * 50})
+        == "Send security headers: off · Content-Security-Policy: " + "x" * 37 + "..."
+    )
+    assert caps.summarize_policy("api_throttling", {"rate": 50}) == (
+        "Steady rate (requests / second): 50"
+    )
+    assert caps.summarize_policy("nope", {"a": 1}) == ""
+    assert caps.summarize_policy("retention", "{bad") == "invalid JSON"
+
+
 def test_load_config_shapes():
     assert base.load_config(None) == {}
     assert base.load_config("") == {}