id          = "ponysay"
name        = "ponysay"
homepage    = "https://github.com/erkin/ponysay/"
description = "Cowsay but with ponies"
executables      = ["ponysay", "ponythink"]

[dotfiles]

# https://github.com/erkin/ponysay/blob/master/manuals/ponysay.texinfo —
# the manual documents ~/.ponysayrc and the XDG fallback
# $XDG_CONFIG_HOME/ponysay/ponysayrc. These are user-authored display settings.
paths = ["~/.ponysayrc", "[configHome]/ponysay/ponysayrc"]

# The ~/.cache/ponysay directory documented by the manual is generated cache,
# not configuration.
exclude = ["[xdgCache]/ponysay/"]
secret  = []


[commands]
format = 1
label = "Say something"
description = "Print a pony saying a message. Pony and quote selection only; list modes and rendering tweaks are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "readme"
kind = "manual"
url = "https://github.com/erkin/ponysay/blob/master/README.md"
revision = "2026-10-27"
evidence = """
ponysay "I am just the cutest pony!"
ponysay -f pinkie "Partay!~"
Running `ponysay -q` will print a random pony saying one of its quotes from My Little Pony: Friendship is Magic. The pony can be specified: `ponysay -q pinkie`.
When running `ponysay -l` or `ponysay -L` the ponies with quotes will be printed in bold or bright
"""

[[commands.field]]
id = "message"
label = "Message"
description = "Leave empty with Quote, or pipe text in."
type = "string"
position = 0
sources = ["readme"]

[[commands.field]]
id = "pony"
label = "Pony"
description = "Pony name, e.g. pinkie."
type = "string"
option = ["-f"]
sources = ["readme"]

[[commands.field]]
id = "quote"
label = "Random quote"
description = "Print a pony saying one of its quotes."
type = "boolean"
option = ["-q"]
sources = ["readme"]

[[commands.field]]
id = "list"
label = "List ponies"
type = "boolean"
option = ["-l"]
sources = ["readme"]

[[commands.task]]
id = "say"
label = "Say a message"
fields = ["message", "pony"]
required = ["message"]

[[commands.task]]
id = "quote"
label = "Random quote"
set = { quote = [true] }
lock = ["quote"]
fields = ["quote", "pony"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["message", "pony", "quote", "list"]