id       = "gcalcli"
name     = "gcalcli"
homepage = "https://github.com/insanum/gcalcli"
description = "Easily access your Google Calendar(s) from a command-line."
executables   = ["gcalcli"]

[dotfiles]

# https://github.com/insanum/gcalcli/blob/master/docs/README.md documents the
# legacy ~/.gcalclirc flag file and ~/.gcalcli_oauth token. Current gcalcli's
# man page documents ~/.config/gcalcli/config.toml and gcalclirc, with OAuth
# migrated to the platform data directory.
paths = [
  "~/.gcalclirc",
  "[configHome]/gcalcli/config.toml",
  "[configHome]/gcalcli/gcalclirc",
]
secret = ["~/.gcalcli_oauth", "[dataHome]/gcalcli/oauth"]

[commands]
format = 1
label = "Run a calendar command"
description = "Run a gcalcli subcommand such as agenda, calw, calm, quick or list with the global display options. Per-subcommand options are left out; pass them in the extra arguments."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.source]]
id = "man"
kind = "manual"
url = "https://manpages.debian.org/testing/gcalcli/gcalcli.1.en.html"
revision = "4.5.1-1.1"
evidence = """
{init,list,search,edit,delete,agenda,agendaupdate,updates,conflicts,calw,calm,quick,add,import,remind,config,util}
--calendar GLOBAL_CALENDARS
--default-calendar DEFAULT_CALENDARS
--refresh Delete and refresh cached data (default: False)
--nocache Execute command without using cache (default: True)
--nocolor Enable/Disable all color output (default: True)
--lineart {fancy,unicode,ascii}
--locale LOCALE System locale (default: )
"""

[[commands.field]]
id = "command"
label = "Subcommand"
type = "enum"
position = 0
choices = [{ value = "agenda", label = "agenda" }, { value = "calw", label = "calw (week)" }, { value = "calm", label = "calm (month)" }, { value = "quick", label = "quick (quick-add event)" }, { value = "add", label = "add (detailed event)" }, { value = "search", label = "search" }, { value = "list", label = "list calendars" }, { value = "edit", label = "edit" }, { value = "delete", label = "delete" }, { value = "conflicts", label = "conflicts" }, { value = "import", label = "import" }, { value = "init", label = "init" }]
sources = ["man"]

[[commands.field]]
id = "args"
label = "Subcommand arguments"
description = "Positional arguments such as a start date or event text."
type = "string"
position = 1
multiple = true
min = 0
sources = ["man"]

[[commands.field]]
id = "calendar"
label = "Calendar"
type = "string"
option = ["--calendar"]
multiple = true
sources = ["man"]

[[commands.field]]
id = "default_calendar"
label = "Default calendar"
type = "string"
option = ["--default-calendar"]
sources = ["man"]

[[commands.field]]
id = "nocolor"
label = "No color"
type = "boolean"
option = ["--nocolor"]
sources = ["man"]

[[commands.field]]
id = "lineart"
label = "Line art style"
type = "enum"
option = ["--lineart"]
choices = [{ value = "fancy", label = "Fancy" }, { value = "unicode", label = "Unicode" }, { value = "ascii", label = "ASCII" }]
sources = ["man"]

[[commands.field]]
id = "refresh"
label = "Refresh cache"
type = "boolean"
option = ["--refresh"]
sources = ["man"]

[[commands.field]]
id = "nocache"
label = "Bypass cache"
type = "boolean"
option = ["--nocache"]
sources = ["man"]

[[commands.task]]
id = "agenda"
label = "Show agenda"
set = { command = ["agenda"] }
lock = ["command"]
fields = ["command", "args", "calendar", "nocolor"]
required = ["command"]

[[commands.task]]
id = "quick-add"
label = "Quick-add an event"
set = { command = ["quick"] }
lock = ["command"]
fields = ["command", "args", "calendar"]
required = ["command", "args"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["command", "args", "calendar"]
[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["default_calendar", "nocolor", "lineart", "refresh", "nocache"]