feat: add usage field to tasks

docs/tasks/task-configuration.md

@@ -254,6 +254,20 @@ like to hide even the output that the task emits, use [`silent`](#silent).
 
 Suppress all output from the task. If set to `"stdout"` or `"stderr"`, only that stream will be suppressed.
 
+### `usage`
+
+- **Type**: `string`
+
+More advanced usage specs can be added to the task's `usage` field. This only applies to toml-tasks.
+
+```toml
+[tasks.test]
+usage = '''
+arg "file" description="The file to test" default="src/main.rs"
+'''
+run = 'cargo test {{arg(name="file")}}'
+```
+
 ## Vars
 
 Vars are variables that can be shared between tasks like environment variables but they are not

docs/tasks/toml-tasks.md

@@ -441,3 +441,15 @@ fi
 - `name`: The name of the flag. This is used for help/error messages.
 
 The value will be `true` if the flag is passed, and `false` otherwise.
+
+### Usage spec
+
+More advanced usage specs can be added to the task's `usage` field:
+
+```toml
+[tasks.test]
+usage = '''
+arg "file" description="The file to test" default="src/main.rs"
+'''
+run = 'cargo test {{arg(name="file")}}'
+```

e2e/tasks/test_task_run_toml

@@ -35,3 +35,12 @@ assert "mise run -E windows configtask" "configtask:windows"
 assert "mise run -P windows configtask" "configtask:windows"
 MISE_ENV=windows assert "mise run configtask" "configtask:windows"
 MISE_PROFILE=windows assert "mise run configtask" "configtask:windows"
+
+cat <<EOF >mise.toml
+[tasks.a]
+usage = '''
+arg "myarg" "myarg description" default="foo"
+'''
+run = 'echo {{arg(name="myarg")}}'
+EOF
+assert "mise run a" "foo"

mise.lock

@@ -44,7 +44,7 @@ version = "0.2.3"
 backend = "cargo:toml-cli"
 
 [tools."cargo:usage-cli"]
-version = "1.7.3"
+version = "1.7.4"
 backend = "cargo:usage-cli"
 
 [tools.cosign]

src/cli/config/set.rs

@@ -52,23 +52,11 @@ impl ConfigSet {
             let mut container = config.as_item_mut();
             let parts = self.key.split('.').collect::<Vec<&str>>();
             for key in parts.iter().take(parts.len() - 1) {
-<<<<<<< HEAD
                 container = container.as_table_mut().unwrap().entry(key).or_insert({
                     let mut t = toml_edit::Table::new();
                     t.set_implicit(true);
                     toml_edit::Item::Table(t)
                 });
-=======
-                container = container
-                    .as_table_mut()
-                    .unwrap()
-                    .entry(key)
-                    .or_insert({
-                        let mut t = toml_edit::Table::new();
-                        t.set_implicit(true);
-                        toml_edit::Item::Table(t)
-                    });
->>>>>>> 01bd9dbb2 (fix: use implicit keys for `mise config set`)
             }
             let last_key = parts.last().unwrap();
 

src/task/mod.rs

@@ -80,6 +80,8 @@ pub struct Task {
     pub silent: bool,
     #[serde(default)]
     pub tools: IndexMap<String, String>,
+    #[serde(default)]
+    pub usage: String,
 
     // normal type
     #[serde(default, deserialize_with = "deserialize_arr")]
@@ -562,6 +564,7 @@ impl Default for Task {
             file: None,
             quiet: false,
             tools: Default::default(),
+            usage: "".to_string(),
         }
     }
 }

src/task/task_script_parser.rs

@@ -295,10 +295,11 @@ impl TaskScriptParser {
             })
             .collect();
         cmd.flags = input_flags.lock().unwrap().clone();
-        let spec = usage::Spec {
+        let mut spec = usage::Spec {
             cmd,
             ..Default::default()
         };
+        spec.merge(task.usage.parse()?);
 
         Ok((scripts, spec))
     }