id       = "homebrew"
name     = "Homebrew"
homepage = "https://brew.sh"
description = "The missing package manager for macOS and Linux."
icon     = "theSVG:homebrew"
executables   = ["brew"]
platforms = ["macos", "linux"]

[dotfiles]

# `man brew`: `brew bundle --global` reads ~/.Brewfile, and Homebrew sources
# environment settings from ${HOME}/.homebrew/brew.env. There is no other
# per-user config file — everything else is HOMEBREW_* in the environment.
paths = ["~/.Brewfile", "~/.homebrew/brew.env"]

# HOMEBREW_CACHE defaults to the [cacheHome] base directory: ~/Library/Caches
# on macOS, $XDG_CACHE_HOME or ~/.cache on Linux.
exclude = ["[cacheHome]/Homebrew/", "~/.Brewfile.lock.json"]

secret = []

# Both point at directories that exist only on this machine, spelled with this
# user's home expanded. They are only in the file because the user moved them —
# usually to keep a few gigabytes off the system volume — so they are kept to
# set this machine up the same way again: backup.
[[dotfiles.machine_lines]]
file  = "~/.homebrew/brew.env"
match = { prefix = ["HOMEBREW_CACHE", "HOMEBREW_TEMP"] }
scope = "backup"

[commands]
format = 1
label = "Homebrew"
description = "Install, upgrade, uninstall and search formulae and casks. Taps, services, cleanup and developer commands are left out, as are cask directory options."
quality = "ai-draft"
base = "fig:brew"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = true, short_bundles = false }

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

[[commands.subcommand]]
path = ["install"]
label = "Install formulae or casks"

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

[[commands.subcommand.field]]
id = "names"
label = "Formulae or casks"
type = "string"
position = 0
description = "One or more names to install."
multiple = true
sources = ["fig"]

[[commands.subcommand.field]]
id = "formula"
label = "Formulae only"
type = "boolean"
option = ["--formula"]
description = "Treat all named arguments as formulae."
sources = ["fig"]

[[commands.subcommand.field]]
id = "cask"
label = "Casks only"
type = "boolean"
option = ["--cask"]
description = "Treat all named arguments as casks."
sources = ["fig"]

[[commands.subcommand.field]]
id = "build_from_source"
label = "Build from source"
type = "boolean"
option = ["--build-from-source", "-s"]
description = "Compile from source even if a bottle is provided."
sources = ["fig"]

[[commands.subcommand.field]]
id = "head"
label = "Install HEAD"
type = "boolean"
option = ["--HEAD"]
description = "Install the HEAD version if the formula defines it."
sources = ["fig"]

[[commands.subcommand.field]]
id = "only_dependencies"
label = "Only dependencies"
type = "boolean"
option = ["--only-dependencies"]
description = "Install the dependencies but not the formula itself."
sources = ["fig"]

[[commands.subcommand.field]]
id = "force"
label = "Force"
type = "boolean"
option = ["--force", "-f"]
description = "Install without checking for previously installed keg-only or non-migrated versions; for casks, overwrite existing files."
effect = "overwrite"
sources = ["fig"]

[[commands.subcommand.field]]
id = "verbose"
label = "Verbose"
type = "boolean"
option = ["--verbose", "-v"]
description = "Print the verification and postinstall steps."
sources = ["fig"]

[[commands.subcommand.task]]
id = "formula"
label = "Install a formula"
set = { formula = [true] }
fields = ["names", "formula", "verbose"]
required = ["names"]

[[commands.subcommand.task]]
id = "cask"
label = "Install a cask"
set = { cask = [true] }
fields = ["names", "cask", "verbose"]
required = ["names"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["names", "formula", "cask", "verbose"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["build_from_source", "head", "only_dependencies", "force"]

[[commands.subcommand]]
path = ["upgrade"]
label = "Upgrade outdated packages"
description = "Leave names empty to upgrade everything that is outdated."

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

[[commands.subcommand.field]]
id = "names"
label = "Formulae or casks"
type = "string"
position = 0
description = "Names to upgrade; empty upgrades all outdated."
multiple = true
sources = ["fig"]

[[commands.subcommand.field]]
id = "dry_run"
label = "Dry run"
type = "boolean"
option = ["--dry-run", "-n"]
description = "Show what would be upgraded without upgrading."
sources = ["fig"]

[[commands.subcommand.field]]
id = "formula"
label = "Formulae only"
type = "boolean"
option = ["--formula", "--formulae"]
description = "Treat all named arguments as formulae."
sources = ["fig"]

[[commands.subcommand.field]]
id = "cask"
label = "Casks only"
type = "boolean"
option = ["--cask", "--casks"]
description = "Treat all named arguments as casks."
sources = ["fig"]

[[commands.subcommand.field]]
id = "greedy"
label = "Include auto-updating casks"
type = "boolean"
option = ["--greedy"]
description = "Also include casks with auto_updates true or version :latest."
sources = ["fig"]

[[commands.subcommand.field]]
id = "verbose"
label = "Verbose"
type = "boolean"
option = ["--verbose", "-v"]
description = "Print the verification and postinstall steps."
sources = ["fig"]

[[commands.subcommand.task]]
id = "preview"
label = "Preview upgrades"
set = { dry_run = [true] }
fields = ["names", "formula", "cask", "greedy"]
required = []

[[commands.subcommand.task]]
id = "all"
label = "Upgrade everything"
fields = ["names", "formula", "cask", "greedy", "dry_run"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["names", "dry_run", "formula", "cask"]

[[commands.subcommand.group]]
id = "advanced"
label = "Advanced"
fields = ["greedy", "verbose"]

[[commands.subcommand]]
path = ["uninstall"]
label = "Uninstall a formula or cask"

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

[[commands.subcommand.field]]
id = "names"
label = "Formulae or casks"
type = "string"
position = 0
description = "One or more installed names to remove."
multiple = true
effect = "delete"
sources = ["fig"]

[[commands.subcommand.task]]
id = "uninstall"
label = "Uninstall"
fields = ["names"]
required = ["names"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["names"]

[[commands.subcommand]]
path = ["search"]
label = "Search formulae and casks"

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

[[commands.subcommand.field]]
id = "text"
label = "Search text"
type = "string"
position = 0
description = "Substring or /regex/ to look for."
sources = ["fig"]

[[commands.subcommand.field]]
id = "formula"
label = "Formulae only"
type = "boolean"
option = ["--formula"]
description = "Search online and locally for formulae."
sources = ["fig"]

[[commands.subcommand.field]]
id = "cask"
label = "Casks only"
type = "boolean"
option = ["--cask"]
description = "Search online and locally for casks."
sources = ["fig"]

[[commands.subcommand.field]]
id = "desc"
label = "Search descriptions"
type = "boolean"
option = ["--desc"]
description = "Match descriptions of formulae and names of casks."
sources = ["fig"]

[[commands.subcommand.task]]
id = "search"
label = "Search"
fields = ["text", "formula", "cask", "desc"]
required = ["text"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["text", "formula", "cask", "desc"]