fix(tools): allow using env vars in tools

[antonsergeyev]

When parsing tools section, add locally defined environment variables to Tera context, so they are available for templating.

Note that this only allows using the variables from the current file. References to other files are not resolved.

Example:

[env]
TERRAFORM_VERSION = '1.0.0'
JQ_PREFIX = '1.6'

[tools]
terraform = "{{env.TERRAFORM_VERSION}}"
jq = { prefix = "{{ env.JQ_PREFIX }}" }

Also see this discussion: #3782

---

Note

Allow tools entries to reference environment variables defined in the same mise.toml via Tera context; update docs and add tests.

• Core/Config (src/config/config_file/mise_toml.rs)
  • Add update_context_env to merge base env with local [env] vars and inject into Tera context (env).
  • Call update_context_env in init and from_str to enable templating env vars in tools (versions/options).
  • Imports updated to use EnvMap and env module.
• Tests
  • Add test_env_var_in_tool verifying tools can use {{ env.VAR }}; add snapshot ...env_var_in_tool.snap.
• Docs
  • docs/dev-tools/index.md: Note that tool versions can reference env vars defined in the same file (no resolution from referenced files).
  • docs/templates.md: Expand example showing [env]-defined var used in [tools], and external env via get_env().

^{Written by Cursor Bugbot for commit e437569. This will update automatically on new commits. Configure here.}

[Copilot]

Pull request overview

This PR enables environment variable templating in the tools section of mise configuration files by adding locally defined environment variables to the Tera template context during parsing.

• Allows tools to reference env vars defined in the same file using {{ env.VARIABLE_NAME }} syntax
• Updates context initialization to include environment variables during config file parsing
• Documents the new feature with examples and limitations

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
src/config/config_file/mise_toml.rs	Implements env var context update logic and adds test coverage for the new templating feature
docs/templates.md	Adds example showing env var usage in tools section
docs/dev-tools/index.md	Documents the new templating capability and its limitation regarding referenced files

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[jdx]

bugbot run

[cursor]

✅ Bugbot reviewed your changes and found no bugs!

---