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 opt-in anonymous telemetry, to provide the Pants maintainers with data to help drive development decisions.
  • Added a warning when an inferred dependency is skipped due to ambiguity, and allowed ambiguity to be resolved by explicitly including or excluding (with !) dependency choices.
  • Enabled use of pytest-html, and other Pytest plugins that write output to files.
  • Added support for Pytest config files (e.g. pytest.ini). See test.
  • Added a --stats-log option for insights on cache behavior at the end of the run, such as the # of cache hits.
  • Added a default module_mapping for Python 3rdparty dependency inference.
  • Fixed an issue that would prevent code-generated sources from having valid source roots.

See here for a detailed change log.

Updated about a month ago


Suggested Edits are limited on API Reference Pages

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