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
requiredThe 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.
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.
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.