mirrors/brew
1
0
Fork 0
mirror of https://github.com/Homebrew/brew.git synced 2025-07-14 16:09:03 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #20204 from Homebrew/eval-all-check-env

Browse Source 
cmd/dev-cmd: fetch `HOMEBREW_EVAL_ALL` for `--eval-all`
This commit is contained in:
Eric Knibbe 2025-07-04 02:05:22 +00:00 committed by GitHub
commit 0b7c57af3b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
17 changed files with 123 additions and 120 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Library/Homebrew/cmd/deps.rb
View File

@ -91,7 +91,7 @@ module Homebrew
raise UsageError, "`brew deps --arch=all` is not supported" if args.arch == "all"
os, arch = T.must(args.os_arch_combinations.first)
all = args.eval_all?
eval_all = args.eval_all?
Formulary.enable_factory_cache!
@ -164,9 +164,9 @@ module Homebrew
puts_deps_tree(dependents, recursive:)
return
elsif all
elsif eval_all
puts_deps(sorted_dependents(
Formula.all(eval_all: args.eval_all?) + Cask::Cask.all(eval_all: args.eval_all?),
Formula.all(eval_all:) + Cask::Cask.all(eval_all:),
), recursive:)
return
elsif !args.no_named? && args.for_each?

5
Library/Homebrew/cmd/desc.rb
View File

@ -25,7 +25,8 @@ module Homebrew
"it is interpreted as a regular expression."
switch "--eval-all",
description: "Evaluate all available formulae and casks, whether installed or not, to search their " \
"descriptions. Implied if `$HOMEBREW_EVAL_ALL` is set."
"descriptions.",
env: :eval_all
switch "--formula", "--formulae",
description: "Treat all named arguments as formulae."
switch "--cask", "--casks",
@ -47,7 +48,7 @@ module Homebrew
end
if search_type.present?
if !args.eval_all? && !Homebrew::EnvConfig.eval_all? && Homebrew::EnvConfig.no_install_from_api?
if !args.eval_all? && Homebrew::EnvConfig.no_install_from_api?
raise UsageError, "`brew desc --search` needs `--eval-all` passed or `$HOMEBREW_EVAL_ALL` set!"
end

23
Library/Homebrew/cmd/info.rb
View File

