Class: Gem::Dependency
- Inherits:
-
Object
- Object
- Gem::Dependency
- Defined in:
- lib/rubygems/dependency.rb
Constant Summary collapse
- TYPES =
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.
[ :development, :runtime, ]
Instance Attribute Summary collapse
-
#name ⇒ Object
Dependency name or regular expression.
-
#prerelease ⇒ Object
writeonly
Allows you to force this dependency to be a prerelease.
Instance Method Summary collapse
-
#<=>(other) ⇒ Object
Dependencies are ordered by name.
-
#==(other) ⇒ Object
:nodoc:.
-
#=~(other) ⇒ Object
(also: #===)
Uses this dependency as a pattern to compare to
other
. -
#hash ⇒ Object
A dependency’s hash is the XOR of the hashes of
name
,type
, andrequirement
. -
#initialize(name, *requirements) ⇒ Dependency
constructor
Constructs a dependency with
name
andrequirements
. -
#inspect ⇒ Object
:nodoc:.
-
#latest_version? ⇒ Boolean
Is this dependency simply asking for the latest version of a gem?.
-
#match?(obj, version = nil, allow_prerelease = false) ⇒ Boolean
:call-seq: dep.match? name => true or false dep.match? name, version => true or false dep.match? spec => true or false.
-
#matches_spec?(spec) ⇒ Boolean
Does this dependency match
spec
?. - #matching_specs(platform_only = false) ⇒ Object
-
#merge(other) ⇒ Object
Merges the requirements of
other
into this dependency. -
#prerelease? ⇒ Boolean
Does this dependency require a prerelease?.
-
#pretty_print(q) ⇒ Object
:nodoc:.
-
#requirement ⇒ Object
What does this dependency require?.
- #requirements_list ⇒ Object
- #runtime? ⇒ Boolean
-
#specific? ⇒ Boolean
True if the dependency will not always match the latest version.
-
#to_s ⇒ Object
:nodoc:.
- #to_spec ⇒ Object
- #to_specs ⇒ Object
-
#type ⇒ Object
Dependency type.
Constructor Details
#initialize(name, *requirements) ⇒ Dependency
Constructs a dependency with name
and requirements
. The last argument can optionally be the dependency type, which defaults to :runtime
.
38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 |
# File 'lib/rubygems/dependency.rb', line 38 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 |
Instance Attribute Details
#name ⇒ Object
Dependency name or regular expression.
26 27 28 |
# File 'lib/rubygems/dependency.rb', line 26 def name @name end |
#prerelease=(value) ⇒ Object (writeonly)
Allows you to force this dependency to be a prerelease.
31 32 33 |
# File 'lib/rubygems/dependency.rb', line 31 def prerelease=(value) @prerelease = value end |
Instance Method Details
#<=>(other) ⇒ Object
Dependencies are ordered by name.
182 183 184 |
# File 'lib/rubygems/dependency.rb', line 182 def <=> other self.name <=> other.name end |
#==(other) ⇒ Object
:nodoc:
172 173 174 175 176 177 |
# File 'lib/rubygems/dependency.rb', line 172 def == other # :nodoc: Gem::Dependency === other && self.name == other.name && self.type == other.type && self.requirement == other.requirement end |
#=~(other) ⇒ Object Also known as: ===
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.
192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 |
# File 'lib/rubygems/dependency.rb', line 192 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 |
#hash ⇒ Object
A dependency’s hash is the XOR of the hashes of name
, type
, and requirement
.
73 74 75 |
# File 'lib/rubygems/dependency.rb', line 73 def hash # :nodoc: name.hash ^ type.hash ^ requirement.hash end |
#inspect ⇒ Object
:nodoc:
77 78 79 80 81 82 83 84 85 |
# File 'lib/rubygems/dependency.rb', line 77 def inspect # :nodoc: if prerelease? then "<%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 |
#latest_version? ⇒ Boolean
Is this dependency simply asking for the latest version of a gem?
98 99 100 |
# File 'lib/rubygems/dependency.rb', line 98 def latest_version? @requirement.none? end |
#match?(obj, version = nil, allow_prerelease = false) ⇒ Boolean
: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.
224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 |
# File 'lib/rubygems/dependency.rb', line 224 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 |
#matches_spec?(spec) ⇒ Boolean
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.
251 252 253 254 255 256 |
# File 'lib/rubygems/dependency.rb', line 251 def matches_spec? spec return false unless name === spec.name return true if requirement.none? requirement.satisfied_by?(spec.version) end |
#matching_specs(platform_only = false) ⇒ Object
277 278 279 280 281 282 283 284 285 286 287 288 289 290 |
# File 'lib/rubygems/dependency.rb', line 277 def matching_specs platform_only = false env_req = Gem.env_requirement(name) matches = Gem::Specification.stubs_for(name).find_all { |spec| requirement.satisfied_by?(spec.version) && env_req.satisfied_by?(spec.version) }.map(&:to_spec) if platform_only matches.reject! { |spec| spec.nil? || !Gem::Platform.match(spec.platform) } end matches end |
#merge(other) ⇒ Object
Merges the requirements of other
into this dependency
261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 |
# File 'lib/rubygems/dependency.rb', line 261 def merge other unless name == other.name then 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 |
#prerelease? ⇒ Boolean
Does this dependency require a prerelease?
90 91 92 |
# File 'lib/rubygems/dependency.rb', line 90 def prerelease? @prerelease || requirement.prerelease? end |
#pretty_print(q) ⇒ Object
:nodoc:
102 103 104 105 106 107 108 109 110 111 112 113 114 115 |
# File 'lib/rubygems/dependency.rb', line 102 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 |
#requirement ⇒ Object
What does this dependency require?
120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 |
# File 'lib/rubygems/dependency.rb', line 120 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 |
#requirements_list ⇒ Object
149 150 151 |
# File 'lib/rubygems/dependency.rb', line 149 def requirements_list requirement.as_list end |
#runtime? ⇒ Boolean
168 169 170 |
# File 'lib/rubygems/dependency.rb', line 168 def runtime? @type == :runtime || !@type end |
#specific? ⇒ Boolean
True if the dependency will not always match the latest version.
295 296 297 |
# File 'lib/rubygems/dependency.rb', line 295 def specific? @requirement.specific? end |
#to_s ⇒ Object
:nodoc:
153 154 155 156 157 158 159 |
# File 'lib/rubygems/dependency.rb', line 153 def to_s # :nodoc: if type != :runtime then "#{name} (#{requirement}, #{type})" else "#{name} (#{requirement})" end end |
#to_spec ⇒ Object
319 320 321 322 323 324 325 326 327 328 329 330 331 332 |
# File 'lib/rubygems/dependency.rb', line 319 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 |
#to_specs ⇒ Object
299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 |
# File 'lib/rubygems/dependency.rb', line 299 def to_specs matches = matching_specs true # TODO: check Gem.activated_spec[self.name] in case matches falls outside if matches.empty? then 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 |
#type ⇒ Object
Dependency type.
164 165 166 |
# File 'lib/rubygems/dependency.rb', line 164 def type @type ||= :runtime end |