"""check.py answers with three codes, and README.md's weekly job named only one of them. README.md's "After a firmware update" hands an owner a cron line and used to say, of the run that line makes, "it prints what drifted and exits 1 when anything did" - so on that page a non-zero exit was drift and nothing else had a name. check.py answers `0` when the TV still matches the list, `1` when something drifted, and `2` when the run could not check at all (the TV did not answer, nobody accepted the "Allow USB debugging?" prompt, the list path is not there, the list disables Android's core packages); its own source says why the two are kept apart - "exit 2, not the 1 a weekly job reads as "drift". A job built from the page alone could therefore not tell "the TV drifted" from "the check never ran". Two shapes that stop before any connection used to end at 1 for the same reason: with `TV_HOST` unset the run stops in tools/tv.py with its own message, and on a computer without the ADB client recovery.connect() stops with the line that builds the venv - both SystemExit, not Exception, so the clause that answers 2 never saw them. The section has since moved out of the README into docs/firmware-updates.md ("Exit codes, and a weekly job"), which the README's "After a firmware update" links; the checks below read it there. So: the codes are read out of tools/check.py and out of real runs, and the README section that gives the job has to name each of them. Nothing here reads the page's wording: a number on a line that talks about the exit the run makes is what counts, so the sentences can be rewritten freely. Run from the repository root: python3 -m unittest discover -s tests -v """ import json import os from pathlib import Path import re import shutil import subprocess import sys import tempfile import unittest sys.path.insert(0, str(Path(__file__).resolve().parent)) from test_drift_check import FAKE_TV # noqa: E402 (the simulated TV check.py already runs against) ROOT = Path(__file__).resolve().parents[1] README = ROOT / "README.md" GUIDE = ROOT / "docs" / "firmware-updates.md" JOB = "## Exit codes, and a weekly job" CHECK = ROOT / "tools" / "check.py" STOCK = "com.google.android.tvlauncher" CUSTOM = "com.gathin.tvhome" HEADING = "## After a firmware update" def literal_returns(source): """The codes a script returns as literals: `return 0`, `return 2`, `return 1 if ... else 0`.""" codes = set() for line in source.split("\n"): stripped = line.split("#", 1)[0] for m in re.finditer(r"\breturn\s+(\d+)\b", stripped): codes.add(int(m.group(1))) for m in re.finditer(r"\belse\s+(\d+)\b", stripped): codes.add(int(m.group(1))) return codes def readme_section(text, heading=HEADING): """The lines under a `## ` heading, up to the next one; None when the page has no such heading.""" lines = text.split("\n") start = None for i, line in enumerate(lines): if line.strip() == heading: start = i + 1 break if start is None: return None body = [] for line in lines[start:]: if re.match(r"^##\s", line): break body.append(line) return body def paragraphs(lines): """A paragraph's lines joined: the page wraps a sentence over several lines.""" out, buf = [], "" for line in lines: if not line.strip(): if buf: out.append(buf) buf = "" continue buf = (buf + " " + line.strip()).strip() if buf: out.append(buf) return out def codes_named(lines): """Exit codes the reader of this block is told about: a number on a line about the exit made.""" codes = set() for para in paragraphs(lines): if not re.search(r"\bexits?\b|\bexit code\b", para, re.I): continue for m in re.finditer(r"(?