如何让pytest-cov仅在总覆盖率低于90%时输出完整表格？

可以实现这个需求，不过pytest-cov本身没有提供直接的单参数配置，需要结合shell脚本的条件判断来完成。核心思路是先获取总覆盖率数值，再根据阈值决定是否输出完整报告。

方法一：基于文本输出提取覆盖率（依赖grep、bc工具） #

# 替换成你的目标包/模块名
TARGET_PACKAGE="your_package"

# 先运行测试，将覆盖率输出保存到临时文件（跳过已完全覆盖的文件）
pytest --cov=$TARGET_PACKAGE --cov-report=term-missing:skip-covered > coverage_temp.txt 2>&1

# 从临时文件中提取总覆盖率数值
COVERAGE=$(grep -oP 'TOTAL\s+\d+\.\d+%' coverage_temp.txt | grep -oP '\d+\.\d+')

# 根据阈值判断输出逻辑
if (( $(echo "$COVERAGE < 90" | bc -l) )); then
    # 覆盖率低于90%，输出完整报告内容
    cat coverage_temp.txt
else
    # 覆盖率达标，仅输出简单提示（也可以直接留空不输出）
    echo "覆盖率达标：$COVERAGE% (≥90%)"
fi

# 清理临时文件
rm coverage_temp.txt

方法二：基于JSON报告提取覆盖率（更准确，依赖jq工具） #

如果系统安装了jq（JSON处理工具），可以用这种更可靠的方式：

TARGET_PACKAGE="your_package"

# 生成JSON格式的覆盖率报告
pytest --cov=$TARGET_PACKAGE --cov-report=json:coverage.json

# 从JSON中提取总覆盖率数值
COVERAGE=$(jq '.totals.percent_covered' coverage.json)

# 判断输出逻辑
if (( $(echo "$COVERAGE < 90" | bc -l) )); then
    # 低于阈值，输出完整的带缺失行的报告
    pytest --cov=$TARGET_PACKAGE --cov-report=term-missing
else
    echo "覆盖率达标：$COVERAGE% (≥90%)"
fi

# 清理JSON报告文件
rm coverage.json

关键参数说明 #

• --cov=your_package：指定要统计覆盖率的目标包或模块，替换为你项目的实际路径。
• --cov-report=term-missing：在终端输出覆盖率表格，并标记未覆盖的代码行。
• :skip-covered：可选参数，跳过显示已完全覆盖的文件，让报告更简洁。

内容的提问来源于stack exchange，提问作者Ivan Prychantovskyi