id       = "bpytop"
name     = "bpytop"
homepage = "https://github.com/aristocratos/bpytop"
description = "Resource monitor that shows usage and stats for processor, memory, disks, network and processes."
executables   = ["bpytop"]
platforms = ["macos", "linux"]

[dotfiles]

# The project's README (Configurability) says config files are stored in
# "$HOME/.config/bpytop" and documents bpytop.cfg plus user-created themes.
# This is an explicit XDG-style path on both supported platforms, so it is
# written literally rather than using macOS's Application Support root.
# https://github.com/aristocratos/bpytop#configurability
paths = [
  "[configHome]/bpytop/bpytop.cfg",
  "[configHome]/bpytop/themes/",
]
exclude = [
  "[configHome]/bpytop/error.log",
]
secret  = []

[commands]
format = 1
label = "Start bpytop"
description = "Start the resource monitor, choosing the boxes shown at start and the color mode. Settings in bpytop.cfg and the interactive menu 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 = "help"
url = "https://raw.githubusercontent.com/aristocratos/bpytop/HEAD/README.md"
revision = "README command line options"
evidence = """
usage: bpytop.py [-h] [-b BOXES] [-lc] [-v] [--debug]
  -b BOXES, --boxes BOXES
                        which boxes to show at start, example: -b "cpu mem net proc"
  -lc, --low-color      disable truecolor, converts 24-bit colors to 256-color
  --debug               start with loglevel set to DEBUG overriding value set in config
"""

[[commands.field]]
id = "boxes"
label = "Boxes at start"
description = "Space-separated list of boxes to show, for example cpu mem net proc."
type = "string"
option = ["--boxes", "-b"]
suggestions = [{ value = "cpu mem net proc", label = "All boxes" }, { value = "cpu proc", label = "CPU and processes" }]
sources = ["readme"]

[[commands.field]]
id = "low_color"
label = "Low color mode"
description = "Disable truecolor and convert 24-bit colors to 256-color."
type = "boolean"
option = ["-lc", "--low-color"]
sources = ["readme"]

[[commands.field]]
id = "debug"
label = "Debug logging"
description = "Start with loglevel set to DEBUG, overriding the config value."
type = "boolean"
option = ["--debug"]
sources = ["readme"]

[[commands.task]]
id = "start"
label = "Start monitor"
fields = ["boxes", "low_color", "debug"]
required = []

[[commands.task]]
id = "low_color"
label = "Start for a 256-color terminal"
fields = ["boxes", "low_color"]
required = []
set = { low_color = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["boxes", "low_color", "debug"]