PHP 8.2.31
Preview: requirement.rb Size: 7.15 KB
//proc/thread-self/root/opt/alt/ruby27/share/rubygems/rubygems/requirement.rb

# frozen_string_literal: true
require "rubygems/version"
require "rubygems/deprecate"

##
# A Requirement is a set of one or more version restrictions. It supports a
# few (<tt>=, !=, >, <, >=, <=, ~></tt>) different restriction operators.
#
# See Gem::Version for a description on how versions and requirements work
# together in RubyGems.

class Gem::Requirement

  OPS = { #:nodoc:
    "="  =>  lambda { |v, r| v == r },
    "!=" =>  lambda { |v, r| v != r },
    ">"  =>  lambda { |v, r| v >  r },
    "<"  =>  lambda { |v, r| v <  r },
    ">=" =>  lambda { |v, r| v >= r },
    "<=" =>  lambda { |v, r| v <= r },
    "~>" =>  lambda { |v, r| v >= r && v.release < r.bump }
  }.freeze

  SOURCE_SET_REQUIREMENT = Struct.new(:for_lockfile).new "!" # :nodoc:

  quoted = OPS.keys.map { |k| Regexp.quote k }.join "|"
  PATTERN_RAW = "\\s*(#{quoted})?\\s*(#{Gem::Version::VERSION_PATTERN})\\s*".freeze # :nodoc:

  ##
  # A regular expression that matches a requirement

  PATTERN = /\A#{PATTERN_RAW}\z/.freeze

  ##
  # The default requirement matches any non-prerelease version

  DefaultRequirement = [">=", Gem::Version.new(0)].freeze

  ##
  # The default requirement matches any version

  DefaultPrereleaseRequirement = [">=", Gem::Version.new("0.a")].freeze

  ##
  # Raised when a bad requirement is encountered

  class BadRequirementError < ArgumentError; end

  ##
  # Factory method to create a Gem::Requirement object.  Input may be
  # a Version, a String, or nil.  Intended to simplify client code.
  #
  # If the input is "weird", the default version requirement is
  # returned.

  def self.create(*inputs)
    return new inputs if inputs.length > 1

    input = inputs.shift

    case input
    when Gem::Requirement then
      input
    when Gem::Version, Array then
      new input
    when '!' then
      source_set
    else
      if input.respond_to? :to_str
        new [input.to_str]
      else
        default
      end
    end
  end

  def self.default
    new '>= 0'
  end

  def self.default_prerelease
    new '>= 0.a'
  end

  ###
  # A source set requirement, used for Gemfiles and lockfiles

  def self.source_set # :nodoc:
    SOURCE_SET_REQUIREMENT
  end

  ##
  # Parse +obj+, returning an <tt>[op, version]</tt> pair. +obj+ can
  # be a String or a Gem::Version.
  #
  # If +obj+ is a String, it can be either a full requirement
  # specification, like <tt>">= 1.2"</tt>, or a simple version number,
  # like <tt>"1.2"</tt>.
  #
  #     parse("> 1.0")                 # => [">", Gem::Version.new("1.0")]
  #     parse("1.0")                   # => ["=", Gem::Version.new("1.0")]
  #     parse(Gem::Version.new("1.0")) # => ["=,  Gem::Version.new("1.0")]

  def self.parse(obj)
    return ["=", obj] if Gem::Version === obj

    unless PATTERN =~ obj.to_s
      raise BadRequirementError, "Illformed requirement [#{obj.inspect}]"
    end

    if $1 == ">=" && $2 == "0"
      DefaultRequirement
    elsif $1 == ">=" && $2 == "0.a"
      DefaultPrereleaseRequirement
    else
      [$1 || "=", Gem::Version.new($2)]
    end
  end

  ##
  # An array of requirement pairs. The first element of the pair is
  # the op, and the second is the Gem::Version.

  attr_reader :requirements #:nodoc:

  ##
  # Constructs a requirement from +requirements+. Requirements can be
  # Strings, Gem::Versions, or Arrays of those. +nil+ and duplicate
  # requirements are ignored. An empty set of +requirements+ is the
  # same as <tt>">= 0"</tt>.

  def initialize(*requirements)
    requirements = requirements.flatten
    requirements.compact!
    requirements.uniq!

    if requirements.empty?
      @requirements = [DefaultRequirement]
    else
      @requirements = requirements.map! { |r| self.class.parse r }
    end
  end

  ##
  # Concatenates the +new+ requirements onto this requirement.

  def concat(new)
    new = new.flatten
    new.compact!
    new.uniq!
    new = new.map { |r| self.class.parse r }

    @requirements.concat new
  end

  ##
  # Formats this requirement for use in a Gem::RequestSet::Lockfile.

  def for_lockfile # :nodoc:
    return if [DefaultRequirement] == @requirements

    list = requirements.sort_by do |_, version|
      version
    end.map do |op, version|
      "#{op} #{version}"
    end.uniq

    " (#{list.join ', '})"
  end

  ##
  # true if this gem has no requirements.

  def none?
    if @requirements.size == 1
      @requirements[0] == DefaultRequirement
    else
      false
    end
  end

  ##
  # true if the requirement is for only an exact version

  def exact?
    return false unless @requirements.size == 1
    @requirements[0][0] == "="
  end

  def as_list # :nodoc:
    requirements.map { |op, version| "#{op} #{version}" }
  end

  def hash # :nodoc:
    requirements.sort.hash
  end

  def marshal_dump # :nodoc:
    fix_syck_default_key_in_requirements

    [@requirements]
  end

  def marshal_load(array) # :nodoc:
    @requirements = array[0]

    fix_syck_default_key_in_requirements
  end

  def yaml_initialize(tag, vals) # :nodoc:
    vals.each do |ivar, val|
      instance_variable_set "@#{ivar}", val
    end

    Gem.load_yaml
    fix_syck_default_key_in_requirements
  end

  def init_with(coder) # :nodoc:
    yaml_initialize coder.tag, coder.map
  end

  def to_yaml_properties # :nodoc:
    ["@requirements"]
  end

  def encode_with(coder) # :nodoc:
    coder.add 'requirements', @requirements
  end

  ##
  # A requirement is a prerelease if any of the versions inside of it
  # are prereleases

  def prerelease?
    requirements.any? { |r| r.last.prerelease? }
  end

  def pretty_print(q) # :nodoc:
    q.group 1, 'Gem::Requirement.new(', ')' do
      q.pp as_list
    end
  end

  ##
  # True if +version+ satisfies this Requirement.

  def satisfied_by?(version)
    raise ArgumentError, "Need a Gem::Version: #{version.inspect}" unless
      Gem::Version === version
    # #28965: syck has a bug with unquoted '=' YAML.loading as YAML::DefaultKey
    requirements.all? { |op, rv| (OPS[op] || OPS["="]).call version, rv }
  end

  alias :=== :satisfied_by?
  alias :=~ :satisfied_by?

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

  def specific?
    return true if @requirements.length > 1 # GIGO, > 1, > 2 is silly

    not %w[> >=].include? @requirements.first.first # grab the operator
  end

  def to_s # :nodoc:
    as_list.join ", "
  end

  def ==(other) # :nodoc:
    return unless Gem::Requirement === other

    # An == check is always necessary
    return false unless requirements == other.requirements

    # An == check is sufficient unless any requirements use ~>
    return true unless _tilde_requirements.any?

    # If any requirements use ~> we use the stricter `#eql?` that also checks
    # that version precision is the same
    _tilde_requirements.eql?(other._tilde_requirements)
  end

  protected

  def _tilde_requirements
    requirements.select { |r| r.first == "~>" }
  end

  private

  def fix_syck_default_key_in_requirements # :nodoc:
    Gem.load_yaml

    # Fixup the Syck DefaultKey bug
    @requirements.each do |r|
      if r[0].kind_of? Gem::SyckDefaultKey
        r[0] = "="
      end
    end
  end

