Version: 2.3 (deprecated)

Global options

Options to control the overall behavior of Pants.

Backend: ``

Config section: [GLOBAL]

Basic options

`colors`

--[no-]colors
PANTS_COLORS

pants.toml
[GLOBAL]
colors = <bool>

default: False

Whether Pants should use colors in output or not. This may also impact whether some tools Pants run use color.

`dynamic_ui`

--[no-]dynamic-ui
PANTS_DYNAMIC_UI

pants.toml
[GLOBAL]
dynamic_ui = <bool>

default: True

Display a dynamically-updating console UI as Pants runs. This is true by default if Pants detects a TTY and there is no 'CI' environment variable indicating that Pants is running in a continuous integration environment.

`exclude_target_regexp`

--exclude-target-regexp="[<regexp>, <regexp>, ...]"
PANTS_EXCLUDE_TARGET_REGEXP

pants.toml
[GLOBAL]
exclude_target_regexp = [
  <regexp>,
  <regexp>,
  ...,
]

default: []

Exclude targets that match these regexes. This does not impact file arguments.

`level`

-l=<LogLevel>, --level=<LogLevel>
PANTS_LEVEL

pants.toml
[GLOBAL]
level = <LogLevel>

one of: trace, debug, info, warn, error
default: info

Set the logging level.

`loop`

--[no-]loop
PANTS_LOOP

pants.toml
[GLOBAL]
loop = <bool>

default: False

Run goals continuously as file changes are detected. Alpha feature.

`spec_files`

--spec-files="['<str>', '<str>', ...]"
PANTS_SPEC_FILES

pants.toml
[GLOBAL]
spec_files = [
  '<str>',
  '<str>',
  ...,
]

default: []

Read additional specs (target addresses, files, and/or globs), one per line,from these files.

`tag`

--tag="[[+-]tag1,tag2,..., [+-]tag1,tag2,..., ...]"
PANTS_TAG

pants.toml
[GLOBAL]
tag = [
  [+-]tag1,tag2,...,
  [+-]tag1,tag2,...,
  ...,
]

default: []

Include only targets with these tags (optional '+' prefix) or without these tags ('-' prefix). See https://www.pantsbuild.org/v2.3/docs/advanced-target-selection.

Advanced options

`backend_packages`

--backend-packages="['<str>', '<str>', ...]"
PANTS_BACKEND_PACKAGES

pants.toml
[GLOBAL]
backend_packages = [
  '<str>',
  '<str>',
  ...,
]

default: []

The backend packages must be present on the PYTHONPATH, typically because they are in the Pants core dist, in a plugin dist, or available as sources in the repo.

`build_file_prelude_globs`

--build-file-prelude-globs="['<str>', '<str>', ...]"
PANTS_BUILD_FILE_PRELUDE_GLOBS

pants.toml
[GLOBAL]
build_file_prelude_globs = [
  '<str>',
  '<str>',
  ...,
]

default: []

Python files to evaluate and whose symbols should be exposed to all BUILD files. See https://www.pantsbuild.org/v2.3/docs/macros.

`build_ignore`

--build-ignore="['<str>', '<str>', ...]"
PANTS_BUILD_IGNORE

pants.toml
[GLOBAL]
build_ignore = [
  '<str>',
  '<str>',
  ...,
]

default: []

