id       = "minicom"
name     = "minicom"
homepage = "https://salsa.debian.org/minicom-team/minicom"
description = "A menu-driven terminal emulator for serial communication."
executables   = ["minicom"]

[dotfiles]

# https://man7.org/linux/man-pages/man1/minicom.1.html — minicom normally
# reads minirc.dfl, and a user-created setup is saved as ~/.minirc.dfl; named
# per-device variants use ~/.minirc.configuration.
paths = [
  "~/.minirc.dfl",
  "~/.minirc.*",
]
secret = []
side_effect = false

[commands]
format = 1
label = "Open a serial terminal"
description = "Start minicom on a serial device with common overrides. Setup mode, scripts, status-line formats and character-set options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "man"
kind = "manual"
url = "https://man7.org/linux/man-pages/man1/minicom.1.html"
revision = "minicom(1)"
evidence = """-D, --device
            Specify the device, overriding the value given in the
-b, --baudrate
            Specify the baud rate, overriding the value given in the
-C, --capturefile=FILE
            filename.  Open capture file at startup.
-d, --dial=ENTRY
-t, --term=TERM
-c, --color=on/off
-w, --wrap
-H, --displayhex
-m, --metakey
-o, --noinit
-s, --setup
-7, --7bit
-8, --8bit
[configuration] argument: minicom [options] [configuration]"""

[[commands.field]]
id = "device"
label = "Serial device"
type = "path"
path = { kind = "file", role = "input" }
option = ["--device", "-D"]
sources = ["man"]

[[commands.field]]
id = "baudrate"
label = "Baud rate"
type = "integer"
option = ["--baudrate", "-b"]
sources = ["man"]

[[commands.field]]
id = "capture"
label = "Capture file"
type = "path"
path = { kind = "file", role = "output" }
option = ["--capturefile", "-C"]
sources = ["man"]

[[commands.field]]
id = "dial"
label = "Dial entry"
type = "string"
option = ["--dial", "-d"]
sources = ["man"]

[[commands.field]]
id = "term"
label = "Terminal type"
type = "string"
option = ["--term", "-t"]
sources = ["man"]

[[commands.field]]
id = "color"
label = "Color"
type = "enum"
option = ["--color", "-c"]
choices = [{ value = "on", label = "On" }, { value = "off", label = "Off" }]
sources = ["man"]

[[commands.field]]
id = "wrap"
label = "Line wrap at startup"
type = "boolean"
option = ["--wrap", "-w"]
sources = ["man"]

[[commands.field]]
id = "displayhex"
label = "Hex output"
type = "boolean"
option = ["--displayhex", "-H"]
sources = ["man"]

[[commands.field]]
id = "metakey"
label = "Meta/Alt as command key"
type = "boolean"
option = ["--metakey", "-m"]
sources = ["man"]

[[commands.field]]
id = "noinit"
label = "Skip modem initialisation"
description = "Skips lock-file checks; use only after quitting without reset."
type = "boolean"
option = ["--noinit", "-o"]
sources = ["man"]

[[commands.task]]
id = "open"
label = "Open device at baud rate"
fields = ["device", "baudrate"]
required = ["device"]

[[commands.task]]
id = "capture"
label = "Open with capture file"
fields = ["device", "baudrate", "capture"]
required = ["device", "capture"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["device", "baudrate", "capture", "dial"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["term", "color", "wrap", "displayhex", "metakey", "noinit"]