Class: Homebrew::Cmd::Untap Private

Inherits:
AbstractCommand show all
Defined in:
cmd/untap.rb,
sorbet/rbi/dsl/homebrew/cmd/untap.rbi

This class is part of a private API. This class may only be used in the Homebrew/brew repository. Third parties should avoid using this class if possible, as it may be removed or changed without warning.

Defined Under Namespace

Classes: Args

Instance Method Summary collapse

Methods inherited from AbstractCommand

command, command_name, dev_cmd?, #initialize, parser, ruby_cmd?

Methods included from Utils::Output::Mixin

#issue_reporting_message, #odebug, #odeprecated, #odie, #odisabled, #ofail, #oh1, #oh1_title, #ohai, #ohai_title, #onoe, #opoo, #opoo_outside_github_actions, #opoo_without_github_actions_annotation, #pretty_deprecated, #pretty_disabled, #pretty_duration, #pretty_install_status, #pretty_installed, #pretty_uninstalled, #pretty_unmarked, #pretty_upgradable, #pretty_warning

Constructor Details

This class inherits a constructor from Homebrew::AbstractCommand

Instance Method Details

#argsHomebrew::Cmd::Untap::Args

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.



10
# File 'sorbet/rbi/dsl/homebrew/cmd/untap.rbi', line 10

def args; end

#installed_casks_for(tap:) ⇒ Array<Cask::Cask>

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

All installed casks currently available in a tap by cask full name.

Parameters:

Returns:



127
128
129
130
131
132
133
134
135
136
137
138
139
140
# File 'cmd/untap.rb', line 127

def installed_casks_for(tap:)
  tap.cask_tokens.filter_map do |cask_token|
    next unless installed_cask_tokens.include?(Utils.name_from_full_name(cask_token))

    cask = begin
      Cask::CaskLoader.load(cask_token)
    rescue Cask::CaskUnavailableError, MethodDeprecatedError
      # Don't blow up because of a single unavailable cask or a deprecated method.
      next
    end

    cask if cask.installed?
  end
end

#installed_formulae_for(tap:) ⇒ Array<Formula>

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

All installed formulae currently available in a tap by formula full name.

Parameters:

Returns:



108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
# File 'cmd/untap.rb', line 108

def installed_formulae_for(tap:)
  tap.formula_names.filter_map do |formula_name|
    next unless installed_formulae_names.include?(Utils.name_from_full_name(formula_name))

    formula = begin
      Formulary.factory(formula_name)
    rescue FormulaUnavailableError, FormulaSpecificationError
      # Don't blow up because of a single unavailable or invalid formula.
      next
    end

    # Can't use Formula#any_version_installed? because it doesn't consider
    # taps correctly.
    formula if formula.installed_kegs.any? { |keg| keg.tab.tap == tap }
  end
end

#runvoid

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

This method returns an undefined value.



25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
# File 'cmd/untap.rb', line 25

def run
  taps = begin
    args.named.to_installed_taps
  rescue Tap::InvalidNameError => e
    odie e.message
  end

  taps.each do |tap|
    if tap.core_tap? && Homebrew::EnvConfig.no_install_from_api?
      ofail "Untapping #{tap} is not allowed"
      next
    end

    if Homebrew::EnvConfig.no_install_from_api? || (!tap.core_tap? && !tap.core_cask_tap?)
      installed_tap_formulae = installed_formulae_for(tap:)
      installed_tap_casks = installed_casks_for(tap:)

      if installed_tap_formulae.present? || installed_tap_casks.present?
        installed_formulae_names = installed_tap_formulae.map(&:full_name)
        installed_cask_names = installed_tap_casks.map(&:full_name)
        installed_package_types = if installed_formulae_names.empty?
          "casks"
        elsif installed_cask_names.empty?
          "formulae"
        else
          "formulae and casks"
        end
        installed_names = (installed_formulae_names + installed_cask_names).join("\n")
        if Homebrew::EnvConfig.developer? && !args.force?
          opoo <<~EOS
            Untapping #{tap} even though it contains the following installed #{installed_package_types}:
            #{installed_names}
          EOS
        else
          unless args.force?
            ohai "Would untap #{tap} after uninstalling the following #{installed_package_types}:"
            puts installed_names
            confirmed = begin
              Homebrew::Ask.confirm?(action: "changes")
            rescue SystemExit
              false
            end
            unless confirmed
              ofail <<~EOS
                Refusing to untap #{tap} because it contains the following installed #{installed_package_types}:
                #{installed_names}
              EOS
              next
            end
          end

          named_args = installed_formulae_names + installed_cask_names
          kegs_by_rack = installed_tap_formulae.flat_map do |formula|
            formula.installed_kegs.select { |keg| keg.tab.tap == tap }
          end.group_by(&:rack)

          Cask::Uninstall.check_dependent_casks(*installed_tap_casks, named_args:)
          next if Homebrew.failed?

          Uninstall.uninstall_kegs(kegs_by_rack, casks: installed_tap_casks, force: args.force?, named_args:)
          next if Homebrew.failed?

          begin
            Cask::Uninstall.uninstall_casks(*installed_tap_casks, force: args.force?)
          rescue
            ofail $ERROR_INFO
            next
          end

          if installed_formulae_for(tap:).present? || installed_casks_for(tap:).present?
            ofail "Failed to fully uninstall #{installed_package_types} from #{tap}"
            next
          end
        end
      end
    end

    tap.uninstall manual: true
  end
end