Class: Cask::Cask Private

Inherits:
Object show all
Extended by:
APIHashable, Attrable, Forwardable
Includes:
Metadata
Defined in:
cask/cask.rb,
cask/cask.rbi,
sorbet/rbi/parlour.rbi

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.

An instance of a cask.

Constant Summary

Constants included from Metadata

Metadata::METADATA_SUBDIR, Metadata::TIMESTAMP_FORMAT

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Attrable

attr_predicate, attr_rw

Methods included from APIHashable

generated_hash!, generating_hash!, generating_hash?

Methods included from Metadata

#metadata_main_container_path, #metadata_subdir, #metadata_timestamped_path, #metadata_versioned_path

Constructor Details

#initialize(token, sourcefile_path: nil, source: nil, tap: nil, loaded_from_api: false, config: nil, allow_reassignment: false, loader: nil, &block) ⇒ 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:

  • token (String)
  • sourcefile_path (Pathname, nil) (defaults to: nil)
  • source (String, nil) (defaults to: nil)
  • tap (Tap, nil) (defaults to: nil)
  • loaded_from_api (Boolean) (defaults to: false)
  • config (Config, nil) (defaults to: nil)
  • allow_reassignment (Boolean) (defaults to: false)
  • loader (CaskLoader::ILoader, nil) (defaults to: nil)
  • block (T.proc.bind(DSL).void, nil)


72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
# File 'cask/cask.rb', line 72

def initialize(token, sourcefile_path: nil, source: nil, tap: nil, loaded_from_api: false,
               config: nil, allow_reassignment: false, loader: nil, &block)
  @token = token
  @sourcefile_path = sourcefile_path
  @source = source
  @tap = tap
  @allow_reassignment = allow_reassignment
  @loaded_from_api = loaded_from_api
  @loader = loader
  # Sorbet has trouble with bound procs assigned to instance variables:
  # https://github.com/sorbet/sorbet/issues/6843
  instance_variable_set(:@block, block)

  @default_config = config || Config.new

  self.config = if config_path.exist?
    Config.from_json(File.read(config_path), ignore_invalid_keys: true)
  else
    @default_config
  end
end

Instance Attribute Details

#allow_reassignmentObject

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.



32
33
34
# File 'cask/cask.rb', line 32

def allow_reassignment
  @allow_reassignment
end

#configObject

This method is part of an internal API. This method may only be used internally in repositories owned by Homebrew, except in casks or formulae. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

The configuration of this Cask::Cask.



29
30
31
# File 'cask/cask.rb', line 29

def config
  @config
end

#default_configObject (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.



31
32
33
# File 'cask/cask.rb', line 31

def default_config
  @default_config
end

#downloadObject

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.



32
33
34
# File 'cask/cask.rb', line 32

def download
  @download
end

#loaderObject (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.



31
32
33
# File 'cask/cask.rb', line 31

def loader
  @loader
end

#sourceObject (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.



31
32
33
# File 'cask/cask.rb', line 31

def source
  @source
end

#sourcefile_pathObject (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.



31
32
33
# File 'cask/cask.rb', line 31

def sourcefile_path
  @sourcefile_path
end

#tokenObject (readonly)

This method is part of an internal API. This method may only be used internally in repositories owned by Homebrew, except in casks or formulae. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

The token of this Cask::Cask.



24
25
26
# File 'cask/cask.rb', line 24

def token
  @token
end

Class Method Details

.all(eval_all: false) ⇒ Object

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.



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
# File 'cask/cask.rb', line 36

def self.all(eval_all: false)
  if !eval_all && !Homebrew::EnvConfig.eval_all?
    raise ArgumentError, "Cask::Cask#all cannot be used without `--eval-all` or HOMEBREW_EVAL_ALL"
  end

  # Load core casks from tokens so they load from the API when the core cask is not tapped.
  tokens_and_files = CoreCaskTap.instance.cask_tokens
  tokens_and_files += Tap.reject(&:core_cask_tap?).flat_map(&:cask_files)
  tokens_and_files.filter_map do |token_or_file|
    CaskLoader.load(token_or_file)
  rescue CaskUnreadableError => e
    opoo e.message

    nil
  end
