id = "env"
name = "env"
description = "Set environment variables and run a utility, or print the environment."
executables = ["env"]

[commands]
format = 1
label = "Run with environment"
description = "Run a utility with a modified environment, or print the environment when no utility is given."
quality = "ai-draft"
base = "fig:env"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/env.ts"
license = "MIT"

[[commands.field]]
id = "ignore_env"
label = "Start with empty environment"
type = "boolean"
option = ["-i"]
sources = ["fig"]

[[commands.field]]
id = "unset"
label = "Unset variable"
type = "string"
option = ["-u"]
multiple = true
sources = ["fig"]

[[commands.field]]
id = "nul"
label = "NUL-terminate output lines"
type = "boolean"
option = ["-0"]
sources = ["fig"]

[[commands.field]]
id = "verbose"
label = "Verbose"
type = "boolean"
option = ["-v"]
sources = ["fig"]

[[commands.field]]
id = "words"
label = "Variables, utility and arguments"
description = "NAME=value assignments first, then the utility to run and its arguments. Leave empty to print the environment."
type = "string"
position = 0
multiple = true
sources = ["fig"]

[[commands.task]]
id = "run"
label = "Run with variables"
fields = ["words", "unset"]
required = ["words"]

[[commands.task]]
id = "clean"
label = "Run in clean environment"
set = { ignore_env = [true] }
fields = ["ignore_env", "words"]
required = ["words"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["words", "ignore_env", "unset"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["nul", "verbose"]