Class: Bundler::Index
- Inherits:
 - 
      Object
      
        
- Object
 - Bundler::Index
 
 
- Includes:
 - Enumerable
 
- Defined in:
 - lib/bundler/index.rb
 
Constant Summary collapse
- RUBY =
 "ruby".freeze
- NULL =
 "\0".freeze
Instance Attribute Summary collapse
- 
  
    
      #sources  ⇒ Object 
    
    
  
  
  
  
    
      readonly
    
    
  
  
  
  
  
  
    
Returns the value of attribute sources.
 
Class Method Summary collapse
Instance Method Summary collapse
- #<<(spec) ⇒ Object
 - 
  
    
      #==(other)  ⇒ Object 
    
    
  
  
  
  
  
  
  
  
  
    
Whether all the specs in self are in other TODO: rename to #include?.
 - #add_source(index) ⇒ Object
 - #dependencies_eql?(spec, other_spec) ⇒ Boolean
 - #dependency_names ⇒ Object
 - #each(&blk) ⇒ Object
 - #empty? ⇒ Boolean
 - 
  
    
      #initialize  ⇒ Index 
    
    
  
  
  
    constructor
  
  
  
  
  
  
  
    
A new instance of Index.
 - #initialize_copy(o) ⇒ Object
 - #inspect ⇒ Object
 - #local_search(query, base = nil) ⇒ Object
 - 
  
    
      #search(query, base = nil)  ⇒ Object 
    
    
      (also: #[])
    
  
  
  
  
  
  
  
  
  
    
Search this index’s specs, and any source indexes that this index knows about, returning all of the results.
 - #search_all(name) ⇒ Object
 - #size ⇒ Object
 - #sort_specs(specs) ⇒ Object
 - #spec_names ⇒ Object
 - 
  
    
      #unmet_dependency_names  ⇒ Object 
    
    
  
  
  
  
  
  
  
  
  
    
returns a list of the dependencies.
 - #use(other, override_dupes = false) ⇒ Object
 
Constructor Details
#initialize ⇒ Index
Returns a new instance of Index.
      21 22 23 24 25 26  | 
    
      # File 'lib/bundler/index.rb', line 21 def initialize @sources = [] @cache = {} @specs = Hash.new {|h, k| h[k] = {} } @all_specs = Hash.new {|h, k| h[k] = EMPTY_SEARCH } end  | 
  
Instance Attribute Details
#sources ⇒ Object (readonly)
Returns the value of attribute sources.
      15 16 17  | 
    
      # File 'lib/bundler/index.rb', line 15 def sources @sources end  | 
  
Class Method Details
.build {|i| ... } ⇒ Object
      9 10 11 12 13  | 
    
      # File 'lib/bundler/index.rb', line 9 def self.build i = new yield i i end  | 
  
Instance Method Details
#<<(spec) ⇒ Object
      104 105 106 107  | 
    
      # File 'lib/bundler/index.rb', line 104 def <<(spec) @specs[spec.name][spec.full_name] = spec spec end  | 
  
#==(other) ⇒ Object
Whether all the specs in self are in other TODO: rename to #include?
      163 164 165 166 167 168  | 
    
      # File 'lib/bundler/index.rb', line 163 def ==(other) all? do |spec| other_spec = other[spec].first other_spec && dependencies_eql?(spec, other_spec) && spec.source == other_spec.source end end  | 
  
#add_source(index) ⇒ Object
      176 177 178 179 180  | 
    
      # File 'lib/bundler/index.rb', line 176 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
      170 171 172 173 174  | 
    
      # File 'lib/bundler/index.rb', line 170 def dependencies_eql?(spec, other_spec) deps = spec.dependencies.select {|d| d.type != :development } other_deps = other_spec.dependencies.select {|d| d.type != :development } Set.new(deps) == Set.new(other_deps) end  | 
  
#dependency_names ⇒ Object
      131 132 133 134 135 136 137 138 139 140  | 
    
      # File 'lib/bundler/index.rb', line 131 def dependency_names names = [] each do |spec| spec.dependencies.each do |dep| next if dep.type == :development names << dep.name end end names.uniq end  | 
  
#each(&blk) ⇒ Object
      109 110 111 112 113 114 115 116  | 
    
      # File 'lib/bundler/index.rb', line 109 def each(&blk) return enum_for(:each) unless blk specs.values.each do |spec_sets| spec_sets.values.each(&blk) end sources.each {|s| s.each(&blk) } self end  | 
  
#empty? ⇒ Boolean
      46 47 48 49  | 
    
      # File 'lib/bundler/index.rb', line 46 def empty? each { return false } true end  | 
  
#initialize_copy(o) ⇒ Object
      28 29 30 31 32 33 34 35 36 37 38 39 40  | 
    
      # File 'lib/bundler/index.rb', line 28 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 ⇒ Object
      42 43 44  | 
    
      # File 'lib/bundler/index.rb', line 42 def inspect "#<#{self.class}:0x#{object_id} sources=#{sources.map(&:inspect)} specs.size=#{specs.size}>" end  | 
  
#local_search(query, base = nil) ⇒ Object
      91 92 93 94 95 96 97 98 99 100  | 
    
      # File 'lib/bundler/index.rb', line 91 def local_search(query, base = nil) case query when Gem::Specification, RemoteSpecification, LazySpecification, EndpointSpecification then search_by_spec(query) when String then specs_by_name(query) when Gem::Dependency then search_by_dependency(query, base) when DepProxy then search_by_dependency(query.dep, base) else raise "You can't search for a #{query.inspect}." end end  | 
  
#search(query, base = nil) ⇒ Object Also known as: []
Search this index’s specs, and any source indexes that this index knows about, returning all of the results.
      61 62 63  | 
    
      # File 'lib/bundler/index.rb', line 61 def search(query, base = nil) sort_specs(unsorted_search(query, base)) end  | 
  
#search_all(name) ⇒ Object
      51 52 53 54 55 56 57  | 
    
      # File 'lib/bundler/index.rb', line 51 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  | 
  
#size ⇒ Object
      155 156 157 158 159  | 
    
      # File 'lib/bundler/index.rb', line 155 def size @sources.inject(@specs.size) do |size, source| size += source.size end end  | 
  
#sort_specs(specs) ⇒ Object
      87 88 89  | 
    
      # File 'lib/bundler/index.rb', line 87 def sort_specs(specs) self.class.sort_specs(specs) end  | 
  
#spec_names ⇒ Object
      118 119 120 121 122  | 
    
      # File 'lib/bundler/index.rb', line 118 def spec_names names = specs.keys + sources.map(&:spec_names) names.uniq! names end  | 
  
#unmet_dependency_names ⇒ Object
returns a list of the dependencies
      125 126 127 128 129  | 
    
      # File 'lib/bundler/index.rb', line 125 def unmet_dependency_names dependency_names.select do |name| name != "bundler" && search(name).empty? end end  | 
  
#use(other, override_dupes = false) ⇒ Object
      142 143 144 145 146 147 148 149 150 151 152 153  | 
    
      # File 'lib/bundler/index.rb', line 142 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  |