.coveragerc

[run]
# Use the modern Python 3.12+ sys.monitoring backend, which avoids the
# C-trace conflict with torch's _C extension.
core = sysmon
parallel = false
branch = false

# NOTE on the coverage scope:
#
# We do NOT set `source = ...` here. The runner script
# (scripts/run_platform_tests.sh) sets `--cov=...` flags dynamically
# based on which backend is being tested:
#
#   * `kv_cache_proposer` and the platform-neutral `inference_engine`
#     subpackages (proposer/, memory/, scheduler/, server/) are ALWAYS
#     covered — their tests run on every backend.
#   * `inference_engine.backends.<selected>` is covered only when that
#     backend is being tested. An MLX backend module sitting on a Linux
#     CUDA host is not in scope (the host can't import mlx), and vice
#     versa.
#
# This avoids the alternative — setting `source = inference_engine` —
# which would force every backend module to be 100% covered on every
# host, even when its dependencies (Metal / CUDA) aren't present.

# CLI entry-point scripts are exercised by end-to-end demo runs (under
# `results/`) and by an integration test that invokes them via
# subprocess; they are intentionally not part of the unit-test coverage
# target (their bodies are argparse plumbing + orchestration of already-
# tested library code).
omit =
    kv_cache_proposer/run_demo.py
    # Generated gRPC / protobuf stubs (PR-B1 of ADR 0008). The
    # canonical regeneration command is
    # ``scripts/regenerate_proto_stubs.sh``; CI's
    # ``proto-stub-drift`` step verifies that the committed stubs
    # match what the script would produce. The stubs are not the
    # surface we own — protoc owns them — so coverage on them is
    # neither meaningful nor stable across protoc versions.
    inference_engine/server/proto_gen/*

[report]
exclude_lines =
    pragma: no cover
    raise NotImplementedError
    if __name__ == .__main__.:
    if TYPE_CHECKING:
show_missing = true
skip_empty = true
fail_under = 100