velocity-python 0.1.14__tar.gz → 0.1.16__tar.gz

{velocity_python-0.1.14/src/velocity_python.egg-info → velocity_python-0.1.16}/PKG-INFO

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

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

{velocity_python-0.1.14 → velocity_python-0.1.16}/src/velocity/__init__.py

@@ -1,12 +1,11 @@
-__version__ = version = "0.1.14"
+__version__ = version = "0.1.16"
 
 import importlib as _importlib
 
 from . import db
 from . import misc
-from . import app
 
-__all__ = ["aws", "db", "misc", "app"]
+__all__ = ["aws", "db", "misc"]
 
 _LAZY_SUBMODULES = {"aws"}
 

{velocity_python-0.1.14 → velocity_python-0.1.16}/src/velocity/misc/pdf.py

@@ -46,7 +46,9 @@ if "AWS_LAMBDA_FUNCTION_NAME" in os.environ:
 
 try:
     import weasyprint
-except ImportError:
+except (ImportError, OSError):
+    # OSError: WeasyPrint's ffi.py raises OSError when native libs
+    # (libgobject, libpango, etc.) cannot be loaded via cffi.dlopen().
     weasyprint = None  # type: ignore[assignment]
 
 _DEFAULT_BODY_CSS = """\

{velocity_python-0.1.14 → velocity_python-0.1.16/src/velocity_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: velocity-python
-Version: 0.1.14
+Version: 0.1.16
 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.14 → velocity_python-0.1.16}/src/velocity_python.egg-info/SOURCES.txt

@@ -3,19 +3,6 @@ README.md
 pyproject.toml
 src/velocity/__init__.py
 src/velocity/logging.py
-src/velocity/app/__init__.py
-src/velocity/app/invoices.py
-src/velocity/app/orders.py
-src/velocity/app/payments.py
-src/velocity/app/purchase_orders.py
-src/velocity/app/formbuilder/__init__.py
-src/velocity/app/formbuilder/reshaper.py
-src/velocity/app/tests/__init__.py
-src/velocity/app/tests/test_email_processing.py
-src/velocity/app/tests/test_payment_profile_sorting.py
-src/velocity/app/tests/test_spreadsheet_functions.py
-src/velocity/app/validators/__init__.py
-src/velocity/app/validators/formbuilder_template.py
 src/velocity/aws/__init__.py
 src/velocity/aws/amplify.py
 src/velocity/aws/amplify_build.py
@@ -158,8 +145,7 @@ tests/test_concurrency_safety.py
 tests/test_connection_pool.py
 tests/test_connection_resilience.py
 tests/test_decorators.py
-tests/test_formbuilder_reshaper.py
-tests/test_formbuilder_template_validator.py
+tests/test_email_processing.py
 tests/test_iconv_money_to_cents.py
 tests/test_lambda_handler.py
 tests/test_lambda_handler_auth.py
@@ -168,6 +154,7 @@ tests/test_n_plus_one.py
 tests/test_observability.py
 tests/test_payment_braintree_adapter.py
 tests/test_payment_demo_profiles.py
+tests/test_payment_profile_sorting.py
 tests/test_payment_profiles.py
 tests/test_payment_router.py
 tests/test_payment_stripe_adapter.py
@@ -180,6 +167,7 @@ tests/test_row_cache_staleness.py
 tests/test_row_dirty_tracking.py
 tests/test_schema_migrations.py
 tests/test_security_hardening.py
+tests/test_spreadsheet_functions.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.14/src/velocity/app/formbuilder/__init__.py

@@ -1 +0,0 @@
-"""velocity.app.formbuilder — shared logic for form_builder_template records."""

velocity_python-0.1.14/src/velocity/app/formbuilder/reshaper.py

@@ -1,201 +0,0 @@
-"""velocity.app.formbuilder.reshaper
-
-Reshape a raw ``form_builder_template`` database row into the public ``fb``
-payload structure as produced by ``DonateMainEvents.OnActionGetFormBuilder``.
-
-The single public entry-point is :func:`reshape_formbuilder_template`.  It is
-a **pure function** — the input is deep-copied and never mutated.
-
-Payment tokens, reCAPTCHA keys, and live thermometer totals are **not**
-included; those are runtime secrets and database query results that the caller
-must add separately (as DonateMain does in
-``OnActionGetFormBuilder``).  The returned dict is safe to serialise and
-return as a preview payload.
-
-Usage::
-
-    from velocity.app.formbuilder.reshaper import reshape_formbuilder_template
-
-    fb = reshape_formbuilder_template(template_row.to_dict())
-"""
-
-import ast
-import copy
-from typing import Any, Dict, Optional
-
-
-# ---------------------------------------------------------------------------
-# Internal per-metric / per-donation helpers
-# ---------------------------------------------------------------------------
-
-def _parse_key_value_string(raw: Optional[str]) -> Dict[str, Any]:
-    """Parse a ``"key1: val1, key2: val2"`` string into a dict.
-
-    Wraps the string in braces and calls ``ast.literal_eval``, exactly as the
-    original DonateMain ``getMetric`` / ``getDonation`` functions do.
-    Returns an empty dict on failure so a bad value never crashes the reshaper.
-    """
-    if not raw:
-        return {}
-    try:
-        return ast.literal_eval("{" + raw + "}")
-    except Exception:
-        return {}
-
-
-def _extract_metric(count: int, data: Dict[str, Any]) -> Dict[str, Any]:
-    """Extract metric_{count}_* fields from *data* (mutates *data*).
-
-    Returns the nested metric dict when the metric has a label and is not
-    hidden, otherwise returns ``{}``.  Either way all flat metric_N_* keys
-    are removed from *data*.
-    """
-    prefix = f"metric_{count}_"
-    flat_keys = [
-        "header", "image", "label", "secondarytext", "helpertext",
-        "values", "defaultvalue", "show_other", "other_minimum_value",
-        "orientation",
-    ]
-
-    is_hidden = data.get(f"{prefix}hide_donation_from_ui")
-    has_label = data.get(f"{prefix}label")
-
-    if not is_hidden and has_label:
-        result = {
-            "header": data.pop(f"{prefix}header", None),
-            "image": data.pop(f"{prefix}image", None),
-            "label": data.pop(f"{prefix}label", None),
-            "secondarytext": data.pop(f"{prefix}secondarytext", None),
-            "helpertext": data.pop(f"{prefix}helpertext", None),
-            "values": _parse_key_value_string(data.pop(f"{prefix}values", None)),
-            "defaultvalue": data.pop(f"{prefix}defaultvalue", None),
-            "show_other": data.pop(f"{prefix}show_other", ""),
-            "other_minimum_value": data.pop(f"{prefix}other_minimum_value", ""),
-            "orientation": data.pop(f"{prefix}orientation", ""),
-        }
-        data.pop(f"{prefix}hide_donation_from_ui", None)
-        return result
-
-    # Strip all flat keys even when hidden / empty
-    for key in flat_keys:
-        data.pop(f"{prefix}{key}", None)
-    data.pop(f"{prefix}hide_donation_from_ui", None)
-    return {}
-
-
-def _extract_donation(count: int, data: Dict[str, Any]) -> Dict[str, Any]:
-    """Extract donation_{count}_* fields from *data* (mutates *data*).
-
-    Returns the nested donation dict when the donation has a label and is not
-    hidden, otherwise returns ``{}``.  Either way all flat donation_N_* keys
-    are removed from *data*.
-    """
-    prefix = f"donation_{count}_"
-    flat_keys = [
-        "header", "image", "html", "label", "secondarytext", "helpertext",
-        "values", "defaultvalue", "show_other", "other_minimum_value",
-        "orientation", "dropdown", "dropdown_label",
-    ]
-
-    is_hidden = data.get(f"{prefix}hide_donation_from_ui")
-    has_label = data.get(f"{prefix}label")
-
-    if not is_hidden and has_label:
-        result = {
-            "header": data.pop(f"{prefix}header", None),
-            "image": data.pop(f"{prefix}image", None),
-            "html": data.pop(f"{prefix}html", None),
-            "label": data.pop(f"{prefix}label", None),
-            "secondarytext": data.pop(f"{prefix}secondarytext", None),
-            "helpertext": data.pop(f"{prefix}helpertext", None),
-            "values": _parse_key_value_string(data.pop(f"{prefix}values", None)),
-            "defaultvalue": data.pop(f"{prefix}defaultvalue", None),
-            "show_other": data.pop(f"{prefix}show_other", ""),
-            "other_minimum_value": data.pop(f"{prefix}other_minimum_value", ""),
-            "orientation": data.pop(f"{prefix}orientation", ""),
-            "dropdown": data.pop(f"{prefix}dropdown", None),
-            "dropdown_label": data.pop(f"{prefix}dropdown_label", None),
-        }
-        data.pop(f"{prefix}hide_donation_from_ui", None)
-        return result
-
-    for key in flat_keys:
-        data.pop(f"{prefix}{key}", None)
-    data.pop(f"{prefix}hide_donation_from_ui", None)
-    return {}
-
-
-# ---------------------------------------------------------------------------
-# Public API
-# ---------------------------------------------------------------------------
-
-def reshape_formbuilder_template(raw_row: Dict[str, Any]) -> Dict[str, Any]:
-    """Reshape a raw ``form_builder_template`` DB row into the public ``fb`` dict.
-
-    This replicates exactly what ``DonateMainEvents.OnActionGetFormBuilder``
-    does to reshape the flat database row before returning it to the browser,
-    without the live DB queries (thermometer totals) or runtime secrets
-    (payment tokens, reCAPTCHA keys).
-
-    The caller is responsible for:
-
-    - Passing in a plain Python dict (call ``.to_dict()`` on a velocity DB
-      row first so that Decimal and datetime values are already serialisable).
-    - Optionally adding ``fb["thermometer"]`` / ``fb["rival_thermometer"]``
-      after the call if live totals are desired.
-
-    Returns a new dict; the input is never mutated.
-
-    Example::
-
-        row = tx.table("form_builder_template").one({"sys_id": sys_id})
-        fb  = reshape_formbuilder_template(row.to_dict())
-    """
-    fb = copy.deepcopy(raw_row)
-
-    fb["metrics"] = {
-        f"metric_{i}": _extract_metric(i, fb) for i in range(1, 10)
-    }
-    fb["donations"] = {
-        f"donation_{i}": _extract_donation(i, fb) for i in range(1, 10)
-    }
-
-    # Expose the primary key under the public name used by DonateMain
-    fb["_num_entries"] = fb.get("sys_id")
-
-    # Strip internal / private fields
-    for key in list(fb.keys()):
-        if key.startswith("sys_"):
-            del fb[key]
-
-    for key in (
-        # UI-only computed column (row counter) — never a real DB column
-        "row_number",
-        "url_slug",
-        "url_slug_alternate",
-        # Administrative / validation metadata — not read by DonateMain frontend
-        "is_published",
-        "datetime_last_validated",
-        "last_validation_result",
-        "last_validation_reason",
-        # Backend-only: security / fraud prevention
-        "whitelist_end_date",
-        "recaptcha_version",
-        "recaptcha_v3_score_threshold",
-        # Backend-only: routing / campaign metadata
-        "campaign",
-        "sub_campaign",
-        # Backend-only: email receipts (server-side sending only)
-        "receipt_from_address",
-        "receipt_subject",
-        "receipt_body_text",
-        "mail_bcc",
-        # Backend-only: rally out-of-band receipts
-        "rally_receipt_from_address",
-        "rally_receipt_subject",
-        "rally_receipt_body_text",
-        "rally_mail_bcc",
-    ):
-        fb.pop(key, None)
-
-    return fb

velocity_python-0.1.14/src/velocity/app/orders.py

@@ -1,179 +0,0 @@
-import datetime
-import pprint
-import velocity.db
-
-engine = velocity.db.postgres.initialize()
-REQUIRED = object()
-
-
-@engine.transaction
-class Order:
-    SCHEMA = {
-        "headers": {
-            "customer_email": REQUIRED,
-            "order_date": REQUIRED,
-            "order_type": REQUIRED,
-        },
-        "lineitems": {
-            "sku": REQUIRED,
-            "qty": REQUIRED,
-            "price": REQUIRED,
-        },
-        "lineitems_supp": {
-            "note": str,
-        },
-    }
-
-    DEFAULTS = {
-        "headers": {
-            "order_date": lambda: datetime.date.today(),
-            "effective_date": lambda: datetime.date.today(),
-        }
-    }
-
-    def __init__(self, order_id=None):
-        self.order_id = order_id
-        self.headers = {}
-        self.lineitems = {}
-        self.lineitems_supp = {}
-
-    def __repr__(self):
-        return f"Order(order_id={self.order_id}, headers={pprint.pformat(self.headers)}, lineitems={pprint.pformat(self.lineitems)}, lineitems_supp={pprint.pformat(self.lineitems_supp)})"
-
-    def exists(self, tx):
-        if not self.order_id:
-            raise ValueError("order_id must be set to check existence")
-        return tx.table("orders").find(self.order_id)
-
-    def __bool__(self):
-        return bool(self.order_id) and self.exists(engine.transaction())
-
-    def load(self, tx):
-        if not self.order_id:
-            raise ValueError("order_id must be set to load an order")
-
-        order = tx.table("orders").one(self.order_id)
-        if not order:
-            raise ValueError(f"Order {self.order_id} not found")
-
-        self.headers = dict(order)
-
-        items = (
-            tx.table("order_lineitems")
-            .select(where={"order_id": self.order_id}, orderby="line_number")
-            .all()
-        )
-        for idx, row in enumerate(items):
-            self.lineitems[idx] = dict(row)
-
-        supps = (
-            tx.table("order_lineitems_supp")
-            .select(where={"order_id": self.order_id}, orderby="line_number")
-            .all()
-        )
-        for idx, row in enumerate(supps):
-            self.lineitems_supp[idx] = dict(row)
-
-    def update_header(self, key, value):
-        self.headers[key] = value
-
-    def add_lineitem(self, data: dict, supp_data: dict = None):
-        index = len(self.lineitems)
-        self.lineitems[index] = data
-        self.lineitems_supp[index] = supp_data or {}
-
-    def update_lineitem(self, index: int, data: dict = None, supp_data: dict = None):
-        if index not in self.lineitems:
-            raise IndexError(f"No line item at index {index}")
-        if data:
-            self.lineitems[index].update(data)
-        if supp_data is not None:
-            self.lineitems_supp[index].update(supp_data)
-
-    def delete_lineitem(self, index: int):
-        if index not in self.lineitems:
-            raise IndexError(f"No line item at index {index}")
-        del self.lineitems[index]
-        if index in self.lineitems_supp:
-            del self.lineitems_supp[index]
-        self._reindex_lineitems()
-
-    def _reindex_lineitems(self):
-        """Re-index lineitems and supplemental data after deletion."""
-        new_items = {}
-        new_supps = {}
-        for i, key in enumerate(sorted(self.lineitems)):
-            new_items[i] = self.lineitems[key]
-            new_supps[i] = self.lineitems_supp.get(key, {})
-        self.lineitems = new_items
-        self.lineitems_supp = new_supps
-
-    def _apply_defaults(self):
-        for section, defaults in self.DEFAULTS.items():
-            target = getattr(self, section)
-            for key, default in defaults.items():
-                if key not in target:
-                    target[key] = default() if callable(default) else default
-
-    def _validate(self):
-        self._apply_defaults()
-
-        for key, requirement in self.SCHEMA["headers"].items():
-            if requirement is REQUIRED and key not in self.headers:
-                raise ValueError(f"Missing required header field: {key}")
-            if (
-                key in self.headers
-                and requirement is not REQUIRED
-                and not isinstance(self.headers[key], requirement)
-            ):
-                raise TypeError(
-                    f"Header field '{key}' must be of type {requirement.__name__}"
-                )
-
-        for idx, item in self.lineitems.items():
-            for key, requirement in self.SCHEMA["lineitems"].items():
-                if requirement is REQUIRED and key not in item:
-                    raise ValueError(f"Line item {idx} missing required field: {key}")
-
-        for idx, supp in self.lineitems_supp.items():
-            for key, expected in self.SCHEMA["lineitems_supp"].items():
-                if key in supp and not isinstance(supp[key], expected):
-                    raise TypeError(
-                        f"Supplemental field '{key}' in item {idx} must be of type {expected.__name__}"
-                    )
-
-    def persist(self, tx):
-        self._validate()
-
-        if self.order_id:
-            tx.table("orders").update(self.headers, self.order_id)
-        else:
-            record = tx.table("orders").new(self.headers)
-            self.order_id = record["sys_id"]
-
-        tx.table("order_lineitems").delete(where={"order_id": self.order_id})
-        tx.table("order_lineitems_supp").delete(where={"order_id": self.order_id})
-
-        for index in sorted(self.lineitems):
-            tx.table("order_lineitems").insert(
-                {
-                    "order_id": self.order_id,
-                    "line_number": index,
-                    **self.lineitems[index],
-                }
-            )
-            tx.table("order_lineitems_supp").insert(
-                {
-                    "order_id": self.order_id,
-                    "line_number": index,
-                    **self.lineitems_supp.get(index, {}),
-                }
-            )
-
-    def to_dict(self):
-        return {
-            "order_id": self.order_id,
-            "headers": self.headers,
-            "lineitems": self.lineitems,
-            "lineitems_supp": self.lineitems_supp,
-        }

velocity_python-0.1.14/src/velocity/app/tests/__init__.py

@@ -1 +0,0 @@
-# App module tests

velocity_python-0.1.14/src/velocity/app/validators/__init__.py

@@ -1 +0,0 @@
-"""velocity.app.validators — domain validators for shared application entities."""