id          = "tidy-viewer"
name        = "Tidy Viewer"
homepage    = "https://github.com/alexhallam/tv"
description = "CLI csv pretty printer"
executables      = ["tidy-viewer", "tv"]

[dotfiles]

# https://github.com/alexhallam/tv#help documents tv.toml in the XDG config
# home on Linux, Application Support on macOS, and RoamingAppData on Windows.
paths = ["[configHome]/tv.toml", "[appData]/tv.toml", "%APPDATA%/tv.toml"]
secret = []

[commands]
format = 1
label = "View CSV in the terminal"
description = "Pretty-print a delimited file as an aligned table. Column-width and decimal tuning are mostly left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "help"
kind = "help"
url = "https://github.com/alexhallam/tv"
revision = "README"
evidence = """
    tv [FLAGS] [OPTIONS] [FILE]
    -e, --extend-width-and-length       Extended width beyond term width (do not truncate). Useful with `less -S`.
    -f, --force-all-rows                Print all rows in file. May be piped to 'less -S'.
    -a, --color-always                  Always force color output.
    -D, --no-dimensions                 Turns off dimensions of the data
    -R, --no-row-numbering              Turns off row numbering
    -s, --delimiter <delimiter>                      The delimiter separating the columns.
    -F, --footer <footer>                            Add a footer to your tv. Example 'footer info' [default: NA]
    -n, --number-of-rows-to-output <row-display>     Show how many rows to display. [default: 25]
    -g, --sigfig <sigfig>                            Significant Digits. Default 3. Max is 7 [default: 3]
    -t, --title <title>                              Add a title to your tv. Example 'Test Data' [default: NA]
    -u, --upper-column-width <upper-column-width>    The upper (maximum) width of columns. [default: 20]
"""

[[commands.field]]
id = "file"
label = "Data file"
type = "path"
path = { kind = "file", role = "input" }
position = 0
sources = ["help"]

[[commands.field]]
id = "delimiter"
label = "Delimiter"
type = "string"
option = ["--delimiter", "-s"]
suggestions = [{ value = ",", label = "Comma" }, { value = "\t", label = "Tab" }, { value = ";", label = "Semicolon" }]
sources = ["help"]

[[commands.field]]
id = "rows"
label = "Rows to show"
type = "integer"
option = ["--number-of-rows-to-output", "-n"]
sources = ["help"]

[[commands.field]]
id = "all_rows"
label = "Show all rows"
type = "boolean"
option = ["--force-all-rows", "-f"]
sources = ["help"]

[[commands.field]]
id = "title"
label = "Title"
type = "string"
option = ["--title", "-t"]
sources = ["help"]

[[commands.field]]
id = "footer"
label = "Footer"
type = "string"
option = ["--footer", "-F"]
sources = ["help"]

[[commands.field]]
id = "sigfig"
label = "Significant digits"
type = "integer"
option = ["--sigfig", "-g"]
sources = ["help"]

[[commands.field]]
id = "upper_width"
label = "Maximum column width"
type = "integer"
option = ["--upper-column-width", "-u"]
sources = ["help"]

[[commands.field]]
id = "extend"
label = "Do not truncate to terminal width"
type = "boolean"
option = ["--extend-width-and-length", "-e"]
sources = ["help"]

[[commands.field]]
id = "color_always"
label = "Always color"
type = "boolean"
option = ["--color-always", "-a"]
sources = ["help"]

[[commands.field]]
id = "no_row_numbers"
label = "Hide row numbers"
type = "boolean"
option = ["--no-row-numbering", "-R"]
sources = ["help"]

[[commands.field]]
id = "no_dimensions"
label = "Hide dimensions"
type = "boolean"
option = ["--no-dimensions", "-D"]
sources = ["help"]

[[commands.task]]
id = "view"
label = "View a file"
fields = ["file", "delimiter", "rows"]
required = ["file"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["file", "delimiter", "rows", "all_rows", "title", "footer"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["sigfig", "upper_width", "extend", "color_always", "no_row_numbers", "no_dimensions"]