使用Bazel 6.0生成Python代码覆盖率报告遇故障求助

问题拆解 #

你遇到的两个核心问题：

1. pip_install 触发 AttributeError：rules_python 0.5.0版本过旧，对Git URL形式的依赖解析存在bug，无法提取有效包名导致name为None，进而触发replace属性错误。
2. 直接指定coverage路径报错：Bazel自动生成的.coveragerc包含过时配置项，且未正确适配你使用的lcov-support分支的coverage工具命令。

分步解决方案 #

1. 升级rules_python并修复依赖解析 #

旧版rules_python处理Git依赖的逻辑不完善，先升级到适配Bazel 6.0的稳定版本：

更新WORKSPACE文件

load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

http_archive(
    name = "rules_python",
    url = "https://github.com/bazelbuild/rules_python/releases/download/0.23.0/rules_python-0.23.0.tar.gz",
    sha256 = "a8a80b4f39475e020a3f03c13a323190d363b62f0406b44164bd3f730d055f3b",
)

load("@rules_python//python:pip.bzl", "pip_install")

pip_install(
   name = "python_deps",
   requirements = "//:requirements.txt",
)

修正requirements.txt

明确指定包名，避免解析失败：

coverage @ git+https://github.com/ulfjack/coveragepy.git@lcov-support

2. 调整BUILD规则与coverage配置 #

修改BUILD文件中的py_test规则

禁用Bazel自动生成的配置，确保coverage工具正常工作：

load("@python_deps//:requirements.bzl", "entry_point")

alias(
    name = "python_coverage_tools",
    actual = entry_point("coverage"),
)

py_test(
    name = "test",
    srcs = ["test.py"],
    env = {
        "PYTHON_COVERAGE": "$(location :python_coverage_tools)",
        # 禁用Bazel自动生成的.coveragerc，避免配置冲突
        "COVERAGE_PROCESS_START": "",
    },
    deps = [
        ":main",
        ":python_coverage_tools",
    ],
    # 显式启用覆盖率收集
    coverage = True,
)

添加自定义.coveragerc配置

在项目根目录创建该文件，替换Bazel的默认配置：

[run]
source = .
relative_files = True

[report]
show_missing = True

3. 执行覆盖率收集与报告生成 #

运行以下命令收集覆盖率数据：

bazel coverage --test_env=COVERAGE_CONFIG_PATH=$(pwd)/.coveragerc //tests:test_main

生成HTML格式报告（可选）：

# 复制Bazel生成的覆盖率数据到当前目录
cp bazel-out/_coverage/_coverage_report.dat .
# 生成HTML报告
coverage html -i _coverage_report.dat

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