0.1.4-alpha.2.fix.1

tests/test_text_hygiene.py

@@ -0,0 +1,83 @@
+# file: tests/test_text_hygiene.py
+# version: 1
+
+"""Exercise the governed text hygiene audit's real file and CLI contracts."""
+
+from __future__ import annotations
+
+import pathlib
+import subprocess
+import sys
+import tempfile
+import unittest
+
+_SCRIPT = pathlib.Path(__file__).resolve().parents[1] / "scripts/audit_text_hygiene.py"
+
+
+class TextHygieneAuditTests(unittest.TestCase):
+    def setUp(self) -> None:
+        temporary = tempfile.TemporaryDirectory(prefix="pgr-text-hygiene-")
+        self.addCleanup(temporary.cleanup)
+        self.root = pathlib.Path(temporary.name)
+
+    def source(self, name: str, contents: bytes) -> pathlib.Path:
+        path = self.root / name
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_bytes(contents)
+        return path
+
+    def run_audit(self, *paths: str) -> subprocess.CompletedProcess[str]:
+        return subprocess.run(
+            [sys.executable, "-B", str(_SCRIPT), *paths],
+            cwd=self.root,
+            capture_output=True,
+            text=True,
+            check=False,
+        )
+
+    def test_exactly_one_final_lf_is_clean(self) -> None:
+        self.source("README.md", b"line one\nline two\n")
+        result = self.run_audit("README.md")
+        self.assertEqual(result.returncode, 0, result.stderr)
+        self.assertIn("clean (1 file(s))", result.stdout)
+
+    def test_extra_blank_line_at_eof_is_rejected(self) -> None:
+        self.source("docs/page.md", b"content\n\n")
+        result = self.run_audit("docs/page.md")
+        self.assertEqual(result.returncode, 1)
+        self.assertIn("extra blank line", result.stderr)
+
+    def test_missing_final_lf_is_rejected(self) -> None:
+        self.source("VERSION", b"1.2.3")
+        result = self.run_audit("VERSION")
+        self.assertEqual(result.returncode, 1)
+        self.assertIn("missing final LF", result.stderr)
+
+    def test_crlf_is_rejected(self) -> None:
+        self.source("config.toml", b"value = true\r\n")
+        result = self.run_audit("config.toml")
+        self.assertEqual(result.returncode, 1)
+        self.assertIn("CR byte found", result.stderr)
+
+    def test_trailing_space_and_tab_are_rejected(self) -> None:
+        self.source("docs/page.md", b"first \nsecond\t\n")
+        result = self.run_audit("docs/page.md")
+        self.assertEqual(result.returncode, 1)
+        self.assertIn("docs/page.md:1: trailing whitespace", result.stderr)
+        self.assertIn("docs/page.md:2: trailing whitespace", result.stderr)
+
+    def test_generated_directory_is_skipped(self) -> None:
+        self.source("docs/visible.md", b"clean\n")
+        self.source("docs/target/generated.md", b"bad\n\n")
+        result = self.run_audit("docs")
+        self.assertEqual(result.returncode, 0, result.stderr)
+        self.assertIn("clean (1 file(s))", result.stdout)
+
+    def test_missing_path_is_a_selection_error(self) -> None:
+        result = self.run_audit("missing.md")
+        self.assertEqual(result.returncode, 2)
+        self.assertIn("unsupported or missing path", result.stderr)
+
+
+if __name__ == "__main__":
+    unittest.main()