field_ios

In-the-field app for Radroots on iOS
git clone https://radroots.dev/git/field_ios.git
Log | Files | Refs | README | LICENSE

app_dependency_graph.py (5353B)


      1 """Validate the real locked application graph after the proxy crate is retired."""
      2 
      3 from __future__ import annotations
      4 
      5 from typing import Any
      6 
      7 OWNED = {"tera_core", "tera_ffi", "tera_bindgen", "tera_wasm"}
      8 MOBILE = OWNED - {"tera_wasm"}
      9 RETIRED = {
     10     "radroots_ios_source_lock",
     11     "radroots_mobile_core",
     12     "radroots_mobile_ffi",
     13     "radroots_mobile_bindgen",
     14     "radroots_mobile_wasm",
     15 }
     16 ASKAMA_REPAIR = "d47daf8767805c0c4dfb456145fc857bfd9c1d2c"
     17 ASKAMA_SOURCE = (
     18     f"git+https://github.com/askama-rs/askama?rev={ASKAMA_REPAIR}#{ASKAMA_REPAIR}"
     19 )
     20 
     21 
     22 class GraphError(ValueError):
     23     """A stable rejection without dependency source paths or command output."""
     24 
     25 
     26 def require(condition: bool, reason: str) -> None:
     27     if not condition:
     28         raise GraphError(reason)
     29 
     30 
     31 def indexed(rows: Any, label: str) -> dict[str, dict[str, Any]]:
     32     require(isinstance(rows, list) and bool(rows), f"{label} inventory is absent")
     33     result = {}
     34     for row in rows:
     35         require(isinstance(row, dict), f"{label} entry is malformed")
     36         identifier = row.get("id")
     37         require(
     38             isinstance(identifier, str) and bool(identifier),
     39             f"{label} identity is absent",
     40         )
     41         require(identifier not in result, f"{label} identity is duplicated")
     42         result[identifier] = row
     43     return result
     44 
     45 
     46 def owned_packages(
     47     document: dict[str, Any], packages: dict[str, Any]
     48 ) -> dict[str, Any]:
     49     members = document.get("workspace_members")
     50     require(isinstance(members, list), "owned workspace members are absent")
     51     require(len(members) == len(OWNED), "owned workspace inventory differs")
     52     require(
     53         all(identifier in packages for identifier in members), "owned package is absent"
     54     )
     55     owned = {
     56         packages[identifier]["name"]: packages[identifier] for identifier in members
     57     }
     58     require(set(owned) == OWNED, "owned workspace inventory differs")
     59     defaults = document.get("workspace_default_members")
     60     require(isinstance(defaults, list), "mobile defaults are absent")
     61     require(
     62         sorted(defaults) == sorted(owned[name]["id"] for name in MOBILE),
     63         "mobile defaults must select the real native packages only",
     64     )
     65     return owned
     66 
     67 
     68 def foundation_sources(packages: dict[str, Any], foundation: dict[str, Any]) -> None:
     69     revision = foundation["revision"]
     70     expected = f"git+{foundation['repository']}?rev={revision}#{revision}"
     71     shared = []
     72     for package in packages.values():
     73         name = package.get("name")
     74         require(isinstance(name, str), "resolved package name is absent")
     75         require(
     76             name not in RETIRED,
     77             "retired mobile producer or source-lock shim is present",
     78         )
     79         if name.startswith("radroots_"):
     80             shared.append(package)
     81             require(
     82                 package.get("source") == expected, "resolved foundation source differs"
     83             )
     84             require(
     85                 package.get("version") == foundation["version"],
     86                 "resolved foundation version differs",
     87             )
     88         elif package.get("source") is None:
     89             require(
     90                 name in OWNED, "unowned local package entered the application graph"
     91             )
     92     require(bool(shared), "resolved foundation inventory is empty")
     93 
     94 
     95 def mobile_profile(owned: dict[str, Any], nodes: dict[str, Any]) -> None:
     96     ffi = owned["tera_ffi"]
     97     edges = ffi.get("dependencies")
     98     require(isinstance(edges, list), "owned FFI dependency inventory is absent")
     99     core_edges = [edge for edge in edges if edge.get("name") == "tera_core"]
    100     require(len(core_edges) == 1, "owned FFI must select one application core")
    101     edge = core_edges[0]
    102     require(
    103         edge.get("source") is None and edge.get("kind") is None,
    104         "FFI core must be an owned runtime dependency",
    105     )
    106     require(
    107         "mobile-social" in edge.get("features", []),
    108         "owned FFI mobile-social profile is absent",
    109     )
    110     core_node = nodes.get(owned["tera_core"]["id"], {})
    111     require(
    112         "mobile-social" in core_node.get("features", []),
    113         "resolved mobile-social feature is absent",
    114     )
    115 
    116 
    117 def generator_sources(packages: dict[str, Any]) -> None:
    118     repaired = set()
    119     for package in packages.values():
    120         name = package.get("name")
    121         require(name != "basic-toml", "archived generator parser is present")
    122         if name in {"askama_derive", "askama_parser"}:
    123             require(
    124                 package.get("source") == ASKAMA_SOURCE
    125                 and package.get("version") == "0.16.1",
    126                 "generator repair source differs",
    127             )
    128             repaired.add(name)
    129     require(
    130         repaired == {"askama_derive", "askama_parser"},
    131         "generator repair inventory differs",
    132     )
    133 
    134 
    135 def validate(document: dict[str, Any], foundation: dict[str, Any]) -> None:
    136     packages = indexed(document.get("packages"), "resolved package")
    137     owned = owned_packages(document, packages)
    138     foundation_sources(packages, foundation)
    139     generator_sources(packages)
    140     resolution = document.get("resolve")
    141     require(isinstance(resolution, dict), "resolved dependency graph is absent")
    142     nodes = indexed(resolution.get("nodes"), "resolved node")
    143     require(set(nodes) == set(packages), "resolved node inventory differs")
    144     mobile_profile(owned, nodes)