id       = "hyfetch"
name     = "HyFetch"
homepage = "https://github.com/hykilpikonna/hyfetch"
description = "Neofetch with pride flags."
executables   = ["hyfetch", "neowofetch"]

[dotfiles]

# HyFetch's upstream README and issue examples identify ~/.config/hyfetch.json
# as its configuration file. Neofetch/neowofetch's separate config is owned by
# the existing neofetch entry and is intentionally not duplicated here.
# https://github.com/hykilpikonna/hyfetch#questions-and-answers
# https://github.com/hykilpikonna/hyfetch/issues/373
paths = ["[configHome]/hyfetch.json"]
exclude = []
secret = []
side_effect = false

[commands]
format = 1
label = "Run HyFetch"
description = "Show system info with a pride-flag colored logo. Color tuning (--c-scale, --c-set-l) and test options are not in this form."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "src"
kind = "help"
url = "https://github.com/hykilpikonna/hyfetch/blob/master/hyfetch/main.py"
revision = "2026-10-27"
evidence = """
    parser.add_argument('-c', '--config', action='store_true', help=color(f'Configure hyfetch'))
    parser.add_argument('-C', '--config-file', dest='config_file', default=CONFIG_PATH, help=f'Use another config file')
    parser.add_argument('-p', '--preset', help=f'Use preset or comma-separated hex color list (e.g., "#ff0000,#00ff00,#0000ff")')
    parser.add_argument('-m', '--mode', help=f'Color mode', choices=['8bit', 'rgb'])
    parser.add_argument('-b', '--backend', help=f'Choose a *fetch backend', choices=['qwqfetch', 'neofetch', 'fastfetch', 'fastfetch-old'])
    parser.add_argument('-r', '--random-alignment', action='store_true', help=color(f'Use a fresh random color alignment every time, independent of config'))
    parser.add_argument('--ascii-file', help='Use a specific file for the ascii art')
"""

[[commands.field]]
id = "config"
label = "Run configuration wizard"
type = "boolean"
option = ["--config", "-c"]
sources = ["src"]

[[commands.field]]
id = "config_file"
label = "Config file"
type = "path"
option = ["--config-file", "-C"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["src"]

[[commands.field]]
id = "preset"
label = "Flag preset or hex colors"
description = "A preset name or comma-separated hex colors."
type = "string"
option = ["--preset", "-p"]
sources = ["src"]

[[commands.field]]
id = "mode"
label = "Color mode"
type = "enum"
option = ["--mode", "-m"]
choices = [{ value = "8bit", label = "8-bit" }, { value = "rgb", label = "RGB" }]
sources = ["src"]

[[commands.field]]
id = "backend"
label = "Fetch backend"
type = "enum"
option = ["--backend", "-b"]
choices = [{ value = "qwqfetch", label = "qwqfetch" }, { value = "neofetch", label = "neofetch" }, { value = "fastfetch", label = "fastfetch" }, { value = "fastfetch-old", label = "fastfetch (old)" }]
sources = ["src"]

[[commands.field]]
id = "random_alignment"
label = "Random color alignment"
type = "boolean"
option = ["--random-alignment", "-r"]
sources = ["src"]

[[commands.field]]
id = "ascii_file"
label = "Custom ASCII art file"
type = "path"
option = ["--ascii-file"]
path = { kind = "file", role = "input", must_exist = true }
sources = ["src"]

[[commands.task]]
id = "show"
label = "Show with a preset"
fields = ["preset", "mode", "backend", "random_alignment"]
required = []

[[commands.task]]
id = "configure"
label = "Configure"
set = { config = [true] }
lock = ["config"]
fields = ["config", "config_file"]
required = []

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["preset", "mode", "backend", "random_alignment", "config"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["config_file", "ascii_file"]