end

Instance Method Details

#appdirObject

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.



5
# File 'cask/cask.rbi', line 5

def appdir; end

#artifactsObject

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.



7
# File 'cask/cask.rbi', line 7

def artifacts; end

#auto_updatesObject

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.



9
# File 'cask/cask.rbi', line 9

def auto_updates; end

#bundle_long_versionString?

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:



208
209
210
# File 'cask/cask.rb', line 208

def bundle_long_version
  bundle_version&.version
end

#bundle_short_versionString?

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:



203
204
205
# File 'cask/cask.rb', line 203

def bundle_short_version
  bundle_version&.short_version
end

#caskfile_only?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.

The caskfile is needed during installation when there are *flight blocks or the cask has multiple languages

Returns:

  • (Boolean)


157
158
159
# File 'cask/cask.rb', line 157

def caskfile_only?
  languages.any? || artifacts.any?(Artifact::AbstractFlightBlock)
end

#caskroom_pathPathname

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:



241
242
243
# File 'cask/cask.rb', line 241

def caskroom_path
  @caskroom_path ||= Caskroom.path.join(token)
end

#caveatsObject

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.



11
# File 'cask/cask.rbi', line 11

def caveats; end

#checksumable?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)


216
217
218
# File 'cask/cask.rb', line 216

def checksumable?
  DownloadStrategyDetector.detect(url.to_s, url.using) <= AbstractFileDownloadStrategy
end

#config_pathObject

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.



212
213
214
# File 'cask/cask.rb', line 212

def config_path
  /"config.json"
end

#conflicts_withObject

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.



13
# File 'cask/cask.rbi', line 13

def conflicts_with; end

#containerObject

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.



15
# File 'cask/cask.rbi', line 15

def container; end

#depends_onObject

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.



17
# File 'cask/cask.rbi', line 17

def depends_on; end

#deprecated?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)


23
# File 'cask/cask.rbi', line 23

def deprecated?; end

#deprecation_dateObject

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.



25
# File 'cask/cask.rbi', line 25

def deprecation_date; end

#deprecation_reasonObject

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.



27
# File 'cask/cask.rbi', line 27

def deprecation_reason; end

#descObject

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.



19
# File 'cask/cask.rbi', line 19

def desc; end

#disable_dateObject

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.



31
# File 'cask/cask.rbi', line 31

def disable_date; end

#disable_reasonObject

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.



33
# File 'cask/cask.rbi', line 33

def disable_reason; end

#disabled?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)


29
# File 'cask/cask.rbi', line 29

def disabled?; end

#discontinued?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)


21
# File 'cask/cask.rbi', line 21

def discontinued?; end

#download_sha_pathObject

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.



220
221
222
# File 'cask/cask.rb', line 220

def download_sha_path
  /"LATEST_DOWNLOAD_SHA256"
end

#full_nameObject

This method is part of an internal API. This method may only be used internally in repositories owned by Homebrew, except in casks or formulae. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Alias for #full_token.



148
# File 'cask/cask.rb', line 148

def full_name = full_token

#full_tokenObject

This method is part of an internal API. This method may only be used internally in repositories owned by Homebrew, except in casks or formulae. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

The fully-qualified token of this Cask::Cask.



138
139
140
141
142
143
# File 'cask/cask.rb', line 138

def full_token
  return token if tap.nil?
  return token if tap.core_cask_tap?

  "#{tap.name}/#{token}"
end

#homepageObject

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.



35
# File 'cask/cask.rbi', line 35

def homepage; end

#install_timeTime?

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:



162
163
164
165
166
# File 'cask/cask.rb', line 162

def install_time
  # <caskroom_path>/.metadata/<version>/<timestamp>/Casks/<token>.{rb,json} -> <timestamp>
  time = installed_caskfile&.dirname&.dirname&.basename&.to_s
  Time.strptime(time, Metadata::TIMESTAMP_FORMAT) if time
end

#installed?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)


151
152
153
# File 'cask/cask.rb', line 151

