test_shim.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# tests/test_shim.py
 
"""
pytest Compatibility Shim — oc_diagnostics
==========================================
 
Purpose
-------
Allow CI systems and contributors that use ``pytest`` as their standard
test-runner entry point to invoke the full ``oc_diagnostics`` test suite
without knowledge of the custom ``tests/run_tests.py`` runner (OI-20 / FS-11).
 
How it works
------------
A single pytest test function runs ``tests/run_tests.py`` as a subprocess and
asserts exit code 0.  The custom Option C runner is unchanged; this file is a
thin adapter only.
 
Usage
-----
    pytest tests/test_shim.py        # run via pytest
    python tests/run_tests.py        # run directly (preferred for development)
"""
 
import os
import subprocess
import sys
 
import pytest
 
_REPO_ROOT = os.path.normpath(os.path.join(os.path.dirname(__file__), ".."))
_RUN_TESTS = os.path.join(_REPO_ROOT, "tests", "run_tests.py")
 
 
def test_oc_diagnostics_suite():
    """Run the full oc_diagnostics suite via the custom tests/run_tests.py runner.
 
    Passes when run_tests.py exits 0 (all non-skipped tests pass).
    Fails with the captured output when run_tests.py exits non-zero.
    """
    result = subprocess.run(
        [sys.executable, _RUN_TESTS],
        cwd=_REPO_ROOT,
        capture_output=True,
        text=True,
        timeout=120,
    )
 
    if result.returncode != 0:
        output = (result.stdout + result.stderr).strip()
        pytest.fail(
            f"run_tests.py exited with code {result.returncode}:\n{output}"
        )