PyRuntimeInfo

报告问题 查看源代码 每夜版 · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

包含有关 Python 运行时(由 py_runtime 规则返回)的信息。

Python 运行时描述的是平台运行时还是内置运行时。平台运行时会访问已知路径中的系统安装的解释器,而内置运行时会指向充当解释器的 File。在这两种情况下,“解释器”实际上是指任何能够运行通过命令行传递的 Python 脚本的可执行二进制文件或封装脚本,并且遵循与标准 CPython 解释器相同的惯例。

成员

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 File 的 depset;或 None; 默认值为 None
新对象的 files 字段的值。如果您传入 interpreter_path,请勿为此实参提供值。如果指定了 interpreter,且此实参为 None,则 files 会改为成为空的 depset
coverage_tool 文件;或 None; 默认值为 None
新对象的 coverage_tool 字段的值。
coverage_files File 的 depset;或 None; 默认值为 None
新对象的 coverage_files 字段的值。如果您未同时传入 coverage_tool,请勿为此实参提供值。
python_version 必需
新对象的 python_version 字段的值。
stub_shebang string; default is 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 内运行时,则此字段是需要添加到使用此运行时的可执行目标文件的 runfiles 中的 Filedepset(尤其是 interpreter 所需的文件)。interpreter 的值无需包含在此字段中。如果这是平台运行时,则此字段为 None。 可能会返回 None

翻译

File PyRuntimeInfo.interpreter

如果这是内置运行时,则此字段是表示解释器的 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

在执行 py_binary 目标时,附加到引导 Python 桩脚本的“Shebang”表达式。不适用于 Windows。