Class: Resource::BottleManifest Private

Inherits:
Resource
  • Object
show all
Defined in:
resource.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.

A resource for a bottle manifest.

Defined Under Namespace

Classes: Error

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(bottle) ⇒ 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:



361
362
363
364
365
 
# File 'resource.rb', line 361

def initialize(bottle)
  super("#{bottle.name}_bottle_manifest")
  @bottle = bottle
  @manifest_annotations = T.let(nil, T.nilable(T::Hash[String, String]))
end

Instance Attribute Details

#bottle ⇒ Bottle (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:



358
359
360
 
# File 'resource.rb', line 358

def bottle
  @bottle
end

Instance Method Details

#bottle_size ⇒ Integer?

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:



403
404
405
 
# File 'resource.rb', line 403

def bottle_size
  manifest_annotations["sh.brew.bottle.size"]&.to_i
end

#clear_cache ⇒ 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.

This method returns an undefined value.



368
369
370
371
 
# File 'resource.rb', line 368

def clear_cache
  super
  @manifest_annotations = nil
end

#download_queue_name ⇒ 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:



441
 
# File 'resource.rb', line 441

def download_queue_name = "#{bottle.name} (#{bottle.resource.version})"

#download_queue_type ⇒ 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:



438
 
# File 'resource.rb', line 438

def download_queue_type = "Bottle Manifest"

#downloaded_and_valid? ⇒ 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) 


380
381
382
383
384
385
386
387
388
 
# File 'resource.rb', line 380

def downloaded_and_valid?
  return false unless downloaded?

  with_context(quiet: true) { verify_download_integrity(cached_download) }
  true
rescue Error
  clear_cache
  false
end

#installed_size ⇒ Integer?

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:



408
409
410
 
# File 'resource.rb', line 408

def installed_size
  manifest_annotations["sh.brew.bottle.installed_size"]&.to_i
end

#path_exec_files ⇒ Array<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:



413
414
415
 
# File 'resource.rb', line 413

def path_exec_files
  manifest_annotations["sh.brew.path_exec_files"]&.split(",")
end

#sbom_supplement ⇒ Hash{String => 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.

Returns:



418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
 
# File 'resource.rb', line 418

def sbom_supplement
  supplement = manifest_annotations["sh.brew.sbom.supplement"]
  return if supplement.blank?

  parsed_supplement = JSON.parse(supplement)
  return unless parsed_supplement.is_a?(Hash)

  if (tags = parsed_supplement["tags"]).is_a?(Hash)
    tag_supplement = tags[Utils::Bottles.tag.to_s]
    return tag_supplement if tag_supplement.is_a?(Hash)

    return
  end

  parsed_supplement
rescue JSON::ParserError
  nil
end

#tab ⇒ Hash{String => T.untyped}

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:

Raises:



391
392
393
394
395
396
397
398
399
400
 
# File 'resource.rb', line 391

def tab
  tab = manifest_annotations["sh.brew.tab"]
  raise Error, "Couldn't find tab from manifest." if tab.blank?

  begin
    JSON.parse(tab)
  rescue JSON::ParserError
    raise Error, "Couldn't parse tab JSON."
  end
end

#verify_download_integrity(_filename) ⇒ 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.

This method returns an undefined value.

Parameters:



374
375
376
377
 
# File 'resource.rb', line 374

def verify_download_integrity(_filename)
  # We don't have a checksum, but we can at least try parsing it.
  tab
end