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:

  • Added support for generating Python from Protocol Buffers (Protobuf). See Protobuf.
  • Added the junit_xml_dir option to the [pytest] scope to allow saving JUnit XML test results. See test.
  • Allow defining macros though a new "preludes" mechanism. See Macros.
  • Simplified how source roots are declared. See Source roots.
  • Added the dependees goal. See Project introspection.
  • UI enhancements, including:
    • Improved the interactive UI to not take over the screen and to work when piping to other programs.
    • Improved output for fmt and lint to explain which tools ran.
    • Improved output for test to be less chatty.

See here for a detailed change log.

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