Pants v2: Fast, consistent builds for Python and more

Welcome to the Pants v2 documentation hub!

Pants v2 is a fast, scalable build system for growing codebases. It's currently focused on Python, with support for other languages coming soon.

Here you'll find guides to help you get started with Pants v2, comprehensive documentation on how to configure, run and customize Pants v2, and information on how to get help from the Pants community.

Get Started

python-infer

Options controlling which dependencies will be inferred for Python targets.

Config section: [python-infer]

Basic options

--[no-]python-infer-imports
PANTS_PYTHON_INFER_IMPORTS
imports
default: True
Infer a target's imported dependencies by parsing import statements from sources.

--[no-]python-infer-string-imports
PANTS_PYTHON_INFER_STRING_IMPORTS
string_imports
default: False
Infer a target's dependencies based on strings that look like dynamic dependencies, such as Django settings files expressing dependencies as strings. To ignore any false positives, put `!{bad_address}` in the `dependencies` field of your target.

--[no-]python-infer-inits
PANTS_PYTHON_INFER_INITS
inits
default: False
Infer a target's dependencies on any __init__.py files existing for the packages it is located in (recursively upward in the directory structure). Even if this is disabled, Pants will still include any ancestor __init__.py files, only they will not be 'proper' dependencies, e.g. they will not show up in `./pants dependencies` and their own dependencies will not be used. If you have empty `__init__.py` files, it's safe to leave this option off; otherwise, you should enable this option.

--[no-]python-infer-conftests
PANTS_PYTHON_INFER_CONFTESTS
conftests
default: True
Infer a test target's dependencies on any conftest.py files in parent directories.

Advanced options

None

Deprecated options

None

Updated about a month ago


python-infer


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.