mirror of
https://github.com/Homebrew/brew.git
synced 2025-07-14 16:09:03 +08:00
2a346241c2
We've not seen complaints about these and they are the default behaviour on High Sierra and Mojave so it's easier to apply them consistently everywhere.
127 lines
3.6 KiB
Ruby
127 lines
3.6 KiB
Ruby
#: * `ln`, `link` [`--overwrite`] [`--dry-run`] [`--force`] <formula>:
|
|
#: Symlink all of <formula>'s installed files into the Homebrew prefix. This
|
|
#: is done automatically when you install formulae but can be useful for DIY
|
|
#: installations.
|
|
#:
|
|
#: If `--overwrite` is passed, Homebrew will delete files which already exist in
|
|
#: the prefix while linking.
|
|
#:
|
|
#: If `--dry-run` or `-n` is passed, Homebrew will list all files which would
|
|
#: be linked or which would be deleted by `brew link --overwrite`, but will not
|
|
#: actually link or delete any files.
|
|
#:
|
|
#: If `--force` (or `-f`) is passed, Homebrew will allow keg-only formulae to be linked.
|
|
|
|
require "ostruct"
|
|
require "caveats"
|
|
require "cli_parser"
|
|
|
|
module Homebrew
|
|
module_function
|
|
|
|
def link_args
|
|
Homebrew::CLI::Parser.new do
|
|
usage_banner <<~EOS
|
|
`ln`, `link` <options> <formula>
|
|
|
|
Symlink all of <formula>'s installed files into the Homebrew prefix. This
|
|
is done automatically when you install formulae but can be useful for DIY
|
|
installations.
|
|
EOS
|
|
switch "--overwrite",
|
|
description: "Delete files already existing in the prefix while linking."
|
|
switch "-n", "--dry-run",
|
|
description: "List all files which would be linked or deleted by "\
|
|
"`brew link --overwrite`, but will not actually link or delete any files."
|
|
switch :force,
|
|
description: "Allow only key-only formulae to be linked."
|
|
switch :verbose
|
|
switch :debug
|
|
end
|
|
end
|
|
|
|
def link
|
|
link_args.parse
|
|
|
|
raise KegUnspecifiedError if ARGV.named.empty?
|
|
|
|
mode = OpenStruct.new
|
|
|
|
mode.overwrite = true if args.overwrite?
|
|
mode.dry_run = true if args.dry_run?
|
|
|
|
ARGV.kegs.each do |keg|
|
|
keg_only = Formulary.keg_only?(keg.rack)
|
|
|
|
if keg.linked?
|
|
opoo "Already linked: #{keg}"
|
|
name_and_flag = if keg_only
|
|
"--force #{keg.name}"
|
|
else
|
|
keg.name
|
|
end
|
|
puts "To relink: brew unlink #{keg.name} && brew link #{name_and_flag}"
|
|
next
|
|
end
|
|
|
|
if mode.dry_run
|
|
if mode.overwrite
|
|
puts "Would remove:"
|
|
else
|
|
puts "Would link:"
|
|
end
|
|
keg.link(mode)
|
|
puts_keg_only_path_message(keg) if keg_only
|
|
next
|
|
end
|
|
|
|
if keg_only
|
|
if Homebrew.default_prefix?
|
|
f = keg.to_formula
|
|
if f.keg_only_reason.reason == :provided_by_macos
|
|
caveats = Caveats.new(f)
|
|
opoo <<~EOS
|
|
Refusing to link macOS-provided software: #{keg.name}
|
|
#{caveats.keg_only_text(skip_reason: true).strip}
|
|
EOS
|
|
next
|
|
end
|
|
end
|
|
|
|
unless args.force?
|
|
opoo "#{keg.name} is keg-only and must be linked with --force"
|
|
puts_keg_only_path_message(keg)
|
|
next
|
|
end
|
|
end
|
|
|
|
keg.lock do
|
|
print "Linking #{keg}... "
|
|
puts if args.verbose?
|
|
|
|
begin
|
|
n = keg.link(mode)
|
|
rescue Keg::LinkError
|
|
puts
|
|
raise
|
|
else
|
|
puts "#{n} symlinks created"
|
|
end
|
|
|
|
puts_keg_only_path_message(keg) if keg_only && !ARGV.homebrew_developer?
|
|
end
|
|
end
|
|
end
|
|
|
|
def puts_keg_only_path_message(keg)
|
|
bin = keg/"bin"
|
|
sbin = keg/"sbin"
|
|
return if !bin.directory? && !sbin.directory?
|
|
|
|
opt = HOMEBREW_PREFIX/"opt/#{keg.name}"
|
|
puts "\nIf you need to have this software first in your PATH instead consider running:"
|
|
puts " #{Utils::Shell.prepend_path_in_profile(opt/"bin")}" if bin.directory?
|
|
puts " #{Utils::Shell.prepend_path_in_profile(opt/"sbin")}" if sbin.directory?
|
|
end
|
|
end
|