class Gem::Dependency
def <=> other
def <=> other self.name <=> other.name end
def == other # :nodoc:
def == other # :nodoc: Gem::Dependency === other && self.name == other.name && self.type == other.type && self.requirement == other.requirement end
def =~ other
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
def hash # :nodoc:
def hash # :nodoc: name.hash ^ type.hash ^ requirement.hash end
def initialize name, *requirements
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
def inspect # :nodoc:
def inspect # :nodoc: if @prerelease "<%s type=%p name=%p requirements=%p prerelease=ok>" % [self.class, self.type, self.name, requirement.to_s] else "<%s type=%p name=%p requirements=%p>" % [self.class, self.type, self.name, requirement.to_s] end end
def latest_version?
def latest_version? @requirement.none? end
def match? obj, version=nil
def match? obj, version=nil if !version name = obj.name version = obj.version else name = obj end return false unless self.name === name return true if requirement.none? requirement.satisfied_by? Gem::Version.new(version) end
def matches_spec? spec
def matches_spec? spec return false unless name === spec.name return true if requirement.none? requirement.satisfied_by?(spec.version) end
def matching_specs platform_only = false
def matching_specs platform_only = false matches = Gem::Specification.find_all { |spec| self.name === spec.name and # TODO: == instead of === requirement.satisfied_by? spec.version } if platform_only matches.reject! { |spec| not Gem::Platform.match spec.platform } end matches = matches.sort_by { |s| s.sort_obj } # HACK: shouldn't be needed end
def merge other
def merge other unless name == other.name then 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
def prerelease?
def prerelease? @prerelease || requirement.prerelease? end
def pretty_print q # :nodoc:
def pretty_print q # :nodoc: q.group 1, 'Gem::Dependency.new(', ')' do q.pp name q.text ',' q.breakable q.pp requirement q.text ',' q.breakable q.pp type end end
def requirement
def requirement return @requirement if defined?(@requirement) and @requirement # @version_requirements and @version_requirement are legacy ivar # names, and supported here because older gems need to keep # working and Dependency doesn't implement marshal_dump and # marshal_load. In a happier world, this would be an # attr_accessor. The horrifying instance_variable_get you see # below is also the legacy of some old restructurings. # # Note also that because of backwards compatibility (loading new # gems in an old RubyGems installation), we can't add explicit # marshaling to this class until we want to make a big # break. Maybe 2.0. # # Children, define explicit marshal and unmarshal behavior for # public classes. Marshal formats are part of your public API. # REFACTOR: See above if defined?(@version_requirement) && @version_requirement version = @version_requirement.instance_variable_get :@version @version_requirement = nil @version_requirements = Gem::Requirement.new version end @requirement = @version_requirements if defined?(@version_requirements) end
def requirements_list
def requirements_list requirement.as_list end
def specific?
def specific? @requirement.specific? end
def to_s # :nodoc:
def to_s # :nodoc: if type != :runtime then "#{name} (#{requirement}, #{type})" else "#{name} (#{requirement})" end end
def to_spec
def to_spec matches = self.to_specs matches.find { |spec| spec.activated? } or matches.last end
def to_specs
def to_specs matches = matching_specs true # TODO: check Gem.activated_spec[self.name] in case matches falls outside if matches.empty? then specs = Gem::Specification.find_all { |s| s.name == name }.map { |x| x.full_name } if specs.empty? total = Gem::Specification.to_a.size error = Gem::LoadError.new \ "Could not find '#{name}' (#{requirement}) among #{total} total gem(s)" else error = Gem::LoadError.new \ "Could not find '#{name}' (#{requirement}) - did find: [#{specs.join ','}]" end error.name = self.name error.requirement = self.requirement raise error end # TODO: any other resolver validations should go here matches end
def type
def type @type ||= :runtime end