Class | Gem::Requirement |
In: |
lib/rubygems/requirement.rb
|
Parent: | Object |
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 | = | /\A\s*(#{quoted})?\s*(#{Gem::Version::VERSION_PATTERN})\s*\z/ |
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.
# File lib/rubygems/requirement.rb, line 39 39: def self.create input 40: case input 41: when Gem::Requirement then 42: input 43: when Gem::Version, Array then 44: new input 45: else 46: if input.respond_to? :to_str then 47: new [input.to_str] 48: else 49: default 50: end 51: end 52: end
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".
# File lib/rubygems/requirement.rb, line 99 99: def initialize *requirements 100: requirements = requirements.flatten 101: requirements.compact! 102: requirements.uniq! 103: 104: requirements << ">= 0" if requirements.empty? 105: @none = (requirements == ">= 0") 106: @requirements = requirements.map! { |r| self.class.parse r } 107: end
Parse obj, returning an [op, version] pair. obj can be a String or a Gem::Version.
If obj is a String, it can be either a full requirement specification, like ">= 1.2", or a simple version number, like "1.2".
parse("> 1.0") # => [">", "1.0"] parse("1.0") # => ["=", "1.0"] parse(Gem::Version.new("1.0")) # => ["=, "1.0"]
# File lib/rubygems/requirement.rb, line 77 77: def self.parse obj 78: return ["=", obj] if Gem::Version === obj 79: 80: unless PATTERN =~ obj.to_s 81: raise ArgumentError, "Illformed requirement [#{obj.inspect}]" 82: end 83: 84: [$1 || "=", Gem::Version.new($2)] 85: end
# File lib/rubygems/requirement.rb, line 109 109: def none? 110: @none ||= (to_s == ">= 0") 111: end
# File lib/rubygems/requirement.rb, line 145 145: def prerelease? 146: requirements.any? { |r| r.last.prerelease? } 147: end
True if version satisfies this Requirement.
# File lib/rubygems/requirement.rb, line 158 158: def satisfied_by? version 159: # #28965: syck has a bug with unquoted '=' YAML.loading as YAML::DefaultKey 160: requirements.all? { |op, rv| (OPS[op] || OPS["="]).call version, rv } 161: end