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

---

tags

field.type_hint

required

Arbitrary strings to describe a target.

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

description

field.type_hint

required

A human-readable description of the target.

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

binary_name

field.type_hint

required

The name of the binary to find.

extra_search_paths

field.type_hint

default: ()

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

fingerprint

field.type_hint

required

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

fingerprint_args

field.type_hint

default: ()

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

fingerprint_dependencies

field.type_hint

required

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.