docassert 0.16.0__tar.gz → 0.17.0__tar.gz

{docassert-0.16.0/docassert.egg-info → docassert-0.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.16.0
+Version: 0.17.0
 Summary: Unit testing for business documents — validate structured Markdown docs against a configurable audit standard.
 Author: C4G Enterprises Inc.
 License: Apache-2.0
@@ -102,6 +102,8 @@ flagged as TODOs, never invented). The skill's source is
 | `docassert extract <file>` | Extract plain text from a source `.docx` / `.pdf` / `.md` / `.txt` (the first step of doc-to-pmo conversion). Needs the `convert` extra: `pip install "docassert[convert]"`. |
 
 Every document-reading command accepts `--documents-dir` (default `documents/`).
+The full flag-by-flag reference, and what 1.x does and does not promise to
+keep stable, live in [STABILITY.md](STABILITY.md).
 AI alignment grades at most `alignment_limit` links per run (default 25; set it
 in `consistency.yaml`, `0` = no cap) so API cost stays bounded on large graphs.
 

{docassert-0.16.0 → docassert-0.17.0}/README.md

@@ -62,6 +62,8 @@ flagged as TODOs, never invented). The skill's source is
 | `docassert extract <file>` | Extract plain text from a source `.docx` / `.pdf` / `.md` / `.txt` (the first step of doc-to-pmo conversion). Needs the `convert` extra: `pip install "docassert[convert]"`. |
 
 Every document-reading command accepts `--documents-dir` (default `documents/`).
+The full flag-by-flag reference, and what 1.x does and does not promise to
+keep stable, live in [STABILITY.md](STABILITY.md).
 AI alignment grades at most `alignment_limit` links per run (default 25; set it
 in `consistency.yaml`, `0` = no cap) so API cost stays bounded on large graphs.
 

{docassert-0.16.0 → docassert-0.17.0}/docassert/__init__.py

@@ -5,4 +5,4 @@ standard: deterministic structural checks that gate a merge, plus optional
 AI-graded semantic checks that advise.
 """
 
-__version__ = "0.16.0"
+__version__ = "0.17.0"

{docassert-0.16.0 → docassert-0.17.0/docassert.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docassert
-Version: 0.16.0
+Version: 0.17.0
 Summary: Unit testing for business documents — validate structured Markdown docs against a configurable audit standard.
 Author: C4G Enterprises Inc.
 License: Apache-2.0
@@ -102,6 +102,8 @@ flagged as TODOs, never invented). The skill's source is
 | `docassert extract <file>` | Extract plain text from a source `.docx` / `.pdf` / `.md` / `.txt` (the first step of doc-to-pmo conversion). Needs the `convert` extra: `pip install "docassert[convert]"`. |
 
 Every document-reading command accepts `--documents-dir` (default `documents/`).
+The full flag-by-flag reference, and what 1.x does and does not promise to
+keep stable, live in [STABILITY.md](STABILITY.md).
 AI alignment grades at most `alignment_limit` links per run (default 25; set it
 in `consistency.yaml`, `0` = no cap) so API cost stays bounded on large graphs.
 

{docassert-0.16.0 → docassert-0.17.0}/docassert.egg-info/SOURCES.txt

@@ -116,6 +116,7 @@ tests/test_kinds_operate.py
 tests/test_kinds_reporting.py
 tests/test_profiles.py
 tests/test_projects.py
+tests/test_report_extract.py
 tests/test_scaffold.py
 tests/test_semantic.py
 tests/test_status.py

{docassert-0.16.0 → docassert-0.17.0}/pyproject.toml

@@ -85,4 +85,4 @@ source = ["docassert"]
 
 [tool.coverage.report]
 # Keep the gate honest: fail CI if coverage drops below the floor.
-fail_under = 80
+fail_under = 85

docassert-0.17.0/tests/test_report_extract.py

@@ -0,0 +1,70 @@
+"""Coverage for the report renderers, extraction text paths, and the module
+entry point — the last stretch to the 85% floor (ENG-US-009)."""
+import runpy
+
+import pytest
+
+from docassert import report
+from docassert.extract import extract
+from docassert.models import CheckResult
+
+
+def _results():
+    return {
+        "documents/a.md": [
+            CheckResult("frontmatter-schema", True, True, "ok"),
+            CheckResult("required-sections", False, True, "missing: Scope"),
+            CheckResult("alignment", False, False, "weak link", kind="semantic",
+                        score=0.4),
+        ],
+        "documents/b.md": [CheckResult("unique-id", True, True, "unique")],
+    }
+
+
+def test_markdown_report_carries_verdicts():
+    md = report.markdown(_results())
+    assert "a.md" in md and "required-sections" in md
+    assert "🔴" in md and "🟢" in md and "⚪" not in md.split("alignment")[0]
+
+
+def test_junit_report_is_valid_xml_with_failures():
+    import xml.etree.ElementTree as ET
+    xml = report.junit(_results())
+    root = ET.fromstring(xml)
+    assert root.tag in {"testsuite", "testsuites"}
+    assert int(root.get("failures", root.get("errors", "0"))) >= 1 or \
+        any(int(s.get("failures", "0")) >= 1 for s in root.iter("testsuite"))
+
+
+def test_json_console_and_summary_agree_on_failure():
+    res = _results()
+    assert "1 blocking failure" in report.summary_line(res) \
+        or "blocking" in report.summary_line(res)
+    assert "required-sections" in report.console(res)
+    assert '"passed": false' in report.json_report(res)
+
+
+def test_extract_reads_md_and_txt(tmp_path):
+    md = tmp_path / "s.md"
+    md.write_text("# hello", encoding="utf-8")
+    txt = tmp_path / "s.txt"
+    txt.write_text("plain", encoding="utf-8")
+    assert extract(md) == "# hello"
+    assert extract(txt) == "plain"
+
+
+def test_extract_rejects_unknown_and_missing(tmp_path):
+    odd = tmp_path / "s.xyz"
+    odd.write_text("x", encoding="utf-8")
+    with pytest.raises(ValueError):
+        extract(odd)
+    with pytest.raises(FileNotFoundError):
+        extract(tmp_path / "absent.md")
+
+
+def test_module_entry_point_reports_version(capsys, monkeypatch):
+    monkeypatch.setattr("sys.argv", ["docassert", "--version"])
+    with pytest.raises(SystemExit) as exc:
+        runpy.run_module("docassert.__main__", run_name="__main__")
+    assert exc.value.code == 0
+    assert "docassert" in capsys.readouterr().out