def installed?
  installed_caskfile&.exist? || false
end

#installed_caskfilePathname?

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:



169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
# File 'cask/cask.rb', line 169

def installed_caskfile
  installed_caskroom_path = caskroom_path
  installed_token = token

  # Check if the cask is installed with an old name.
  old_tokens.each do |old_token|
    old_caskroom_path = Caskroom.path/old_token
    next if !old_caskroom_path.directory? || old_caskroom_path.symlink?

    installed_caskroom_path = old_caskroom_path
    installed_token = old_token
    break
  end

  installed_version = timestamped_versions(caskroom_path: installed_caskroom_path).last
  return unless installed_version

  caskfile_dir = (caskroom_path: installed_caskroom_path)
                 .join(*installed_version, "Casks")

  ["json", "rb"]
    .map { |ext| caskfile_dir.join("#{installed_token}.#{ext}") }
    .find(&:exist?)
end

#installed_versionString?

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:



195
196
197
198
199
200
# File 'cask/cask.rb', line 195

def installed_version
  return unless (installed_caskfile = self.installed_caskfile)

  # <caskroom_path>/.metadata/<version>/<timestamp>/Casks/<token>.{rb,json} -> <version>
  installed_caskfile.dirname.dirname.dirname.basename.to_s
end

#languageObject

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.



37
# File 'cask/cask.rbi', line 37

def language; end

#languagesObject

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.



304
305
306
# File 'cask/cask.rb', line 304

def languages
  @languages ||= @dsl.languages
end

#livecheckObject

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.



41
# File 'cask/cask.rbi', line 41

def livecheck; end

#livecheckable?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)


43
# File 'cask/cask.rbi', line 43

def livecheckable?; end

#loaded_from_api?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)


313
# File 'sorbet/rbi/parlour.rbi', line 313

def loaded_from_api?; end

#nameObject

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.



45
# File 'cask/cask.rbi', line 45

def name; end

#new_download_shaObject

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.



224
225
226
227
228
229
230
231
# File 'cask/cask.rb', line 224

def new_download_sha
  require "cask/installer"

  # Call checksumable? before hashing
  @new_download_sha ||= Installer.new(self, verify_download_integrity: false)
                                 .download(quiet: true)
                                 .instance_eval { |x| Digest::SHA256.file(x).hexdigest }
end

#old_tokensArray<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.

An old name for the cask.

Returns:



96
97
98
99
100
101
102
103
# File 'cask/cask.rb', line 96

def old_tokens
  @old_tokens ||= if (tap = self.tap)
    Tap.tap_migration_oldnames(tap, token) +
      tap.cask_reverse_renames.fetch(token, [])
  else
    []
  end
end

#on_system_blocks_exist?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)


47
# File 'cask/cask.rbi', line 47

def on_system_blocks_exist?; end

#outdated?(greedy: false, greedy_latest: false, greedy_auto_updates: false) ⇒ Boolean

This method is part of an internal API. This method may only be used internally in repositories owned by Homebrew, except in casks or formulae. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Check if the installed cask is outdated.

Returns:

  • (Boolean)


248
249
250
251
# File 'cask/cask.rb', line 248

def outdated?(greedy: false, greedy_latest: false, greedy_auto_updates: false)
  !outdated_version(greedy:, greedy_latest:,
                    greedy_auto_updates:).nil?
end

#outdated_download_sha?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)


233
234
235
236
237
238
# File 'cask/cask.rb', line 233

def outdated_download_sha?
  return true unless checksumable?

  current_download_sha = download_sha_path.read if download_sha_path.exist?
  current_download_sha.blank? || current_download_sha != new_download_sha
end

#outdated_info(greedy, verbose, json, greedy_latest, greedy_auto_updates) ⇒ Object

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.



271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
# File 'cask/cask.rb', line 271

def outdated_info(greedy, verbose, json, greedy_latest, greedy_auto_updates)
  return token if !verbose && !json

  installed_version = outdated_version(greedy:, greedy_latest:,
                                       greedy_auto_updates:).to_s

  if json
    {
      name:               token,
      installed_versions: [installed_version],
      current_version:    version,
    }
  else
    "#{token} (#{installed_version}) != #{version}"
  end
