123456789_123456789_123456789_123456789_123456789_

Class: Gem::Resolver::BestSet

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, ComposedSet, Set
Instance Chain:
self, ComposedSet, Set
Inherits: Gem::Resolver::ComposedSet
Defined in: lib/rubygems/resolver/best_set.rb

Overview

The BestSet chooses the best available method to query a remote index.

It combines IndexSet and APISet

Class Method Summary

ComposedSet - Inherited

.new

Creates a new ComposedSet containing sets.

Set - Inherited

.new

Instance Attribute Summary

ComposedSet - Inherited

#prerelease=

When allow_prerelease is set to true prereleases gems are allowed to match dependencies.
#remote=

Sets the remote network access for all composed sets.
#sets

Set - Inherited

#errors

Errors encountered when resolving gems.
#prerelease

When true, allows matching of requests to prerelease gems.
#remote

Set to true to disable network access for this set.
#remote?

When true, this set is allowed to access the network when looking up specifications or dependencies.

Instance Method Summary

ComposedSet - Inherited

#errors,
#find_all

Finds all specs matching req in all sets.
#prefetch

Prefetches reqs in all sets.

Set - Inherited

#find_all

The find_all method must be implemented.
#prefetch

The #prefetch method may be overridden, but this is not necessary.

Constructor Details

.new(sources = Gem.sources) ⇒ BestSet

Creates a BestSet for the given Gem.sources or Gem.sources if none are specified. Gem.sources must be a ::Gem::SourceList.

[ GitHub ] 

  


# File 'lib/rubygems/resolver/best_set.rb', line 13



def initialize(sources = Gem.sources)
  super()

  @sources = sources
end


  







Instance Method Details



  

    #find_all(req)  
  

  

    This method is for internal use only.
  

  [ GitHub ]


  

  


# File 'lib/rubygems/resolver/best_set.rb', line 28



def find_all(req) # :nodoc:
  pick_sets if @remote && @sets.empty?

  super
rescue Gem::RemoteFetcher::FetchError => e
  replace_failed_api_set e

  retry
end


  








  

    #pick_sets  
  

  

    This method is for internal use only.
  



  

    

Picks which sets to use for the configured sources.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/resolver/best_set.rb', line 22



def pick_sets # :nodoc:
  @sources.each_source do |source|
    @sets << source.dependency_resolver_set
  end
end


  








  

    #prefetch(reqs)  
  

  

    This method is for internal use only.
  

  [ GitHub ]


  

  


# File 'lib/rubygems/resolver/best_set.rb', line 38



def prefetch(reqs) # :nodoc:
  pick_sets if @remote && @sets.empty?

  super
end


  








  

    #pretty_print(q)  
  

  

    This method is for internal use only.
  

  [ GitHub ]


  

  


# File 'lib/rubygems/resolver/best_set.rb', line 44



def pretty_print(q) # :nodoc:
  q.group 2, "[BestSet", "]" do
    q.breakable
    q.text "sets:"

    q.breakable
    q.pp @sets
  end
end


  








  

    #replace_failed_api_set(error)  
  

  

    This method is for internal use only.
  



  

    

Replaces a failed APISet for the ::Gem::URI in error with an IndexSet.



If no matching APISet can be found the original error is raised.



The calling method must retry the exception to repeat the lookup.


  



  [ GitHub ]


  

  


# File 'lib/rubygems/resolver/best_set.rb', line 61



def replace_failed_api_set(error) # :nodoc:
  uri = error.original_uri
  uri = Gem::URI uri unless Gem::URI === uri
  uri += "."

  raise error unless api_set = @sets.find do |set|
    Gem::Resolver::APISet === set && set.dep_uri == uri
  end

  index_set = Gem::Resolver::IndexSet.new api_set.source

  @sets.map! do |set|
    next set unless set == api_set
    index_set
  end
end