id       = "gmt"
name     = "GMT"
homepage = "https://www.generic-mapping-tools.org/"
executables   = ["gmt"]

[dotfiles]

# GMT 6's defaults documentation searches gmt.conf in ~/ and ~/.gmt. Older
# GMT releases used .gmtdefaults4 in those same two locations, so both shipped
# spellings are retained for users migrating an older GMT setup.
# https://docs.generic-mapping-tools.org/dev/gmtdefaults.html
# https://docs.generic-mapping-tools.org/4/gmt/html/man/gmtdefaults.html
paths = [
  "~/gmt.conf",
  "~/.gmt/gmt.conf",
  "~/.gmtdefaults4",
  "~/.gmt/.gmtdefaults4",
]
secret = []

[commands]
format = 1
label = "Inspect GMT installation"
description = "Print GMT installation details or a modern-mode script template. Running individual GMT modules (gmt plot, gmt grdimage ...) is not covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.source]]
id = "man"
kind = "manual"
url = "https://manpages.debian.org/unstable/gmt/gmt.1.en.html"
revision = "2026-10-27"
evidence = """
--help
List and description of GMT modules.
--new-script[=L]
Write a GMT modern mode script template to standard output. Optionally append the desired scripting language among bash, csh, or batch.
--show-bindir
Show directory of executables and exit.
--show-citation
Show the citation for the latest GMT publication.
--show-cores
Show number of available cores.
--show-datadir
Show data directory/ies and exit.
--show-modules
List modern module names on standard output and exit.
--show-classic
List classic module names on standard output and exit.
--show-library
Show the path of the shared GMT library.
--show-plugindir
Show plugin directory and exit.
--show-sharedir
Show share directory and exit.
--show-userdir
Show full path of user's ~/.gmt dir and exit.
--version
Print version and exit.
"""

[[commands.field]]
id = "version"
label = "Version"
type = "boolean"
option = ["--version"]
sources = ["man"]

[[commands.field]]
id = "help"
label = "List modules"
type = "boolean"
option = ["--help"]
sources = ["man"]

[[commands.field]]
id = "show_modules"
label = "Modern module names"
type = "boolean"
option = ["--show-modules"]
sources = ["man"]

[[commands.field]]
id = "show_classic"
label = "Classic module names"
type = "boolean"
option = ["--show-classic"]
sources = ["man"]

[[commands.field]]
id = "show_datadir"
label = "Data directory"
type = "boolean"
option = ["--show-datadir"]
sources = ["man"]

[[commands.field]]
id = "show_userdir"
label = "User directory (~/.gmt)"
type = "boolean"
option = ["--show-userdir"]
sources = ["man"]

[[commands.field]]
id = "show_sharedir"
label = "Share directory"
type = "boolean"
option = ["--show-sharedir"]
sources = ["man"]

[[commands.field]]
id = "show_cores"
label = "Available cores"
type = "boolean"
option = ["--show-cores"]
sources = ["man"]

[[commands.field]]
id = "new_script"
label = "Script template language"
description = "Write a modern-mode script template to standard output."
type = "enum"
option = ["--new-script"]
choices = [{ value = "bash", label = "bash" }, { value = "csh", label = "csh" }, { value = "batch", label = "batch" }]
sources = ["man"]

[[commands.task]]
id = "version"
label = "Show version"
set = { version = [true] }
lock = ["version"]
fields = ["version"]
required = []

[[commands.task]]
id = "template"
label = "New script template"
fields = ["new_script"]
required = ["new_script"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["version", "help", "new_script"]

[[commands.group]]
id = "advanced"
label = "Show paths and modules"
fields = ["show_modules", "show_classic", "show_datadir", "show_userdir", "show_sharedir", "show_cores"]