end

#outdated_version(greedy: false, greedy_latest: false, greedy_auto_updates: false) ⇒ Object

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.



253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
# File 'cask/cask.rb', line 253

def outdated_version(greedy: false, greedy_latest: false, greedy_auto_updates: false)
  # special case: tap version is not available
  return if version.nil?

  if version.latest?
    return installed_version if (greedy || greedy_latest) && outdated_download_sha?

    return
  elsif auto_updates && !greedy && !greedy_auto_updates
    return
  end

  # not outdated unless there is a different version on tap
  return if installed_version == version

  installed_version
end

#populate_from_api!(json_cask) ⇒ Object

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.

Raises:

  • (ArgumentError)


312
313
314
315
316
317
318
319
320
321
322
323
324
# File 'cask/cask.rb', line 312

def populate_from_api!(json_cask)
  raise ArgumentError, "Expected cask to be loaded from the API" unless loaded_from_api?

  @languages = json_cask.fetch(:languages, [])
  @tap_git_head = json_cask.fetch(:tap_git_head, "HEAD")

  @ruby_source_path = json_cask[:ruby_source_path]

  # TODO: Clean this up when we deprecate the current JSON API and move to the internal JSON v3.
  ruby_source_sha256 = json_cask.dig(:ruby_source_checksum, :sha256)
  ruby_source_sha256 ||= json_cask[:ruby_source_sha256]
  @ruby_source_checksum = { sha256: ruby_source_sha256 }
end

#refreshObject

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.



111
112
113
114
115
116
117
# File 'cask/cask.rb', line 111

def refresh
  @dsl = DSL.new(self)
  return unless @block

  @dsl.instance_eval(&@block)
  @dsl.language_eval
end

#ruby_source_checksumHash{Symbol => 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:



298
299
300
301
302
# File 'cask/cask.rb', line 298

def ruby_source_checksum
  @ruby_source_checksum ||= {
    sha256: Digest::SHA256.file(sourcefile_path).hexdigest,
  }.freeze
end

#ruby_source_pathObject

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.



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

def ruby_source_path
  return @ruby_source_path if defined?(@ruby_source_path)

  return unless sourcefile_path
  return unless tap

  @ruby_source_path = sourcefile_path.relative_path_from(tap.path)
end

#sha256Object

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.



49
# File 'cask/cask.rbi', line 49

def sha256; end

#staged_pathObject

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.



51
# File 'cask/cask.rbi', line 51

def staged_path; end

#tapObject

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.



53
54
55
56
57
# File 'cask/cask.rb', line 53

def tap
  return super if block_given? # Object#tap

  @tap
end

#tap_git_headObject

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.



308
309
310
# File 'cask/cask.rb', line 308

def tap_git_head
  @tap_git_head ||= tap&.git_head
end

#timestamped_versions(caskroom_path: self.caskroom_path) ⇒ Array<Array(String, 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.

Parameters:

  • caskroom_path (Pathname) (defaults to: self.caskroom_path)

Returns:



124
125
126
127
128
129
130
131
132
133
# File 'cask/cask.rb', line 124

def timestamped_versions(caskroom_path: self.caskroom_path)
  relative_paths = Pathname.glob((
                                   version: "*", timestamp: "*",
                                   caskroom_path:
                                 ))
                           .map { |p| p.relative_path_from(p.parent.parent) }
  # Sorbet is unaware that Pathname is sortable: https://github.com/sorbet/sorbet/issues/6844
  T.unsafe(relative_paths).sort_by(&:basename) # sort by timestamp
   .map { |p| p.split.map(&:to_s) }
end

#to_hObject

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.



344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
# File 'cask/cask.rb', line 344