@ -57,7 +57,8 @@ module Homebrew
switch "--eval-all",
depends_on: "--json",
description: "Evaluate all available formulae and casks, whether installed or not, to print their " \
"JSON. Implied if `$HOMEBREW_EVAL_ALL` is set."
"JSON.",
env: :eval_all
switch "--variations",
depends_on: "--json",
description: "Include the variations hash in each formula's JSON output."
@ -97,9 +98,7 @@ module Homebrew
print_analytics
elsif (json = args.json)
all = args.eval_all?
print_json(json, all)
print_json(json, args.eval_all?)
elsif args.github?
raise FormulaOrCaskUnspecifiedError if args.no_named?
@ -192,16 +191,16 @@ module Homebrew
version_hash[version]
end
sig { params(json: T.any(T::Boolean, String), all: T::Boolean).void }
def print_json(json, all)
raise FormulaOrCaskUnspecifiedError if !(all || args.installed?) && args.no_named?
sig { params(json: T.any(T::Boolean, String), eval_all: T::Boolean).void }
def print_json(json, eval_all)
raise FormulaOrCaskUnspecifiedError if !(eval_all || args.installed?) && args.no_named?
json = case json_version(json)
when :v1, :default
raise UsageError, "Cannot specify `--cask` when using `--json=v1`!" if args.cask?
formulae = if all
Formula.all(eval_all: args.eval_all?).sort
formulae = if eval_all
Formula.all(eval_all:).sort
elsif args.installed?
Formula.installed.sort
else
@ -215,10 +214,10 @@ module Homebrew
end
when :v2
formulae, casks = T.let(
if all
if eval_all
[
Formula.all(eval_all: args.eval_all?).sort,
Cask::Cask.all(eval_all: args.eval_all?).sort_by(&:full_name),
Formula.all(eval_all:).sort,
Cask::Cask.all(eval_all:).sort_by(&:full_name),
]
elsif args.installed?
[Formula.installed.sort, Cask::Caskroom.casks.sort_by(&:full_name)]

9
Library/Homebrew/cmd/options.rb
View File

@ -18,7 +18,8 @@ module Homebrew
description: "Show options for formulae that are currently installed."
switch "--eval-all",
description: "Evaluate all available formulae and casks, whether installed or not, to show their " \
"options."
"options.",
env: :eval_all
flag "--command=",
description: "Show options for the specified <command>."
@ -29,10 +30,10 @@ module Homebrew
sig { override.void }
def run
all = args.eval_all?
eval_all = args.eval_all?
if all
puts_options(Formula.all(eval_all: args.eval_all?).sort)
if eval_all
puts_options(Formula.all(eval_all:).sort)
elsif args.installed?
puts_options(Formula.installed.sort)
elsif args.command.present?

6
Library/Homebrew/cmd/readall.rb
View File

@ -24,8 +24,8 @@ module Homebrew
switch "--syntax",
description: "Syntax-check all of Homebrew's Ruby files (if no <tap> is passed)."
switch "--eval-all",
description: "Evaluate all available formulae and casks, whether installed or not. " \
"Implied if `$HOMEBREW_EVAL_ALL` is set."
description: "Evaluate all available formulae and casks, whether installed or not.",
env: :eval_all
switch "--no-simulate",
description: "Don't simulate other system configurations when checking formulae and casks."
@ -49,7 +49,7 @@ module Homebrew
options[:os_arch_combinations] = args.os_arch_combinations if args.os || args.arch
taps = if args.no_named?
if !args.eval_all? && !Homebrew::EnvConfig.eval_all?
unless args.eval_all?
raise UsageError, "`brew readall` needs a tap or `--eval-all` passed or `$HOMEBREW_EVAL_ALL` set!"
end

5
Library/Homebrew/cmd/search.rb
View File

@ -40,7 +40,8 @@ module Homebrew
switch "--eval-all",
depends_on: "--desc",
description: "Evaluate all available formulae and casks, whether installed or not, to search their " \
"descriptions. Implied if `$HOMEBREW_EVAL_ALL` is set."
"descriptions.",
env: :eval_all
switch "--pull-request",
description: "Search for GitHub pull requests containing <text>."
switch "--open",
@ -70,7 +71,7 @@ module Homebrew
string_or_regex = Search.query_regexp(query)
if args.desc?
if !args.eval_all? && !Homebrew::EnvConfig.eval_all? && Homebrew::EnvConfig.no_install_from_api?
if !args.eval_all? && Homebrew::EnvConfig.no_install_from_api?
raise UsageError, "`brew search --desc` needs `--eval-all` passed or `$HOMEBREW_EVAL_ALL` set!"
end

6
Library/Homebrew/cmd/tap.rb
View File

@ -39,8 +39,8 @@ module Homebrew
description: "Add missing symlinks to tap manpages and shell completions. Correct git remote " \
"refs for any taps where upstream HEAD branch has been renamed."
switch "--eval-all",
description: "Evaluate all the formulae, casks and aliases in the new tap to check validity. " \
"Implied if `$HOMEBREW_EVAL_ALL` is set."
description: "Evaluate all formulae, casks and aliases in the new tap to check their validity.",
env: :eval_all
switch "-f", "--force",
description: "Force install core taps even under API mode."
@ -62,7 +62,7 @@ module Homebrew
tap.install clone_target: args.named.second,
custom_remote: args.custom_remote?,
quiet: args.quiet?,
verify: args.eval_all? || Homebrew::EnvConfig.eval_all?,
verify: args.eval_all?,
force: args.force?
rescue Tap::InvalidNameError, TapRemoteMismatchError, TapNoCustomRemoteError => e
odie e

11
Library/Homebrew/cmd/uses.rb
View File

@ -36,7 +36,8 @@ module Homebrew
description: "Only list formulae and casks that are not currently installed."
switch "--eval-all",
description: "Evaluate all available formulae and casks, whether installed or not, to show " \
"their dependents."
"their dependents.",
env: :eval_all
switch "--include-implicit",
description: "Include formulae that have <formula> as an implicit dependency for " \
"downloading and unpacking source files."
@ -119,17 +120,17 @@ module Homebrew
deps
else
all = args.eval_all?
eval_all = args.eval_all?
if !args.installed? && !(all || Homebrew::EnvConfig.eval_all?)
if !args.installed? && !eval_all
raise UsageError, "`brew uses` needs `--installed` or `--eval-all` passed or `$HOMEBREW_EVAL_ALL` set!"
end
if show_formulae_and_casks || args.formula?
deps += args.installed? ? Formula.installed : Formula.all(eval_all: args.eval_all?)
deps += args.installed? ? Formula.installed : Formula.all(eval_all:)
end
if show_formulae_and_casks || args.cask?
deps += args.installed? ? Cask::Caskroom.casks : Cask::Cask.all(eval_all: args.eval_all?)
deps += args.installed? ? Cask::Caskroom.casks : Cask::Cask.all(eval_all:)
end
if args.missing?

12
Library/Homebrew/dev-cmd/audit.rb
View File

@ -42,8 +42,8 @@ module Homebrew
switch "--installed",
description: "Only check formulae and casks that are currently installed."
switch "--eval-all",
description: "Evaluate all available formulae and casks, whether installed or not, to audit them. " \
"Implied if `$HOMEBREW_EVAL_ALL` is set."
description: "Evaluate all available formulae and casks, whether installed or not, to audit them.",
env: :eval_all
switch "--new",
description: "Run various additional style checks to determine if a new formula or cask is eligible " \
"for Homebrew. This should be used when creating new formulae or casks and implies " \
@ -137,15 +137,17 @@ module Homebrew
no_named_args = true
[Formula.installed, Cask::Caskroom.casks]
elsif args.no_named?
if !args.eval_all? && !Homebrew::EnvConfig.eval_all?
eval_all = args.eval_all?
unless eval_all
# This odisabled should probably stick around indefinitely.
odisabled "brew audit",
"brew audit --eval-all or HOMEBREW_EVAL_ALL"
end
no_named_args = true
[
Formula.all(eval_all: args.eval_all?),
Cask::Cask.all(eval_all: args.eval_all?),
Formula.all(eval_all:),
Cask::Cask.all(eval_all:),
]
else
if args.named.any? { |named_arg| named_arg.end_with?(".rb") }

13
Library/Homebrew/dev-cmd/bump.rb
View File

@ -40,7 +40,8 @@ module Homebrew
switch "--cask", "--casks",
description: "Check only casks."
switch "--eval-all",
description: "Evaluate all formulae and casks."
description: "Evaluate all formulae and casks.",
env: :eval_all
switch "--repology",
description: "Use Repology to check for outdated packages."
flag "--tap=",
@ -71,14 +72,12 @@ module Homebrew
Homebrew.install_bundler_gems!(groups: ["livecheck"])
Homebrew.with_no_api_env do
eval_all = args.eval_all? || Homebrew::EnvConfig.eval_all?
eval_all = args.eval_all?
excluded_autobump = []
if args.no_autobump?
excluded_autobump.concat(autobumped_formulae_or_casks(CoreTap.instance)) if eval_all || args.formula?
if eval_all || args.cask?
excluded_autobump.concat(autobumped_formulae_or_casks(CoreCaskTap.instance, casks: true))
end
if args.no_autobump? && eval_all
excluded_autobump.concat(autobumped_formulae_or_casks(CoreTap.instance)) if args.formula?
excluded_autobump.concat(autobumped_formulae_or_casks(CoreCaskTap.instance, casks: true)) if args.cask?
end
formulae_and_casks = if args.auto?

13
Library/Homebrew/dev-cmd/livecheck.rb
View File

@ -53,7 +53,7 @@ module Homebrew
def run
Homebrew.install_bundler_gems!(groups: ["livecheck"])
all = args.eval_all?
eval_all = args.eval_all?
if args.debug? && args.verbose?
puts args
@ -70,12 +70,12 @@ module Homebrew
formulae = args.cask? ? [] : Formula.installed
casks = args.formula? ? [] : Cask::Caskroom.casks
formulae + casks
elsif all
formulae = args.cask? ? [] : Formula.all(eval_all: args.eval_all?)
casks = args.formula? ? [] : Cask::Cask.all(eval_all: args.eval_all?)
formulae + casks
elsif args.named.present?
args.named.to_formulae_and_casks_with_taps
elsif eval_all
formulae = args.cask? ? [] : Formula.all(eval_all:)
casks = args.formula? ? [] : Cask::Cask.all(eval_all:)
formulae + casks
elsif File.exist?(watchlist_path)
begin
names = Pathname.new(watchlist_path).read.lines
@ -88,7 +88,8 @@ module Homebrew
onoe e
end
else
raise UsageError, "A watchlist file is required when no arguments are given."
raise UsageError,
"`brew livecheck` with no arguments needs a watchlist file to be present or `--eval-all` passed!"
end
end

37
Library/Homebrew/dev-cmd/unbottled.rb
View File

@ -22,8 +22,8 @@ module Homebrew
switch "--lost",
description: "Print the `homebrew/core` commits where bottles were lost in the last week."
switch "--eval-all",
description: "Evaluate all available formulae and casks, whether installed or not, to check them. " \
"Implied if `$HOMEBREW_EVAL_ALL` is set."
description: "Evaluate all available formulae and casks, whether installed or not, to check them.",
env: :eval_all
conflicts "--dependents", "--total", "--lost"
@ -65,22 +65,19 @@ module Homebrew
end
Homebrew::SimulateSystem.with(os:, arch:) do
all = args.eval_all?
if args.total?
if !all && !Homebrew::EnvConfig.eval_all?
raise UsageError, "`brew unbottled --total` needs `--eval-all` passed or `$HOMEBREW_EVAL_ALL` set!"
end
eval_all = args.eval_all?
all = true
if args.total? && !eval_all
raise UsageError, "`brew unbottled --total` needs `--eval-all` passed or `$HOMEBREW_EVAL_ALL` set!"
end
if args.named.blank?
ohai "Getting formulae..."
elsif all
elsif eval_all
raise UsageError, "Cannot specify formulae when using `--eval-all`/`--total`."
end
formulae, all_formulae, formula_installs = formulae_all_installs_from_args(all)
formulae, all_formulae, formula_installs = formulae_all_installs_from_args(eval_all)
deps_hash, uses_hash = deps_uses_from_formulae(all_formulae)
if args.dependents?
@ -89,7 +86,7 @@ module Homebrew
dependents = uses_hash[f.name]&.length || 0
formula_dependents[f.name] ||= dependents
end.reverse
elsif all
elsif eval_all
output_total(formulae)
return
end
@ -111,22 +108,22 @@ module Homebrew
private
sig {
params(all: T::Boolean).returns([T::Array[Formula], T::Array[Formula], T.nilable(T::Hash[Symbol, Integer])])
params(eval_all: T::Boolean).returns([T::Array[Formula], T::Array[Formula],
T.nilable(T::Hash[Symbol, Integer])])
}
def formulae_all_installs_from_args(all)
def formulae_all_installs_from_args(eval_all)
if args.named.present?
formulae = all_formulae = args.named.to_formulae
elsif args.dependents?
if !args.eval_all? && !Homebrew::EnvConfig.eval_all?
raise UsageError,
"`brew unbottled --dependents` needs `--eval-all` passed or `$HOMEBREW_EVAL_ALL` set!"
unless eval_all
raise UsageError, "`brew unbottled --dependents` needs `--eval-all` passed or `$HOMEBREW_EVAL_ALL` set!"
end
formulae = all_formulae = Formula.all(eval_all: args.eval_all?)
formulae = all_formulae = Formula.all(eval_all:)
@sort = T.let(" (sorted by number of dependents)", T.nilable(String))
elsif all
formulae = all_formulae = Formula.all(eval_all: args.eval_all?)
elsif eval_all
formulae = all_formulae = Formula.all(eval_all:)
else
formula_installs = {}
@ -153,7 +150,7 @@ module Homebrew
end
@sort = T.let(" (sorted by installs in the last 90 days; top 10,000 only)", T.nilable(String))
all_formulae = Formula.all(eval_all: args.eval_all?)
all_formulae = Formula.all(eval_all:)
end
# Remove deprecated and disabled formulae as we do not care if they are unbottled

2
Library/Homebrew/test/dev-cmd/livecheck_spec.rb
View File

@ -22,7 +22,7 @@ RSpec.describe Homebrew::DevCmd::LivecheckCmd do
it "gives an error when no arguments are given and there's no watchlist", :integration_test do
expect { brew "livecheck", "HOMEBREW_LIVECHECK_WATCHLIST" => ".this_should_not_exist" }
.to output(/Invalid usage: A watchlist file is required when no arguments are given\./).to_stderr
.to output(/Invalid usage: `brew livecheck` with no arguments needs a watchlist file to be present/).to_stderr
.and not_to_output.to_stdout
.and be_a_failure
end

24
completions/fish/brew.fish
View File

@ -277,7 +277,7 @@ __fish_brew_complete_arg '-S' -l closed -d 'Search for only closed GitHub pull r
__fish_brew_complete_arg '-S' -l debian -d 'Search for text in the given database'
__fish_brew_complete_arg '-S' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg '-S' -l desc -d 'Search for formulae with a description matching text and casks with a name or description matching text'
__fish_brew_complete_arg '-S' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Implied if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg '-S' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg '-S' -l fedora -d 'Search for text in the given database'
__fish_brew_complete_arg '-S' -l fink -d 'Search for text in the given database'
__fish_brew_complete_arg '-S' -l formula -d 'Search for formulae'
@ -305,7 +305,7 @@ __fish_brew_complete_arg 'abv' -l cask -d 'Treat all named arguments as casks'
__fish_brew_complete_arg 'abv' -l category -d 'Which type of analytics data to retrieve. The value for category must be `install`, `install-on-request` or `build-error`; `cask-install` or `os-version` may be specified if formula is not. The default is `install`'
__fish_brew_complete_arg 'abv' -l days -d 'How many days of analytics data to retrieve. The value for days must be `30`, `90` or `365`. The default is `30`'
__fish_brew_complete_arg 'abv' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'abv' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to print their JSON. Implied if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'abv' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to print their JSON. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'abv' -l fetch-manifest -d 'Fetch GitHub Packages manifest for extra information when formula is not installed'
__fish_brew_complete_arg 'abv' -l formula -d 'Treat all named arguments as formulae'
__fish_brew_complete_arg 'abv' -l github -d 'Open the GitHub source page for formula and cask in a browser. To view the history locally: `brew log -p` formula or cask'
@ -344,7 +344,7 @@ __fish_brew_complete_arg 'audit' -l audit-debug -d 'Enable debugging and profili
__fish_brew_complete_arg 'audit' -l cask -d 'Treat all named arguments as casks'
__fish_brew_complete_arg 'audit' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'audit' -l display-filename -d 'Prefix every line of output with the file or formula name being audited, to make output easy to grep'
__fish_brew_complete_arg 'audit' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to audit them. Implied if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'audit' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to audit them. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'audit' -l except -d 'Specify a comma-separated method list to skip running the methods named `audit_`method'
__fish_brew_complete_arg 'audit' -l except-cops -d 'Specify a comma-separated cops list to skip checking for violations of the listed RuboCop cops'
__fish_brew_complete_arg 'audit' -l fix -d 'Fix style violations automatically using RuboCop\'s auto-correct feature'
@ -401,7 +401,7 @@ __fish_brew_complete_cmd 'bump' 'Displays out-of-date packages and the latest ve
__fish_brew_complete_arg 'bump' -l bump-synced -d 'Bump additional formulae marked as synced with the given formulae'
__fish_brew_complete_arg 'bump' -l cask -d 'Check only casks'
__fish_brew_complete_arg 'bump' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'bump' -l eval-all -d 'Evaluate all formulae and casks'
__fish_brew_complete_arg 'bump' -l eval-all -d 'Evaluate all formulae and casks. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'bump' -l formula -d 'Check only formulae'
__fish_brew_complete_arg 'bump' -l full-name -d 'Print formulae/casks with fully-qualified names'
__fish_brew_complete_arg 'bump' -l help -d 'Show this message'
@ -679,7 +679,7 @@ __fish_brew_complete_cmd 'desc' 'Display formula\'s name and one-line descriptio
__fish_brew_complete_arg 'desc' -l cask -d 'Treat all named arguments as casks'
__fish_brew_complete_arg 'desc' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'desc' -l description -d 'Search just descriptions for text. If text is flanked by slashes, it is interpreted as a regular expression'
__fish_brew_complete_arg 'desc' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Implied if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'desc' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'desc' -l formula -d 'Treat all named arguments as formulae'
__fish_brew_complete_arg 'desc' -l help -d 'Show this message'
__fish_brew_complete_arg 'desc' -l name -d 'Search just names for text. If text is flanked by slashes, it is interpreted as a regular expression'
@ -933,7 +933,7 @@ __fish_brew_complete_arg 'info' -l cask -d 'Treat all named arguments as casks'
__fish_brew_complete_arg 'info' -l category -d 'Which type of analytics data to retrieve. The value for category must be `install`, `install-on-request` or `build-error`; `cask-install` or `os-version` may be specified if formula is not. The default is `install`'
__fish_brew_complete_arg 'info' -l days -d 'How many days of analytics data to retrieve. The value for days must be `30`, `90` or `365`. The default is `30`'
__fish_brew_complete_arg 'info' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'info' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to print their JSON. Implied if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'info' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to print their JSON. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'info' -l fetch-manifest -d 'Fetch GitHub Packages manifest for extra information when formula is not installed'
__fish_brew_complete_arg 'info' -l formula -d 'Treat all named arguments as formulae'
__fish_brew_complete_arg 'info' -l github -d 'Open the GitHub source page for formula and cask in a browser. To view the history locally: `brew log -p` formula or cask'
@ -1265,7 +1265,7 @@ __fish_brew_complete_cmd 'options' 'Show install options specific to formula'
__fish_brew_complete_arg 'options' -l command -d 'Show options for the specified command'
__fish_brew_complete_arg 'options' -l compact -d 'Show all options on a single line separated by spaces'
__fish_brew_complete_arg 'options' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'options' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to show their options'
__fish_brew_complete_arg 'options' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to show their options. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'options' -l help -d 'Show this message'
__fish_brew_complete_arg 'options' -l installed -d 'Show options for formulae that are currently installed'
__fish_brew_complete_arg 'options' -l quiet -d 'Make some output more quiet'
@ -1410,7 +1410,7 @@ __fish_brew_complete_cmd 'readall' 'Import all items from the specified tap, or
__fish_brew_complete_arg 'readall' -l aliases -d 'Verify any alias symlinks in each tap'
__fish_brew_complete_arg 'readall' -l arch -d 'Read using the given CPU architecture. (Pass `all` to simulate all architectures.)'
__fish_brew_complete_arg 'readall' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'readall' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not. Implied if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'readall' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'readall' -l help -d 'Show this message'
__fish_brew_complete_arg 'readall' -l no-simulate -d 'Don\'t simulate other system configurations when checking formulae and casks'
__fish_brew_complete_arg 'readall' -l os -d 'Read using the given operating system. (Pass `all` to simulate all operating systems.)'
@ -1533,7 +1533,7 @@ __fish_brew_complete_arg 'search' -l closed -d 'Search for only closed GitHub pu
__fish_brew_complete_arg 'search' -l debian -d 'Search for text in the given database'
__fish_brew_complete_arg 'search' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'search' -l desc -d 'Search for formulae with a description matching text and casks with a name or description matching text'
__fish_brew_complete_arg 'search' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Implied if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'search' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'search' -l fedora -d 'Search for text in the given database'
__fish_brew_complete_arg 'search' -l fink -d 'Search for text in the given database'
__fish_brew_complete_arg 'search' -l formula -d 'Search for formulae'
@ -1626,7 +1626,7 @@ __fish_brew_complete_arg 'tab; and not __fish_seen_argument -l formula -l formul
__fish_brew_complete_cmd 'tap' 'Tap a formula repository'
__fish_brew_complete_arg 'tap' -l custom-remote -d 'Install or change a tap with a custom remote. Useful for mirrors'
__fish_brew_complete_arg 'tap' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'tap' -l eval-all -d 'Evaluate all the formulae, casks and aliases in the new tap to check validity. Implied if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'tap' -l eval-all -d 'Evaluate all formulae, casks and aliases in the new tap to check their validity. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'tap' -l force -d 'Force install core taps even under API mode'
__fish_brew_complete_arg 'tap' -l help -d 'Show this message'
__fish_brew_complete_arg 'tap' -l quiet -d 'Make some output more quiet'
@ -1727,7 +1727,7 @@ __fish_brew_complete_arg 'unalias' -l verbose -d 'Make some output more verbose'
__fish_brew_complete_cmd 'unbottled' 'Show the unbottled dependents of formulae'
__fish_brew_complete_arg 'unbottled' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'unbottled' -l dependents -d 'Skip getting analytics data and sort by number of dependents instead'
__fish_brew_complete_arg 'unbottled' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to check them. Implied if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'unbottled' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to check them. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'unbottled' -l help -d 'Show this message'
__fish_brew_complete_arg 'unbottled' -l lost -d 'Print the `homebrew/core` commits where bottles were lost in the last week'
__fish_brew_complete_arg 'unbottled' -l quiet -d 'Make some output more quiet'
@ -1943,7 +1943,7 @@ __fish_brew_complete_arg 'upgrade; and not __fish_seen_argument -l formula -l fo
__fish_brew_complete_cmd 'uses' 'Show formulae and casks that specify formula as a dependency; that is, show dependents of formula'
__fish_brew_complete_arg 'uses' -l cask -d 'Include only casks'
__fish_brew_complete_arg 'uses' -l debug -d 'Display any debugging information'
__fish_brew_complete_arg 'uses' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to show their dependents'
__fish_brew_complete_arg 'uses' -l eval-all -d 'Evaluate all available formulae and casks, whether installed or not, to show their dependents. Enabled by default if `$HOMEBREW_EVAL_ALL` is set'
__fish_brew_complete_arg 'uses' -l formula -d 'Include only formulae'
__fish_brew_complete_arg 'uses' -l help -d 'Show this message'
__fish_brew_complete_arg 'uses' -l include-build -d 'Include formulae that specify formula as a `:build` dependency'

24
completions/zsh/_brew
View File

@ -392,7 +392,7 @@ _brew__s() {
'(--repology --macports --fink --opensuse --fedora --archlinux --ubuntu)--debian[Search for text in the given database]' \
'--debug[Display any debugging information]' \
'(--pull-request)--desc[Search for formulae with a description matching text and casks with a name or description matching text]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Implied if `$HOMEBREW_EVAL_ALL` is set]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'(--repology --macports --fink --opensuse --archlinux --debian --ubuntu)--fedora[Search for text in the given database]' \
'(--repology --macports --opensuse --fedora --archlinux --debian --ubuntu)--fink[Search for text in the given database]' \
'--formula[Search for formulae]' \
@ -423,7 +423,7 @@ _brew_abv() {
'--category[Which type of analytics data to retrieve. The value for category must be `install`, `install-on-request` or `build-error`; `cask-install` or `os-version` may be specified if formula is not. The default is `install`]' \
'--days[How many days of analytics data to retrieve. The value for days must be `30`, `90` or `365`. The default is `30`]' \
'--debug[Display any debugging information]' \
'(--installed)--eval-all[Evaluate all available formulae and casks, whether installed or not, to print their JSON. Implied if `$HOMEBREW_EVAL_ALL` is set]' \
'(--installed)--eval-all[Evaluate all available formulae and casks, whether installed or not, to print their JSON. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'(--cask --json)--fetch-manifest[Fetch GitHub Packages manifest for extra information when formula is not installed]' \
'--github[Open the GitHub source page for formula and cask in a browser. To view the history locally: `brew log -p` formula or cask]' \
'--help[Show this message]' \
@ -468,7 +468,7 @@ _brew_audit() {
'--audit-debug[Enable debugging and profiling of audit methods]' \
'--debug[Display any debugging information]' \
'--display-filename[Prefix every line of output with the file or formula name being audited, to make output easy to grep]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to audit them. Implied if `$HOMEBREW_EVAL_ALL` is set]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to audit them. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'(--only)--except[Specify a comma-separated method list to skip running the methods named `audit_`method]' \
'(--only-cops --strict --only-cops --only)--except-cops[Specify a comma-separated cops list to skip checking for violations of the listed RuboCop cops]' \
'--fix[Fix style violations automatically using RuboCop'\''s auto-correct feature]' \
@ -536,7 +536,7 @@ _brew_bump() {
_arguments \
'--bump-synced[Bump additional formulae marked as synced with the given formulae]' \
'--debug[Display any debugging information]' \
'(--installed)--eval-all[Evaluate all formulae and casks]' \
'(--installed)--eval-all[Evaluate all formulae and casks. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'--full-name[Print formulae/casks with fully-qualified names]' \
'--help[Show this message]' \
'(--tap --eval-all --auto)--installed[Check formulae and casks that are currently installed]' \
@ -855,7 +855,7 @@ _brew_desc() {
_arguments \
'--debug[Display any debugging information]' \
'(--search --name)--description[Search just descriptions for text. If text is flanked by slashes, it is interpreted as a regular expression]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Implied if `$HOMEBREW_EVAL_ALL` is set]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'--help[Show this message]' \
'(--search --description)--name[Search just names for text. If text is flanked by slashes, it is interpreted as a regular expression]' \
'--quiet[Make some output more quiet]' \
@ -1172,7 +1172,7 @@ _brew_info() {
'--category[Which type of analytics data to retrieve. The value for category must be `install`, `install-on-request` or `build-error`; `cask-install` or `os-version` may be specified if formula is not. The default is `install`]' \
'--days[How many days of analytics data to retrieve. The value for days must be `30`, `90` or `365`. The default is `30`]' \
'--debug[Display any debugging information]' \
'(--installed)--eval-all[Evaluate all available formulae and casks, whether installed or not, to print their JSON. Implied if `$HOMEBREW_EVAL_ALL` is set]' \
'(--installed)--eval-all[Evaluate all available formulae and casks, whether installed or not, to print their JSON. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'(--cask --json)--fetch-manifest[Fetch GitHub Packages manifest for extra information when formula is not installed]' \
'--github[Open the GitHub source page for formula and cask in a browser. To view the history locally: `brew log -p` formula or cask]' \
'--help[Show this message]' \
@ -1564,7 +1564,7 @@ _brew_options() {
'(--installed --all)--command[Show options for the specified command]' \
'--compact[Show all options on a single line separated by spaces]' \
'--debug[Display any debugging information]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to show their options]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to show their options. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'--help[Show this message]' \
'(--all --command)--installed[Show options for formulae that are currently installed]' \
'--quiet[Make some output more quiet]' \
@ -1740,7 +1740,7 @@ _brew_readall() {
'--aliases[Verify any alias symlinks in each tap]' \
'--arch[Read using the given CPU architecture. (Pass `all` to simulate all architectures.)]' \
'--debug[Display any debugging information]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not. Implied if `$HOMEBREW_EVAL_ALL` is set]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'--help[Show this message]' \
'--no-simulate[Don'\''t simulate other system configurations when checking formulae and casks]' \
'--os[Read using the given operating system. (Pass `all` to simulate all operating systems.)]' \
@ -1888,7 +1888,7 @@ _brew_search() {
'(--repology --macports --fink --opensuse --fedora --archlinux --ubuntu)--debian[Search for text in the given database]' \
'--debug[Display any debugging information]' \
'(--pull-request)--desc[Search for formulae with a description matching text and casks with a name or description matching text]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Implied if `$HOMEBREW_EVAL_ALL` is set]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to search their descriptions. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'(--repology --macports --fink --opensuse --archlinux --debian --ubuntu)--fedora[Search for text in the given database]' \
'(--repology --macports --opensuse --fedora --archlinux --debian --ubuntu)--fink[Search for text in the given database]' \
'--formula[Search for formulae]' \
@ -1999,7 +1999,7 @@ _brew_tap() {
_arguments \
'--custom-remote[Install or change a tap with a custom remote. Useful for mirrors]' \
'--debug[Display any debugging information]' \
'--eval-all[Evaluate all the formulae, casks and aliases in the new tap to check validity. Implied if `$HOMEBREW_EVAL_ALL` is set]' \
'--eval-all[Evaluate all formulae, casks and aliases in the new tap to check their validity. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'--force[Force install core taps even under API mode]' \
'--help[Show this message]' \
'--quiet[Make some output more quiet]' \
@ -2122,7 +2122,7 @@ _brew_unbottled() {
_arguments \
'--debug[Display any debugging information]' \
'(--total --lost)--dependents[Skip getting analytics data and sort by number of dependents instead]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to check them. Implied if `$HOMEBREW_EVAL_ALL` is set]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to check them. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'--help[Show this message]' \
'(--dependents --total)--lost[Print the `homebrew/core` commits where bottles were lost in the last week]' \
'--quiet[Make some output more quiet]' \
@ -2388,7 +2388,7 @@ _brew_uses() {
_arguments \
'(--formula)--cask[Include only casks]' \
'--debug[Display any debugging information]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to show their dependents]' \
'--eval-all[Evaluate all available formulae and casks, whether installed or not, to show their dependents. Enabled by default if `$HOMEBREW_EVAL_ALL` is set]' \
'--help[Show this message]' \
'--include-build[Include formulae that specify formula as a `:build` dependency]' \
'--include-implicit[Include formulae that have formula as an implicit dependency for downloading and unpacking source files]' \

25
docs/Manpage.md
View File

@ -523,7 +523,7 @@ first search, making that search slower than subsequent ones.
`--eval-all`
: Evaluate all available formulae and casks, whether installed or not, to search
their descriptions. Implied if `$HOMEBREW_EVAL_ALL` is set.
their descriptions. Enabled by default if `$HOMEBREW_EVAL_ALL` is set.
`--formula`
@ -723,7 +723,7 @@ Display brief statistics for your Homebrew installation. If a *`formula`* or
`--eval-all`
: Evaluate all available formulae and casks, whether installed or not, to print
their JSON. Implied if `$HOMEBREW_EVAL_ALL` is set.
their JSON. Enabled by default if `$HOMEBREW_EVAL_ALL` is set.
`--variations`
@ -1115,7 +1115,7 @@ Show install options specific to *`formula`*.
`--eval-all`
: Evaluate all available formulae and casks, whether installed or not, to show
their options.
their options. Enabled by default if `$HOMEBREW_EVAL_ALL` is set.
`--command`
@ -1221,8 +1221,8 @@ all items or checking if any current formulae/casks have Ruby issues.
`--eval-all`
: Evaluate all available formulae and casks, whether installed or not. Implied
if `$HOMEBREW_EVAL_ALL` is set.
: Evaluate all available formulae and casks, whether installed or not. Enabled
by default if `$HOMEBREW_EVAL_ALL` is set.
`--no-simulate`
@ -1351,7 +1351,7 @@ Perform a substring search of cask tokens and formula names for *`text`*. If
`--eval-all`
: Evaluate all available formulae and casks, whether installed or not, to search
their descriptions. Implied if `$HOMEBREW_EVAL_ALL` is set.
their descriptions. Enabled by default if `$HOMEBREW_EVAL_ALL` is set.
`--pull-request`
@ -1546,8 +1546,8 @@ HTTPS, e.g. SSH, git, HTTP, FTP(S), rsync.
`--eval-all`
: Evaluate all the formulae, casks and aliases in the new tap to check validity.
Implied if `$HOMEBREW_EVAL_ALL` is set.
: Evaluate all formulae, casks and aliases in the new tap to check their
validity. Enabled by default if `$HOMEBREW_EVAL_ALL` is set.
`-f`, `--force`
@ -1804,7 +1804,7 @@ dependency for their stable builds.
`--eval-all`
: Evaluate all available formulae and casks, whether installed or not, to show
their dependents.
their dependents. Enabled by default if `$HOMEBREW_EVAL_ALL` is set.
`--include-implicit`
@ -1975,7 +1975,7 @@ checks. Will exit with a non-zero status if any errors are found.
`--eval-all`
: Evaluate all available formulae and casks, whether installed or not, to audit
them. Implied if `$HOMEBREW_EVAL_ALL` is set.
them. Enabled by default if `$HOMEBREW_EVAL_ALL` is set.
`--new`
@ -2135,7 +2135,8 @@ displays whether a pull request has been opened with the URL.
`--eval-all`
: Evaluate all formulae and casks.
: Evaluate all formulae and casks. Enabled by default if `$HOMEBREW_EVAL_ALL` is
set.
`--repology`
@ -3287,7 +3288,7 @@ Show the unbottled dependents of formulae.
`--eval-all`
: Evaluate all available formulae and casks, whether installed or not, to check
them. Implied if `$HOMEBREW_EVAL_ALL` is set.
them. Enabled by default if `$HOMEBREW_EVAL_ALL` is set.
### `unpack` \[*`options`*\] *`formula`* \[...\]

22
manpages/brew.1
View File

@ -1,5 +1,5 @@
.\" generated by kramdown
.TH "BREW" "1" "June 2025" "Homebrew"
.TH "BREW" "1" "July 2025" "Homebrew"
.SH NAME
brew \- The Missing Package Manager for macOS (or Linux)
.SH "SYNOPSIS"
@ -326,7 +326,7 @@ Search just names for \fItext\fP\&\. If \fItext\fP is flanked by slashes, it is
Search just descriptions for \fItext\fP\&\. If \fItext\fP is flanked by slashes, it is interpreted as a regular expression\.
.TP
\fB\-\-eval\-all\fP
Evaluate all available formulae and casks, whether installed or not, to search their descriptions\. Implied if \fB$HOMEBREW_EVAL_ALL\fP is set\.
Evaluate all available formulae and casks, whether installed or not, to search their descriptions\. Enabled by default if \fB$HOMEBREW_EVAL_ALL\fP is set\.
.TP
\fB\-\-formula\fP
Treat all named arguments as formulae\.
@ -450,7 +450,7 @@ Print a JSON representation\. Currently the default value for \fIversion\fP is \
Print JSON of formulae that are currently installed\.
.TP
\fB\-\-eval\-all\fP
Evaluate all available formulae and casks, whether installed or not, to print their JSON\. Implied if \fB$HOMEBREW_EVAL_ALL\fP is set\.
Evaluate all available formulae and casks, whether installed or not, to print their JSON\. Enabled by default if \fB$HOMEBREW_EVAL_ALL\fP is set\.
.TP
\fB\-\-variations\fP
Include the variations hash in each formula\[u2019]s JSON output\.
@ -694,7 +694,7 @@ Show all options on a single line separated by spaces\.
Show options for formulae that are currently installed\.
.TP
\fB\-\-eval\-all\fP
Evaluate all available formulae and casks, whether installed or not, to show their options\.
Evaluate all available formulae and casks, whether installed or not, to show their options\. Enabled by default if \fB$HOMEBREW_EVAL_ALL\fP is set\.
.TP
\fB\-\-command\fP
Show options for the specified \fIcommand\fP\&\.
@ -757,7 +757,7 @@ Verify any alias symlinks in each tap\.
Syntax\-check all of Homebrew\[u2019]s Ruby files (if no \fItap\fP is passed)\.
.TP
\fB\-\-eval\-all\fP
Evaluate all available formulae and casks, whether installed or not\. Implied if \fB$HOMEBREW_EVAL_ALL\fP is set\.
Evaluate all available formulae and casks, whether installed or not\. Enabled by default if \fB$HOMEBREW_EVAL_ALL\fP is set\.
.TP
\fB\-\-no\-simulate\fP
Don\[u2019]t simulate other system configurations when checking formulae and casks\.
@ -837,7 +837,7 @@ Search for casks\.
Search for formulae with a description matching \fItext\fP and casks with a name or description matching \fItext\fP\&\.
.TP
\fB\-\-eval\-all\fP
Evaluate all available formulae and casks, whether installed or not, to search their descriptions\. Implied if \fB$HOMEBREW_EVAL_ALL\fP is set\.
Evaluate all available formulae and casks, whether installed or not, to search their descriptions\. Enabled by default if \fB$HOMEBREW_EVAL_ALL\fP is set\.
.TP
\fB\-\-pull\-request\fP
Search for GitHub pull requests containing \fItext\fP\&\.
@ -960,7 +960,7 @@ Install or change a tap with a custom remote\. Useful for mirrors\.
Add missing symlinks to tap manpages and shell completions\. Correct git remote refs for any taps where upstream HEAD branch has been renamed\.
.TP
\fB\-\-eval\-all\fP
Evaluate all the formulae, casks and aliases in the new tap to check validity\. Implied if \fB$HOMEBREW_EVAL_ALL\fP is set\.
Evaluate all formulae, casks and aliases in the new tap to check their validity\. Enabled by default if \fB$HOMEBREW_EVAL_ALL\fP is set\.
.TP
\fB\-f\fP, \fB\-\-force\fP
Force install core taps even under API mode\.
@ -1115,7 +1115,7 @@ Only list formulae and casks that are currently installed\.
Only list formulae and casks that are not currently installed\.
.TP
\fB\-\-eval\-all\fP
Evaluate all available formulae and casks, whether installed or not, to show their dependents\.
Evaluate all available formulae and casks, whether installed or not, to show their dependents\. Enabled by default if \fB$HOMEBREW_EVAL_ALL\fP is set\.
.TP
\fB\-\-include\-implicit\fP
Include formulae that have \fIformula\fP as an implicit dependency for downloading and unpacking source files\.
@ -1228,7 +1228,7 @@ Run additional, slower style checks that require a network connection\.
Only check formulae and casks that are currently installed\.
.TP
\fB\-\-eval\-all\fP
Evaluate all available formulae and casks, whether installed or not, to audit them\. Implied if \fB$HOMEBREW_EVAL_ALL\fP is set\.
Evaluate all available formulae and casks, whether installed or not, to audit them\. Enabled by default if \fB$HOMEBREW_EVAL_ALL\fP is set\.
.TP
\fB\-\-new\fP
Run various additional style checks to determine if a new formula or cask is eligible for Homebrew\. This should be used when creating new formulae or casks and implies \fB\-\-strict\fP and \fB\-\-online\fP\&\.
@ -1328,7 +1328,7 @@ Check only formulae\.
Check only casks\.
.TP
\fB\-\-eval\-all\fP
Evaluate all formulae and casks\.
Evaluate all formulae and casks\. Enabled by default if \fB$HOMEBREW_EVAL_ALL\fP is set\.
.TP
\fB\-\-repology\fP
Use Repology to check for outdated packages\.
@ -2092,7 +2092,7 @@ Print the number of unbottled and total formulae\.
Print the \fBhomebrew/core\fP commits where bottles were lost in the last week\.
.TP
\fB\-\-eval\-all\fP
Evaluate all available formulae and casks, whether installed or not, to check them\. Implied if \fB$HOMEBREW_EVAL_ALL\fP is set\.
Evaluate all available formulae and casks, whether installed or not, to check them\. Enabled by default if \fB$HOMEBREW_EVAL_ALL\fP is set\.
.SS "\fBunpack\fP \fR[\fIoptions\fP] \fIformula\fP \fR[\.\.\.]"
Unpack the source files for \fIformula\fP into subdirectories of the current working directory\.
.TP