Skip to content

xtr_dotenv.command

Console commands the dotenv bundle contributes when a console is active.

DebugDotenvCommand

List every file in the cascade and each variable's value per file.

Missing files are shown too, in order, so a debugger can see exactly what the loader would have done. name filters the value listing to a single variable, which is what a "why is this value what it is?" session usually needs. Values are masked unless --show-values is passed, so the output is safe to paste into a bug report.

DotenvDumpCommand

Compile the layered cascade for one env into <path>.local.json.

The dump is what :meth:Dotenv.boot_env reads for a fast start. It is computed on a fresh environ carrying only the env key, so no real environment variable lands in it — but it carries whatever the cascade's files carry, the .local overlays included, so gitignore it as those files are. It also stamps the default_env and test_envs it was compiled with, so boot_env can refuse a dump compiled from a different description of the cascade instead of silently loading it.