Class: Bundler::LazySpecification

Inherits:
Object
  • Object
show all
Includes:
MatchPlatform
Defined in:
lib/bundler/lazy_specification.rb

Constant Summary

Constants included from GemHelpers

GemHelpers::GENERICS, GemHelpers::GENERIC_CACHE

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from MatchPlatform

#match_platform, platforms_match?

Methods included from GemHelpers

generic, generic_local_platform, local_platform, platform_specificity_match, same_deps, same_specificity, select_best_platform_match

Constructor Details

#initialize(name, version, platform, source = nil) ⇒ LazySpecification

Returns a new instance of LazySpecification.



12
13
14
15
16
17
18
19
 
# File 'lib/bundler/lazy_specification.rb', line 12

def initialize(name, version, platform, source = nil)
  @name          = name
  @version       = version
  @dependencies  = []
  @platform      = platform || Gem::Platform::RUBY
  @source        = source
  @specification = nil
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method, *args, &blk) ⇒ Object (private) 



137
138
139
140
141
142
143
 
# File 'lib/bundler/lazy_specification.rb', line 137

def method_missing(method, *args, &blk)
  raise "LazySpecification has not been materialized yet (calling :#{method} #{args.inspect})" unless @specification

  return super unless respond_to?(method)

  @specification.send(method, *args, &blk)
end

Instance Attribute Details

#dependencies ⇒ Object (readonly)

Returns the value of attribute dependencies.



9
10
11
 
# File 'lib/bundler/lazy_specification.rb', line 9

def dependencies
  @dependencies
end

#name ⇒ Object (readonly)

Returns the value of attribute name.



9
10
11
 
# File 'lib/bundler/lazy_specification.rb', line 9

def name
  @name
end

#platform ⇒ Object (readonly)

Returns the value of attribute platform.



9
10
11
 
# File 'lib/bundler/lazy_specification.rb', line 9

def platform
  @platform
end

#remote ⇒ Object

Returns the value of attribute remote.



10
11
12
 
# File 'lib/bundler/lazy_specification.rb', line 10

def remote
  @remote
end

#source ⇒ Object

Returns the value of attribute source.



10
11
12
 
# File 'lib/bundler/lazy_specification.rb', line 10

def source
  @source
end

#version ⇒ Object (readonly)

Returns the value of attribute version.



9
10
11
 
# File 'lib/bundler/lazy_specification.rb', line 9

def version
  @version
end

Instance Method Details

#==(other) ⇒ Object 



29
30
31
 
# File 'lib/bundler/lazy_specification.rb', line 29

def ==(other)
  identifier == other.identifier
end

#__materialize__ ⇒ Object 



78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
 
# File 'lib/bundler/lazy_specification.rb', line 78

def __materialize__
  @specification = if source.is_a?(Source::Gemspec) && source.gemspec.name == name
    source.gemspec.tap {|s| s.source = source }
  else
    search_object = if source.is_a?(Source::Path)
      Dependency.new(name, version)
    else
      ruby_platform_materializes_to_ruby_platform? ? self : Dependency.new(name, version)
    end
    platform_object = Gem::Platform.new(platform)
    candidates = source.specs.search(search_object)
    same_platform_candidates = candidates.select do |spec|
      MatchPlatform.platforms_match?(spec.platform, platform_object)
    end
    installable_candidates = same_platform_candidates.select do |spec|
      spec.is_a?(StubSpecification) ||
        (spec.required_ruby_version.satisfied_by?(Gem.ruby_version) &&
          spec.required_rubygems_version.satisfied_by?(Gem.rubygems_version))
    end
    search = installable_candidates.last || same_platform_candidates.last
    search.dependencies = dependencies if search && (search.is_a?(RemoteSpecification) || search.is_a?(EndpointSpecification))
    search
  end
end

#eql?(other) ⇒ Boolean

Returns:

  • (Boolean) 


33
34
35
 
# File 'lib/bundler/lazy_specification.rb', line 33

def eql?(other)
  identifier.eql?(other.identifier)
end

#full_name ⇒ Object 



21
22
23
24
25
26
27
 
# File 'lib/bundler/lazy_specification.rb', line 21

def full_name
  if platform == Gem::Platform::RUBY || platform.nil?
    "#{@name}-#{@version}"
  else
    "#{@name}-#{@version}-#{platform}"
  end
end

#git_version ⇒ Object 



119
120
121
122
 
# File 'lib/bundler/lazy_specification.rb', line 119

def git_version
  return unless source.is_a?(Bundler::Source::Git)
  " #{source.revision[0..6]}"
end

#hash ⇒ Object 



37
38
39
 
# File 'lib/bundler/lazy_specification.rb', line 37

def hash
  identifier.hash
end

#identifier ⇒ Object 



115
116
117
 
# File 'lib/bundler/lazy_specification.rb', line 115

def identifier
  @__identifier ||= [name, version, platform_string]
end

#respond_to?(*args) ⇒ Boolean

Returns:

  • (Boolean) 


103
104
105
 
# File 'lib/bundler/lazy_specification.rb', line 103

def respond_to?(*args)
  super || @specification ? @specification.respond_to?(*args) : nil
end

#satisfies?(dependency) ⇒ Boolean

Does this locked specification satisfy dependency?

NOTE: Rubygems default requirement is “>= 0”, which doesn’t match prereleases of 0 versions, like “0.0.0.dev” or “0.0.0.SNAPSHOT”. However, bundler users expect those to work. We need to make sure that Gemfile dependencies without explicit requirements (which use “>= 0” under the hood by default) are still valid for locked specs using this kind of versions. The method implements an ad-hoc fix for that. A better solution might be to change default rubygems requirement of dependencies to be “>= 0.A” but that’s a major refactoring likely to break things. Hopefully we can attempt it in the future.

Returns:

  • (Boolean) 


55
56
57
58
59
 
# File 'lib/bundler/lazy_specification.rb', line 55

def satisfies?(dependency)
  effective_requirement = dependency.requirement == Gem::Requirement.default ? Gem::Requirement.new(">= 0.A") : dependency.requirement

  @name == dependency.name && effective_requirement.satisfied_by?(Gem::Version.new(@version))
end

#to_lock ⇒ Object 



61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
 
# File 'lib/bundler/lazy_specification.rb', line 61

def to_lock
  out = String.new

  if platform == Gem::Platform::RUBY || platform.nil?
    out << "    #{name} (#{version})\n"
  else
    out << "    #{name} (#{version}-#{platform})\n"
  end

  dependencies.sort_by(&:to_s).uniq.each do |dep|
    next if dep.type == :development
    out << "    #{dep.to_lock}\n"
  end

  out
end

#to_s ⇒ Object 



107
108
109
110
111
112
113
 
# File 'lib/bundler/lazy_specification.rb', line 107

def to_s
  @__to_s ||= if platform == Gem::Platform::RUBY || platform.nil?
    "#{name} (#{version})"
  else
    "#{name} (#{version}-#{platform})"
  end
end