GIF87a;
## # A Requirement is a set of one or more version restrictions. It supports a # few (<tt>=, !=, >, <, >=, <=, ~></tt>) different restriction operators. # REFACTOR: The fact that a requirement is singular or plural is kind of # awkward. Is Requirement the right name for this? Or should it be one # [op, number] pair, and we call the list of requirements something else? # Since a Requirement is held by a Dependency, maybe this should be made # singular and the list aspect should be pulled up into Dependency? require "rubygems/version" require "rubygems/deprecate" # If we're being loaded after yaml was already required, then # load our yaml + workarounds now. Gem.load_yaml if defined? ::YAML 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 } } quoted = OPS.keys.map { |k| Regexp.quote k }.join "|" PATTERN_RAW = "\\s*(#{quoted})?\\s*(#{Gem::Version::VERSION_PATTERN})\\s*" PATTERN = /\A#{PATTERN_RAW}\z/ DefaultRequirement = [">=", Gem::Version.new(0)] 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. # REFACTOR: There's no reason that this can't be unified with .new. # .new is the standard Ruby factory method. 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 ## # A default "version requirement" can surely _only_ be '>= 0'. def self.default new '>= 0' 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") # => [">", "1.0"] # parse("1.0") # => ["=", "1.0"] # parse(Gem::Version.new("1.0")) # => ["=, "1.0"] # 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. 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 ## # 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 ## # true if this gem has no requirements. # FIX: maybe this should be using #default ? def none? if @requirements.size == 1 @requirements[0] == DefaultRequirement else false end end def as_list # :nodoc: requirements.map { |op, version| "#{op} #{version}" }.sort end def hash # :nodoc: requirements.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 ["@requirements"] end def encode_with(coder) 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 # DOC: this should probably be :nodoc'd def == other Gem::Requirement === other and to_s == other.to_s end private # DOC: this should probably be :nodoc'd def fix_syck_default_key_in_requirements 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 # This is needed for compatibility with older yaml # gemspecs. class Gem::Version Requirement = Gem::Requirement end
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
commands | Folder | 0755 |
|
|
core_ext | Folder | 0755 |
|
|
defaults | Folder | 0755 |
|
|
ext | Folder | 0755 |
|
|
package | Folder | 0755 |
|
|
security | Folder | 0755 |
|
|
ssl_certs | Folder | 0755 |
|
|
LICENSE.txt | File | 2.27 KB | 0644 |
|
available_set.rb | File | 1.56 KB | 0644 |
|
command.rb | File | 13.43 KB | 0644 |
|
command_manager.rb | File | 5.36 KB | 0644 |
|
compatibility.rb | File | 1.58 KB | 0644 |
|
config_file.rb | File | 11.82 KB | 0644 |
|
defaults.rb | File | 3.06 KB | 0644 |
|
dependency.rb | File | 7.74 KB | 0644 |
|
dependency_installer.rb | File | 12.12 KB | 0644 |
|
dependency_list.rb | File | 5.53 KB | 0644 |
|
dependency_resolver.rb | File | 14.97 KB | 0644 |
|
deprecate.rb | File | 1.73 KB | 0644 |
|
doctor.rb | File | 2.86 KB | 0644 |
|
errors.rb | File | 2.14 KB | 0644 |
|
exceptions.rb | File | 2.7 KB | 0644 |
|
ext.rb | File | 416 B | 0644 |
|
gem_runner.rb | File | 1.98 KB | 0644 |
|
gemcutter_utilities.rb | File | 2.91 KB | 0644 |
|
indexer.rb | File | 12.89 KB | 0644 |
|
install_message.rb | File | 281 B | 0644 |
|
install_update_options.rb | File | 5.09 KB | 0644 |
|
installer.rb | File | 23.04 KB | 0644 |
|
installer_test_case.rb | File | 4.28 KB | 0644 |
|
local_remote_options.rb | File | 3.36 KB | 0644 |
|
mock_gem_ui.rb | File | 1.35 KB | 0644 |
|
name_tuple.rb | File | 1.96 KB | 0644 |
|
package.rb | File | 14.38 KB | 0644 |
|
package_task.rb | File | 3.77 KB | 0644 |
|
path_support.rb | File | 1.58 KB | 0644 |
|
platform.rb | File | 5.63 KB | 0644 |
|
psych_additions.rb | File | 249 B | 0644 |
|
psych_tree.rb | File | 763 B | 0644 |
|
rdoc.rb | File | 7.72 KB | 0644 |
|
remote_fetcher.rb | File | 15.69 KB | 0644 |
|
request_set.rb | File | 3.67 KB | 0644 |
|
requirement.rb | File | 6.02 KB | 0644 |
|
safe_yaml.rb | File | 1.11 KB | 0644 |
|
security.rb | File | 20.56 KB | 0644 |
|
server.rb | File | 22.03 KB | 0644 |
|
source.rb | File | 3.12 KB | 0644 |
|
source_list.rb | File | 1.22 KB | 0644 |
|
source_local.rb | File | 1.88 KB | 0644 |
|
source_specific_file.rb | File | 552 B | 0644 |
|
spec_fetcher.rb | File | 5.17 KB | 0644 |
|
specification.rb | File | 68.24 KB | 0644 |
|
syck_hack.rb | File | 2.07 KB | 0644 |
|
test_case.rb | File | 28.09 KB | 0644 |
|
test_utilities.rb | File | 4.03 KB | 0644 |
|
text.rb | File | 1.72 KB | 0644 |
|
uninstaller.rb | File | 8.32 KB | 0644 |
|
user_interaction.rb | File | 11.68 KB | 0644 |
|
validator.rb | File | 4.08 KB | 0644 |
|
version.rb | File | 10.5 KB | 0644 |
|
version_option.rb | File | 1.59 KB | 0644 |
|