Class: Cask::CaskLoader::FromNameLoader Private

Inherits:
FromTapLoader show all
Extended by:
Utils::Output::Mixin
Defined in:
cask/cask_loader.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.

Loader which tries loading casks from tap paths, failing if the same token exists in multiple taps.

Instance Attribute Summary

Attributes inherited from FromTapLoader

#tap

Attributes inherited from FromPathLoader

#path, #token

Attributes inherited from AbstractContentLoader

#content, #tap

Class Method Summary collapse

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, pretty_deprecated, pretty_disabled, pretty_duration, pretty_install_status, pretty_installed, pretty_outdated, pretty_uninstalled, pretty_upgradable

Methods inherited from FromTapLoader

#initialize, #load, loader_from_token_tap_type

Methods inherited from FromPathLoader

#initialize, invalid_path?, #load

Methods inherited from AbstractContentLoader

#initialize

Methods included from ILoader

#load

Constructor Details

This class inherits a constructor from Cask::CaskLoader::FromTapLoader

Class Method Details

.try_new(ref, warn: false) ⇒ 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:



567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
 
# File 'cask/cask_loader.rb', line 567

def self.try_new(ref, warn: false)
  return unless ref.is_a?(String)
  return unless ref.match?(/\A#{HOMEBREW_TAP_CASK_TOKEN_REGEX}\Z/o)

  token = ref.downcase

  # If it exists in the default tap, never treat it as ambiguous with another tap.
  if (core_cask_tap = CoreCaskTap.instance).installed? && (token_tap_type = CaskLoader.tap_cask_token_type(
    "#{core_cask_tap}/#{token}", warn: false
  ))
    migrated_token, migrated_tap, type = token_tap_type

    if warn && [:rename, :migration].include?(type) &&
       !(type == :migration && migrated_tap.core_tap?)
      opoo "Cask #{token} was renamed to " \
           "#{migrated_tap.core_cask_tap? ? migrated_token : "#{migrated_tap}/#{migrated_token}"}."
    end

    if (core_cask_loader = loader_from_token_tap_type(token_tap_type))&.path&.exist?
      return core_cask_loader
    end
  end

  loaders = Tap.select { |tap| tap.installed? && !tap.core_cask_tap? }
               .filter_map { |tap| super("#{tap}/#{token}", warn:) }
               .uniq(&:path)
               .select { |loader| loader.is_a?(FromAPILoader) || loader.path.exist? }

  case loaders.count
  when 1
    loaders.first
  when 2..Float::INFINITY
    raise TapCaskAmbiguityError.new(token, loaders)
  end
end