id = "apt-dater"
name = "apt-dater"
homepage = "https://github.com/DE-IBH/apt-dater"
description = "apt-dater - terminal-based remote package update manager"
executables = ["apt-dater"]

[dotfiles]

# apt-dater's manual identifies apt-dater.xml and hosts.xml as user-scoped XDG
# configuration. The upstream source also creates screenrc (or tmux.conf when
# built with tmux); hosts.conf/apt-dater.conf are legacy inputs converted to
# the XML names, so all shipped spellings are retained here.
# https://manpages.debian.org/unstable/apt-dater/apt-dater.8.en.html
# https://github.com/DE-IBH/apt-dater/blob/master/src/keyfiles.c
paths = [
  "[configHome]/apt-dater/apt-dater.xml",
  "[configHome]/apt-dater/hosts.xml",
  "[configHome]/apt-dater/apt-dater.conf",
  "[configHome]/apt-dater/hosts.conf",
  "[configHome]/apt-dater/screenrc",
  "[configHome]/apt-dater/tmux.conf",
]
secret = []

[commands]
format = 1
label = "Run apt-dater"
description = "Start the apt-dater terminal UI with an alternative config file, or print version information. XML report mode is 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://manpages.debian.org/unstable/apt-dater/apt-dater.8.en.html"
revision = "1.0.4+git20260113-3"
evidence = """
-c config
Use alternative config file. Default is
  $XDG_CONFIG_HOME/apt-dater/apt-dater.xml.
-v
Show apt-dater version and copyright statement.
"""

[[commands.field]]
id = "config"
label = "Config file"
description = "Defaults to $XDG_CONFIG_HOME/apt-dater/apt-dater.xml."
type = "path"
option = ["-c"]
path = { kind = "file", role = "input" }
sources = ["man"]

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

[[commands.task]]
id = "start"
label = "Start with a config file"
fields = ["config"]
required = ["config"]

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

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