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

Welcome to Pants!

What is Pants?

Pants is a scalable software build system. Pants orchestrates the various tools and steps that process your source code into deployable software: code generation, compilation/type checking, testing, linting, formatting, packaging and more.

Pants is useful for repos of all sizes, but is particularly relevant if you want to scale your codebase without breaking it up into multiple disconnected repos. Pants allows you to have a monorepo: a codebase containing multiple projects—often using multiple programming languages and frameworks—in a single unified repository.

What are the main features of Pants?

Pants is designed for fast, consistent builds. Some noteworthy features include:

  • Dependency modeling with minimal boilerplate.
  • Fine-grained invalidation.
  • Shared result caching.
  • Concurrent execution.
  • Remote execution.
  • Unified interface for multiple tools and languages.
  • Extensibility and customizability via a plugin API.

Which languages and frameworks does Pants support?

Pants currently works with Python code, but support for other languages, including Javascript/Node, Java, Scala and more, is coming soon.

How does Pants work?

See here for details about the Pants engine.

Who develops Pants?

Pants is an open-source software project, developed at Pants is released under the Apache License 2.0.


Pants 1.x vs. 2.x

This documentation is for Pants v2, which is a ground-up redesign of Pants based on lessons from the past 10 years of development. See here for Pants v1 documentation, which includes support for Node, Go, Java, and Scala.

Updated 16 days ago

Welcome to Pants!

Suggested Edits are limited on API Reference Pages

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