id          = "ov"
name        = "ov"
homepage    = "https://github.com/noborus/ov"
description = "A feature-rich terminal-based text viewer and pager."
executables      = ["ov"]

[dotfiles]
paths       = ["[configHome]/ov/config.yaml", "~/.ov.yaml", "%USERPROFILE%/.ov.yaml"]
secret      = []

# ov's upstream README lists config.yaml under the user config directory and
# .ov.yaml in the home directory as its user configuration locations.
# https://github.com/noborus/ov

[commands]
format = 1
label = "View files"
description = "Open files in the ov pager with a pinned header, column mode, following or a filter. Section, sidebar and key-binding options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "readme"
kind = "manual"
url = "https://github.com/noborus/ov"
evidence = """
| -C,   | --alternate-rows                           | highlight even and odd rows in alternating colors |
| -d,   | --column-delimiter character               | column delimiter character (default ",") |
| -c,   | --column-mode                              | split content into columns at the delimiter |
| -X,   | --exit-write                               | output the current screen when exiting |
| -A,   | --follow-all                               | follow multiple files and show the most recently updated one |
| -f,   | --follow-mode                              | monitor file and display new content as it is written |
| -H,   | --header int                               | number of lines to pin as a fixed header |
| -n,   | --line-number                              | show line numbers |
| -F,   | --quit-if-one-screen                       | quit if the output fits on one screen |
`--filter`
"""

[[commands.field]]
id = "files"
label = "Files"
type = "path"
position = 0
multiple = true
path = { kind = "file", role = "input", must_exist = true }
sources = ["readme"]

[[commands.field]]
id = "header"
label = "Header lines"
type = "integer"
option = ["--header", "-H"]
sources = ["readme"]

[[commands.field]]
id = "column_mode"
label = "Column mode"
type = "boolean"
option = ["--column-mode", "-c"]
sources = ["readme"]

[[commands.field]]
id = "column_delimiter"
label = "Column delimiter"
type = "string"
option = ["--column-delimiter", "-d"]
sources = ["readme"]

[[commands.field]]
id = "filter"
label = "Filter"
type = "string"
option = ["--filter"]
sources = ["readme"]

[[commands.field]]
id = "follow_mode"
label = "Follow appended data"
type = "boolean"
option = ["--follow-mode", "-f"]
sources = ["readme"]

[[commands.field]]
id = "follow_all"
label = "Follow all files"
type = "boolean"
option = ["--follow-all", "-A"]
sources = ["readme"]

[[commands.field]]
id = "line_number"
label = "Line numbers"
type = "boolean"
option = ["--line-number", "-n"]
sources = ["readme"]

[[commands.field]]
id = "alternate_rows"
label = "Alternate row colors"
type = "boolean"
option = ["--alternate-rows", "-C"]
sources = ["readme"]

[[commands.field]]
id = "quit_if_one_screen"
label = "Quit if one screen"
type = "boolean"
option = ["--quit-if-one-screen", "-F"]
sources = ["readme"]

[[commands.field]]
id = "exit_write"
label = "Print screen on exit"
type = "boolean"
option = ["--exit-write", "-X"]
sources = ["readme"]

[[commands.task]]
id = "csv"
label = "View CSV as columns"
fields = ["files", "header", "column_mode", "column_delimiter"]
required = ["files"]
set = { column_mode = [true], header = [1] }

[[commands.task]]
id = "follow"
label = "Follow a log"
fields = ["files", "follow_mode"]
required = ["files"]
set = { follow_mode = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["files", "header", "column_mode", "column_delimiter", "filter", "follow_mode"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["follow_all", "line_number", "alternate_rows", "quit_if_one_screen", "exit_write"]