test_diagnostics_stub.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# tests/tests_core/test_diagnostics_stub.py
 
"""
Purpose
-------
OI-525 regression tests — ``oct.core.diagnostics`` must provide a single
``_dbg`` entry point that re-binds ``oc_diagnostics._dbg`` when available
and falls back to a silent no-op stub otherwise. This eliminates the
duplicated per-module try/except that previously existed in every
``oct/git/*.py`` file.
 
Responsibilities
----------------
- Importing ``_dbg`` from ``oct.core.diagnostics`` never raises.
- The resolved ``_dbg`` is callable with ``(domain, func, msg, level)``
  and arbitrary kwargs, and returns ``None``.
- When ``oc_diagnostics`` is importable, ``_dbg`` is the real callable
  (``oc_diagnostics._dbg``) or a trivial bind of it — not a no-op shim.
- When ``oc_diagnostics`` is unavailable, a re-evaluated module exposes
  a no-op fallback.
 
Diagnostics
-----------
Domain: CORE-TESTS
Levels:
    L2 — test lifecycle
    L3 — assertion details
    L4 — deep tracing
 
Contracts
---------
- Signature must match ``oc_diagnostics._dbg`` so callers can switch
  transparently.
"""
 
import importlib
import sys
 
import pytest
 
 
def test_dbg_importable_and_callable():
    from oct.core.diagnostics import _dbg
    func = "test_dbg_importable_and_callable"
 
    assert callable(_dbg)
    result = _dbg("OCT-CORE", func, "probe message", 3, extra="ok")
    assert result is None
 
 
def test_dbg_matches_oc_diagnostics_when_available():
    try:
        from oc_diagnostics import _dbg as real_dbg
    except ImportError:
        pytest.skip(
            "oc_diagnostics._dbg not importable (namespace-package "
            "shadowing or not installed)"
        )
 
    from oct.core.diagnostics import _dbg
 
    assert _dbg is real_dbg
 
 
def test_dbg_fallback_when_oc_diagnostics_missing(monkeypatch):
    func = "test_dbg_fallback_when_oc_diagnostics_missing"
    import oct.core.diagnostics as mod
 
    monkeypatch.setitem(sys.modules, "oc_diagnostics", None)
    sys.modules.pop("oct.core.diagnostics", None)
 
    try:
        reloaded = importlib.import_module("oct.core.diagnostics")
        assert callable(reloaded._dbg)
        assert reloaded._dbg("X", func, "z", 1) is None
    finally:
        sys.modules["oct.core.diagnostics"] = mod