feat: lazy env eval

docs/environments/index.md

@@ -31,6 +31,18 @@ NODE_ENV  development  mise.toml
 $ mise unset NODE_ENV
 ```
 
+## Lazy eval
+
+Environment variables typically are resolved before tools—that way you can configure tool installation
+with environment variables. However, sometimes you want to access environment variables produced by
+tools. To do that, turn the value into a map with `tools = true`:
+
+```toml
+[env]
+MY_VAR = { value = "tools path: {{env.PATH}}", tools = true }
+_.path = { value = ["{{env.GEM_HOME}}/bin"], tools = true } # directives may also set tools = true
+```
+
 ## `env._` directives
 
 `env._.*` define special behavior for setting environment variables. (e.g.: reading env vars
@@ -57,6 +69,15 @@ not to mise since there is not much mise can do about the way that crate works.
 Or set [`MISE_ENV_FILE=.env`](/configuration#mise-env-file) to automatically load dotenv files in any
 directory.
 
+You can also use json or yaml files:
+
+```toml
+[env]
+_.file = '.env.json'
+```
+
+See [secrets](/environments/secrets) for ways to read encrypted files with `env._.file`.
+
 ### `env._.path`
 
 `PATH` is treated specially, it needs to be defined as a string/array in `mise.path`:

e2e/config/test_config_post_tools

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+cat <<EOF >mise.toml
+[[env]]
+A_PATH = "foo: {{ env.PATH }}"
+B_PATH = { value = "foo: {{ env.PATH }}", tools = true }
+[[env]]
+_.path = {value = "tiny-{{env.JDXCODE_TINY}}-tiny", tools = true}
+
+[tools]
+tiny = "1.0.0"
+EOF
+
+mise i
+assert_not_contains "mise env | grep A_PATH" "tiny"
+assert_contains "mise env | grep B_PATH" "tiny"
+
+assert_contains "mise dr path" "tiny-1.0.0-tiny"

mise.usage.kdl

@@ -359,6 +359,7 @@ cmd "doctor" help="Check mise installation for possible problems" {
     [WARN] plugin node is not installed
 "
     cmd "path" help="Print the current PATH entries mise is providing" {
+        alias "paths" hide=true
         after_long_help r"Examples:
 
     Get the current PATH entries mise is providing

src/cli/doctor/path.rs

@@ -4,7 +4,7 @@ use std::env;
 
 /// Print the current PATH entries mise is providing
 #[derive(Debug, clap::Args)]
-#[clap(verbatim_doc_comment, after_long_help = AFTER_LONG_HELP)]
+#[clap(alias="paths", verbatim_doc_comment, after_long_help = AFTER_LONG_HELP)]
 pub struct Path {
     /// Print all entries including those not provided by mise
     #[clap(long, short, verbatim_doc_comment)]

src/cli/set.rs

@@ -68,7 +68,7 @@ impl Set {
             if env_vars.len() == 1 && env_vars[0].value.is_none() {
                 let key = &env_vars[0].key;
                 match config.env_entries()?.into_iter().find_map(|ev| match ev {
-                    EnvDirective::Val(k, v) if &k == key => Some(v),
+                    EnvDirective::Val(k, v, _) if &k == key => Some(v),
                     _ => None,
                 }) {
                     Some(value) => miseprintln!("{value}"),
@@ -122,7 +122,7 @@ impl Set {
                 .env_entries()?
                 .into_iter()
                 .filter_map(|ed| match ed {
-                    EnvDirective::Val(key, value) => Some(Row {
+                    EnvDirective::Val(key, value, _) => Some(Row {
                         key,
                         value,
                         source: display_path(file),