Class: Utils::Bottles::Tag Private

Inherits:
Object show all
Defined in:
utils/bottles.rb

Overview

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.

Denotes the arch and OS of a bottle.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(system:, arch:) ⇒ void

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.

Parameters:



195
196
197
198
 
# File 'utils/bottles.rb', line 195

def initialize(system:, arch:)
  @system = system
  @arch = arch
end

Instance Attribute Details

#arch ⇒ Symbol (readonly)

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.

Returns:



164
165
166
 
# File 'utils/bottles.rb', line 164

def arch
  @arch
end

#system ⇒ Symbol (readonly)

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.

Returns:



164
165
166
 
# File 'utils/bottles.rb', line 164

def system
  @system
end

Class Method Details

.from_arg(arg, os:, arch:) ⇒ T.attached_class

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.

Parameters:

Returns:

  • (T.attached_class) 


186
187
188
189
190
191
192
 
# File 'utils/bottles.rb', line 186

def self.from_arg(arg, os:, arch:)
  if arg
    from_symbol(arg)
  else
    new(system: os, arch:)
  end
end

.from_symbol(value) ⇒ T.attached_class

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.

Parameters:

Returns:

  • (T.attached_class)

Raises:

  • (ArgumentError) 


167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
 
# File 'utils/bottles.rb', line 167

def self.from_symbol(value)
  return new(system: :all, arch: :all) if value == :all

  @all_archs_regex ||= T.let(begin
    all_archs = Hardware::CPU::ALL_ARCHS.map(&:to_s)
    /
      ^((?<arch>#{Regexp.union(all_archs)})_)?
      (?<system>[\w.]+)$
    /x
  end, T.nilable(Regexp))
  match = @all_archs_regex.match(value.to_s)
  raise ArgumentError, "Invalid bottle tag symbol" unless match

  system = T.must(match[:system]).to_sym
  arch = match[:arch]&.to_sym || :x86_64
  new(system:, arch:)
end

Instance Method Details

#default_cellar ⇒ String

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.

Returns:



288
289
290
291
292
293
294
295
296
 
# File 'utils/bottles.rb', line 288

def default_cellar
  if linux?
    Homebrew::DEFAULT_LINUX_CELLAR
  elsif standardized_arch == :arm64
    Homebrew::DEFAULT_MACOS_ARM_CELLAR
  else
    Homebrew::DEFAULT_MACOS_CELLAR
  end
end

#default_prefix ⇒ String

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.

Returns:



277
278
279
280
281
282
283
284
285
 
# File 'utils/bottles.rb', line 277

def default_prefix
  if linux?
    T.must(HOMEBREW_LINUX_DEFAULT_PREFIX)
  elsif standardized_arch == :arm64
    T.must(HOMEBREW_MACOS_ARM_DEFAULT_PREFIX)
  else
    HOMEBREW_DEFAULT_PREFIX
  end
end

#linux? ⇒ Boolean

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.

Returns:

  • (Boolean) 


258
259
260
 
# File 'utils/bottles.rb', line 258

def linux?
  system == :linux
end

#macos? ⇒ Boolean

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.

Returns:

  • (Boolean) 


263
264
265
 
# File 'utils/bottles.rb', line 263

def macos?
  MacOSVersion::SYMBOLS.key?(system)
end

#standardized_arch ⇒ Symbol

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.

Returns:



226
227
228
229
230
231
 
# File 'utils/bottles.rb', line 226

def standardized_arch
  return :x86_64 if [:x86_64, :intel].include? arch
  return :arm64 if [:arm64, :arm, :aarch64].include? arch

  arch
end

#to_macos_version ⇒ MacOSVersion

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.

Returns:



253
254
255
 
# File 'utils/bottles.rb', line 253

def to_macos_version
  @to_macos_version ||= T.let(MacOSVersion.from_symbol(system), T.nilable(MacOSVersion))
end

#to_sym ⇒ Symbol

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.

Returns:



234
235
236
 
# File 'utils/bottles.rb', line 234

def to_sym
  arch_to_symbol(standardized_arch)
end

#to_unstandardized_sym ⇒ Symbol

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.

Returns:



244
245
246
247
248
249
250
 
# File 'utils/bottles.rb', line 244

def to_unstandardized_sym
  # Never allow these generic names
  return to_sym if [:intel, :arm].include? arch

  # Backwards compatibility with older bottle names
  arch_to_symbol(arch)
end

#valid_combination? ⇒ Boolean

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.

Returns:

  • (Boolean) 


268
269
270
271
272
273
274
 
# File 'utils/bottles.rb', line 268

def valid_combination?
  return true unless [:arm64, :arm, :aarch64].include? arch
  return true unless macos?

  # Big Sur is the first version of macOS that runs on ARM
  to_macos_version >= :big_sur
end