chore: give every coverage pragma a reason (TS6) (#83)

Author: lesnik512

semvertag/__main__.py

@@ -176,5 +176,5 @@ def main() -> None:
         MAIN_APP()
 
 
-if __name__ == "__main__":  # pragma: no cover
+if __name__ == "__main__":
     main()

semvertag/_outcome.py

@@ -91,5 +91,5 @@ def to_run_result(outcome: Outcome, *, strategy: str) -> RunResult:
             return RunResult(
                 strategy=strategy, bump=Bump.NONE.value, status=status, tag=None, commit=commit, reason=reason
             )
-        case _:  # pragma: no cover
+        case _:  # pragma: no cover - exhaustiveness guard; ty verifies every Outcome is matched
             typing.assert_never(outcome)

semvertag/_output.py

@@ -68,7 +68,7 @@ def _format_outcome(outcome: Outcome, *, strategy: str) -> str:
             return f"No tag created — latest commit is already tagged {tag}."
         case NoBump(reason=reason):
             return f"No tag created — {reason}"
-        case _:  # pragma: no cover
+        case _:  # pragma: no cover - exhaustiveness guard; ty verifies every Outcome is matched
             typing.assert_never(outcome)
 
 

semvertag/ioc.py

@@ -70,7 +70,7 @@ def _build_current_provider(
                 http=gitlab_client,
                 default_branch=settings.default_branch,
             )
-        case _:  # pragma: no cover
+        case _:  # pragma: no cover - exhaustiveness guard; ty verifies every ProviderTarget is matched
             typing.assert_never(settings.provider_target)
 
 

tests/_descriptor_gate.py

@@ -116,5 +116,5 @@ def main(argv: list[str]) -> None:
     sys.stdout.write(f"{argv[1]} shape OK\n")
 
 
-if __name__ == "__main__":  # pragma: no cover
+if __name__ == "__main__":
     main(sys.argv)

tests/integration/test_cli_errors.py

@@ -1,5 +1,6 @@
 import collections.abc
 import importlib.metadata
+import runpy
 import sys
 import typing
 import unittest.mock
@@ -167,3 +168,11 @@ def test_main_entry_point_runs_typer_app_inside_ioc_container(
     with pytest.raises(SystemExit) as exc_info:
         cli_main.main()
     assert exc_info.value.code == 0
+
+
+def test_python_dash_m_semvertag_runs_the_cli(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr(sys, "argv", ["semvertag", "--version"])
+    monkeypatch.delitem(sys.modules, "semvertag.__main__")
+    with pytest.raises(SystemExit) as exc_info:
+        runpy.run_module("semvertag", run_name="__main__")
+    assert exc_info.value.code == 0

tests/test_ci_descriptor_gate.py

@@ -7,6 +7,8 @@
 """
 
 import pathlib
+import runpy
+import sys
 import typing
 
 import pytest
@@ -129,6 +131,16 @@ def test_main_prints_shape_ok_for_valid_descriptor(capsys: pytest.CaptureFixture
     assert captured.out == f"{_DESCRIPTOR_PATH} shape OK\n"
 
 
+def test_module_run_as_script_validates_argv_path(
+    monkeypatch: pytest.MonkeyPatch, capsys: pytest.CaptureFixture[str]
+) -> None:
+    monkeypatch.setattr(sys, "argv", ["_descriptor_gate", str(_DESCRIPTOR_PATH)])
+    monkeypatch.delitem(sys.modules, "tests._descriptor_gate")
+    runpy.run_module("tests._descriptor_gate", run_name="__main__")
+    captured: typing.Final = capsys.readouterr()
+    assert captured.out == f"{_DESCRIPTOR_PATH} shape OK\n"
+
+
 def test_main_raises_when_argv_length_wrong() -> None:
     with pytest.raises(DescriptorGateError, match=r"usage: python -m tests\._descriptor_gate"):
         main(["_descriptor_gate"])

tests/unit/test_use_case.py

@@ -5,7 +5,7 @@
 import semver
 
 from semvertag._outcome import AlreadyTagged, Created, DryRun, NoBump, NoTags, Outcome
-from semvertag._types import Bump, CheckResult, Commit, Tag
+from semvertag._types import Bump, Commit, Tag
 from semvertag._use_case import SemvertagUseCase, _compute_new_version, _select_latest_semver_tag
 
 
@@ -62,18 +62,6 @@ def list_tags(self) -> list[Tag]:
     def create_tag(self, name: str, commit_sha: str) -> None:
         self.create_tag_calls.append((name, commit_sha))
 
-    def check_token(self) -> CheckResult:  # pragma: no cover
-        return CheckResult(name="token", status="passed", cause="stub")
-
-    def check_scopes(self) -> CheckResult:  # pragma: no cover
-        return CheckResult(name="scopes", status="passed", cause="stub")
-
-    def check_project_access(self) -> CheckResult:  # pragma: no cover
-        return CheckResult(name="project_access", status="passed", cause="stub")
-
-    def check_protected_tags(self) -> CheckResult:  # pragma: no cover
-        return CheckResult(name="protected_tags", status="passed", cause="stub")
-
 
 @dataclasses.dataclass(slots=True, kw_only=True)
 class _StubStrategy: