id = "ecl"
name = "Embeddable Common-Lisp"
homepage = "https://ecl.common-lisp.dev/"
description = "Embeddable Common Lisp is an implementation of the Common-Lisp language."
executables = ["ecl"]

[dotfiles]

# ECL's official operating-system interface manual lists ~/.ecl and ~/.eclrc
# as its initialization files; the first existing file is loaded automatically.
# https://ecl.common-lisp.dev/static/manual/Operating-System-Interface.html
paths = ["~/.ecl", "~/.eclrc"]
secret = []

[commands]
format = 1
label = "Run Lisp or compile"
description = "Run a Lisp script, load files or evaluate before the REPL, or compile a file to a native program. Linking, encodings and stack/heap sizing are not covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "manpage"
kind = "manual"
url = "https://manpages.debian.org/unstable/ecl/ecl.1.en.html"
revision = "2026-10-27"
evidence = """
  -?, --help
  -v, --version,
  --norc
  --load file
  --shell file
  --eval file
  -o file
  -q
  --compile file
  Evaluate the file before loading the .rc file and starting
  --shell file
  Executes the given file and exits, without providing a
  --compile file
  Translates file to C and invokes the local C compiler to produce a
  -o file
  Provide the output target file for compilation.
  -q
  Short for quiet -- produce less notes.
"""

[[commands.field]]
id = "shell"
label = "Run script and exit"
type = "path"
option = ["--shell"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["manpage"]

[[commands.field]]
id = "load"
label = "Load file first"
type = "path"
option = ["--load"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["manpage"]

[[commands.field]]
id = "eval"
label = "Evaluate expression"
description = "The manual calls the value a file; ECL evaluates it before the REPL starts."
type = "string"
option = ["--eval"]
sources = ["manpage"]

[[commands.field]]
id = "norc"
label = "Skip configuration files"
type = "boolean"
option = ["--norc"]
sources = ["manpage"]

[[commands.field]]
id = "compile"
label = "Compile file to native program"
type = "path"
option = ["--compile"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["manpage"]

[[commands.field]]
id = "output"
label = "Compile output file"
type = "path"
option = ["-o"]
path = { kind = "file", role = "output", must_exist = false }
effect = "overwrite"
sources = ["manpage"]

[[commands.field]]
id = "quiet"
label = "Quiet compile"
type = "boolean"
option = ["-q"]
sources = ["manpage"]

[[commands.task]]
id = "script"
label = "Run a script"
fields = ["shell", "norc"]
required = ["shell"]

[[commands.task]]
id = "compile"
label = "Compile a file"
fields = ["compile", "output", "quiet"]
required = ["compile"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["shell", "load", "eval", "compile", "output"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["norc", "quiet"]