id       = "lsd"
name     = "lsd"
homepage = "https://github.com/lsd-rs/lsd"
description = "A rewrite of GNU ls with lots of added features like colors, icons, tree-view, more formatting options etc."
# The project's crab mark, from its GitHub organisation avatar.
icon     = "https://github.com/lsd-rs.png?size=200"
executables   = ["lsd"]

[dotfiles]

# README, "Customizing lsd (configuration and theming)": "you can create any of
# the following three files" — config.yaml, colors.yaml, icons.yaml — and
# "Config file locations": on Unix lsd follows the XDG Base Directory
# Specification and looks in "$HOME/.config/lsd" or "$XDG_CONFIG_HOME/lsd"; on
# Windows it looks in "%USERPROFILE%\.config\lsd" then "%APPDATA%\lsd".
#
# XDG on Unix — macOS included, so ~/.config there and not ~/Library — with
# %APPDATA% as the Windows spelling is exactly [configHome], one entry per
# file. The %USERPROFILE%\.config\lsd directory Windows probes first is the
# same ".config" name under another root and has no named-base-directory
# spelling; %APPDATA%\lsd is the location the README documents for Windows.
paths = [
  "[configHome]/lsd/config.yaml",
  "[configHome]/lsd/colors.yaml",
  "[configHome]/lsd/icons.yaml",
]

exclude = []

# A listing tool with no accounts and no credentials.
secret = []

# Read once per invocation.
side_effect = false

# No machine_lines: date format, sorting, blocks, colors and icon overrides are
# exactly the preferences a user wants to follow them to the next machine.

[commands]
format = 1
label = "List directory"
description = "List files with lsd: hidden files, long table, tree, sorting and colour. Icon, date format and block layout options are left out."
quality = "ai-draft"
base = "fig:lsd"
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/lsd.ts"
license = "MIT"

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

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

[[commands.field]]
id = "almost_all"
label = "Hidden files except . and .."
type = "boolean"
option = ["--almost-all", "-A"]
sources = ["fig"]

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

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

[[commands.field]]
id = "depth"
label = "Max depth"
type = "integer"
option = ["--depth"]
sources = ["fig"]

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

[[commands.field]]
id = "directory_only"
label = "Directories themselves"
type = "boolean"
option = ["--directory-only", "-d"]
sources = ["fig"]

[[commands.field]]
id = "sort"
label = "Sort by"
type = "enum"
option = ["--sort"]
choices = [{ value = "size", label = "Size" }, { value = "time", label = "Time" }, { value = "version", label = "Version" }, { value = "extension", label = "Extension" }]
sources = ["fig"]

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

[[commands.field]]
id = "group_dirs"
label = "Group directories"
type = "enum"
option = ["--group-dirs"]
choices = [{ value = "none", label = "None" }, { value = "first", label = "First" }, { value = "last", label = "Last" }]
sources = ["fig"]

[[commands.field]]
id = "color"
label = "Colour"
type = "enum"
option = ["--color"]
choices = [{ value = "always", label = "Always" }, { value = "auto", label = "Auto" }, { value = "never", label = "Never" }]
sources = ["fig"]

[[commands.task]]
id = "long_list"
label = "Long listing"
fields = ["paths", "long", "all"]
set = { long = [true] }

[[commands.task]]
id = "tree_view"
label = "Tree view"
fields = ["paths", "tree", "depth", "all"]
set = { tree = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["paths", "all", "long", "tree", "depth"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["almost_all", "recursive", "directory_only", "sort", "reverse", "group_dirs", "color"]