Files
threshing-atlas/tests/core/test_dictionary.py
ekcSchianoandClaude Opus 5.5 3b24a11f5a Collection as an ETL pipeline; runs_clean.csv from every source; Report a run
- collection/pipeline.yaml declares every source (extract kind, transform,
  privacy rules, load target, run source); `python -m collection update|build`
- extract keeps data/raw/<source>/current + previous only (git-ignored);
  data/manifest.json records the current raw checksum and change date
- transforms are pure; validate checks runs against data/dictionary.yaml
  before load; load writes byte-stable files only when they change
- data/public/runs_clean.csv: every run from every source with a new
  `source` column (reddit spreadsheet, reddit thread, reported, bot,
  reddit pdf); the sheet's own row label moves to `entry`; run_id is text
- bot importer ported to Python (same output as bot.js on the fixture);
  labels and crosswalk in collection/specs/bot.yaml, written into graph.js
- Reddit through the official API (result links to add by hand); the 12
  result pages move to collection/manual/reddit_results.yaml
- "Report a run": a GitHub issue form generated from
  collection/specs/report_form.yaml, collected as source "reported", plus a
  site tab pointing to it, the community spreadsheet and the megathread
- analysis and the route model read runs_clean.csv (sources in
  measures.yaml); stats.json and policy.json unchanged apart from the
  factor's new name
- daily workflow runs the pipeline; the raw store is kept between runs in
  the Actions cache, encrypted with RAW_ARCHIVE_KEY

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UCzTd31GphpMXDhQqWrCMQ
2026-11-04 02:46:48 +00:00

78 lines
3.0 KiB
Python

"""The data dictionary describes every published column and value, and data/croissant.json matches it."""
import csv
import json
import re
import sys
import unittest
from pathlib import Path
import yaml
ROOT = Path(__file__).resolve().parents[2]
sys.path.insert(0, str(ROOT))
from collection.etl import metadata as publish_metadata # noqa: E402
with open(ROOT / "data" / "dictionary.yaml", encoding="utf-8") as f:
DICT = yaml.safe_load(f)
with open(ROOT / "data" / "public" / "runs_clean.csv", encoding="utf-8", newline="") as f:
reader = csv.DictReader(f)
HEADER = reader.fieldnames
ROWS = list(reader)
CHECKS = {
"integer": lambda v: re.fullmatch(r"-?\d+", v),
"boolean": lambda v: v in ("True", "False"),
"date": lambda v: re.fullmatch(r"\d{4}-\d{2}-\d{2}", v),
"text": lambda v: True,
}
class Dictionary(unittest.TestCase):
def test_every_column_described_in_order(self):
self.assertEqual(HEADER, list(DICT["columns"]))
def test_every_column_has_type_and_description(self):
for name, col in DICT["columns"].items():
self.assertIn(col.get("type"), CHECKS, name)
self.assertTrue(col.get("description"), name)
def test_values_have_the_declared_type(self):
for name, col in DICT["columns"].items():
bad = {r[name] for r in ROWS if r[name] and not CHECKS[col["type"]](r[name])}
self.assertFalse(bad, f"{name}: not {col['type']}: {sorted(bad)[:5]}")
def test_every_value_is_listed(self):
for name, col in DICT["columns"].items():
if "values" not in col:
continue
allowed = col["values"]
# YAML reads bare Yes/No as booleans: a listed value must be written as text
self.assertTrue(all(isinstance(v, str) for v in allowed), f"{name}: quote every value")
bad = {r[name] for r in ROWS if r[name] and r[name] not in allowed}
self.assertFalse(bad, f"{name}: values not in the dictionary: {sorted(bad)}")
def test_every_published_file_exists(self):
for key, f in DICT["files"].items():
self.assertTrue((ROOT / f["path"]).exists(), key)
class Croissant(unittest.TestCase):
def test_croissant_is_up_to_date(self):
expected = publish_metadata.render(publish_metadata.build(DICT))
actual = (ROOT / "data" / "croissant.json").read_text(encoding="utf-8")
self.assertEqual(actual, expected, "run python -m collection build")
def test_fields_and_checksums(self):
doc = json.loads((ROOT / "data" / "croissant.json").read_text(encoding="utf-8"))
names = [f["name"] for f in doc["recordSet"][0]["field"]]
self.assertEqual(names, HEADER)
for obj in doc["distribution"]:
path = ROOT / DICT["files"][obj["@id"]]["path"]
self.assertEqual(obj["sha256"], publish_metadata.sha256(path), obj["@id"])
# the route PDF is not redistributed, so it is not a source of the published data
self.assertNotIn("pdf", json.dumps(doc["isBasedOn"]).lower())
if __name__ == "__main__":
unittest.main()