test_header_fixing.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# tests/tests_linter/test_header_fixing.py
 
"""
Purpose
-------
Validate the linter's header auto-fixing logic.
 
Responsibilities
----------------
- Ensure missing or incorrect header lines are corrected.
- Ensure duplicates and misplaced lines are removed.
- Ensure docstrings and code remain intact.
- Ensure backup files are created.
 
Diagnostics
-----------
Domain: LINTER-TESTS
Levels:
    L2 — lifecycle
    L3 — semantic details
    L4 — deep tracing
 
Contracts
---------
- Must not modify fixtures outside the temporary project root.
- Must verify correctness of the rewritten header block.
- Must ensure no corruption of module content.
"""
 
from pathlib import Path
from oct.linter import oct_lint
 
 
def read_lines(path: Path):
    return path.read_text(encoding="utf-8").splitlines()
 
 
def test_fix_missing_shebang(temp_project_root: Path, linter_ctx: oct_lint.LinterContext):
    fixture = temp_project_root / "tests_linter" / "fixtures" / "missing_shebang.py"
    original = fixture.read_text(encoding="utf-8")
 
    oct_lint.fix_header_block(fixture, original, linter_ctx)
    lines = read_lines(fixture)
 
    assert lines[0].strip() == oct_lint.SHEBANG
    assert lines[1].strip() == oct_lint.ENCODING
    assert lines[2].strip().endswith("missing_shebang.py")
    assert lines[3].strip() == ""
 
 
def test_fix_wrong_path_header(temp_project_root: Path, linter_ctx: oct_lint.LinterContext):
    fixture = temp_project_root / "tests_linter" / "fixtures" / "wrong_path_header.py"
    original = fixture.read_text(encoding="utf-8")
 
    oct_lint.fix_header_block(fixture, original, linter_ctx)
    lines = read_lines(fixture)
 
    assert lines[0].strip() == oct_lint.SHEBANG
    assert lines[1].strip() == oct_lint.ENCODING
    assert lines[2].strip().endswith("wrong_path_header.py")
    assert lines[3].strip() == ""