Skip to main content
Version: 2.23 (prerelease)

system_binary


A system binary that can be run with pants run or consumed by adhoc_tool.

Pants will search for binaries with name binary_name in the search paths provided, as well as default search paths. If fingerprint is specified, each binary that is located will be executed with the arguments from fingerprint_args. Any binaries whose output does not match the pattern will be excluded.

The first non-excluded binary will be the one that is resolved.

Backend: pants.backend.experimental.adhoc


binary_name

str
required

The name of the binary to find.

description

str | None
default: None

A human-readable description of the target.

Use pants list --documented :: to see all targets with descriptions.

extra_search_paths

Iterable[str] | None
default: ()

Extra search paths to look for the binary. These take priority over Pants' default search paths.

fingerprint

str | None
default: None

A regular expression which will be used to match the fingerprint outputs from candidate binaries found during the search process.

fingerprint_args

Iterable[str] | None
default: ()

Specifies arguments that will be used to run the binary during the search process.

fingerprint_dependencies

Iterable[str] | None
default: None

Specifies any runnable dependencies that need to be available on the PATH when the binary is run, so that the search process may complete successfully. The name of the target must be the name of the runnable dependency that is called by this binary.

tags

Iterable[str] | None
default: None

Arbitrary strings to describe a target.

For example, you may tag some test targets with 'integration_test' so that you could run pants --tag='integration_test' test :: to only run on targets with that tag.