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

Welcome to Pants!

What is Pants?

Pants is a scalable software build system. It is useful for code repositories of all sizes, but is particularly valuable for those containing multiple distinct but interdependent pieces.

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

Pants is in a similar category as tools such as make, ant, maven, gradle, sbt, bazel and others. Its design leans on ideas and inspiration from some of these earlier tools, while optimizing for speed and correctness in today's real-world use cases.

Who is Pants for?

Pants is useful for repos of all sizes, but is particularly valuable for those containing multiple distinct but interdependent pieces. Pants allows you to have a monorepo: a codebase containing multiple projects—often using multiple programming languages and frameworks—in a single unified repository. If you want to scale your codebase without breaking it up into multiple disconnected repos, with all the versioning and maintenance headaches that causes, Pants provides the tooling for you to do so effectively.

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 2 supports Python and shell code. Support for other languages, including Java, Scala, Go, Rust, 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 github.com/pantsbuild/pants. Pants is released under the Apache License 2.0.

📘

Pants 1.x vs. 2.x

This documentation is for Pants 2.0, 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 4 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.