规则
py_binary
查看规则来源py_binary(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, exec_compatible_with, exec_properties, features, imports, legacy_create_init, licenses, main, output_licenses, python_version, restricted_to, srcs_version, stamp, tags, target_compatible_with, testonly, toolchains, visibility)
py_binary 是一个可执行的 Python 程序，由一组 .py 源文件（可能属于其他 py_library 规则）、一个包含程序在运行时所需的所有代码和数据的 *.runfiles 目录树，以及一个使用正确的初始环境和数据启动程序的桩脚本组成。
示例
py_binary(
name = "foo",
srcs = ["foo.py"],
data = [":transform"], # a cc_binary which we invoke at run time
deps = [
":foolib", # a py_library
],
)
如果您想从另一个二进制文件或测试中运行 py_binary（例如，从 java_test 中运行 Python 二进制文件来设置一些模拟资源），正确的方法是在另一个二进制文件或测试的数据部分中使之依赖于 py_binary。然后，另一个二进制文件可以找到相对于源目录的 py_binary。
py_binary(
name = "test_main",
srcs = ["test_main.py"],
deps = [":testing"],
)
java_library(
name = "testing",
srcs = glob(["*.java"]),
data = [":test_main"]
)
参数
| 属性 | |
|---|---|
name |
名称；必需 相应目标的唯一名称。 如果未指定 main，则此值应与作为应用主要入口点的源文件的名称相同，但不包含扩展名。例如，如果您的入口点名为 main.py，则您的名称应为 main。
|
deps
|
标签列表；默认值为 deps 的一般注释。
这些规则通常为 py_library 规则。
|
srcs
|
标签列表；必需 用于创建目标的源 (.py) 文件列表。
这包括您签入的所有代码和所有生成的源文件。库目标应放在 deps 中，而运行时需要的其他二进制文件应放在 data 中。
|
imports
|
字符串列表；默认值为 PYTHONPATH 的导入目录列表。
需进行“创建变量”替换。这些导入目录将添加到相应规则以及依赖于该规则的所有规则（注意：不包括该规则所依赖的规则）。每个目录都将通过依赖于此规则的
不允许使用绝对路径（以 |
legacy_create_init
|
整数；默认值为 --incompatible_default_to_explicit_init_py。如果为 false，用户负责创建（可能为空）__init__.py 文件，并根据需要将其添加到 Python 目标的 srcs 中。
|
main
|
标签；默认值为 srcs 中列出。如果未指定，则系统会改用 name（见上文）。如果 name 与 srcs 中的任何文件名都不匹配，则必须指定 main。
|
python_version
|
字符串；不可配置；默认值为 deps）。有效值为 "PY2" 和 "PY3"（默认值）。
无论命令行上指定的版本或依赖于此目标的其他更高级别目标指定的版本是什么，Python 版本始终会重置（可能默认）为此属性指定的版本。 如果您想针对当前 Python 版本进行 bug 警告：此属性用于设置 Bazel 构建目标时所用的版本，但由于 #4815，生成的桩脚本在运行时可能仍会调用错误的解释器版本。请参阅此问题解决办法，其中涉及定义一个 |
srcs_version
|
字符串；默认值为 srcs 与 Python 2、Python 3 或两者都兼容。如需实际设置 Python 运行时版本，请使用可执行 Python 规则（py_binary 或 py_test）的 python_version 属性。
允许的值包括： 请注意，只有可执行规则（ 如需获取有关哪些依赖项引入了版本要求的诊断信息，您可以在目标上运行
bazel build <your target> \
--aspects=@rules_python//python:defs.bzl%find_requirements \
--output_groups=pyversioninfo
-pyversioninfo.txt 后缀的文件，其中包含有关目标需要某个 Python 版本而非另一个版本的原因的信息。请注意，即使由于版本冲突导致指定目标构建失败，此方法也能正常运行。
|
stamp
|
整数；默认值为
除非已加戳记的二进制文件发生依赖项更改，否则不会重新构建。 |
py_library
查看规则来源py_library(name, deps, srcs, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, imports, licenses, restricted_to, srcs_version, tags, target_compatible_with, testonly, visibility)
参数
| 属性 | |
|---|---|
name |
名称；必需 相应目标的唯一名称。 |
deps
|
标签列表；默认值为 deps 的一般注释。
这些规则通常为 py_library 规则。
|
srcs
|
标签列表；默认值为 .py) 文件列表。
这包括您签入的所有代码和所有生成的源文件。
|
imports
|
字符串列表；默认值为 PYTHONPATH 的导入目录列表。
需进行“创建变量”替换。这些导入目录将添加到相应规则以及依赖于该规则的所有规则（注意：不包括该规则所依赖的规则）。每个目录都将通过依赖于此规则的
不允许使用绝对路径（以 |
srcs_version
|
字符串；默认值为 srcs 与 Python 2、Python 3 或两者都兼容。如需实际设置 Python 运行时版本，请使用可执行 Python 规则（py_binary 或 py_test）的 python_version 属性。
允许的值包括： 请注意，只有可执行规则（ 如需获取有关哪些依赖项引入了版本要求的诊断信息，您可以在目标上运行
bazel build <your target> \
--aspects=@rules_python//python:defs.bzl%find_requirements \
--output_groups=pyversioninfo
-pyversioninfo.txt 后缀的文件，其中包含有关目标需要某个 Python 版本而非另一个版本的原因的信息。请注意，即使由于版本冲突导致指定目标构建失败，此方法也能正常运行。
|
py_test
查看规则来源py_test(name, deps, srcs, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, imports, legacy_create_init, licenses, local, main, python_version, restricted_to, shard_count, size, srcs_version, stamp, tags, target_compatible_with, testonly, timeout, toolchains, visibility)
py_test() 规则用于编译测试。测试是围绕某些测试代码的二进制封装容器。
示例
py_test(
name = "runtest_test",
srcs = ["runtest_test.py"],
deps = [
"//path/to/a/py/library",
],
)
您还可以指定主模块：
py_test(
name = "runtest_test",
srcs = [
"runtest_main.py",
"runtest_lib.py",
],
main = "runtest_main.py",
)
参数
| 属性 | |
|---|---|
name |
名称；必需 相应目标的唯一名称。 |
deps
|
标签列表；默认值为 deps 的一般注释。
这些规则通常为 py_library 规则。
|
srcs
|
标签列表；必需 用于创建目标的源 (.py) 文件列表。
这包括您签入的所有代码和所有生成的源文件。库目标应放在 deps 中，而运行时需要的其他二进制文件应放在 data 中。
|
imports
|
字符串列表；默认值为 PYTHONPATH 的导入目录列表。
需进行“创建变量”替换。这些导入目录将添加到相应规则以及依赖于该规则的所有规则（注意：不包括该规则所依赖的规则）。每个目录都将通过依赖于此规则的
不允许使用绝对路径（以 |
legacy_create_init
|
整数；默认值为 --incompatible_default_to_explicit_init_py。如果为 false，用户负责创建（可能为空）__init__.py 文件，并根据需要将其添加到 Python 目标的 srcs 中。
|
main
|
标签；默认值为 srcs 中列出。如果未指定，则系统会改用 name（见上文）。如果 name 与 srcs 中的任何文件名都不匹配，则必须指定 main。
|
python_version
|
字符串；不可配置；默认值为 deps）。有效值为 "PY2" 和 "PY3"（默认值）。
无论命令行上指定的版本或依赖于此目标的其他更高级别目标指定的版本是什么，Python 版本始终会重置（可能默认）为此属性指定的版本。 如果您想针对当前 Python 版本进行 bug 警告：此属性用于设置 Bazel 构建目标时所用的版本，但由于 #4815，生成的桩脚本在运行时可能仍会调用错误的解释器版本。请参阅此问题解决办法，其中涉及定义一个 |
srcs_version
|
字符串；默认值为 srcs 与 Python 2、Python 3 或两者都兼容。如需实际设置 Python 运行时版本，请使用可执行 Python 规则（py_binary 或 py_test）的 python_version 属性。
允许的值包括： 请注意，只有可执行规则（ 如需获取有关哪些依赖项引入了版本要求的诊断信息，您可以在目标上运行
bazel build <your target> \
--aspects=@rules_python//python:defs.bzl%find_requirements \
--output_groups=pyversioninfo
-pyversioninfo.txt 后缀的文件，其中包含有关目标需要某个 Python 版本而非另一个版本的原因的信息。请注意，即使由于版本冲突导致指定目标构建失败，此方法也能正常运行。
|
stamp
|
整数；默认值为 |
py_runtime
查看规则来源py_runtime(name, bootstrap_template, compatible_with, coverage_tool, deprecation, distribs, features, files, interpreter, interpreter_path, licenses, python_version, restricted_to, stub_shebang, tags, target_compatible_with, testonly, visibility)
表示用于执行 Python 代码的 Python 运行时。
py_runtime 目标可以表示平台运行时或内置运行时。平台运行时会访问已知路径中的系统安装的解释器，而 build 内运行时会指向充当解释器的可执行目标。在这两种情况下，“解释器”是指能够运行通过命令行传递的 Python 脚本的任何可执行二进制文件或封装脚本，并且遵循与标准 CPython 解释器相同的惯例。
平台运行时本质上是非封闭的。它要求目标平台在特定路径中具有解释器。内置运行时可能具有密封性，也可能不具有密封性，具体取决于它是指向已签入的解释器还是指向访问系统解释器的封装脚本。
示例：
py_runtime(
name = "python-2.7.12",
files = glob(["python-2.7.12/**"]),
interpreter = "python-2.7.12/bin/python",
)
py_runtime(
name = "python-3.6.0",
interpreter_path = "/opt/pyenv/versions/3.6.0/bin/python",
)
参数
| 属性 | |
|---|---|
name |
名称；必需 相应目标的唯一名称。 |
bootstrap_template
|
标签；默认值为 |
coverage_tool
|
标签；默认值为 py_binary 和 py_test 目标收集代码覆盖率信息的目标。
如果设置了该属性，目标必须生成单个文件或为可执行目标。 单个文件的路径（如果目标是可执行文件，则为可执行文件的路径）决定了 Python 代码覆盖率工具的入口点。启用覆盖率时，目标及其 runfiles 将添加到 runfiles 中。 该工具的入口点必须可由 Python 解释器加载（例如 |
files
|
标签列表；默认值为 |
interpreter
|
标签；默认值为 |
interpreter_path
|
字符串；默认值为 |
python_version
|
字符串；默认值为 "PY2" 和 "PY3"。
默认值由 |
stub_shebang
|
字符串；默认值为 py_binary 目标时，附加到引导 Python 脚本的“Shebang”表达式。
如需了解原因，请参阅问题 8685。 不适用于 Windows。 |