Class: Bundler::PubGrub::VersionConstraint

Inherits:
Object
  • Object
show all
Defined in:
lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(package, range: nil) ⇒ VersionConstraint

Returns a new instance of VersionConstraint.

Parameters:



9
10
11
12
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 9

def initialize(package, range: nil)
  @package = package
  @range = range
end

Instance Attribute Details

#packageObject (readonly)

Returns the value of attribute package.



5
6
7
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 5

def package
  @package
end

#rangeObject (readonly)

Returns the value of attribute range.



5
6
7
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 5

def range
  @range
end

Class Method Details

.any(package) ⇒ Object



34
35
36
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 34

def any(package)
  new(package, range: VersionRange.any)
end

.empty(package) ⇒ Object



38
39
40
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 38

def empty(package)
  new(package, range: VersionRange.empty)
end

.exact(package, version) ⇒ Object



29
30
31
32
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 29

def exact(package, version)
  range = VersionRange.new(min: version, max: version, include_min: true, include_max: true)
  new(package, range: range)
end

Instance Method Details

#==(other) ⇒ Object



18
19
20
21
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 18

def ==(other)
  package == other.package &&
    range == other.range
end

#allows_all?(other) ⇒ Boolean

Returns:

  • (Boolean)


68
69
70
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 68

def allows_all?(other)
  range.allows_all?(other.range)
end

#allows_any?(other) ⇒ Boolean

Returns:

  • (Boolean)


72
73
74
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 72

def allows_any?(other)
  range.intersects?(other.range)
end

#any?Boolean

Does this match every version of the package

Returns:

  • (Boolean)


121
122
123
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 121

def any?
  range.any?
end

#constraint_stringObject



108
109
110
111
112
113
114
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 108

def constraint_string
  if any?
    ">= 0"
  else
    range.to_s
  end
end

#difference(other) ⇒ Object



64
65
66
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 64

def difference(other)
  intersect(other.invert)
end

#disjoint?(other) ⇒ Boolean

Returns:

  • (Boolean)


84
85
86
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 84

def disjoint?(other)
  !overlap?(other)
end

#empty?Boolean

Returns:

  • (Boolean)


116
117
118
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 116

def empty?
  range.empty?
end

#eql?(other) ⇒ Boolean

Returns:

  • (Boolean)


23
24
25
26
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 23

def eql?(other)
  package.eql?(other.package) &&
    range.eql?(other.range)
end

#hashObject



14
15
16
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 14

def hash
  package.hash ^ range.hash
end

#inspectObject



125
126
127
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 125

def inspect
  "#<#{self.class} #{self}>"
end

#intersect(other) ⇒ Object



43
44
45
46
47
48
49
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 43

def intersect(other)
  unless package == other.package
    raise ArgumentError, "Can only intersect between VersionConstraint of the same package"
  end

  self.class.new(package, range: range.intersect(other.range))
end

#invertObject



59
60
61
62
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 59

def invert
  new_range = range.invert
  self.class.new(package, range: new_range)
end

#overlap?(other) ⇒ Boolean

Returns:

  • (Boolean)


80
81
82
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 80

def overlap?(other)
  other.allows_any?(self)
end

#relation(other) ⇒ Object



88
89
90
91
92
93
94
95
96
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 88

def relation(other)
  if subset?(other)
    :subset
  elsif overlap?(other)
    :overlap
  else
    :disjoint
  end
end

#subset?(other) ⇒ Boolean

Returns:

  • (Boolean)


76
77
78
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 76

def subset?(other)
  other.allows_all?(self)
end

#to_s(allow_every: false) ⇒ Object



98
99
100
101
102
103
104
105
106
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 98

def to_s(allow_every: false)
  if Package.root?(package)
    package.to_s
  elsif allow_every && any?
    "every version of #{package}"
  else
    "#{package} #{constraint_string}"
  end
end

#union(other) ⇒ Object



51
52
53
54
55
56
57
# File 'lib/bundler/vendor/pub_grub/lib/pub_grub/version_constraint.rb', line 51

def union(other)
  unless package == other.package
    raise ArgumentError, "Can only intersect between VersionConstraint of the same package"
  end

  self.class.new(package, range: range.union(other.range))
end