Class: Bundler::SpecSet
Relationships & Source Files | |
Super Chains via Extension / Inclusion / Inheritance | |
Instance Chain:
self,
TSort ,
Enumerable
|
|
Inherits: | Object |
Defined in: | lib/bundler/spec_set.rb |
Constant Summary
Class Method Summary
- .new(specs) ⇒ SpecSet constructor
Instance Attribute Summary
- #empty? ⇒ Boolean readonly
Instance Method Summary
- #-(other)
- #<<(spec)
- #[](key)
- #[]=(key, value)
- #add_extra_platforms!(platforms)
- #delete(specs)
- #delete_by_name(name)
- #each(&b)
- #find_by_name_and_platform(name, platform)
- #for(dependencies, platforms_or_legacy_check = [nil], legacy_platforms = [nil], skips: [])
- #incomplete_for_platform?(deps, platform) ⇒ Boolean
- #incomplete_specs
- #insecurely_materialized_specs
- #length
- #materialize(deps)
-
#materialized_for_all_platforms ⇒ Array<Gem::Specification>
Materialize for all the specs in the spec set, regardless of what platform they’re for.
- #missing_specs
- #missing_specs_for(dependencies)
- #names
- #normalize_platforms!(deps, platforms)
- #partially_missing_specs
- #size
- #sort!
- #to_a
- #to_hash
- #valid?(s) ⇒ Boolean
- #validate_deps(s)
- #what_required(spec)
- #all_platforms private
- #complete_platform(platform) private
- #extract_circular_gems(error) private
- #lookup private
- #materialize_dependencies(dependencies, platforms = [nil], skips: []) private
- #materialized_specs private
- #reset! private
- #sorted private
- #tsort_each_child(s) private
- #tsort_each_node private
- #valid_dependencies?(s) ⇒ Boolean private
TSort
- Included
#each_strongly_connected_component | The iterator version of the |
#each_strongly_connected_component_from | Iterates over strongly connected component in the subgraph reachable from node. |
#strongly_connected_components | Returns strongly connected components as an array of arrays of nodes. |
#tsort | Returns a topologically sorted array of nodes. |
#tsort_each | The iterator version of the |
#tsort_each_child | Should be implemented by a extended class. |
#tsort_each_node | Should be implemented by a extended class. |
Constructor Details
.new(specs) ⇒ SpecSet
# File 'lib/bundler/spec_set.rb', line 10
def initialize(specs) @specs = specs end
Instance Attribute Details
#empty? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'lib/bundler/spec_set.rb', line 191
def empty? @specs.empty? end
Instance Method Details
#-(other)
[ GitHub ]#<<(spec)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 179
def <<(spec) @specs << spec end
#[](key)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 80
def [](key) key = key.name if key.respond_to?(:name) lookup[key]&.reverse || [] end
#[]=(key, value)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 85
def []=(key, value) @specs << value reset! end
#add_extra_platforms!(platforms)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 50
def add_extra_platforms!(platforms) return platforms.concat([Gem::Platform::RUBY]).uniq if @specs.empty? new_platforms = all_platforms.select do |platform| next if platforms.include?(platform) next unless GemHelpers.generic(platform) == Gem::Platform::RUBY complete_platform(platform) end return platforms if new_platforms.empty? platforms.concat(new_platforms) less_specific_platform = new_platforms.find {|platform| platform != Gem::Platform::RUBY && Bundler.local_platform === platform && platform === Bundler.local_platform } platforms.delete(Bundler.local_platform) if less_specific_platform platforms end
#all_platforms (private)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 272
def all_platforms @specs.flat_map {|spec| spec.source.specs.search([spec.name, spec.version]).map(&:platform) }.uniq end
#complete_platform(platform) (private)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 245
def complete_platform(platform) new_specs = [] valid_platform = lookup.all? do |_, specs| spec = specs.first matching_specs = spec.source.specs.search([spec.name, spec.version]) platform_spec = GemHelpers.select_best_platform_match(matching_specs, platform).find do |s| valid?(s) end if platform_spec new_specs << LazySpecification.from_spec(platform_spec) unless specs.include?(platform_spec) true else false end end if valid_platform && new_specs.any? @specs.concat(new_specs) reset! end valid_platform end
#delete(specs)
[ GitHub ]#delete_by_name(name)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 166
def delete_by_name(name) @specs.reject! {|spec| spec.name == name } reset! end
#each(&b)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 195
def each(&b) sorted.each(&b) end
#extract_circular_gems(error) (private)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 292
def extract_circular_gems(error) error. .scan(/@name="(.*?)"/).flatten end
#find_by_name_and_platform(name, platform)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 162
def find_by_name_and_platform(name, platform) @specs.detect {|spec| spec.name == name && spec.match_platform(platform) } end
#for(dependencies, platforms_or_legacy_check = [nil], legacy_platforms = [nil], skips: [])
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 14
def for(dependencies, platforms_or_legacy_check = [nil], legacy_platforms = [nil], skips: []) platforms = if [true, false].include?(platforms_or_legacy_check) Bundler::SharedHelpers.major_deprecation 2, "SpecSet#for received a `check` parameter, but that's no longer used and deprecated. " \ "SpecSet#for always implicitly performs validation. Please remove this parameter", print_caller_location: true legacy_platforms else platforms_or_legacy_check end materialize_dependencies(dependencies, platforms, skips: skips) @materializations.flat_map(&:specs).uniq end
#incomplete_for_platform?(deps, platform) ⇒ Boolean
# File 'lib/bundler/spec_set.rb', line 127
def incomplete_for_platform?(deps, platform) return false if @specs.empty? validation_set = self.class.new(@specs) validation_set.for(deps, [platform]) validation_set.incomplete_specs.any? end
#incomplete_specs
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 150
def incomplete_specs @materializations.flat_map(&:incomplete_specs) end
#insecurely_materialized_specs
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 154
def insecurely_materialized_specs materialized_specs.select(&:insecurely_materialized?) end
#length
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 183
def length @specs.length end
#lookup (private)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 296
def lookup @lookup ||= begin lookup = {} @specs.each do |s| lookup[s.name] ||= [] lookup[s.name] << s end lookup end end
#materialize(deps)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 109
def materialize(deps) materialize_dependencies(deps) SpecSet.new(materialized_specs) end
#materialize_dependencies(dependencies, platforms = [nil], skips: []) (private)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 209
def materialize_dependencies(dependencies, platforms = [nil], skips: []) handled = ["bundler"].product(platforms).map {|k| [k, true] }.to_h deps = dependencies.product(platforms) @materializations = [] loop do break unless dep = deps.shift dependency = dep[0] platform = dep[1] name = dependency.name key = [name, platform] next if handled.key?(key) handled[key] = true materialization = Materialization.new(dependency, platform, candidates: lookup[name]) deps.concat(materialization.dependencies) if materialization.complete? @materializations << materialization unless skips.include?(name) end @materializations end
#materialized_for_all_platforms ⇒ Array
<Gem::Specification>
Materialize for all the specs in the spec set, regardless of what platform they’re for
# File 'lib/bundler/spec_set.rb', line 117
def materialized_for_all_platforms @specs.map do |s| next s unless s.is_a?(LazySpecification) s.source.remote! spec = s.materialize_strictly raise GemNotFound, "Could not find #{s.full_name} in any of the sources" unless spec spec end end
#materialized_specs (private)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 236
def materialized_specs @materializations.filter_map(&:materialized_spec) end
#missing_specs
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 142
def missing_specs @materializations.flat_map(&:completely_missing_specs) end
#missing_specs_for(dependencies)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 136
def missing_specs_for(dependencies) materialize_dependencies(dependencies) missing_specs end
#names
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 199
def names lookup.keys end
#normalize_platforms!(deps, platforms)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 31
def normalize_platforms!(deps, platforms) complete_platforms = add_extra_platforms!(platforms) complete_platforms.map do |platform| next platform if platform == Gem::Platform::RUBY begin Integer(platform.version) rescue ArgumentError, TypeError next platform end less_specific_platform = Gem::Platform.new([platform.cpu, platform.os, nil]) next platform if incomplete_for_platform?(deps, less_specific_platform) less_specific_platform end.uniq end
#partially_missing_specs
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 146
def partially_missing_specs @materializations.flat_map(&:partially_missing_specs) end
#reset! (private)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 240
def reset! @sorted = nil @lookup = nil end
#size
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 187
def size @specs.size end
#sort!
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 97
def sort! self end
#sorted (private)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 280
def sorted rake = @specs.find {|s| s.name == "rake" } begin @sorted ||= ([rake] + tsort).compact.uniq rescue TSort::Cyclic => error cgems = extract_circular_gems(error) raise CyclicDependencyError, "Your bundle requires gems that depend" \ " on each other, creating an infinite loop. Please remove either" \ " gem '#{cgems[0]}' or gem '#{cgems[1]}' and try again." end end
#to_a
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 101
def to_a sorted.dup end
#to_hash
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 105
def to_hash lookup.dup end
#tsort_each_child(s) (private)
[ GitHub ]#tsort_each_node (private)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 307
def tsort_each_node # MUST sort by name for backwards compatibility @specs.sort_by(&:name).each {|s| yield s } end
#valid?(s) ⇒ Boolean
# File 'lib/bundler/spec_set.rb', line 203
def valid?(s) s. && valid_dependencies?(s) end
#valid_dependencies?(s) ⇒ Boolean
(private)
# File 'lib/bundler/spec_set.rb', line 276
def valid_dependencies?(s) validate_deps(s) == :valid end
#validate_deps(s)
[ GitHub ]#what_required(spec)
[ GitHub ]# File 'lib/bundler/spec_set.rb', line 172
def what_required(spec) unless req = find {|s| s.runtime_dependencies.any? {|d| d.name == spec.name } } return [spec] end what_required(req) << spec end