test_headers.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# tests/tests_linter/test_headers.py
 
"""
Purpose
-------
Validate the linter's header detection logic.
 
Responsibilities
----------------
- Confirm correct detection of valid header blocks.
- Confirm detection of missing or malformed header lines.
- Ensure header validation behaves deterministically.
 
Diagnostics
-----------
Domain: LINTER-TESTS
Levels:
    L2 — lifecycle
    L3 — semantic details
    L4 — deep tracing
 
Contracts
---------
- Must not modify fixture files.
- Must not rely on external state.
- Must assert only on validation, not fixing.
"""
 
from pathlib import Path
from oct.linter import oct_lint
 
 
def test_valid_header_block(temp_project_root: Path, linter_ctx: oct_lint.LinterContext):
    fixture = temp_project_root / "tests_linter" / "fixtures" / "minimal_valid.py"
    text = fixture.read_text(encoding="utf-8")
    lines = text.splitlines()
    ok, errors = oct_lint.validate_header_block(lines, fixture, linter_ctx)
    assert ok
    assert errors == []
 
 
def test_missing_shebang_detected(temp_project_root: Path, linter_ctx: oct_lint.LinterContext):
    fixture = temp_project_root / "tests_linter" / "fixtures" / "missing_shebang.py"
    text = fixture.read_text(encoding="utf-8")
    lines = text.splitlines()
    ok, errors = oct_lint.validate_header_block(lines, fixture, linter_ctx)
    assert not ok
    assert any("Shebang" in e for e in errors)