Class: Bundler::Index
| Relationships & Source Files | |
| Super Chains via Extension / Inclusion / Inheritance | |
| Instance Chain: 
          self,
          Enumerable
         | |
| Inherits: | Object | 
| Defined in: | lib/bundler/index.rb | 
Constant Summary
- 
    EMPTY_SEARCH =
    
 # File 'lib/bundler/index.rb', line 168[].freeze
- 
    NULL =
    
 # File 'lib/bundler/index.rb', line 17"\0"
- 
    RUBY =
    
 # File 'lib/bundler/index.rb', line 16"ruby"
Class Method Summary
- .build {|i| ... }
- .new ⇒ Index constructor
Instance Attribute Summary
- #empty? ⇒ Boolean readonly
- #sources readonly
- #all_specs readonly protected
- #specs readonly protected
Instance Method Summary
- #<<(spec)
- 
    
      #==(other)  
    
    Whether all the specs in self are in other TODO: rename to #include?
- 
    
      #[](query)  
    
    Alias for #search. 
- #add_source(index)
- #dependencies_eql?(spec, other_spec) ⇒ Boolean
- #dependency_names
- #each(&blk)
- #initialize_copy(o)
- #inspect
- #local_search(query)
- 
    
      #search(query)  
      (also: #[])
    
    Search this index’s specs, and any source indexes that this index knows about, returning all of the results. 
- #search_all(name)
- #size
- #spec_names
- #unmet_dependency_names
- #use(other, override_dupes = false)
- #search_by_spec(spec) private
- #specs_by_name(name) private
- #specs_by_name_and_version(name, version) private
Constructor Details
    .new  ⇒ Index 
  
# File 'lib/bundler/index.rb', line 19
def initialize @sources = [] @cache = {} @specs = Hash.new {|h, k| h[k] = {} } @all_specs = Hash.new {|h, k| h[k] = EMPTY_SEARCH } end
Class Method Details
.build {|i| ... }
# File 'lib/bundler/index.rb', line 7
def self.build i = new yield i i end
Instance Attribute Details
#all_specs (readonly, protected)
[ GitHub ]
    #empty?  ⇒ Boolean  (readonly)
  
  [ GitHub ]
# File 'lib/bundler/index.rb', line 44
def empty? each { return false } true end
#sources (readonly)
[ GitHub ]#specs (readonly, protected)
[ GitHub ]Instance Method Details
#<<(spec)
[ GitHub ]# File 'lib/bundler/index.rb', line 81
def <<(spec) @specs[spec.name][spec.full_name] = spec spec end
#==(other)
Whether all the specs in self are in other TODO: rename to #include?
# File 'lib/bundler/index.rb', line 139
def ==(other) all? do |spec| other_spec = other[spec].first other_spec && dependencies_eql?(spec, other_spec) && spec.source == other_spec.source end end
#[](query)
Alias for #search.
# File 'lib/bundler/index.rb', line 79
alias_method :[], :search
#add_source(index)
# File 'lib/bundler/index.rb', line 152
def add_source(index) raise ArgumentError, "Source must be an index, not #{index.class}" unless index.is_a?(Index) @sources << index @sources.uniq! # need to use uniq! here instead of checking for the item before adding end
    #dependencies_eql?(spec, other_spec)  ⇒ Boolean 
  
# File 'lib/bundler/index.rb', line 146
def dependencies_eql?(spec, other_spec) deps = spec.dependencies.select {|d| d.type != :development } other_deps = other_spec.dependencies.select {|d| d.type != :development } deps.sort == other_deps.sort end
#dependency_names
[ GitHub ]#each(&blk)
[ GitHub ]#initialize_copy(o)
[ GitHub ]# File 'lib/bundler/index.rb', line 26
def initialize_copy(o) @sources = o.sources.dup @cache = {} @specs = Hash.new {|h, k| h[k] = {} } @all_specs = Hash.new {|h, k| h[k] = EMPTY_SEARCH } o.specs.each do |name, hash| @specs[name] = hash.dup end o.all_specs.each do |name, array| @all_specs[name] = array.dup end end
#inspect
[ GitHub ]#local_search(query)
[ GitHub ]# File 'lib/bundler/index.rb', line 69
def local_search(query) case query when Gem::Specification, RemoteSpecification, LazySpecification, EndpointSpecification then search_by_spec(query) when String then specs_by_name(query) when Array then specs_by_name_and_version(*query) else raise "You can't search for a #{query.inspect}." end end
#search(query) Also known as: #[]
Search this index’s specs, and any source indexes that this index knows about, returning all of the results.
# File 'lib/bundler/index.rb', line 59
def search(query) results = local_search(query) return results unless @sources.any? @sources.each do |source| results.concat(source.search(query)) end results.uniq(&:full_name) end
#search_all(name)
[ GitHub ]# File 'lib/bundler/index.rb', line 49
def search_all(name) all_matches = local_search(name) + @all_specs[name] @sources.each do |source| all_matches.concat(source.search_all(name)) end all_matches end
#search_by_spec(spec) (private)
[ GitHub ]# File 'lib/bundler/index.rb', line 170
def search_by_spec(spec) spec = @specs[spec.name][spec.full_name] spec ? [spec] : EMPTY_SEARCH end
#size
[ GitHub ]# File 'lib/bundler/index.rb', line 131
def size @sources.inject(@specs.size) do |size, source| size += source.size end end
#spec_names
[ GitHub ]#specs_by_name(name) (private)
[ GitHub ]# File 'lib/bundler/index.rb', line 164
def specs_by_name(name) @specs[name].values end
#specs_by_name_and_version(name, version) (private)
[ GitHub ]# File 'lib/bundler/index.rb', line 160
def specs_by_name_and_version(name, version) specs_by_name(name).select {|spec| spec.version == version } end
#unmet_dependency_names
[ GitHub ]# File 'lib/bundler/index.rb', line 101
def unmet_dependency_names dependency_names.select do |name| search(name).empty? end end
#use(other, override_dupes = false)
[ GitHub ]# File 'lib/bundler/index.rb', line 118
def use(other, override_dupes = false) return unless other other.each do |s| if (dupes = search_by_spec(s)) && !dupes.empty? # safe to << since it's a new array when it has contents @all_specs[s.name] = dupes << s next unless override_dupes end self << s end self end