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

Some highlights:

  • Pants now uses Pex 2.1, which uses Pip instead of its own custom resolver. See https://github.com/pantsbuild/pex/pull/788 for details.
  • Adds support for pants.toml as an improvement on the now legacy pants.ini format. See https://groups.google.com/forum/#!topic/pants-devel/N1H03oJONco for details.
  • Adds support for Python lockfiles.
  • Adds the Pylint linter.
  • Adds IPython support to ./pants repl.
  • Adds support for getting coverage data with ./pants test.
  • When using file arguments with ./.pants test, fmt, or lint, Pants now runs over only the files specified, rather than all files belonging to the owning target.
  • Changes ./pants fmt and ./pants lint to batch targets together for better performance, at the cost of less fine-grained caching. This can be disabled with --fmt-per-target-caching and --lint-per-target-caching.

See here for a detailed change log.

Updated 4 months ago


1.26.x


Suggested Edits are limited on API Reference Pages

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