包含 py_runtime
规则返回的 Python 运行时相关信息。
Python 运行时描述的是平台运行时或 build 内运行时。平台运行时会访问已知路径中的系统安装的解释器,而内置运行时会指向用作解释器的 File
。在这两种情况下,“解释器”实际上是指任何能够运行通过命令行传递的 Python 脚本的可执行二进制文件或封装容器脚本,遵循与标准 CPython 解释器相同的惯例。
成员
- PyRuntimeInfo
- bootstrap_template
- coverage_files
- coverage_tool
- 文件
- interpreter
- interpreter_path
- python_version
- stub_shebang
PyRuntimeInfo
PyRuntimeInfo PyRuntimeInfo(interpreter_path=None, interpreter=None, files=None, coverage_tool=None, coverage_files=None, python_version, stub_shebang=None, bootstrap_template=None)
PyRuntimeInfo
构造函数。
参数
参数 | 说明 |
---|---|
interpreter_path
|
字符串;或 None ;
默认为 None 新对象的 interpreter_path 字段的值。如果您传入 interpreter ,请勿为此参数提供值。
|
interpreter
|
文件;或 None ;
默认为 None 新对象的 interpreter 字段的值。如果您传入 interpreter_path ,请勿为此参数提供值。
|
files
|
文件的 depset;或 None ;
默认为 None 新对象的 files 字段的值。如果您传入 interpreter_path ,请勿为此参数指定值。如果指定了 interpreter ,并且此参数为 None ,则 files 会改为空的 depset 。
|
coverage_tool
|
文件;或 None ;
默认值为 None 新对象的 coverage_tool 字段的值。
|
coverage_files
|
文件的 depset;或 None ;
默认为 None 新对象的 coverage_files 字段的值。如果您未同时传入 coverage_tool ,请勿为此参数指定值。
|
python_version
|
字符串;
必需 新对象的 python_version 字段的值。
|
stub_shebang
|
字符串;
默认值为 None 新对象的 stub_shebang 字段的值。如果为“None”或未指定,则使用 #!/usr/bin/env python3 。
|
bootstrap_template
|
文件;或 None ;
默认值为 None |
bootstrap_template
File PyRuntimeInfo.bootstrap_template要使用的桩脚本模板文件。应包含 %python_binary%、%workspace_name%、%main% 和 %imports%。如需了解更多变量,请参阅 @bazel_tools//tools/python:python_bootstrap_template.txt。
coverage_files
depset PyRuntimeInfo.coverage_files运行时使用
coverage_tool
所需的文件。如果未提供 coverage_tool
,则为 None
。
可以返回 None
。
coverage_tool
File PyRuntimeInfo.coverage_tool如果已设置,此字段是一个
File
,表示用于从 Python 测试收集代码覆盖率信息的工具。否则,此值为 None
。
可以返回 None
。
文件
depset PyRuntimeInfo.files如果这是 build 中的运行时,此字段是需要添加到使用此运行时的可执行目标的 runfile 中的
File
的 depset
(尤其是 interpreter
所需的文件)。无需在此字段中包含 interpreter
的值。如果这是平台运行时,则此字段为 None
。
可以返回 None
。
解释器
File PyRuntimeInfo.interpreter如果这是 build 中的运行时,此字段是一个表示解释器的
File
。否则,此值为 None
。请注意,内置运行时可以使用已提交的预构建解释器,也可以使用从源代码构建的解释器。
可以返回 None
。
interpreter_path
string PyRuntimeInfo.interpreter_path如果这是平台运行时,此字段是目标平台上解释器的绝对文件系统路径。否则,此值为
None
。
可以返回 None
。
python_version
string PyRuntimeInfo.python_version指示此运行时使用的是 Python 主要版本 2 还是 3。有效值仅为
"PY2"
和 "PY3"
。
stub_shebang
string PyRuntimeInfo.stub_shebang附加到引导加载程序 Python 桩脚本的“shebang”表达式,用于执行
py_binary
目标。不适用于 Windows。