class Gem::Dependency
Constants
- TYPES
Valid dependency types.
Attributes
Dependency
name or regular expression.
Allows you to force this dependency to be a prerelease.
Public Class Methods
Constructs a dependency with name
and requirements
. The last argument can optionally be the dependency type, which defaults to :runtime
.
# File lib/rubygems/dependency.rb, line 39 def initialize(name, *requirements) case name when String then # ok when Regexp then msg = ["NOTE: Dependency.new w/ a regexp is deprecated.", "Dependency.new called from #{Gem.location_of_caller.join(":")}"] warn msg.join("\n") unless Gem::Deprecate.skip else raise ArgumentError, "dependency name must be a String, was #{name.inspect}" end type = Symbol === requirements.last ? requirements.pop : :runtime requirements = requirements.first if 1 == requirements.length # unpack unless TYPES.include? type raise ArgumentError, "Valid types are #{TYPES.inspect}, " + "not #{type.inspect}" end @name = name @requirement = Gem::Requirement.create requirements @type = type @prerelease = false # This is for Marshal backwards compatibility. See the comments in # +requirement+ for the dirty details. @version_requirements = @requirement end
Public Instance Methods
Dependencies are ordered by name.
# File lib/rubygems/dependency.rb, line 183 def <=>(other) self.name <=> other.name end
Uses this dependency as a pattern to compare to other
. This dependency will match if the name matches the other's name, and other has only an equal version requirement that satisfies this dependency.
# File lib/rubygems/dependency.rb, line 193 def =~(other) unless Gem::Dependency === other return unless other.respond_to?(:name) && other.respond_to?(:version) other = Gem::Dependency.new other.name, other.version end return false unless name === other.name reqs = other.requirement.requirements return false unless reqs.length == 1 return false unless reqs.first.first == '=' version = reqs.first.last requirement.satisfied_by? version end
# File lib/bundler/rubygems_ext.rb, line 143 def encode_with(coder) to_yaml_properties.each do |ivar| coder[ivar.to_s.sub(/^@/, "")] = instance_variable_get(ivar) end end
Is this dependency simply asking for the latest version of a gem?
# File lib/rubygems/dependency.rb, line 99 def latest_version? @requirement.none? end
Does this dependency match the specification described by name
and version
or match spec
?
NOTE: Unlike matches_spec?
this method does not return true when the version is a prerelease version unless this is a prerelease dependency.
# File lib/rubygems/dependency.rb, line 225 def match?(obj, version=nil, allow_prerelease=false) if !version name = obj.name version = obj.version else name = obj end return false unless self.name === name version = Gem::Version.new version return true if requirement.none? and not version.prerelease? return false if version.prerelease? and not allow_prerelease and not prerelease? requirement.satisfied_by? version end
Backport of performance enhancement added to RubyGems 1.4
# File lib/bundler/rubygems_ext.rb, line 163 def matches_spec?(spec) # name can be a Regexp, so use === return false unless name === spec.name return true if requirement.none? requirement.satisfied_by?(spec.version) end
# File lib/rubygems/dependency.rb, line 278 def matching_specs(platform_only = false) env_req = Gem.env_requirement(name) matches = Gem::Specification.stubs_for(name).find_all { |spec| requirement.satisfied_by?(spec.version) && env_req.satisfied_by?(spec.version) }.map(&:to_spec) Gem::BundlerVersionFinder.filter!(matches) if name == "bundler".freeze if platform_only matches.reject! { |spec| spec.nil? || !Gem::Platform.match(spec.platform) } end matches end
Merges the requirements of other
into this dependency
# File lib/rubygems/dependency.rb, line 262 def merge(other) unless name == other.name raise ArgumentError, "#{self} and #{other} have different names" end default = Gem::Requirement.default self_req = self.requirement other_req = other.requirement return self.class.new name, self_req if other_req == default return self.class.new name, other_req if self_req == default self.class.new name, self_req.as_list.concat(other_req.as_list) end
Does this dependency require a prerelease?
# File lib/rubygems/dependency.rb, line 91 def prerelease? @prerelease || requirement.prerelease? end
# File lib/bundler/shared_helpers.rb, line 17 def requirement version_requirements end
# File lib/rubygems/dependency.rb, line 150 def requirements_list requirement.as_list end
# File lib/rubygems/dependency.rb, line 169 def runtime? @type == :runtime || !@type end
True if the dependency will not always match the latest version.
# File lib/rubygems/dependency.rb, line 298 def specific? @requirement.specific? end
# File lib/bundler/rubygems_ext.rb, line 153 def to_lock out = String.new(" #{name}") unless requirement.none? reqs = requirement.requirements.map {|o, v| "#{o} #{v}" }.sort.reverse out << " (#{reqs.join(", ")})" end out end
# File lib/rubygems/dependency.rb, line 322 def to_spec matches = self.to_specs.compact active = matches.find { |spec| spec.activated? } return active if active return matches.first if prerelease? # Move prereleases to the end of the list for >= 0 requirements pre, matches = matches.partition { |spec| spec.version.prerelease? } matches += pre if requirement == Gem::Requirement.default matches.first end
# File lib/rubygems/dependency.rb, line 302 def to_specs matches = matching_specs true # TODO: check Gem.activated_spec[self.name] in case matches falls outside if matches.empty? specs = Gem::Specification.stubs_for name if specs.empty? raise Gem::MissingSpecError.new name, requirement else raise Gem::MissingSpecVersionError.new name, requirement, specs end end # TODO: any other resolver validations should go here matches end
# File lib/bundler/rubygems_ext.rb, line 149 def to_yaml_properties instance_variables.reject {|p| ["@source", "@groups", "@all_sources"].include?(p.to_s) } end
Dependency
type.
# File lib/rubygems/dependency.rb, line 165 def type @type ||= :runtime end