test_pytest_missing_hint.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# tests/tests_cli/test_pytest_missing_hint.py
 
"""
Purpose
-------
OI-511 regression tests — ``oct test`` must surface an actionable install
hint when pytest is missing. Because ``pytest`` is declared only in the
``[project.optional-dependencies].test`` extra, users who install the
runtime-only package and try to run ``oct test`` should see the hint
rather than a bare ``No module named pytest`` traceback.
 
Responsibilities
----------------
- ``_pytest_missing`` flags the sentinel string pytest emits when not
  importable and returns False otherwise.
- ``_PYTEST_INSTALL_HINT`` references the ``oct[test]`` extra so users
  discover the canonical install path.
 
Diagnostics
-----------
Domain: CLI-TESTS
Levels:
    L2 — test lifecycle
    L3 — assertion details
    L4 — deep tracing
 
Contracts
---------
- Must never claim pytest is missing on a benign pytest failure (e.g.
  assertion mismatch).
"""
 
from oct.cli import _PYTEST_INSTALL_HINT, _pytest_missing
 
 
def test_detects_missing_pytest_in_output():
    sample = (
        "C:\\Python\\python.exe: No module named pytest\n"
    )
    assert _pytest_missing(sample) is True
 
 
def test_does_not_flag_normal_failure_as_missing():
    sample = (
        "tests/foo.py::test_bar FAILED\n"
        "AssertionError: nope\n"
    )
    assert _pytest_missing(sample) is False
 
 
def test_install_hint_mentions_oct_test_extra():
    assert "oct[test]" in _PYTEST_INSTALL_HINT
    assert "pytest" in _PYTEST_INSTALL_HINT