id       = "clock-rs"
name     = "clock-rs"
homepage = "https://github.com/Oughie/clock-rs"
description = "Modern, digital clock that effortlessly runs in your terminal"
executables   = ["clock-rs"]

[dotfiles]

# https://github.com/Oughie/clock-rs#configuration — the upstream README
# documents conf.toml in the OS configuration directory for each platform.
paths = [
  "~/.config/clock-rs/conf.toml",
  "~/Library/Application Support/clock-rs/conf.toml",
  "%LOCALAPPDATA%/clock-rs/conf.toml",
]
secret = []

[commands]
format = 1
label = "Show a clock"
description = "Display the current time in the terminal. The timer subcommand has its own form."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "help"
kind = "help"
url = "https://github.com/Oughie/clock-rs#usage"
revision = "2026-10-27"
evidence = """
Usage: clock-rs [OPTIONS] [COMMAND]
  -c, --color <COLOR>        Specify the clock color
  -i, --interval <INTERVAL>  Set the polling interval in milliseconds
  -B, --blink                Set the colon to blink
  -b, --bold                 Use bold text
  -x, --x-pos <X_POS>        Set the position along the horizontal axis
  -y, --y-pos <Y_POS>        Set the position along the vertical axis
      --fmt <FMT>            Set the date format
  -t                         Use the 12h format
      --utc                  Use UTC time
  -s, --hide-seconds         Do not show seconds
"""

[[commands.field]]
id = "color"
label = "Color"
type = "string"
option = ["--color", "-c"]
sources = ["help"]

[[commands.field]]
id = "blink"
label = "Blinking colon"
type = "boolean"
option = ["--blink", "-B"]
sources = ["help"]

[[commands.field]]
id = "bold"
label = "Bold"
type = "boolean"
option = ["--bold", "-b"]
sources = ["help"]

[[commands.field]]
id = "hour12"
label = "12-hour format"
type = "boolean"
option = ["-t"]
sources = ["help"]

[[commands.field]]
id = "utc"
label = "UTC time"
type = "boolean"
option = ["--utc"]
sources = ["help"]

[[commands.field]]
id = "hide_seconds"
label = "Hide seconds"
type = "boolean"
option = ["--hide-seconds", "-s"]
sources = ["help"]

[[commands.field]]
id = "fmt"
label = "Date format"
type = "string"
option = ["--fmt"]
sources = ["help"]

[[commands.field]]
id = "interval"
label = "Polling interval (ms)"
type = "integer"
option = ["--interval", "-i"]
sources = ["help"]

[[commands.field]]
id = "x_pos"
label = "X position"
type = "integer"
option = ["--x-pos", "-x"]
sources = ["help"]

[[commands.field]]
id = "y_pos"
label = "Y position"
type = "integer"
option = ["--y-pos", "-y"]
sources = ["help"]

[[commands.task]]
id = "clock"
label = "Show clock"
fields = ["color", "bold", "hour12", "hide_seconds"]
required = []

[[commands.task]]
id = "utc"
label = "UTC clock"
set = { utc = [true] }
lock = ["utc"]
fields = ["utc", "color", "hide_seconds"]
required = []

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["color", "bold", "hour12", "utc", "hide_seconds"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["blink", "fmt", "interval", "x_pos", "y_pos"]

[[commands.subcommand]]
path = ["timer"]
label = "Run a timer"

[[commands.subcommand.source]]
id = "help"
kind = "help"
url = "https://github.com/Oughie/clock-rs#usage"
revision = "2026-10-27"
evidence = """
Usage: clock-rs timer [OPTIONS]
  -S, --seconds <SECONDS>  Add seconds to the timer
  -M, --minutes <MINUTES>  Add minutes to the timer
  -H, --hours <HOURS>      Add hours to the timer
  -k, --kill               Terminate the application when the timer finishes
"""

[[commands.subcommand.field]]
id = "hours"
label = "Hours"
type = "integer"
option = ["--hours", "-H"]
sources = ["help"]

[[commands.subcommand.field]]
id = "minutes"
label = "Minutes"
type = "integer"
option = ["--minutes", "-M"]
sources = ["help"]

[[commands.subcommand.field]]
id = "seconds"
label = "Seconds"
type = "integer"
option = ["--seconds", "-S"]
sources = ["help"]

[[commands.subcommand.field]]
id = "kill"
label = "Exit when finished"
type = "boolean"
option = ["--kill", "-k"]
sources = ["help"]

[[commands.subcommand.task]]
id = "five"
label = "5 minute timer"
set = { minutes = [5] }
fields = ["minutes", "seconds", "hours", "kill"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["hours", "minutes", "seconds", "kill"]