Правила
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)
A 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 из другой двоичной программы или теста (например, запустить двоичный файл python для настройки некоторых имитируемых ресурсов внутри java_test), то правильный подход — сделать эту другую двоичную программу или тест зависимым от py_binary в его разделе данных. Затем другая двоичная программа сможет найти py_binary относительно каталога исходных кодов.
py_binary(
name = "test_main",
srcs = ["test_main.py"],
deps = [":testlib"],
)
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. Подлежит замене в соответствии с "Переменными Make". Эти каталоги импорта будут добавлены для данного правила и для всех правил, которые зависят от него (прим.: не для правил, от которых зависит это правило. Каждый каталог будет добавлен к Абсолютные пути (пути, начинающиеся с |
legacy_create_init |
--incompatible_default_to_explicit_init_py. Если false, пользователь отвечает за создание (возможно, пустых) файлов __init__.py и добавление их в srcs целевых файлов Python по мере необходимости. |
main |
srcs. Если не указано, используется name (см. выше). Если name не соответствует имени файла в srcs, необходимо указать main. |
python_version |
deps) для Python 2 или Python 3. Допустимые значения — "PY2" и "PY3" (по умолчанию). Версия Python всегда сбрасывается (возможно, по умолчанию) на ту версию, которая указана в этом атрибуте, независимо от версии, указанной в командной строке или другими вышестоящими целевыми файлами, зависящими от этого. Если вы хотите Предупреждение об ошибке: Этот атрибут устанавливает версию, для которой Bazel создаёт ваш целевой файл, но из-за #4815 результирующий скрипт-заглушка может по-прежнему вызывать интерпретатор с неправильной версией во время выполнения. См. этот обходной путь, который предполагает определение целевого файла |
srcs_version |
python_version правила исполняемого файла Python (py_binary или py_test). Допустимые значения: Обратите внимание, что только правила исполняемых файлов ( Для получения диагностической информации о том, какие зависимости вводят требования к версии, можно запустить аспект
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)
