id       = "aerc"
name     = "aerc"
homepage = "https://aerc-mail.org"
description = "aerc is an email client that runs in your terminal."
executables = ["aerc"]
platforms = ["macos", "linux"]

[dotfiles]

# aerc-config(5) (https://man.archlinux.org/man/aerc-config.5): "aerc uses three
# configuration files: aerc.conf, binds.conf and accounts.conf. […] We look for
# these files in your XDG config home plus _aerc_, which defaults to
# _~/.config/aerc_." That is the XDG config home on macOS as well as Linux,
# which is [configHome]; aerc has no Windows build. The files are ini format,
# so they are line oriented.
paths = [
  "[configHome]/aerc/aerc.conf",
  "[configHome]/aerc/binds.conf",
]

exclude = []

# Same man page, about accounts.conf: "The last one must be kept secret, as it
# may include your account credentials." aerc refuses to start when the file is
# readable by anyone else, so the whole file is treated as a credential rather
# than picked apart — the IMAP/SMTP URLs in `source` and `outgoing` carry the
# password inline.
secret = ["[configHome]/aerc/accounts.conf"]

# No machine_lines: aerc.conf is the pager, the styleset name, the index format
# and the key bindings — preferences a user wants on every machine. Paths do
# appear (`styleset-dirs`, `pager`), but they are as often a bare command or a
# relative directory as an absolute path, so a prefix rule on them would strip
# more preference than machine detail.

[commands]
format = 1
label = "Start aerc"
description = "Launch aerc, optionally limited to some accounts or using alternate config files. mailto: and mbox: arguments and :commands are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "man"
kind = "manual"
url = "https://man.archlinux.org/man/aerc.1"
revision = "aerc(1)"
evidence = """
aerc [-h] [-v] [-a <name>] [-C <file>] [-A <file>] [-B <file>] [-I] [mailto:<...> | mbox:<file> | :<command...>]
-a <name>, --account <name>  Load only the named account, as opposed to all configured accounts. It can also be a comma separated list of names. This option may be specified multiple times.
-C </path/to/aerc.conf>, --aerc-conf </path/to/aerc.conf>  Instead of using $XDG_CONFIG_HOME/aerc/aerc.conf use the file at the specified path for configuring aerc.
-A </path/to/accounts.conf>, --accounts-conf </path/to/accounts.conf>  Instead of using $XDG_CONFIG_HOME/aerc/accounts.conf use the file at the specified path for configuring accounts.
-B </path/to/binds.conf>, --binds-conf </path/to/binds.conf>  Instead of using $XDG_CONFIG_HOME/aerc/binds.conf use the file at the specified path for configuring binds.
-I, --no-ipc  Run commands directly in this instance rather than over IPC in an existing aerc instance.
"""

[[commands.field]]
id = "account"
label = "Account"
description = "Load only this account; repeat for several."
type = "string"
option = ["--account", "-a"]
multiple = true
sources = ["man"]

[[commands.field]]
id = "aerc_conf"
label = "aerc.conf"
type = "path"
option = ["--aerc-conf", "-C"]
path = { kind = "file", role = "input" }
sources = ["man"]

[[commands.field]]
id = "accounts_conf"
label = "accounts.conf"
type = "path"
option = ["--accounts-conf", "-A"]
path = { kind = "file", role = "input" }
sources = ["man"]

[[commands.field]]
id = "binds_conf"
label = "binds.conf"
type = "path"
option = ["--binds-conf", "-B"]
path = { kind = "file", role = "input" }
sources = ["man"]

[[commands.field]]
id = "no_ipc"
label = "Do not use IPC"
type = "boolean"
option = ["--no-ipc", "-I"]
sources = ["man"]

[[commands.task]]
id = "one_account"
label = "Open one account"
fields = ["account"]
required = ["account"]

[[commands.task]]
id = "alt_config"
label = "Use alternate config files"
fields = ["aerc_conf", "accounts_conf", "binds_conf", "no_ipc"]
required = ["accounts_conf"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["account", "no_ipc"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["aerc_conf", "accounts_conf", "binds_conf"]