id          = "gpg-tui"
name        = "gpg-tui"
homepage    = "https://github.com/orhun/gpg-tui"
description = "A terminal user interface for GnuPG."
executables      = ["gpg-tui"]

[dotfiles]

# The upstream README documents three filenames under each platform's config
# directory. [configHome] covers Linux, [appData] macOS Application Support,
# and %APPDATA% Windows RoamingAppData.
# https://github.com/orhun/gpg-tui#configuration
paths = [
  "[configHome]/gpg-tui.toml",
  "[configHome]/gpg-tui/gpg-tui.toml",
  "[configHome]/gpg-tui/config",
  "[appData]/gpg-tui.toml",
  "[appData]/gpg-tui/gpg-tui.toml",
  "[appData]/gpg-tui/config",
  "%APPDATA%/gpg-tui.toml",
  "%APPDATA%/gpg-tui/gpg-tui.toml",
  "%APPDATA%/gpg-tui/config",
]

exclude = []
secret  = []

[commands]
format = 1
label = "Launch gpg-tui"
description = "Open the GnuPG terminal UI with a chosen home directory, output directory and look. Environment-variable equivalents and the key-selection mode are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "help"
kind = "help"
url = "https://github.com/orhun/gpg-tui/blob/master/README.md"
revision = "master 2026-10-27"
evidence = '''
Options:
  -a, --armor                 Enables ASCII armored output
      --splash                Shows the splash screen on startup
      --homedir <dir>         Sets the GnuPG home directory [env: GNUPGHOME=]
  -o, --outdir <dir>          Sets the output directory [env: OUTDIR=]
  -d, --default-key <key>     Sets the default key to sign with [env: DEFAULT_KEY=]
  -t, --tick-rate <ms>        Sets the tick rate of the terminal [env: TICK_RATE=] [default: 250]
  -c, --color <color>         Sets the accent color of the terminal [env: COLOR=] [default: gray]
  -s, --style <style>         Sets the style of the terminal [env: STYLE=] [default: colored] [possible values: plain, colored]
      --log-file <path>       Sets the file to save the logs [env: LOG_FILE=]
'''

[[commands.field]]
id = "homedir"
label = "GnuPG home directory"
type = "path"
option = ["--homedir"]
path = { kind = "directory", role = "input", must_exist = true }
sources = ["help"]

[[commands.field]]
id = "outdir"
label = "Output directory"
type = "path"
option = ["--outdir", "-o"]
path = { kind = "directory", role = "output", must_exist = false }
sources = ["help"]

[[commands.field]]
id = "default_key"
label = "Default signing key"
type = "string"
option = ["--default-key", "-d"]
sources = ["help"]

[[commands.field]]
id = "armor"
label = "ASCII armored output"
type = "boolean"
option = ["--armor", "-a"]
sources = ["help"]

[[commands.field]]
id = "color"
label = "Accent colour"
type = "string"
option = ["--color", "-c"]
sources = ["help"]

[[commands.field]]
id = "style"
label = "Style"
description = "Terminal style, for example plain or colored."
type = "string"
option = ["--style", "-s"]
suggestions = [{ value = "colored", label = "Colored" }, { value = "plain", label = "Plain" }]
sources = ["help"]

[[commands.field]]
id = "tick_rate"
label = "Tick rate (ms)"
type = "integer"
option = ["--tick-rate", "-t"]
sources = ["help"]

[[commands.field]]
id = "splash"
label = "Show splash screen"
type = "boolean"
option = ["--splash"]
sources = ["help"]

[[commands.field]]
id = "log_file"
label = "Log file"
type = "path"
option = ["--log-file"]
path = { kind = "file", role = "output", must_exist = false }
effect = "overwrite"
sources = ["help"]

[[commands.task]]
id = "custom-home"
label = "Use another keyring"
fields = ["homedir", "armor", "default_key"]
required = ["homedir"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["homedir", "outdir", "default_key", "armor"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["color", "style", "tick_rate", "splash", "log_file"]