Class: Bundler::RemoteSpecification
- Inherits:
-
Object
- Object
- Bundler::RemoteSpecification
- Includes:
- MatchPlatform, MatchRemoteMetadata, Comparable
- Defined in:
- lib/bundler/remote_specification.rb
Overview
Represents a lazily loaded gem specification, where the full specification is on the source server in rubygems’ “quick” index. The proxy object is to be seeded with what we’re given from the source’s abbreviated index - the full specification will only be fetched when necessary.
Direct Known Subclasses
Constant Summary
Constants included from GemHelpers
GemHelpers::GENERICS, GemHelpers::GENERIC_CACHE
Instance Attribute Summary collapse
- #dependencies ⇒ Object
-
#name ⇒ Object
readonly
Returns the value of attribute name.
-
#platform ⇒ Object
readonly
Returns the value of attribute platform.
-
#remote ⇒ Object
Returns the value of attribute remote.
-
#source ⇒ Object
Returns the value of attribute source.
-
#version ⇒ Object
readonly
Returns the value of attribute version.
Instance Method Summary collapse
-
#<=>(other) ⇒ Object
Compare this specification against another object.
-
#__swap__(spec) ⇒ Object
Because Rubyforge cannot be trusted to provide valid specifications once the remote gem is downloaded, the backend specification will be swapped out.
-
#fetch_platform ⇒ Object
Needed before installs, since the arch matters then and quick specs don’t bother to include the arch in the platform string.
- #full_name ⇒ Object
- #git_version ⇒ Object
-
#initialize(name, version, platform, spec_fetcher) ⇒ RemoteSpecification
constructor
A new instance of RemoteSpecification.
- #respond_to?(method, include_all = false) ⇒ Boolean
- #runtime_dependencies ⇒ Object
-
#sort_obj ⇒ Array
Create a delegate used for sorting.
- #to_s ⇒ Object
Methods included from MatchPlatform
#match_platform, platforms_match?
Methods included from GemHelpers
force_ruby_platform, generic, generic_local_platform, generic_local_platform_is_ruby?, local_platform, platform_specificity_match, same_deps, same_specificity, select_best_platform_match, sort_best_platform_match
Methods included from MatchMetadata
#matches_current_metadata?, #matches_current_ruby?, #matches_current_rubygems?
Methods included from FetchMetadata
#matches_current_ruby?, #matches_current_rubygems?
Constructor Details
#initialize(name, version, platform, spec_fetcher) ⇒ RemoteSpecification
Returns a new instance of RemoteSpecification.
17 18 19 20 21 22 23 24 |
# File 'lib/bundler/remote_specification.rb', line 17 def initialize(name, version, platform, spec_fetcher) @name = name @version = Gem::Version.create version @original_platform = platform || Gem::Platform::RUBY @platform = Gem::Platform.new(platform) @spec_fetcher = spec_fetcher @dependencies = nil end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(method, *args, &blk) ⇒ Object (private)
112 113 114 |
# File 'lib/bundler/remote_specification.rb', line 112 def method_missing(method, *args, &blk) _remote_specification.send(method, *args, &blk) end |
Instance Attribute Details
#dependencies ⇒ Object
78 79 80 81 82 83 84 85 86 87 88 89 |
# File 'lib/bundler/remote_specification.rb', line 78 def dependencies @dependencies ||= begin deps = method_missing(:dependencies) # allow us to handle when the specs dependencies are an array of array of string # in order to delay the crash to `#__swap__` where it results in a friendlier error # see https://github.com/rubygems/bundler/issues/5797 deps = deps.map {|d| d.is_a?(Gem::Dependency) ? d : Gem::Dependency.new(*d) } deps end end |
#name ⇒ Object (readonly)
Returns the value of attribute name.
13 14 15 |
# File 'lib/bundler/remote_specification.rb', line 13 def name @name end |
#platform ⇒ Object (readonly)
Returns the value of attribute platform.
13 14 15 |
# File 'lib/bundler/remote_specification.rb', line 13 def platform @platform end |
#remote ⇒ Object
Returns the value of attribute remote.
15 16 17 |
# File 'lib/bundler/remote_specification.rb', line 15 def remote @remote end |
#source ⇒ Object
Returns the value of attribute source.
15 16 17 |
# File 'lib/bundler/remote_specification.rb', line 15 def source @source end |
#version ⇒ Object (readonly)
Returns the value of attribute version.
13 14 15 |
# File 'lib/bundler/remote_specification.rb', line 13 def version @version end |
Instance Method Details
#<=>(other) ⇒ Object
Compare this specification against another object. Using sort_obj is compatible with Gem::Specification and other Bundler or RubyGems objects. Otherwise, use the default Object comparison.
43 44 45 46 47 48 49 |
# File 'lib/bundler/remote_specification.rb', line 43 def <=>(other) if other.respond_to?(:sort_obj) sort_obj <=> other.sort_obj else super end end |
#__swap__(spec) ⇒ Object
Because Rubyforge cannot be trusted to provide valid specifications once the remote gem is downloaded, the backend specification will be swapped out.
54 55 56 57 58 59 |
# File 'lib/bundler/remote_specification.rb', line 54 def __swap__(spec) raise APIResponseInvalidDependenciesError unless spec.dependencies.all? {|d| d.is_a?(Gem::Dependency) } SharedHelpers.ensure_same_dependencies(self, dependencies, spec.dependencies) @_remote_specification = spec end |
#fetch_platform ⇒ Object
Needed before installs, since the arch matters then and quick specs don’t bother to include the arch in the platform string
28 29 30 |
# File 'lib/bundler/remote_specification.rb', line 28 def fetch_platform @platform = _remote_specification.platform end |
#full_name ⇒ Object
32 33 34 35 36 37 38 |
# File 'lib/bundler/remote_specification.rb', line 32 def full_name @full_name ||= if @platform == Gem::Platform::RUBY "#{@name}-#{@version}" else "#{@name}-#{@version}-#{@platform}" end end |
#git_version ⇒ Object
95 96 97 98 |
# File 'lib/bundler/remote_specification.rb', line 95 def git_version return unless loaded_from && source.is_a?(Bundler::Source::Git) " #{source.revision[0..6]}" end |
#respond_to?(method, include_all = false) ⇒ Boolean
116 117 118 |
# File 'lib/bundler/remote_specification.rb', line 116 def respond_to?(method, include_all = false) super || _remote_specification.respond_to?(method, include_all) end |
#runtime_dependencies ⇒ Object
91 92 93 |
# File 'lib/bundler/remote_specification.rb', line 91 def runtime_dependencies dependencies.select(&:runtime?) end |
#sort_obj ⇒ Array
Create a delegate used for sorting. This strategy is copied from RubyGems 2.23 and ensures that Bundler’s specifications can be compared and sorted with RubyGems’ own specifications.
70 71 72 |
# File 'lib/bundler/remote_specification.rb', line 70 def sort_obj [@name, @version, @platform == Gem::Platform::RUBY ? -1 : 1] end |
#to_s ⇒ Object
74 75 76 |
# File 'lib/bundler/remote_specification.rb', line 74 def to_s "#<#{self.class} name=#{name} version=#{version} platform=#{platform}>" end |