#!/usr/bin/env python3 """Adversarial tests for lint-skin.py's accessible-SVG contract.""" from __future__ import annotations import subprocess import sys import tempfile from pathlib import Path ROOT = Path(__file__).resolve().parent.parent LINTER = ROOT / "scripts/lint-skin.py" VALID_SVG = """\ Fixture diagram Diagram showing a fixture connected to a result. """ def run_linter(path: Path) -> subprocess.CompletedProcess[str]: return subprocess.run( [sys.executable, str(LINTER), str(path)], capture_output=True, text=True, check=False, ) def require_failure(name: str, html: str, expected: str, directory: Path) -> None: path = directory / f"{name}.html" path.write_text(html, encoding="utf-8") result = run_linter(path) if result.returncode != 1: raise AssertionError( f"{name}: expected exit 1, got {result.returncode}\n{result.stdout}{result.stderr}" ) if f"a11y: {expected}" not in result.stdout: raise AssertionError( f"{name}: missing expected a11y finding {expected!r}\n{result.stdout}" ) print(f"OK: {name} rejected — {expected}") def require_pass(name: str, html: str, directory: Path) -> None: path = directory / f"{name}.html" path.write_text(html, encoding="utf-8") result = run_linter(path) if result.returncode != 0: raise AssertionError( f"{name}: expected exit 0, got {result.returncode}\n{result.stdout}{result.stderr}" ) if "a11y:" in result.stdout: raise AssertionError(f"{name}: unexpected a11y finding\n{result.stdout}") print(f"OK: {name} accepted") def main() -> int: with tempfile.TemporaryDirectory(prefix="lint-a11y-") as temp_dir: directory = Path(temp_dir) require_failure( "missing-role", VALID_SVG.replace(' role="img"', ""), 'diagram must carry role="img"', directory, ) require_failure( "unresolved-labelled-by", VALID_SVG.replace( 'aria-labelledby="fixture-title fixture-desc"', 'aria-labelledby="absent-title absent-desc"', ), "aria-labelledby references missing id(s): absent-title, absent-desc", directory, ) require_failure( "labels-unrelated-elements", VALID_SVG.replace(' id="fixture-title"', "") .replace(' id="fixture-desc"', "") .replace( ' ', ' \n' ' \n' ' ', ), "aria-labelledby must name the and IDs", directory, ) require_failure( "late-title", VALID_SVG.replace( ' Fixture diagram\n \n Fixture diagram\n must be the first child element of ", directory, ) require_failure( "empty-desc", VALID_SVG.replace( "Diagram showing a fixture connected to a result.", " " ), " must not be empty", directory, ) require_failure( "bare-ids", VALID_SVG.replace("fixture-title", "title").replace( "fixture-desc", "desc" ), 'bare id="title" and id="desc" are not allowed', directory, ) require_pass( "decorative", '\n', directory, ) print("All accessible-SVG lint cases passed.") return 0 if __name__ == "__main__": sys.exit(main())