id = "maxima"
name = "Maxima"
homepage = "https://maxima.sourceforge.io/"
description = "A system for the manipulation of symbolic and numerical expressions."
executables = ["maxima"]

[dotfiles]

# https://maxima.sourceforge.io/docs/manual/Command_002dline-options.html
# documents ~/.maxima as the Unix default maxima_userdir and maxima-init.mac
# and maxima-init.lisp as the default initialization files. The runtime
# manual also documents maximarc in MAXIMA_USERDIR.
paths = [
  "~/.maxima/maxima-init.mac",
  "~/.maxima/maxima-init.lisp",
  "~/.maxima/maximarc",
]
secret = []
side_effect = false

[commands]
format = 1
label = "Run Maxima"
description = "Start Maxima interactively, or run a batch file or string noninteractively. Lisp selection, server mode and Lisp options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "help"
kind = "manual"
url = "https://manpages.debian.org/unstable/maxima/maxima.1.en.html"
evidence = """
-b file,
--batch=file
Process file in noninteractive mode.
--batch-string=string
Process string in noninteractive mode.
-r string,
--run-string=string
Process string in interactive mode.
--init-mac=file
Load the Maxima initialization file file at startup.
-q, --quiet
Suppress Maxima start-up message.
-Q,
--quit-on-error
--very-quiet
--no-init,
--norc
--suppress-input-echo
--userdir=directory
"""

[[commands.field]]
id = "batch"
label = "Batch file"
type = "path"
option = ["--batch", "-b"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["help"]

[[commands.field]]
id = "batch_string"
label = "Batch string"
type = "string"
option = ["--batch-string"]
sources = ["help"]

[[commands.field]]
id = "run_string"
label = "Run string then stay interactive"
type = "string"
option = ["--run-string", "-r"]
sources = ["help"]

[[commands.field]]
id = "init_mac"
label = "Init file"
type = "path"
option = ["--init-mac"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["help"]

[[commands.field]]
id = "userdir"
label = "User directory"
type = "path"
option = ["--userdir"]
path = { kind = "directory", role = "input" }
sources = ["help"]

[[commands.field]]
id = "quiet"
label = "Quiet start-up"
type = "boolean"
option = ["--quiet", "-q"]
sources = ["help"]

[[commands.field]]
id = "very_quiet"
label = "Very quiet"
type = "boolean"
option = ["--very-quiet"]
sources = ["help"]

[[commands.field]]
id = "quit_on_error"
label = "Quit on error (exit code 1)"
type = "boolean"
option = ["--quit-on-error", "-Q"]
sources = ["help"]

[[commands.field]]
id = "no_init"
label = "Skip init files"
type = "boolean"
option = ["--no-init", "--norc"]
sources = ["help"]

[[commands.field]]
id = "no_echo"
label = "Suppress input echo"
type = "boolean"
option = ["--suppress-input-echo"]
sources = ["help"]

[[commands.task]]
id = "batch_file"
label = "Run a batch file"
fields = ["batch", "quiet", "quit_on_error", "no_echo"]
required = ["batch"]

[[commands.task]]
id = "evaluate"
label = "Evaluate an expression"
fields = ["batch_string", "very_quiet", "quit_on_error"]
required = ["batch_string"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["batch", "batch_string", "run_string", "quiet", "quit_on_error"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["init_mac", "userdir", "very_quiet", "no_init", "no_echo"]