Paths to ignore when identifying BUILD files. This does not affect any other filesystem operations; use --pants-ignore for that instead. Patterns use the gitignore pattern syntax (https://git-scm.com/docs/gitignore).

`build_patterns`

--build-patterns="['<str>', '<str>', ...]"
PANTS_BUILD_PATTERNS

pants.toml
[GLOBAL]
build_patterns = [
  '<str>',
  '<str>',
  ...,
]

default:

[
  "BUILD",
  "BUILD.*"
]

The naming scheme for BUILD files, i.e. where you define targets. This only sets the naming scheme, not the directory paths to look for. To add ignorepatterns, use the option --build-ignore.

`ca_certs_path`

--ca-certs-path=<str>
PANTS_CA_CERTS_PATH

pants.toml
[GLOBAL]
ca_certs_path = <str>

default: None

Path to a file containing PEM-format CA certificates used for verifying secure connections when downloading files required by a build.

`concurrent`

--[no-]concurrent
PANTS_CONCURRENT

pants.toml
[GLOBAL]
concurrent = <bool>

default: False

Enable concurrent runs of Pants. Without this enabled, Pants will start up all concurrent invocations (e.g. in other terminals) without pantsd. Enabling this option requires parallel Pants invocations to block on the first

`files_not_found_behavior`

--files-not-found-behavior=<FilesNotFoundBehavior>
PANTS_FILES_NOT_FOUND_BEHAVIOR

pants.toml
[GLOBAL]
files_not_found_behavior = <FilesNotFoundBehavior>

one of: warn, error
default: warn

What to do when files and globs specified in BUILD files, such as in the sources field, cannot be found. This happens when the files do not exist on your machine or when they are ignored by the --pants-ignore option.

`ignore_pants_warnings`

--ignore-pants-warnings="['<str>', '<str>', ...]"
PANTS_IGNORE_PANTS_WARNINGS

pants.toml
[GLOBAL]
ignore_pants_warnings = [
  '<str>',
  '<str>',
  ...,
]

default: []

Regexps matching warning strings to ignore, e.g. ["DEPRECATED: the option --my-opt will be removed"]. The regex patterns will be matched from the start of the warning string, and are case-insensitive.

`local_execution_root_dir`

--local-execution-root-dir=<str>
PANTS_LOCAL_EXECUTION_ROOT_DIR

pants.toml
[GLOBAL]
local_execution_root_dir = <str>

default: /tmp

Directory to use for local process execution sandboxing. The path may be absolute or relative. If the directory is within the build root, be sure to include it in --pants-ignore.

`local_store_dir`

--local-store-dir=<str>
PANTS_LOCAL_STORE_DIR

pants.toml
[GLOBAL]
local_store_dir = <str>

default: $XDG_CACHE_HOME/pants/lmdb_store

Directory to use for the local file store, which stores the results of subprocesses run by Pants. The path may be absolute or relative. If the directory is within the build root, be sure to include it in --pants-ignore.

`log_levels_by_target`

--log-levels-by-target="{'key1': val1, 'key2': val2, ...}"
PANTS_LOG_LEVELS_BY_TARGET

pants.toml
[GLOBAL.log_levels_by_target]
key1 = val1
key2 = val2
...

default: {}

Set a more specific logging level for one or more logging targets. The names of logging targets are specified in log strings when the --show-log-target option is set. The logging levels are one of: "error", "warn", "info", "debug", "trace". All logging targets not specified here use the global log level set with --level. For example, you can set --log-levels-by-target='{"workunit_store": "info", "pants.engine.rules": "warn"}'.

`log_show_rust_3rdparty`

--[no-]log-show-rust-3rdparty
PANTS_LOG_SHOW_RUST_3RDPARTY

pants.toml
[GLOBAL]
log_show_rust_3rdparty = <bool>

default: False

Whether to show/hide logging done by 3rdparty Rust crates used by the Pants engine.

`logdir`

-d=<dir>, --logdir=<dir>
PANTS_LOGDIR

pants.toml
[GLOBAL]
logdir = <dir>

default: None

Write logs to files under this directory.

`loop_max`

--loop-max=<int>
PANTS_LOOP_MAX

pants.toml
[GLOBAL]
loop_max = <int>

default: 4294967296

The maximum number of times to loop when --loop is specified.

`named_caches_dir`

--named-caches-dir=<str>
PANTS_NAMED_CACHES_DIR

pants.toml
[GLOBAL]
named_caches_dir = <str>

default: $XDG_CACHE_HOME/pants/named_caches

Directory to use for named global caches for tools and processes with trusted, concurrency-safe caches. The path may be absolute or relative. If the directory is within the build root, be sure to include it in --pants-ignore.

`native_engine_visualize_to`

--native-engine-visualize-to=<dir_option>
PANTS_NATIVE_ENGINE_VISUALIZE_TO

pants.toml
[GLOBAL]
native_engine_visualize_to = <dir_option>

default: None

A directory to write execution and rule graphs to as dot files. The contents of the directory will be overwritten if any filenames collide.

`owners_not_found_behavior`

--owners-not-found-behavior=<OwnersNotFoundBehavior>
PANTS_OWNERS_NOT_FOUND_BEHAVIOR

pants.toml
[GLOBAL]
owners_not_found_behavior = <OwnersNotFoundBehavior>

one of: ignore, warn, error
default: error

What to do when file arguments do not have any owning target. This happens when there are no targets whose sources fields include the file argument.

`pants_bin_name`

--pants-bin-name=<str>
PANTS_BIN_NAME

pants.toml
[GLOBAL]
pants_bin_name = <str>

default: ./pants

The name of the script or binary used to invoke Pants. Useful when printing help messages.

`pants_config_files`

--pants-config-files="['<str>', '<str>', ...]"
PANTS_CONFIG_FILES

pants.toml
[GLOBAL]
pants_config_files = [
  '<str>',
  '<str>',
  ...,
]

default:

[
  "<buildroot>/pants.toml"
]

Paths to Pants config files. This may only be set through the environment variable PANTS_CONFIG_FILES and the command line argument --pants-config-files; it will be ignored if in a config file like pants.toml.

`pants_distdir`

--pants-distdir=<dir>
PANTS_DISTDIR

pants.toml
[GLOBAL]
pants_distdir = <dir>

default: <buildroot>/dist

Write end products, such as the results of ./pants package, to this dir.

`pants_ignore`

--pants-ignore="['<str>', '<str>', ...]"
PANTS_IGNORE

pants.toml
[GLOBAL]
pants_ignore = [
  '<str>',
  '<str>',
  ...,
]

default:

[
  ".*/",
  "/dist/"
]

Paths to ignore for all filesystem operations performed by pants (e.g. BUILD file scanning, glob matching, etc). Patterns use the gitignore syntax (https://git-scm.com/docs/gitignore). The pants_distdir and pants_workdir locations are automatically ignored. pants_ignore can be used in tandem with pants_ignore_use_gitignore; any rules specified here are applied after rules specified in a .gitignore file.

`pants_ignore_use_gitignore`

--[no-]pants-ignore-use-gitignore
PANTS_IGNORE_USE_GITIGNORE

pants.toml
[GLOBAL]
pants_ignore_use_gitignore = <bool>

default: True

Make use of a root .gitignore file when determining whether to ignore filesystem operations performed by Pants. If used together with --pants-ignore, any exclude/include patterns specified there apply after .gitignore rules.

`pants_physical_workdir_base`

--pants-physical-workdir-base=<dir>
PANTS_PHYSICAL_WORKDIR_BASE

pants.toml
[GLOBAL]
pants_physical_workdir_base = <dir>

default: None

When set, a base directory in which to store --pants-workdir contents. If this option is a set, the workdir will be created as symlink into a per-workspace subdirectory.

`pants_subprocessdir`

--pants-subprocessdir=<str>
PANTS_SUBPROCESSDIR

pants.toml
[GLOBAL]
pants_subprocessdir = <str>

default: <buildroot>/.pids

The directory to use for tracking subprocess metadata. This should live outside of the dir used by pants_workdir to allow for tracking subprocesses that outlive the workdir data.

`pants_supportdir`

--pants-supportdir=<dir>
PANTS_SUPPORTDIR

pants.toml
[GLOBAL]
pants_supportdir = <dir>

default: <buildroot>/build-support

Unused. Will be deprecated in 2.2.0.

`pants_version`

--pants-version=<str>
PANTS_VERSION

pants.toml
[GLOBAL]
pants_version = <str>

default: 2.3.3

Use this Pants version. Note that Pants only uses this to verify that you are using the requested version, as Pants cannot dynamically change the version it is using once the program is already running.

If you use the ./pants script from https://www.pantsbuild.org/v2.3/docs/installation, however, changing the value in your pants.toml will cause the new version to be installed and run automatically.

Run ./pants --version to check what is being used.

`pants_workdir`

--pants-workdir=<dir>
PANTS_WORKDIR

pants.toml
[GLOBAL]
pants_workdir = <dir>

default: <buildroot>/.pants.d

Write intermediate logs and output files to this dir.

`pantsd`

--[no-]pantsd
PANTS_PANTSD

pants.toml
[GLOBAL]
pantsd = <bool>

default: True

Enables use of the Pants daemon (pantsd). pantsd can significantly improve runtime performance by lowering per-run startup cost, and by memoizing filesystem operations and rule execution.

`pantsd_invalidation_globs`

--pantsd-invalidation-globs="['<str>', '<str>', ...]"
PANTS_PANTSD_INVALIDATION_GLOBS

pants.toml
[GLOBAL]
pantsd_invalidation_globs = [
  '<str>',
  '<str>',
  ...,
]

default: []

Filesystem events matching any of these globs will trigger a daemon restart. Pants's own code, plugins, and --pants-config-files are inherently invalidated.

`pantsd_max_memory_usage`

--pantsd-max-memory-usage=<int>
PANTS_PANTSD_MAX_MEMORY_USAGE

pants.toml
[GLOBAL]
pantsd_max_memory_usage = <int>

default: 1073741824

The maximum memory usage of a pantsd process (in bytes). There is at most one pantsd process per workspace.

`pantsd_pailgun_port`

--pantsd-pailgun-port=<int>
PANTS_PANTSD_PAILGUN_PORT

pants.toml
[GLOBAL]
pantsd_pailgun_port = <int>

default: 0

The port to bind the Pants nailgun server to. Defaults to a random port.

`pantsd_timeout_when_multiple_invocations`

--pantsd-timeout-when-multiple-invocations=<float>
PANTS_PANTSD_TIMEOUT_WHEN_MULTIPLE_INVOCATIONS

pants.toml
[GLOBAL]
pantsd_timeout_when_multiple_invocations = <float>

default: 60.0

The maximum amount of time to wait for the invocation to start until raising a timeout exception. Because pantsd currently does not support parallel runs, any prior running Pants command must be finished for the current one to start. To never timeout, use the value -1.

`pantsrc`

--[no-]pantsrc
PANTS_PANTSRC

pants.toml
[GLOBAL]
pantsrc = <bool>

default: True

Use pantsrc files located at the paths specified in the global option pantsrc_files.

`pantsrc_files`

--pantsrc-files="[<path>, <path>, ...]"
PANTS_PANTSRC_FILES

pants.toml
[GLOBAL]
pantsrc_files = [
  <path>,
  <path>,
  ...,
]

default:

[
  "/etc/pantsrc",
  "~/.pants.rc"
]

Override config with values from these files, using syntax matching that of --pants-config-files.

`plugins`

--plugins="['<str>', '<str>', ...]"
PANTS_PLUGINS

pants.toml
[GLOBAL]
plugins = [
  '<str>',
  '<str>',
  ...,
]

default: []

Allow backends to be loaded from these plugins (usually released through PyPI). The default backends for each plugin will be loaded automatically. Other backends in a plugin can be loaded by listing them in backend_packages in the [GLOBAL] scope.

`plugins_force_resolve`

--[no-]plugins-force-resolve
PANTS_PLUGINS_FORCE_RESOLVE

pants.toml
[GLOBAL]
plugins_force_resolve = <bool>

default: False

Re-resolve plugins, even if previously resolved.

`print_stacktrace`

--[no-]print-stacktrace
PANTS_PRINT_STACKTRACE

pants.toml
[GLOBAL]
print_stacktrace = <bool>

default: False

Print the full exception stack trace for any errors.

`process_execution_cache_namespace`

--process-execution-cache-namespace=<str>
PANTS_PROCESS_EXECUTION_CACHE_NAMESPACE

pants.toml
[GLOBAL]
process_execution_cache_namespace = <str>

default: None

The cache namespace for process execution. Change this value to invalidate every artifact's execution, or to prevent process cache entries from being (re)used for different usecases or users.

`process_execution_cleanup_local_dirs`

--[no-]process-execution-cleanup-local-dirs
PANTS_PROCESS_EXECUTION_CLEANUP_LOCAL_DIRS

pants.toml
[GLOBAL]
process_execution_cleanup_local_dirs = <bool>

default: True

Whether or not to cleanup directories used for local process execution (primarily useful for e.g. debugging).

`process_execution_local_enable_nailgun`

--[no-]process-execution-local-enable-nailgun
PANTS_PROCESS_EXECUTION_LOCAL_ENABLE_NAILGUN

pants.toml
[GLOBAL]
process_execution_local_enable_nailgun = <bool>

default: False

Whether or not to use nailgun to run the requests that are marked as nailgunnable.

`process_execution_local_parallelism`

--process-execution-local-parallelism=<int>
PANTS_PROCESS_EXECUTION_LOCAL_PARALLELISM

pants.toml
[GLOBAL]
process_execution_local_parallelism = <int>

default: 64

Number of concurrent processes that may be executed locally.

`process_execution_remote_parallelism`

--process-execution-remote-parallelism=<int>
PANTS_PROCESS_EXECUTION_REMOTE_PARALLELISM

pants.toml
[GLOBAL]
process_execution_remote_parallelism = <int>

default: 128

Number of concurrent processes that may be executed remotely.

`process_execution_use_local_cache`

--[no-]process-execution-use-local-cache
PANTS_PROCESS_EXECUTION_USE_LOCAL_CACHE

pants.toml
[GLOBAL]
process_execution_use_local_cache = <bool>

default: True

Whether to keep process executions in a local cache persisted to disk.

`pythonpath`

--pythonpath="['<str>', '<str>', ...]"
PANTS_PYTHONPATH

pants.toml
[GLOBAL]
pythonpath = [
  '<str>',
  '<str>',
  ...,
]

default: []

Add these directories to PYTHONPATH to search for plugins. This does not impact the PYTHONPATH used by Pants when running your Python code.

`remote_auth_plugin`

--remote-auth-plugin=<str>
PANTS_REMOTE_AUTH_PLUGIN

pants.toml
[GLOBAL]
remote_auth_plugin = <str>

default: None

Path to a plugin to dynamically configure remote caching and execution options.

Format: path.to.module:my_func. Pants will import your module and run your function. Update the --pythonpath option to ensure your file is loadable.

The function should take the kwargs initial_store_headers: Dict[str, str], initial_execution_headers: Dict[str, str], and options: Options (from pants.option.options). It should return an instance of AuthPluginResult from pants.option.global_options.

Pants will replace the headers it would normally use with whatever your plugin returns; usually, you should include the initial_store_headers and initial_execution_headers in your result so that options like --remote-store-headers still work.

If you return instance_name, Pants will replace --remote-instance-name with this value.

If the returned auth state is AuthPluginState.UNAVAILABLE, Pants will disable remote caching and execution.

`remote_ca_certs_path`

--remote-ca-certs-path=<str>
PANTS_REMOTE_CA_CERTS_PATH

pants.toml
[GLOBAL]
remote_ca_certs_path = <str>

default: None

Path to a PEM file containing CA certificates used for verifying secure connections to --remote-execution-address and --remote-store-address.

If unspecified, Pants will attempt to auto-discover root CA certificates when TLS is enabled with remote execution and caching.

`remote_cache_eager_fetch`

--[no-]remote-cache-eager-fetch
PANTS_REMOTE_CACHE_EAGER_FETCH

pants.toml
[GLOBAL]
remote_cache_eager_fetch = <bool>

default: True

Eagerly fetch relevant content from the remote store instead of lazily fetching.

This may result in worse performance, but reduce the frequency of errors encountered by reducing the surface area of when remote caching is used.

`remote_cache_read`

--[no-]remote-cache-read
PANTS_REMOTE_CACHE_READ

pants.toml
[GLOBAL]
remote_cache_read = <bool>

default: False

Whether to enable reading from a remote cache.

This cannot be used at the same time as --remote-execution.

`remote_cache_write`

--[no-]remote-cache-write
PANTS_REMOTE_CACHE_WRITE

pants.toml
[GLOBAL]
remote_cache_write = <bool>

default: False

Whether to enable writing results to a remote cache.

This cannot be used at the same time as --remote-execution.

`remote_execution`

--[no-]remote-execution
PANTS_REMOTE_EXECUTION

pants.toml
[GLOBAL]
remote_execution = <bool>

default: False

Enables remote workers for increased parallelism. (Alpha)

Alternatively, you can use --remote-cache-read and --remote-cache-write to still run everything locally, but to use a remote cache.

`remote_execution_address`

--remote-execution-address=<str>
PANTS_REMOTE_EXECUTION_ADDRESS

pants.toml
[GLOBAL]
remote_execution_address = <str>

default: None

The URI of a server used as a remote execution scheduler.

Format: scheme://host:port. The supported schemes are grpc and grpcs, i.e. gRPC with TLS enabled. If grpc is used, TLS will be disabled.

You must also set --remote-store-address, which will often be the same value.

`remote_execution_extra_platform_properties`

--remote-execution-extra-platform-properties="['<str>', '<str>', ...]"
PANTS_REMOTE_EXECUTION_EXTRA_PLATFORM_PROPERTIES

pants.toml
[GLOBAL]
remote_execution_extra_platform_properties = [
  '<str>',
  '<str>',
  ...,
]

default: []

Platform properties to set on remote execution requests. Format: property=value. Multiple values should be specified as multiple occurrences of this flag. Pants itself may add additional platform properties.

`remote_execution_headers`

--remote-execution-headers="{'key1': val1, 'key2': val2, ...}"
PANTS_REMOTE_EXECUTION_HEADERS

pants.toml
[GLOBAL.remote_execution_headers]
key1 = val1
key2 = val2
...

default: {}

Headers to set on remote execution requests. Format: header=value. Pants may add additional headers.

See --remote-store-headers as well.

`remote_execution_overall_deadline_secs`

--remote-execution-overall-deadline-secs=<int>
PANTS_REMOTE_EXECUTION_OVERALL_DEADLINE_SECS

pants.toml
[GLOBAL]
remote_execution_overall_deadline_secs = <int>

default: 3600

Overall timeout in seconds for each remote execution request from time of submission

`remote_instance_name`

--remote-instance-name=<str>
PANTS_REMOTE_INSTANCE_NAME

pants.toml
[GLOBAL]
remote_instance_name = <str>

default: None

Name of the remote instance to use by remote caching and remote execution.

This is used by some remote servers for routing. Consult your remote server for whether this should be set.

You can also use --remote-auth-plugin to provide a plugin to dynamically set this value.

`remote_oauth_bearer_token_path`

--remote-oauth-bearer-token-path=<str>
PANTS_REMOTE_OAUTH_BEARER_TOKEN_PATH

pants.toml
[GLOBAL]
remote_oauth_bearer_token_path = <str>

default: None

Path to a file containing an oauth token to use for gGRPC connections to --remote-execution-address and --remote-store-address.

If specified, Pants will add a header in the format authorization: Bearer <token>. You can also manually add this header via --remote-execution-headers and --remote-store-headers, or use --remote-auth-plugin to provide a plugin to dynamically set the relevant headers. Otherwise, no authorization will be performed.

`remote_store_address`

--remote-store-address=<str>
PANTS_REMOTE_STORE_ADDRESS

pants.toml
[GLOBAL]
remote_store_address = <str>

default: None

The URI of a server used for the remote file store.

Format: scheme://host:port. The supported schemes are grpc and grpcs, i.e. gRPC with TLS enabled. If grpc is used, TLS will be disabled.

`remote_store_chunk_bytes`

--remote-store-chunk-bytes=<int>
PANTS_REMOTE_STORE_CHUNK_BYTES

pants.toml
[GLOBAL]
remote_store_chunk_bytes = <int>

default: 1048576

Size in bytes of chunks transferred to/from the remote file store.

`remote_store_chunk_upload_timeout_seconds`

--remote-store-chunk-upload-timeout-seconds=<int>
PANTS_REMOTE_STORE_CHUNK_UPLOAD_TIMEOUT_SECONDS

pants.toml
[GLOBAL]
remote_store_chunk_upload_timeout_seconds = <int>

default: 60

Timeout (in seconds) for uploads of individual chunks to the remote file store.

`remote_store_headers`

--remote-store-headers="{'key1': val1, 'key2': val2, ...}"
PANTS_REMOTE_STORE_HEADERS

pants.toml
[GLOBAL.remote_store_headers]
key1 = val1
key2 = val2
...

default: {}

Headers to set on remote store requests.

Format: header=value. Pants may add additional headers.

See --remote-execution-headers as well.

`remote_store_rpc_retries`

--remote-store-rpc-retries=<int>
PANTS_REMOTE_STORE_RPC_RETRIES

pants.toml
[GLOBAL]
remote_store_rpc_retries = <int>

default: 2

Number of times to retry any RPC to the remote store before giving up.

`rule_threads_core`

--rule-threads-core=<int>
PANTS_RULE_THREADS_CORE

pants.toml
[GLOBAL]
rule_threads_core = <int>

default: 32

The number of threads to keep active and ready to execute @rule logic (see also: --rule-threads-max). Values less than 2 are not currently supported. This value is independent of the number of processes that may be spawned in parallel locally (controlled by --process-execution-local-parallelism).

`rule_threads_max`

--rule-threads-max=<int>
PANTS_RULE_THREADS_MAX

pants.toml
[GLOBAL]
rule_threads_max = <int>

default: None

The maximum number of threads to use to execute @rule logic. Defaults to a small multiple of --rule-threads-core.

`show_log_target`

--[no-]show-log-target
PANTS_SHOW_LOG_TARGET

pants.toml
[GLOBAL]
show_log_target = <bool>

default: False

Display the target where a log message originates in that log message's output. This can be helpful when paired with --log-levels-by-target.

`stats_record_option_scopes`

--stats-record-option-scopes="['<str>', '<str>', ...]"
PANTS_STATS_RECORD_OPTION_SCOPES

pants.toml
[GLOBAL]
stats_record_option_scopes = [
  '<str>',
  '<str>',
  ...,
]

default:

[
  "*"
]

Option scopes to record in stats on run completion. Options may be selected by joining the scope and the option with a ^ character, i.e. to get option pantsd in the GLOBAL scope, you'd pass GLOBAL^pantsd. Add a '*' to the list to capture all known scopes.

`streaming_workunits_report_interval`

--streaming-workunits-report-interval=<float>
PANTS_STREAMING_WORKUNITS_REPORT_INTERVAL

pants.toml
[GLOBAL]
streaming_workunits_report_interval = <float>

default: 1.0

Interval in seconds between when streaming workunit event receivers will be polled.

`subproject_roots`

--subproject-roots="['<str>', '<str>', ...]"
PANTS_SUBPROJECT_ROOTS

pants.toml
[GLOBAL]
subproject_roots = [
  '<str>',
  '<str>',
  ...,
]

default: []

Paths that correspond with build roots for any subproject that this project depends on.

`verify_config`

--[no-]verify-config
PANTS_VERIFY_CONFIG

pants.toml
[GLOBAL]
verify_config = <bool>

default: True

Verify that all config file values correspond to known options.

Deprecated options

`plugin_cache_dir`

--plugin-cache-dir=<str>
PANTS_PLUGIN_CACHE_DIR

pants.toml
[GLOBAL]
plugin_cache_dir = <str>

default: $XDG_CACHE_HOME/pants/plugins
Deprecated, will be removed in version: 2.5.0.dev0.
This option now no-ops, the plugins cache is now housed in the named caches.

Cache resolved plugin requirements here.

`process_execution_speculation_delay`

--process-execution-speculation-delay=<float>
PANTS_PROCESS_EXECUTION_SPECULATION_DELAY

pants.toml
[GLOBAL]
process_execution_speculation_delay = <float>

default: 1.0
Deprecated, will be removed in version: 2.4.0.dev0.
This option now no-ops, as speculation has been removed. It will be re-implemented in the future.

Number of seconds to wait before speculating a second request for a slow process. see --process-execution-speculation-strategy

`process_execution_speculation_strategy`

--process-execution-speculation-strategy=<str>
PANTS_PROCESS_EXECUTION_SPECULATION_STRATEGY

pants.toml
[GLOBAL]
process_execution_speculation_strategy = <str>

one of: remote_first, local_first, none
default: none
Deprecated, will be removed in version: 2.4.0.dev0.
This option now no-ops, as speculation has been removed. It will be re-implemented in the future.

Speculate a second request for an underlying process if the first one does not complete within --process-execution-speculation-delay seconds. local_first (default): Try to run the process locally first, and fall back to remote execution if available. remote_first: Run the process on the remote execution backend if available, and fall back to the local host if remote calls take longer than the speculation timeout. none: Do not speculate about long running processes.

`remote_execution_server`

--remote-execution-server=<str>
PANTS_REMOTE_EXECUTION_SERVER

pants.toml
[GLOBAL]
remote_execution_server = <str>

default: None
Deprecated, will be removed in version: 2.4.0.dev0.
Use `--remote-execution-address` instead. Note that you must add the prefix `grpc://` or `grpcs://` to identify whether TLS should be used.

host:port of grpc server to use as remote execution scheduler.

`remote_store_connection_limit`

--remote-store-connection-limit=<int>
PANTS_REMOTE_STORE_CONNECTION_LIMIT

pants.toml
[GLOBAL]
remote_store_connection_limit = <int>

default: 0
Deprecated, will be removed in version: 2.4.0.dev0.
This option now no-ops.

Number of remote stores to concurrently allow connections to.

`remote_store_initial_timeout`

--remote-store-initial-timeout=<int>
PANTS_REMOTE_STORE_INITIAL_TIMEOUT

pants.toml
[GLOBAL]
remote_store_initial_timeout = <int>

default: 0
Deprecated, will be removed in version: 2.4.0.dev0.
This option now no-ops.

Initial timeout (in milliseconds) when there is a failure in accessing a remote store.

`remote_store_maximum_timeout`

--remote-store-maximum-timeout=<int>
PANTS_REMOTE_STORE_MAXIMUM_TIMEOUT

pants.toml
[GLOBAL]
remote_store_maximum_timeout = <int>

default: 0
Deprecated, will be removed in version: 2.4.0.dev0.
This option now no-ops.

Maximum timeout (in millseconds) to allow between retry attempts in accessing a remote store.

`remote_store_server`

--remote-store-server="['<str>', '<str>', ...]"
PANTS_REMOTE_STORE_SERVER

pants.toml
[GLOBAL]
remote_store_server = [
  '<str>',
  '<str>',
  ...,
]

default: []
Deprecated, will be removed in version: 2.4.0.dev0.
Use `--remote-store-address` instead. Note that you must add the prefix `grpc://` or `grpcs://` to identify whether TLS should be used. `--remote-store-address` also is a string option, rather than list option; if you still need support for multiple servers, please open a GitHub issue or reach out on Slack in the #remoting channel. See https://www.pantsbuild.org/v2.3/docs/community.

host:port of grpc server to use as remote execution file store.

`remote_store_thread_count`

--remote-store-thread-count=<int>
PANTS_REMOTE_STORE_THREAD_COUNT

pants.toml
[GLOBAL]
remote_store_thread_count = <int>

default: 0
Deprecated, will be removed in version: 2.4.0.dev0.
This option now no-ops.

Thread count to use for the pool that interacts with the remote file store.

`remote_store_timeout_multiplier`

--remote-store-timeout-multiplier=<float>
PANTS_REMOTE_STORE_TIMEOUT_MULTIPLIER

pants.toml
[GLOBAL]
remote_store_timeout_multiplier = <float>

default: 0.0
Deprecated, will be removed in version: 2.4.0.dev0.
This option now no-ops.

Multiplier used to increase the timeout (starting with value of --remote-store-initial-timeout) between retry attempts in accessing a remote store.

None

Basic options
Advanced options
Deprecated options
Related subsystems

Basic options​

colors​

dynamic_ui​

exclude_target_regexp​

level​

loop​

spec_files​

tag​

Advanced options​

backend_packages​

build_file_prelude_globs​

build_ignore​

build_patterns​

ca_certs_path​

concurrent​

files_not_found_behavior​

ignore_pants_warnings​

local_execution_root_dir​

local_store_dir​

log_levels_by_target​

log_show_rust_3rdparty​

logdir​

loop_max​

named_caches_dir​

native_engine_visualize_to​

owners_not_found_behavior​

pants_bin_name​

pants_config_files​

pants_distdir​

pants_ignore​

pants_ignore_use_gitignore​

pants_physical_workdir_base​

pants_subprocessdir​

pants_supportdir​

pants_version​

pants_workdir​

pantsd​

pantsd_invalidation_globs​

pantsd_max_memory_usage​

pantsd_pailgun_port​

pantsd_timeout_when_multiple_invocations​

pantsrc​

pantsrc_files​

plugins​

plugins_force_resolve​

print_stacktrace​

process_execution_cache_namespace​

process_execution_cleanup_local_dirs​

process_execution_local_enable_nailgun​

process_execution_local_parallelism​

process_execution_remote_parallelism​

process_execution_use_local_cache​

pythonpath​

remote_auth_plugin​

remote_ca_certs_path​

remote_cache_eager_fetch​

remote_cache_read​

remote_cache_write​

remote_execution​

remote_execution_address​

remote_execution_extra_platform_properties​

remote_execution_headers​

remote_execution_overall_deadline_secs​

remote_instance_name​

remote_oauth_bearer_token_path​

remote_store_address​

remote_store_chunk_bytes​

remote_store_chunk_upload_timeout_seconds​

remote_store_headers​

remote_store_rpc_retries​

rule_threads_core​

rule_threads_max​

show_log_target​

stats_record_option_scopes​

streaming_workunits_report_interval​

subproject_roots​

verify_config​

Deprecated options​

plugin_cache_dir​

process_execution_speculation_delay​

Basic options

`colors`

`dynamic_ui`

`exclude_target_regexp`

`level`

`loop`

`spec_files`

`tag`

Advanced options

`backend_packages`

`build_file_prelude_globs`

`build_ignore`

`build_patterns`

`ca_certs_path`

`concurrent`

`files_not_found_behavior`

`ignore_pants_warnings`

`local_execution_root_dir`

`local_store_dir`

`log_levels_by_target`

`log_show_rust_3rdparty`

`logdir`

`loop_max`

`named_caches_dir`

`native_engine_visualize_to`

`owners_not_found_behavior`

`pants_bin_name`

`pants_config_files`

`pants_distdir`

`pants_ignore`

`pants_ignore_use_gitignore`

`pants_physical_workdir_base`

`pants_subprocessdir`

`pants_supportdir`

`pants_version`

`pants_workdir`

`pantsd`

`pantsd_invalidation_globs`

`pantsd_max_memory_usage`

`pantsd_pailgun_port`

`pantsd_timeout_when_multiple_invocations`

`pantsrc`

`pantsrc_files`

`plugins`

`plugins_force_resolve`

`print_stacktrace`

`process_execution_cache_namespace`

`process_execution_cleanup_local_dirs`

`process_execution_local_enable_nailgun`

`process_execution_local_parallelism`

`process_execution_remote_parallelism`

`process_execution_use_local_cache`

`pythonpath`

`remote_auth_plugin`

`remote_ca_certs_path`

`remote_cache_eager_fetch`

`remote_cache_read`

`remote_cache_write`

`remote_execution`

`remote_execution_address`

`remote_execution_extra_platform_properties`

`remote_execution_headers`

`remote_execution_overall_deadline_secs`

`remote_instance_name`

`remote_oauth_bearer_token_path`

`remote_store_address`

`remote_store_chunk_bytes`

`remote_store_chunk_upload_timeout_seconds`

`remote_store_headers`

`remote_store_rpc_retries`

`rule_threads_core`

`rule_threads_max`

`show_log_target`

`stats_record_option_scopes`

`streaming_workunits_report_interval`

`subproject_roots`

`verify_config`

Deprecated options

`plugin_cache_dir`

`process_execution_speculation_delay`