- 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
77 lines
1.8 KiB
Python
77 lines
1.8 KiB
Python
"""Paths, the pipeline spec, and byte-stable writers shared by every stage."""
|
|
import hashlib
|
|
import json
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
import yaml
|
|
|
|
ROOT = Path(__file__).resolve().parents[2]
|
|
if str(ROOT / "core") not in sys.path:
|
|
sys.path.insert(0, str(ROOT / "core"))
|
|
|
|
|
|
def path(p):
|
|
return ROOT / p
|
|
|
|
|
|
def read_yaml(p):
|
|
with open(path(p), encoding="utf-8") as f:
|
|
return yaml.safe_load(f)
|
|
|
|
|
|
def pipeline():
|
|
return read_yaml("collection/pipeline.yaml")
|
|
|
|
|
|
def sha256_bytes(data):
|
|
return hashlib.sha256(data).hexdigest()
|
|
|
|
|
|
def sha256_file(p):
|
|
h = hashlib.sha256()
|
|
with open(p, "rb") as f:
|
|
for block in iter(lambda: f.read(1 << 20), b""):
|
|
h.update(block)
|
|
return h.hexdigest()
|
|
|
|
|
|
def json_bytes(obj, compact=True):
|
|
if compact:
|
|
return (json.dumps(obj, ensure_ascii=False, separators=(",", ":"))).encode("utf-8")
|
|
return (json.dumps(obj, ensure_ascii=False, indent=1) + "\n").encode("utf-8")
|
|
|
|
|
|
def jsonl_bytes(rows):
|
|
return "".join(json.dumps(r, ensure_ascii=False, separators=(",", ":")) + "\n" for r in rows).encode("utf-8")
|
|
|
|
|
|
def read_jsonl(p):
|
|
p = Path(p)
|
|
if not p.exists():
|
|
return []
|
|
out = []
|
|
for line in p.read_text(encoding="utf-8").splitlines():
|
|
if line.strip():
|
|
try:
|
|
out.append(json.loads(line))
|
|
except json.JSONDecodeError:
|
|
pass
|
|
return out
|
|
|
|
|
|
class Report:
|
|
"""What a pipeline run did, as Markdown lines (the daily pull request's body)."""
|
|
|
|
def __init__(self):
|
|
self.lines = []
|
|
self.changed = False
|
|
self.failed = []
|
|
|
|
def add(self, line):
|
|
self.lines.append(line)
|
|
print(line)
|
|
|
|
def text(self, title):
|
|
return "\n".join([f"## {title}", ""] + self.lines) + "\n"
|