Hey! These docs are for version 2.10, which is no longer officially supported. Click here for the latest version, 2.14!
./pants run [args]

Runs a binary target.

This goal propagates the return code of the underlying executable.

If your application can safely be restarted while it is running, you can pass restartable=True on your binary target (for supported types), and the run goal will automatically restart them as all relevant files change. This can be particularly useful for server applications.

Backend: pants.core
Config section: [run]

Basic options

args

--run-args="[<shell_str>, <shell_str>, ...]", ... -- [<shell_str> [<shell_str> [...]]]
PANTS_RUN_ARGS
default: []

Arguments to pass directly to the executed target, e.g. --run-args="val1 val2 --debug"


cleanup

--[no-]run-cleanup
PANTS_RUN_CLEANUP
default: True

Whether to clean up the temporary directory in which the binary is chrooted. Set to false to retain the directory, e.g., for debugging.


Advanced options

None

Deprecated options

None