end

class Gem::Version

  # This is needed for compatibility with older yaml
  # gemspecs.

  Requirement = Gem::Requirement # :nodoc:

end

Directory Contents

Dirs: 12 × Files: 65

Name Size Perms Modified Actions
commands DIR
- drwxr-xr-x 2024-03-03 22:47:27
Edit Download
core_ext DIR
- drwxr-xr-x 2024-03-03 22:47:27
Edit Download
defaults DIR
- drwxr-xr-x 2024-03-03 22:47:27
Edit Download
ext DIR
- drwxr-xr-x 2024-03-03 22:47:27
Edit Download
package DIR
- drwxr-xr-x 2024-03-03 22:47:27
Edit Download
request DIR
- drwxr-xr-x 2024-03-03 22:47:27
Edit Download
- drwxr-xr-x 2024-03-03 22:47:27
Edit Download
resolver DIR
- drwxr-xr-x 2024-03-03 22:47:27
Edit Download
security DIR
- drwxr-xr-x 2024-03-03 22:47:27
Edit Download
source DIR
- drwxr-xr-x 2024-03-03 22:47:27
Edit Download
ssl_certs DIR
- drwxr-xr-x 2023-06-06 14:55:54
Edit Download
util DIR
- drwxr-xr-x 2024-03-03 22:47:27
Edit Download
3.02 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
7.62 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
2.97 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
15.79 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
4.99 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
1022 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
12.69 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
4.76 KB lrw-r--r-- 2023-06-06 14:51:26
Edit Download
8.64 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
12.00 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
5.54 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
1.75 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
3.06 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
4.64 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
6.49 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
460 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
5.16 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
2.18 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
11.29 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
26.62 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
4.80 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
336 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
310 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
6.26 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
3.53 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
1.38 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
2.42 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
17.99 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
3.80 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
1.88 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
6.25 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
300 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
796 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
524 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
9.48 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
8.70 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
11.94 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
7.15 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
9.46 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
5.93 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
1.55 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
21.24 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
1.03 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
22.72 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
5.38 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
2.55 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
274 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
272 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
70.78 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
11.67 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
6.30 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
4.74 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
2.12 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
39.92 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
8.84 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
1.85 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
8.83 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
778 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
785 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
324 B lrw-r--r-- 2023-03-30 12:34:08
Edit Download
13.30 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
2.41 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
3.65 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
12.45 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download
2.02 KB lrw-r--r-- 2023-03-30 12:34:08
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).