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 181[].freeze
-
NULL =
# File 'lib/bundler/index.rb', line 17"\0".freeze
-
RUBY =
# File 'lib/bundler/index.rb', line 16"ruby".freeze
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_dependency(dependency) private
- #search_by_name_and_version(name, version) private
- #search_by_spec(spec) private
- #specs_by_name(name) 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 82
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 140
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 80
alias_method :[], :search
#add_source(index)
# File 'lib/bundler/index.rb', line 153
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 147
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 Gem::Dependency then search_by_dependency(query) when Array then search_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_dependency(dependency) (private)
[ GitHub ]# File 'lib/bundler/index.rb', line 165
def search_by_dependency(dependency) @cache[dependency] ||= begin specs = specs_by_name(dependency.name) found = specs.select do |spec| next true if spec.source.is_a?(Source::Gemspec) dependency.matches_spec?(spec) end found end end
#search_by_name_and_version(name, version) (private)
[ GitHub ]# File 'lib/bundler/index.rb', line 177
def search_by_name_and_version(name, version) specs_by_name(name).select {|spec| spec.version == version } end
#search_by_spec(spec) (private)
[ GitHub ]# File 'lib/bundler/index.rb', line 183
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 132
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 161
def specs_by_name(name) @specs[name].values end
#unmet_dependency_names
[ GitHub ]# File 'lib/bundler/index.rb', line 102
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 119
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