PyRuntime 資訊

回報問題 查看原始碼 。 。 。 。 夜間 。 。 。 7.3 7.2 。 。 7.1 7.0 6.5 。 。

包含 py_runtime 規則傳回的 Python 執行階段相關資訊。

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 string;或 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 string; 必要
新物件的 python_version 欄位值。
stub_shebang string; 預設值為 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

如果這是內部執行階段，這個欄位為 File 的 depset，必須新增至使用該執行階段目標的執行檔案 (尤其是 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

「Shebang」運算式前方會加在 Bootstrapping Python 虛設常式指令碼前方，以便執行 py_binary 目標。不適用於 Windows。