test_lint_health.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# tests/tests_health/test_lint_health.py
 
"""
Tests for lint health check.
 
Purpose
-------
Verify that check_lint_health correctly aggregates linter results.
 
Responsibilities
----------------
- Test fully compliant projects.
- Test partially compliant projects.
- Test empty projects.
- Test verbose mode file details.
 
Diagnostics
-----------
Domain: TESTS.HEALTH
Levels:
    L2 — test lifecycle
    L3 — lint aggregation verification
    L4 — per-check count validation
 
Contracts
---------
- Compliance percentage is calculated correctly.
- Per-check pass counts match actual results.
- Verbose mode includes per-file breakdown.
"""
 
import pytest
from pathlib import Path
 
from oct.health.oct_health import check_lint_health
from oct.linter.oct_lint import LinterContext
from tests.tests_health.conftest import make_compliant_file, NON_COMPLIANT_FILE
 
 
def test_lint_health_all_compliant(temp_project_root: Path, linter_ctx: LinterContext):
    """Test 100% compliance when all files pass."""
    (temp_project_root / "good.py").write_text(make_compliant_file("good.py"), encoding="utf-8")
 
    result = check_lint_health(temp_project_root, linter_ctx)
 
    assert result["total_files"] == 1
    assert result["fully_compliant"] == 1
    assert result["compliance_pct"] == 100.0
 
 
def test_lint_health_partial_compliance(temp_project_root: Path, linter_ctx: LinterContext):
    """Test mixed compliance results."""
    (temp_project_root / "good.py").write_text(make_compliant_file("good.py"), encoding="utf-8")
    # Pad non-compliant to > 20 lines so it's not trivial
    padded = NON_COMPLIANT_FILE + "\n".join(["# pad"] * 20)
    (temp_project_root / "bad.py").write_text(padded, encoding="utf-8")
 
    result = check_lint_health(temp_project_root, linter_ctx)
 
    assert result["total_files"] == 2
    assert result["fully_compliant"] == 1
    assert result["compliance_pct"] == 50.0
 
 
def test_lint_health_empty_project(temp_project_root: Path, linter_ctx: LinterContext):
    """Test health check on project with no Python files."""
    result = check_lint_health(temp_project_root, linter_ctx)
 
    assert result["total_files"] == 0
    assert result["fully_compliant"] == 0
    assert result["compliance_pct"] == 0.0
 
 
def test_lint_health_check_categories(temp_project_root: Path, linter_ctx: LinterContext):
    """Test that all check categories are reported."""
    (temp_project_root / "good.py").write_text(make_compliant_file("good.py"), encoding="utf-8")
 
    result = check_lint_health(temp_project_root, linter_ctx)
 
    expected_checks = ["header", "docstring", "diagnostics_profile", "dbg_usage", "dbg_import", "func_pattern"]
    for check_name in expected_checks:
        assert check_name in result["checks"]
        assert "pass" in result["checks"][check_name]
        assert "total" in result["checks"][check_name]
        assert "pct" in result["checks"][check_name]
 
 
def test_lint_health_verbose_includes_files(temp_project_root: Path, linter_ctx: LinterContext):
    """Test that verbose mode includes per-file details."""
    (temp_project_root / "good.py").write_text(make_compliant_file("good.py"), encoding="utf-8")
 
    result = check_lint_health(temp_project_root, linter_ctx, verbose=True)
 
    assert "files" in result
    assert len(result["files"]) == 1
    assert result["files"][0]["compliant"] is True
 
 
def test_lint_health_verbose_shows_failures(temp_project_root: Path, linter_ctx: LinterContext):
    """Test that verbose mode shows failed checks per file."""
    padded = NON_COMPLIANT_FILE + "\n".join(["# pad"] * 20)
    (temp_project_root / "bad.py").write_text(padded, encoding="utf-8")
 
    result = check_lint_health(temp_project_root, linter_ctx, verbose=True)
 
    assert "files" in result
    assert len(result["files"]) == 1
    assert result["files"][0]["compliant"] is False