Información de PyRuntime

Contiene información sobre un entorno de ejecución de Python, como lo muestra la regla py_runtime.

Un entorno de ejecución de Python describe un entorno de ejecución de plataforma o un entorno de ejecución integrado. Un entorno de ejecución de plataforma accede a un intérprete instalado en el sistema en una ruta de acceso conocida, mientras que un entorno de ejecución integrado apunta a un File que actúa como intérprete. En ambos casos, un "intérprete" es realmente cualquier objeto binario ejecutable o secuencia de comandos de wrapper que sea capaz de ejecutar una secuencia de comandos de Python que se pasa en la línea de comandos, siguiendo las mismas convenciones que el intérprete estándar de CPython.

Miembros

PyRuntimeInfo

PyRuntimeInfo PyRuntimeInfo(interpreter_path=None, interpreter=None, files=None, coverage_tool=None, coverage_files=None, python_version, stub_shebang=None, bootstrap_template=None)

El constructor PyRuntimeInfo.

Parámetros

Parámetro Descripción
interpreter_path cadena; o None; el valor predeterminado es None
El valor del campo interpreter_path del objeto nuevo. No le des un valor a este argumento si pasas interpreter.
interpreter Archivo; o None; el valor predeterminado es None
El valor del campo interpreter del objeto nuevo. No le des un valor a este argumento si pasas interpreter_path.
files depset de archivos; o None; el valor predeterminado es None
El valor del campo files del objeto nuevo. No le des un valor a este argumento si pasas interpreter_path. Si se proporciona interpreter y este argumento es None, files se convierte en un depset vacío.
coverage_tool Archivo; o None; el valor predeterminado es None
El valor del campo coverage_tool del objeto nuevo.
coverage_files depset de Files; o None; el valor predeterminado es None
El valor del campo coverage_files del objeto nuevo. No le des un valor a este argumento si tampoco pasas coverage_tool.
python_version obligatorio
El valor del campo python_version del objeto nuevo.
stub_shebang cadena; el valor predeterminado es None
El valor del campo stub_shebang del objeto nuevo. Si no se especifica o es None, se usa #!/usr/bin/env python3.
bootstrap_template Archivo; o None; el valor predeterminado es None

bootstrap_template

File PyRuntimeInfo.bootstrap_template

El archivo de plantilla de secuencia de comandos de stub que se usará. Debe tener %python_binary%, %workspace_name%, %main% y %imports%. Consulta @bazel_tools//tools/python:python_bootstrap_template.txt para obtener más variables.

coverage_files

depset PyRuntimeInfo.coverage_files

Los archivos necesarios en el tiempo de ejecución para usar coverage_tool. Será None si no se proporcionó coverage_tool. Puede devolver None.

coverage_tool

File PyRuntimeInfo.coverage_tool

Si se configura, este campo es un File que representa la herramienta que se usa para recopilar información de cobertura de código de las pruebas de Python. De lo contrario, es None. Puede devolver None.

files

depset PyRuntimeInfo.files

Si se trata de un entorno de ejecución integrado, este campo es un depset de Files que deben agregarse a los archivos de ejecución de un destino ejecutable que usa este entorno de ejecución (en particular, los archivos que necesita interpreter). No es necesario incluir el valor de interpreter en este campo. Si se trata de un entorno de ejecución de plataforma, este campo es None. Puede devolver None.

interpreter

File PyRuntimeInfo.interpreter

Si se trata de un entorno de ejecución integrado, este campo es un File que representa el intérprete. De lo contrario, es None. Ten en cuenta que un entorno de ejecución integrado puede usar un intérprete precompilado y registrado o un intérprete compilado a partir de la fuente. Puede devolver None.

interpreter_path

string PyRuntimeInfo.interpreter_path

Si se trata de un entorno de ejecución de plataforma, este campo es la ruta de acceso absoluta del sistema de archivos al intérprete en la plataforma de destino. De lo contrario, es None. Puede devolver None.

python_version

string PyRuntimeInfo.python_version

Indica si este entorno de ejecución usa la versión principal 2 o 3 de Python. Los valores válidos son (solo) "PY2" y "PY3".

stub_shebang

string PyRuntimeInfo.stub_shebang

Expresión "Shebang" antepuesta a la secuencia de comandos de stub de Python de bootstrapping que se usa cuando se ejecutan destinos py_binary. No se aplica a Windows.