mirror of
https://github.com/Homebrew/brew.git
synced 2025-07-14 16:09:03 +08:00
83 lines
3.1 KiB
Ruby
83 lines
3.1 KiB
Ruby
# typed: true
|
|
# frozen_string_literal: true
|
|
|
|
require "cli/parser"
|
|
|
|
module Homebrew
|
|
extend T::Sig
|
|
|
|
module_function
|
|
|
|
sig { returns(CLI::Parser) }
|
|
def tap_args
|
|
Homebrew::CLI::Parser.new do
|
|
usage_banner "`tap` [<options>] [<user>`/`<repo>] [<URL>]"
|
|
description <<~EOS
|
|
Tap a formula repository.
|
|
|
|
If no arguments are provided, list all installed taps.
|
|
|
|
With <URL> unspecified, tap a formula repository from GitHub using HTTPS.
|
|
Since so many taps are hosted on GitHub, this command is a shortcut for
|
|
`brew tap` <user>`/`<repo> `https://github.com/`<user>`/homebrew-`<repo>.
|
|
|
|
With <URL> specified, tap a formula repository from anywhere, using
|
|
any transport protocol that `git`(1) handles. The one-argument form of `tap`
|
|
simplifies but also limits. This two-argument command makes no
|
|
assumptions, so taps can be cloned from places other than GitHub and
|
|
using protocols other than HTTPS, e.g. SSH, git, HTTP, FTP(S), rsync.
|
|
EOS
|
|
switch "--full",
|
|
description: "Convert a shallow clone to a full clone without untapping. Taps are only cloned as " \
|
|
"shallow clones if `--shallow` was originally passed.",
|
|
replacement: false,
|
|
disable: true
|
|
switch "--shallow",
|
|
description: "Fetch tap as a shallow clone rather than a full clone. Useful for continuous integration.",
|
|
replacement: false,
|
|
disable: true
|
|
switch "--[no-]force-auto-update",
|
|
description: "Auto-update tap even if it is not hosted on GitHub. By default, only taps " \
|
|
"hosted on GitHub are auto-updated (for performance reasons)."
|
|
switch "--custom-remote",
|
|
description: "Install or change a tap with a custom remote. Useful for mirrors."
|
|
switch "--repair",
|
|
description: "Migrate tapped formulae from symlink-based to directory-based structure."
|
|
switch "--list-pinned",
|
|
description: "List all pinned taps."
|
|
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."
|
|
|
|
named_args :tap, max: 2
|
|
end
|
|
end
|
|
|
|
sig { void }
|
|
def tap
|
|
args = tap_args.parse
|
|
|
|
if args.repair?
|
|
Tap.each(&:link_completions_and_manpages)
|
|
Tap.each(&:fix_remote_configuration)
|
|
elsif args.list_pinned?
|
|
puts Tap.select(&:pinned?).map(&:name)
|
|
elsif args.no_named?
|
|
puts Tap.names
|
|
else
|
|
tap = Tap.fetch(args.named.first)
|
|
begin
|
|
tap.install clone_target: args.named.second,
|
|
force_auto_update: args.force_auto_update?,
|
|
custom_remote: args.custom_remote?,
|
|
quiet: args.quiet?,
|
|
verify: args.eval_all? || Homebrew::EnvConfig.eval_all?
|
|
rescue TapRemoteMismatchError, TapNoCustomRemoteError => e
|
|
odie e
|
|
rescue TapAlreadyTappedError
|
|
nil
|
|
end
|
|
end
|
|
end
|
|
end
|