.plzconfig

[Please]
Version = >=17.25.1

[Build]
hashcheckers = sha256

[Plugin "cc"]
Target = //plugins:cc
LdGarbageCollection = true

DefaultOptCFlags = -std=c99
DefaultOptCFlags = -Os
DefaultOptCFlags = -DNDEBUG
DefaultOptCFlags = -Wall
DefaultOptCFlags = -Wextra
DefaultOptCFlags = -Werror
DefaultOptCFlags = -flto
DefaultOptCFlags = -D_LARGEFILE64_SOURCE
DefaultOptCFlags = -D_FILE_OFFSET_BITS=64

DefaultDbgCFlags = -std=c99
DefaultDbgCFlags = -g3
DefaultDbgCFlags = -DDEBUG
DefaultDbgCFlags = -Wall
DefaultDbgCFlags = -Wextra
DefaultDbgCFlags = -Werror
DefaultDbgCFlags = -D_LARGEFILE64_SOURCE
DefaultDbgCFlags = -D_FILE_OFFSET_BITS=64

[Plugin "go"]
Target = //plugins:go
ImportPath = github.com/please-build/python-rules
gotool = //third_party/go:toolchain|go
Stdlib = //third_party/go:std

[Plugin "python"]
DisableVendorFlags = true

[Plugin "shell"]
Target = //plugins:shell

[Plugin "e2e"]
Target = //plugins:e2e
PleaseVersion = 17.25.1
DefaultPlugin = //test:python-rules

[PluginDefinition]
name = python

[PluginConfig "default_interpreter"]
ConfigKey = DefaultInterpreter
DefaultValue = python3
Inherit = true
Help = The default Python interpreter to use when building .pex files.

[PluginConfig "default_runtime_interpreters"]
ConfigKey = DefaultRuntimeInterpreters
Optional = true
Repeatable = true
Inherit = true
Help = A list of possible paths to Python interpreters with which to run .pex files.

[PluginConfig "default_runtime_interpreter_args"]
ConfigKey = DefaultRuntimeInterpreterArgs
Optional = true
Repeatable = true
Inherit = true
Help = A list of additional arguments to pass to the Python interpreter when running .pex files.

[PluginConfig "pex_tool"]
ConfigKey = PexTool
DefaultValue = //tools:please_pex
Inherit = true
Help = A path or build label for the pex tool, which is used to create .pex files from python sources

[PluginConfig "test_runner"]
ConfigKey = TestRunner
DefaultValue = unittest
Help = The test runner to use e.g. unittest or pytest

[PluginConfig "testrunner_deps"]
ConfigKey = TestrunnerDeps
DefaultValue = //third_party/python:unittest_bootstrap
Help = A label for a build target containting the dependencies of the test runner

[PluginConfig "test_runner_bootstrap"]
ConfigKey = TestrunnerBootstrap
DefaultValue = ""

[PluginConfig "debugger"]
ConfigKey = Debugger
DefaultValue = pdb
Inherit = true
Help = The debugger to use when debugging python binaries

[PluginConfig "module_dir"]
ConfigKey = ModuleDir
DefaultValue = third_party.python
Help = The path to the third party python directory, in python import path format e.g. third_party.py3 for //third_party/py3

[PluginConfig "pip_tool"]
ConfigKey = PipTool
DefaultValue = ""
Optional = true
Inherit = true
Help = The tool to use for pip. Defaults to using python -m pip

[PluginConfig "default_pip_repo"]
ConfigKey = DefaultPipRepo
DefaultValue = ""
Optional = true
Help = The default repository to look for pip dependencies in

[PluginConfig "use_pypi"]
ConfigKey = UsePypi
DefaultValue = true
Type = bool
Help = Whether to use PyPi as a repository for python_wheel

[PluginConfig "pip_flags"]
ConfigKey = PipFlags
DefaultValue = ""
Optional = true
Help = Any additional flags to pass to pip

[PluginConfig "disable_vendor_flags"]
ConfigKey = DisableVendorFlags
DefaultValue = false
Inherit = true
Type = bool
Help = Disables any vendor specific flags e.g. the --system flag passed to debians fork of pip

[PluginConfig "pip_compile_flags"]
ConfigKey = PipCompileFlags
DefaultValue = ""
Optional = true
Inherit = true
Help = Flags to pass to pip when compiling

[PluginConfig "wheel_repo"]
ConfigKey = WheelRepo
Optional = true
Help = The root URL for the wheel repo

[PluginConfig "wheel_name_scheme"]
ConfigKey = WheelNameScheme
Optional = true
Repeatable = true
Help = A format string for the wheel repo URL. Format fields url_base, package_name, initial, and version. Initial is the first character of the package name.

[PluginConfig "wheel_tool"]
ConfigKey = WheelTool
Optional = true
Inherit = true
Help = The tool used to resolve wheels with using the pypi API.

[PluginConfig "wheel_dist_info"]
ConfigKey = WheelDistInfo
Type = bool
DefaultValue = false
Optional = true
Inherit = true
Help = Controls whether python_wheel outputs the module's .dist-info directory by default.

[PluginConfig "prereleases"]
DefaultValue = false
Type = bool
Help = Allow prereleased versions in python_wheel targets

[PluginConfig "require_licences"]
DefaultValue = false
Type = bool
Inherit = true
Help = If set, the licences field on pip_library and python_wheel will be mandatory

[PluginConfig "verbosity"]
DefaultValue = "info"
Help = Passes verbosity level to wheel_tool, for example: wheel_tool --verbosity info
Optional = true

[PluginConfig "default_preamble_verbosity"]
ConfigKey = DefaultPreambleVerbosity
DefaultValue = error
Inherit = true
Help = The default logging level for the .pex preamble. Must be one of trace, debug, info, warn, error or fatal.

[PluginConfig "feature_flags"]
DefaultValue = ""
Repeatable = true
Optional = true
Inherit = true
Help = Flags to enable in-development features, or toggle breaking changes