如何在rules-proto-grpc的python_grpc_library规则中配置pyi_out路径？

要解决这个问题，核心是理解Bazel沙盒构建环境的路径规则——不能直接用本地的相对/绝对路径，得用Bazel提供的路径宏指定输出位置，同时要让Bazel识别生成的存根文件作为规则输出。

正确配置步骤 #

1. 指定protoc输出路径：在extra_protoc_args中用$(RULEDIR)作为--pyi_out的目标路径，这个宏会指向Bazel为当前规则分配的沙盒输出目录，是构建过程中唯一合法的可写路径。
2. 声明输出文件：通过outs参数列出所有要生成的.pyi文件，确保Bazel会收集这些文件并保留在构建输出中。

示例配置 #

假设你有一个foo.proto文件，对应的python_grpc_library配置如下：

python_grpc_library(
    name = "foo_py_grpc",
    protos = [":foo_proto"],
    visibility = ["//visibility:public"],
    extra_protoc_args = [
        "--pyi_out=$(RULEDIR)",
    ],
    outs = [
        "foo_pb2.pyi",
        "foo_pb2_grpc.pyi",
    ],
    deps = [
        "@pip//grpcio",
        "@pip//grpcio-tools",
        # 其他依赖
    ],
)

为什么之前的配置无效 #

• 用.作为路径：Bazel构建在沙盒中执行，.指向的是沙盒内的临时工作目录，而非你本地项目的目录，生成的文件会被沙盒清理，无法保留。
• 用绝对路径：沙盒环境有严格的文件访问限制，绝对路径不在允许的访问范围内，protoc会因权限问题无法写入。

多proto文件场景 #

如果有多个proto文件，只需在outs中补全所有对应的.pyi文件名即可，比如bar.proto对应bar_pb2.pyi和bar_pb2_grpc.pyi，都要添加到outs列表里。

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