?HAMA

Navigation

Breadcrumbs

/ / proc / thread-self / root / opt / alt / ruby27 / share / rubygems / rubygems

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 8.64 KB

//proc/thread-self/root/opt/alt/ruby27/share/rubygems/rubygems/dependency.rb

Text Base64

# frozen_string_literal: true
##
# The Dependency class holds a Gem name and a Gem::Requirement.

require "rubygems/bundler_version_finder"
require "rubygems/requirement"

class Gem::Dependency

##
  # Valid dependency types.
  #--
  # When this list is updated, be sure to change
  # Gem::Specification::CURRENT_SPECIFICATION_VERSION as well.
  #
  # REFACTOR: This type of constant, TYPES, indicates we might want
  # two classes, used via inheritance or duck typing.

TYPES = [
    :development,
    :runtime,
  ].freeze

##
  # Dependency name or regular expression.

attr_accessor :name

##
  # Allows you to force this dependency to be a prerelease.

attr_writer :prerelease

##
  # Constructs a dependency with +name+ and +requirements+. The last
  # argument can optionally be the dependency type, which defaults to
  # <tt>:runtime</tt>.

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

##
  # A dependency's hash is the XOR of the hashes of +name+, +type+,
  # and +requirement+.

def hash # :nodoc:
    name.hash ^ type.hash ^ requirement.hash
  end

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

##
  # Does this dependency require a prerelease?

def prerelease?
    @prerelease || requirement.prerelease?
  end

##
  # Is this dependency simply asking for the latest version
  # of a gem?

def latest_version?
    @requirement.none?
  end

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

##
  # What does this dependency require?

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
    requirement.as_list
  end

def to_s # :nodoc:
    if type != :runtime
      "#{name} (#{requirement}, #{type})"
    else
      "#{name} (#{requirement})"
    end
  end

##
  # Dependency type.

def type
    @type ||= :runtime
  end

def runtime?
    @type == :runtime || !@type
  end

def ==(other) # :nodoc:
    Gem::Dependency === other &&
      self.name        == other.name &&
      self.type        == other.type &&
      self.requirement == other.requirement
  end

##
  # Dependencies are ordered by name.

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.

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

alias === =~

##
  # :call-seq:
  #   dep.match? name          => true or false
  #   dep.match? name, version => true or false
  #   dep.match? spec          => true or false
  #
  # 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.

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

##
  # Does this dependency match +spec+?
  #
  # NOTE:  This is not a convenience method.  Unlike #match? this method
  # returns true when +spec+ is a prerelease version even if this dependency
  # is not a prerelease dependency.

def matches_spec?(spec)
    return false unless name === spec.name
    return true  if requirement.none?

requirement.satisfied_by?(spec.version)
  end

##
  # Merges the requirements of +other+ into this dependency

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

def matching_specs(platform_only = false)
    env_req = Gem.env_requirement(name)
    matches = Gem::Specification.stubs_for(name).find_all do |spec|
      requirement.satisfied_by?(spec.version) && env_req.satisfied_by?(spec.version)
    end.map(&:to_spec)

Gem::BundlerVersionFinder.filter!(matches) if name == "bundler".freeze && !requirement.specific?

if platform_only
      matches.reject! do |spec|
        spec.nil? || !Gem::Platform.match(spec.platform)
      end
    end

matches
  end

##
  # True if the dependency will not always match the latest version.

def specific?
    @requirement.specific?
  end

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

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

def identity
    if prerelease?
      if specific?
        :complete
      else
        :abs_latest
      end
    elsif latest_version?
      :latest
    else
      :released
    end
  end

end

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 12 × Files: 65

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
commands DIR	-	drwxr-xr-x	2024-03-03 22:47:27	Edit Download recursive recursive
core_ext DIR	-	drwxr-xr-x	2024-03-03 22:47:27	Edit Download recursive recursive
defaults DIR	-	drwxr-xr-x	2024-03-03 22:47:27	Edit Download recursive recursive
ext DIR	-	drwxr-xr-x	2024-03-03 22:47:27	Edit Download recursive recursive
package DIR	-	drwxr-xr-x	2024-03-03 22:47:27	Edit Download recursive recursive
request DIR	-	drwxr-xr-x	2024-03-03 22:47:27	Edit Download recursive recursive
request_set DIR	-	drwxr-xr-x	2024-03-03 22:47:27	Edit Download recursive recursive
resolver DIR	-	drwxr-xr-x	2024-03-03 22:47:27	Edit Download recursive recursive
security DIR	-	drwxr-xr-x	2024-03-03 22:47:27	Edit Download recursive recursive
source DIR	-	drwxr-xr-x	2024-03-03 22:47:27	Edit Download recursive recursive
ssl_certs DIR	-	drwxr-xr-x	2023-06-06 14:55:54	Edit Download recursive recursive
util DIR	-	drwxr-xr-x	2024-03-03 22:47:27	Edit Download recursive recursive
available_set.rb	3.02 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
basic_specification.rb	7.62 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
bundler_version_finder.rb	2.97 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
command.rb	15.79 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
command_manager.rb	4.99 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
compatibility.rb	1022 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
config_file.rb	12.69 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
defaults.rb	4.76 KB	lrw-r--r--	2023-06-06 14:51:26	Edit Download recursive recursive
dependency.rb	8.64 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
dependency_installer.rb	12.00 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
dependency_list.rb	5.54 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
deprecate.rb	1.75 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
doctor.rb	3.06 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
errors.rb	4.64 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
exceptions.rb	6.49 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
ext.rb	460 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
gemcutter_utilities.rb	5.16 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
gem_runner.rb	2.18 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
indexer.rb	11.29 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
installer.rb	26.62 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
installer_test_case.rb	4.80 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
install_default_message.rb	336 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
install_message.rb	310 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
install_update_options.rb	6.26 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
local_remote_options.rb	3.53 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
mock_gem_ui.rb	1.38 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
name_tuple.rb	2.42 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
package.rb	17.99 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
package_task.rb	3.80 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
path_support.rb	1.88 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
platform.rb	6.25 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
psych_additions.rb	300 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
psych_tree.rb	796 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
rdoc.rb	524 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
remote_fetcher.rb	9.48 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
request.rb	8.70 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
request_set.rb	11.94 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
requirement.rb	7.15 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
resolver.rb	9.46 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
s3_uri_signer.rb	5.93 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
safe_yaml.rb	1.55 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
security.rb	21.24 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
security_option.rb	1.03 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
server.rb	22.72 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
source.rb	5.38 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
source_list.rb	2.55 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
source_local.rb	274 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
source_specific_file.rb	272 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
specification.rb	70.78 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
specification_policy.rb	11.67 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
spec_fetcher.rb	6.30 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
stub_specification.rb	4.74 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
syck_hack.rb	2.12 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
test_case.rb	39.92 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
test_utilities.rb	8.84 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
text.rb	1.85 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
uninstaller.rb	8.83 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
uri_formatter.rb	778 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
uri_parser.rb	785 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
uri_parsing.rb	324 B	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
user_interaction.rb	13.30 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
util.rb	2.41 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
validator.rb	3.65 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
version.rb	12.45 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive
version_option.rb	2.02 KB	lrw-r--r--	2023-03-30 12:34:08	Edit Download recursive recursive