Pants is an Apache2 licensed build tool written in Python and Rust.

The latest documentation can be found at pantsbuild.org.

2.17.x Release Series

2.17.0.dev1 (Mar 24, 2023)

New Features

• engine: add an option to clear the destination directory when writing digest to disk (#18534)

• javascript: NodeJS bootstrapping via binary paths, PATH, asdf or nvm (#18520)

• javascript: Initial NPM support (#18326)

• Always provide Python-for-Pants-scripts (#18433)

User API Changes

• Upgrade Pex to 2.1.130. (#18576)

• Deprecate old-style custom tool lockfiles. (#18494)

• Let a user resolve shadow a tool lockfile of the same name (#18481)

Bug fixes

• Ensure that a symlinked exported venv exists and is valid. (#18575)

• Fail fast for attempts to use test --debug with a docker environment (#18560)

• Declare ruff outputs as files. (#18551)

• Add support for Docker registry auth (#18541)

• Fix Poetry req synthesis for URLs with markers. (#18535)

• Re-enable hardlinking using fclonefileat on macOS. (#18501)

Performance

• Materialize "large" files in a new store location and hardlink them in sandboxes (#18153)

• Finish parallelizing materialization of Process inputs (#18469)

Documentation

• First pass at adhoc_tool documentation (#18531)

• Add Tobias Nilsson to team page (#18571)

• docs: fix an f-string in help (#18539)

• Clarify that experimental_ shell functions are deprecated and replaced (#18529)

• Update docs on running pants from sources with scie-pants. (#18513)

• Add ExoFlare to user list. (#18496)

• Fix malformed pantsbuild/example-python link in documentation (#18484)

• update scie-jump cache directory reference (#18485)

• Expand lockfile documentation to its own page. (#18471)

2.17.0.dev0 (Mar 10, 2023)

New Features

• Expose environment information on process metadata (#18458)

• Support running pants from anywhere in the project. (#18412)

User API Changes

• Audit and update requirements for Python tools. (#18431)

• Upgrade Pex to 2.1.128. (#18453)

Bug fixes

• Preserve environment variables in pantsd to allow Docker auth. (#18465)

• Only expose the equiv of from typing import * in prelude files (#18452)

• Support type hints in prelude files. (#18442)

• Synthesized lockfile targets should never err on missing lockfiles. (#18406)

• Fixes to visualisations for xdot (#18421)