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

Tell Pants to detect what files and targets have changed from Git.

Config section: [changed]

Basic options

--changed-since=<str>
PANTS_CHANGED_SINCE
since
default: None
Calculate changes since this Git spec (commit range/SHA/ref).

--changed-diffspec=<str>
PANTS_CHANGED_DIFFSPEC
diffspec
default: None
Calculate changes contained within a given Git spec (commit range/SHA/ref).

--changed-dependees=<DependeesOption>
PANTS_CHANGED_DEPENDEES
dependees
one of: none, direct, transitive
default: none
Include direct or transitive dependees of changed targets.

Advanced options

None

Deprecated options

--changed-changes-since=<str>, --changed-parent=<str>
PANTS_CHANGED_CHANGES_SINCE
changes_since
default: None
Deprecated, will be removed in version: 2.1.0.dev0.
Use `--changed-since` instead of `--changed-parent` or `--changed-changes-since`.
Calculate changes since this tree-ish/scm ref.

--changed-include-dependees=<DependeesOption>
PANTS_CHANGED_INCLUDE_DEPENDEES
include_dependees
one of: none, direct, transitive
default: none
Deprecated, will be removed in version: 2.1.0.dev0.
Use `--changed-dependees` instead of `--changed-include-dependees`.
Include direct or transitive dependees of changed targets.

--[no-]changed-fast
PANTS_CHANGED_FAST
fast
default: False
Deprecated, will be removed in version: 2.1.0.dev0.
The option `--changed-fast` no longer does anything.
Stop searching for owners once a source is mapped to at least one owning target.

Updated about a month ago


changed


Suggested Edits are limited on API Reference Pages

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