id       = "eza"
name     = "eza"
homepage = "https://github.com/eza-community/eza"
description = "A modern alternative to ls."
# The eza mark, from the eza-community organisation's avatar.
icon     = "https://github.com/eza-community.png"
executables   = ["eza"]

[dotfiles]

# src/options/theme.rs ThemeConfig::deduce(): $EZA_CONFIG_DIR when set, else
# dirs::config_dir()/eza; in either directory theme.yml is tried first and
# theme.yaml second. The `dirs` crate resolves config_dir() to the [appData]
# base directory — ~/Library/Application Support on macOS, $XDG_CONFIG_HOME or
# ~/.config on Linux, %APPDATA% on Windows — so the man page's XDG spelling is
# only the Linux half of it.
paths = [
  "[appData]/eza/theme.yml",
  "[appData]/eza/theme.yaml",
]

exclude = []

secret = []

# Parsed once per invocation; eza exits before anything can rewrite it.
side_effect = false

# No machine_lines: the theme file is colours and icons, which is exactly the
# part a user wants to follow them between machines.

[commands]
format = 1
label = "List files"
description = "List directory contents with eza. Covers common display, filtering and sorting flags only."
quality = "ai-draft"
base = "fig:eza"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/eza.ts"
license = "MIT"

[[commands.field]]
id = "value"
label = "Paths"
type = "path"
position = 0
multiple = true
path = { kind = "any", role = "input" }
sources = ["fig"]

[[commands.field]]
id = "long"
label = "Long format"
type = "boolean"
option = ["--long", "-l"]
sources = ["fig"]

[[commands.field]]
id = "tree"
label = "Tree"
type = "boolean"
option = ["--tree", "-T"]
sources = ["fig"]

[[commands.field]]
id = "all"
label = "Show hidden"
type = "boolean"
option = ["--all", "-a"]
sources = ["fig"]

[[commands.field]]
id = "oneline"
label = "One per line"
type = "boolean"
option = ["--oneline", "-1"]
sources = ["fig"]

[[commands.field]]
id = "recurse"
label = "Recurse"
type = "boolean"
option = ["--recurse", "-R"]
sources = ["fig"]

[[commands.field]]
id = "level"
label = "Depth limit"
type = "integer"
option = ["--level", "-L"]
sources = ["fig"]

[[commands.field]]
id = "only_dirs"
label = "Only directories"
type = "boolean"
option = ["--only-dirs", "-D"]
sources = ["fig"]

[[commands.field]]
id = "only_files"
label = "Only files"
type = "boolean"
option = ["--only-files", "-f"]
sources = ["fig"]

[[commands.field]]
id = "sort"
label = "Sort by"
type = "string"
option = ["--sort", "-s"]
suggestions = [{ value = "name", label = "name" }, { value = "Name", label = "Name" }, { value = "extension", label = "extension" }, { value = "Extension", label = "Extension" }, { value = "size", label = "size" }, { value = "modified", label = "modified" }, { value = "changed", label = "changed" }, { value = "accessed", label = "accessed" }, { value = "created", label = "created" }, { value = "inode", label = "inode" }, { value = "type", label = "type" }, { value = "none", label = "none" }, { value = "date", label = "date" }, { value = "age", label = "age" }]
sources = ["fig"]

[[commands.field]]
id = "reverse"
label = "Reverse sort"
type = "boolean"
option = ["--reverse", "-r"]
sources = ["fig"]

[[commands.field]]
id = "group_directories_first"
label = "Directories first"
type = "boolean"
option = ["--group-directories-first"]
sources = ["fig"]

[[commands.field]]
id = "git"
label = "Git status"
type = "boolean"
option = ["--git"]
sources = ["fig"]

[[commands.field]]
id = "git_ignore"
label = "Respect .gitignore"
type = "boolean"
option = ["--git-ignore"]
sources = ["fig"]

[[commands.field]]
id = "header"
label = "Header row"
type = "boolean"
option = ["--header", "-h"]
sources = ["fig"]

[[commands.field]]
id = "icons"
label = "Icons"
type = "string"
option = ["--icons"]
suggestions = [{ value = "auto", label = "auto" }, { value = "always", label = "always" }, { value = "never", label = "never" }]
sources = ["fig"]

[[commands.field]]
id = "total_size"
label = "Directory total size"
type = "boolean"
option = ["--total-size"]
sources = ["fig"]

[[commands.task]]
id = "long"
label = "Long listing"
set = { long = [true], header = [true] }
fields = ["value", "long", "header", "all", "sort", "git"]

[[commands.task]]
id = "tree"
label = "Tree view"
set = { tree = [true] }
fields = ["value", "tree", "level", "all", "git_ignore"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["value", "long", "tree", "all", "oneline", "level", "only_dirs", "sort", "git", "icons"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["reverse", "group_directories_first", "git_ignore", "header", "total_size", "recurse", "only_files"]