Class: Bundler::RemoteSpecification

Inherits:
Object
  • Object
show all
Includes:
MatchPlatform, 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

StubSpecification

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, platform_specificity_match, select_best_platform_match

Constructor Details

#initialize(name, version, platform, spec_fetcher) ⇒ RemoteSpecification

Returns a new instance of RemoteSpecification



18
19
20
21
22
23
24
# File 'lib/bundler/remote_specification.rb', line 18

def initialize(name, version, platform, spec_fetcher)
  @name         = name
  @version      = Gem::Version.create version
  @platform     = 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)



105
106
107
# File 'lib/bundler/remote_specification.rb', line 105

def method_missing(method, *args, &blk)
  _remote_specification.send(method, *args, &blk)
end

Instance Attribute Details

#dependenciesObject



76
77
78
79
80
81
82
83
84
85
86
# File 'lib/bundler/remote_specification.rb', line 76

def dependencies
  @dependencies ||= begin
    deps = method_missing(:dependencies)

    # allow us to handle when the specs dependencies are an array of array of string
    # see https://github.com/bundler/bundler/issues/5797
    deps = deps.map {|d| d.is_a?(Gem::Dependency) ? d : Gem::Dependency.new(*d) }

    deps
  end
end

#nameObject (readonly)

Returns the value of attribute name



14
15
16
# File 'lib/bundler/remote_specification.rb', line 14

def name
  @name
end

#platformObject (readonly)

Returns the value of attribute platform



14
15
16
# File 'lib/bundler/remote_specification.rb', line 14

def platform
  @platform
end

#remoteObject

Returns the value of attribute remote



16
17
18
# File 'lib/bundler/remote_specification.rb', line 16

def remote
  @remote
end

#sourceObject

Returns the value of attribute source



16
17
18
# File 'lib/bundler/remote_specification.rb', line 16

def source
  @source
end

#versionObject (readonly)

Returns the value of attribute version



14
15
16
# File 'lib/bundler/remote_specification.rb', line 14

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
# File 'lib/bundler/remote_specification.rb', line 54

def __swap__(spec)
  SharedHelpers.ensure_same_dependencies(self, dependencies, spec.dependencies)
  @_remote_specification = spec
end

#fetch_platformObject

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_nameObject



32
33
34
35
36
37
38
# File 'lib/bundler/remote_specification.rb', line 32

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

#git_versionObject



88
89
90
91
# File 'lib/bundler/remote_specification.rb', line 88

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

Returns:

  • (Boolean)


109
110
111
# File 'lib/bundler/remote_specification.rb', line 109

def respond_to?(method, include_all = false)
  super || _remote_specification.respond_to?(method, include_all)
end

#sort_objArray

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.

Returns:

  • (Array)

    an object you can use to compare and sort this specification against other specifications

See Also:

  • #<=>
  • Gem::Specification#sort_obj


68
69
70
# File 'lib/bundler/remote_specification.rb', line 68

def sort_obj
  [@name, @version, @platform == Gem::Platform::RUBY ? -1 : 1]
end

#to_sObject



72
73
74
# File 'lib/bundler/remote_specification.rb', line 72

def to_s
  "#<#{self.class} name=#{name} version=#{version} platform=#{platform}>"
end