> ## Documentation Index
> Fetch the complete documentation index at: https://bazel-pr-30827.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# configuration {#modules.configuration}

This object holds information about the environment in which the build is running. See the [Rules page](https://bazel.build/extending/rules#configurations) for more on the general concept of configurations.

## Members

* [coverage\_enabled](#coverage_enabled)
* [default\_shell\_env](#default_shell_env)
* [host\_path\_separator](#host_path_separator)
* [is\_tool\_configuration](#is_tool_configuration)
* [short\_id](#short_id)
* [test\_env](#test_env)

<h2 id="coverage_enabled">
  coverage\_enabled
</h2>

```
bool configuration.coverage_enabled
```

A boolean that tells whether code coverage is enabled for this run. Note that this does not compute whether a specific rule should be instrumented for code coverage data collection. For that, see the [`ctx.coverage_instrumented`](../builtins/ctx#coverage_instrumented) function.

<h2 id="default_shell_env">
  default\_shell\_env
</h2>

```
dict configuration.default_shell_env
```

A dictionary representing the static local shell environment. It maps variables to their values (strings).

<h2 id="host_path_separator">
  host\_path\_separator
</h2>

```
string configuration.host_path_separator
```

Returns the separator for PATH environment variable, which is ':' on Unix.

<h2 id="is_tool_configuration">
  is\_tool\_configuration
</h2>

```
bool configuration.is_tool_configuration()
```

Returns true when building in the tool (exec) configuration.

<h2 id="short_id">
  short\_id
</h2>

```
string configuration.short_id
```

A short identifier for this configuration understood by the `config` and query subcommands.

Use this to distinguish different configurations for the same target in a way that is friendly to humans and tool usage, for example in an aspect used by an IDE. Keep in mind the following caveats:

* The value may differ across Bazel versions, including patch releases.\* The value encodes the value of **every** flag, including those that aren't otherwise relevant for the current target and may thus invalidate caches more frequently.

<h2 id="test_env">
  test\_env
</h2>

```
dict configuration.test_env
```

A dictionary containing user-specified test environment variables and their values, as set by the `--test_env` options. DO NOT USE! This is not the complete environment!
