Namespace
Methods
#
C
D
E
N
P
S
T
Constants
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 } }
 
PATTERN_RAW = "\\s*(#{quoted})?\\s*(#{Gem::Version::VERSION_PATTERN})\\s*"
 
PATTERN = /\A#{PATTERN_RAW}\z/
 
DefaultRequirement = [">=", Gem::Version.new(0)]
 
Class Public methods
create(input)

REFACTOR: There's no reason that this can't be unified with .new. .new is the standard Ruby factory method.

Source: show | on GitHub 

# File lib/rubygems/requirement.rb, line 47
def self.create input
  case input
  when Gem::Requirement then
    input
  when Gem::Version, Array then
    new input
  else
    if input.respond_to? :to_str then
      new [input.to_str]
    else
      default
    end
  end
end
default()

A default “version requirement” can surely only be '>= 0'.

Source: show | on GitHub 

# File lib/rubygems/requirement.rb, line 65
def self.default
  new '>= 0'
end
new(*requirements)

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 ">= 0".

Source: show | on GitHub 

# File lib/rubygems/requirement.rb, line 112
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
parse(obj)

REFACTOR: Little two element arrays like this have no real semantic value. I'd love to see something like this: Constraint = Struct.new(:operator, :version); (or similar) and have a Requirement be a list of Constraints.

Source: show | on GitHub 

# File lib/rubygems/requirement.rb, line 86
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
  else
    [$1 || "=", Gem::Version.new($2)]
  end
end
Instance Public methods
==(other)

DOC: this should probably be :nodoc'd

Source: show | on GitHub 

# File lib/rubygems/requirement.rb, line 218
def == other
  Gem::Requirement === other and to_s == other.to_s
end
===(version)
Alias for: satisfied_by?
=~(version)
Alias for: satisfied_by?
encode_with(coder)

Source: show | on GitHub 

# File lib/rubygems/requirement.rb, line 173
def encode_with(coder)
  coder.add 'requirements', @requirements
end
none?()

FIX: maybe this should be using default ?

Source: show | on GitHub 

# File lib/rubygems/requirement.rb, line 128
def none?
  if @requirements.size == 1
    @requirements[0] == DefaultRequirement
  else
    false
  end
end
prerelease?()

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

Source: show | on GitHub 

# File lib/rubygems/requirement.rb, line 181
def prerelease?
  requirements.any? { |r| r.last.prerelease? }
end
satisfied_by?(version)

True if version satisfies this Requirement.

Also aliased as: ===, =~

Source: show | on GitHub 

# File lib/rubygems/requirement.rb, line 194
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
specific?()

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

Source: show | on GitHub 

# File lib/rubygems/requirement.rb, line 207
def specific?
  return true if @requirements.length > 1 # GIGO, > 1, > 2 is silly

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

Source: show | on GitHub 

# File lib/rubygems/requirement.rb, line 169
def to_yaml_properties
  ["@requirements"]
end