def to_h
  {
    "token"                => token,
    "full_token"           => full_name,
    "old_tokens"           => old_tokens,
    "tap"                  => tap&.name,
    "name"                 => name,
    "desc"                 => desc,
    "homepage"             => homepage,
    "url"                  => url,
    "url_specs"            => url_specs,
    "version"              => version,
    "installed"            => installed_version,
    "installed_time"       => install_time&.to_i,
    "bundle_version"       => bundle_long_version,
    "bundle_short_version" => bundle_short_version,
    "outdated"             => outdated?,
    "sha256"               => sha256,
    "artifacts"            => artifacts_list,
    "caveats"              => (caveats unless caveats.empty?),
    "depends_on"           => depends_on,
    "conflicts_with"       => conflicts_with,
    "container"            => container&.pairs,
    "auto_updates"         => auto_updates,
    "deprecated"           => deprecated?,
    "deprecation_date"     => deprecation_date,
    "deprecation_reason"   => deprecation_reason,
    "disabled"             => disabled?,
    "disable_date"         => disable_date,
    "disable_reason"       => disable_reason,
    "tap_git_head"         => tap_git_head,
    "languages"            => languages,
    "ruby_source_path"     => ruby_source_path,
    "ruby_source_checksum" => ruby_source_checksum,
  }
end

#to_hash_with_variations(hash_method: :to_h) ⇒ Object

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.



423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
# File 'cask/cask.rb', line 423

def to_hash_with_variations(hash_method: :to_h)
  case hash_method
  when :to_h
    if loaded_from_api? && !Homebrew::EnvConfig.no_install_from_api?
      return api_to_local_hash(Homebrew::API::Cask.all_casks[token].dup)
    end
  when :to_internal_api_hash
    raise ArgumentError, "API Hash must be generated from Ruby source files" if loaded_from_api?
  else
    raise ArgumentError, "Unknown hash method #{hash_method.inspect}"
  end

  hash = public_send(hash_method)
  variations = {}

  if @dsl.on_system_blocks_exist?
    begin
      MacOSVersion::SYMBOLS.keys.product(OnSystem::ARCH_OPTIONS).each do |os, arch|
        bottle_tag = ::Utils::Bottles::Tag.new(system: os, arch:)
        next unless bottle_tag.valid_combination?

        Homebrew::SimulateSystem.with(os:, arch:) do
          refresh

          public_send(hash_method).each do |key, value|
            next if HASH_KEYS_TO_SKIP.include? key
            next if value.to_s == hash[key].to_s

            variations[bottle_tag.to_sym] ||= {}
            variations[bottle_tag.to_sym][key] = value
          end
        end
      end
    ensure
      refresh
    end
  end

  hash["variations"] = variations if hash_method != :to_internal_api_hash || variations.present?
  hash
end

#to_internal_api_hashObject

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.



381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
# File 'cask/cask.rb', line 381

def to_internal_api_hash
  api_hash = {
    "token"              => token,
    "name"               => name,
    "desc"               => desc,
    "homepage"           => homepage,
    "url"                => url,
    "version"            => version,
    "sha256"             => sha256,
    "artifacts"          => artifacts_list(compact: true),
    "ruby_source_path"   => ruby_source_path,
    "ruby_source_sha256" => ruby_source_checksum.fetch(:sha256),
  }

  if deprecation_date
    api_hash["deprecation_date"] = deprecation_date
    api_hash["deprecation_reason"] = deprecation_reason
  end

  if disable_date
    api_hash["disable_date"] = disable_date
    api_hash["disable_reason"] = disable_reason
  end

  if (url_specs_hash = url_specs).present?
    api_hash["url_specs"] = url_specs_hash
  end

  api_hash["caskfile_only"] = true if caskfile_only?
  api_hash["conflicts_with"] = conflicts_with if conflicts_with.present?
  api_hash["depends_on"] = depends_on if depends_on.present?
  api_hash["container"] = container.pairs if container
  api_hash["caveats"] = caveats if caveats.present?
  api_hash["auto_updates"] = auto_updates if auto_updates
  api_hash["languages"] = languages if languages.present?

  api_hash
end

#urlObject

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.



53
# File 'cask/cask.rbi', line 53

def url; end

#versionObject

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.



55
# File 'cask/cask.rbi', line 55

def version; end