Skip to main content
Version: 2.25 (dev)

run

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
pants.toml
[run]
args = [
    <shell_str>,
    <shell_str>,
    ...,
]
default: []

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

debug_adapter​

--[no-]run-debug-adapter
PANTS_RUN_DEBUG_ADAPTER
pants.toml
[run]
debug_adapter = <bool>
default: False

Run the interactive process using a Debug Adapter (https://microsoft.github.io/debug-adapter-protocol/) for the language if supported.

The interactive process used will be immediately blocked waiting for a client before continuing.

Advanced options​

None

Deprecated options​

None