Pants v2: The ergonomic build system

Welcome to the Pants v2 documentation hub!

Pants v2 is a fast, scalable, user-friendly 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 for details.
  • Adds support for pants.toml as an improvement on the now legacy pants.ini format. See!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 10 months ago


Suggested Edits are limited on API Reference Pages

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