- 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
33 lines
1.1 KiB
Python
33 lines
1.1 KiB
Python
"""Read data/public/runs_clean.csv (written by `python -m collection build`) as typed records.
|
|
|
|
Every analysis reads the runs from this one published file. Types come from data/dictionary.yaml: integers and
|
|
booleans are parsed, empty cells are None (data_flags is "" when a row has no flags).
|
|
"""
|
|
import csv
|
|
from pathlib import Path
|
|
|
|
import yaml
|
|
|
|
ROOT = Path(__file__).resolve().parents[2]
|
|
PATH = ROOT / "data/public/runs_clean.csv"
|
|
with open(ROOT / "data/dictionary.yaml", encoding="utf-8") as _f:
|
|
TYPES = {k: v["type"] for k, v in yaml.safe_load(_f)["columns"].items()}
|
|
|
|
|
|
def _parse(col, v):
|
|
if v == "":
|
|
return "" if col == "data_flags" else None
|
|
t = TYPES.get(col, "text")
|
|
if t == "integer":
|
|
return int(v)
|
|
if t == "boolean":
|
|
return v == "True"
|
|
return v
|
|
|
|
|
|
def read(path=PATH, sources=None, drop=("run_id",)):
|
|
"""Typed records, optionally only from some sources (the `source` column)."""
|
|
with open(path, encoding="utf-8", newline="") as f:
|
|
rows = [{k: _parse(k, v) for k, v in r.items() if k not in drop} for r in csv.DictReader(f)]
|
|
return [r for r in rows if sources is None or r["source"] in sources]
|