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

This release requires having a Python 3.7 or 3.8 interpreter to run Pants. Run curl -L -o ./pants to update your ./pants script to choose the correct interpreter.

Some highlights:

  • Added dependency inference for Python imports of Protobuf, along with Protobuf imports of Protobuf. See Protobuf and gRPC.
  • Pantsd will no longer restart when a run of Pants is killed (such as with Ctrl+C): instead, the serverside work will be canceled. This improves performance by keeping your builds warm for longer periods.
  • Pants uses PEX 2.1.24, which enables using the new PIP resolver by setting [python-setup] resolver_version: pip-2020-resolver. This is expected to be the only stable release of Pants that supports both resolvers without a deprecation, so give it a whirl soon!
  • The sources field is deprecated for pex_binary and python_awslambda targets to ease dependency inference, and improve consistency. See the change for more info!

See here for a detailed change log.

Updated 4 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.