Class: SemanticVersion

Inherits:
Object
  • Object
show all
Defined in:
lib/semver_dialects/semantic_version/semantic_version.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(version_string, segments = nil) ⇒ SemanticVersion

Returns a new instance of SemanticVersion.



8
9
10
11
12
13
14
15
16
17
18
19
20
21
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 8

def initialize(version_string, segments = nil)
  @version_string = version_string
  @prefix_segments = []
  @suffix_segments = []
  @prefix_delimiter = 0
  version, _ = version_string.split('+')
  if segments.nil?
    @segments = split_version_string!(version)
  else
    @prefix_segments = segments
    @prefix_delimiter = segments.size - 1
    @segments = segments
  end
end

Instance Attribute Details

#prefix_delimiter ⇒ Object (readonly)

Returns the value of attribute prefix_delimiter.



6
7
8
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 6

def prefix_delimiter
  @prefix_delimiter
end

#prefix_segments ⇒ Object (readonly)

Returns the value of attribute prefix_segments.



6
7
8
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 6

def prefix_segments
  @prefix_segments
end

#segments ⇒ Object (readonly)

Returns the value of attribute segments.



6
7
8
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 6

def segments
  @segments
end

#suffix_segments ⇒ Object (readonly)

Returns the value of attribute suffix_segments.



6
7
8
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 6

def suffix_segments
  @suffix_segments
end

#version_string ⇒ Object (readonly)

Returns the value of attribute version_string.



6
7
8
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 6

def version_string
  @version_string
end

Instance Method Details

#!=(other_semver) ⇒ Object 



159
160
161
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 159

def !=(other_semver)
  return !(self == other_semver)
end

#<(other_semver) ⇒ Object 



91
92
93
94
95
96
97
98
99
100
101
102
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 91

def <(other_semver)
  self_array, other_array = get_equalized_arrays_for(self, other_semver)
  (0..self_array.size - 1).each {
    |i|
    if self_array[i] < other_array[i]
      return true
    elsif self_array[i] > other_array[i]
      return false
    end
  }
  false
end

#<=(other_semver) ⇒ Object 



133
134
135
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 133

def <=(other_semver)
  self == other_semver || self < other_semver
end

#==(other_semver) ⇒ Object 



137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 137

def ==(other_semver)
  segments_a = []
  segments_b = []

  segments_a += other_semver.segments
  segments_b += @segments

  if other_semver.segments.size < @segments.size
    (@segments.size - other_semver.segments.size).times {|_| segments_a << SemanticVersionSegment.new("0")}
  elsif other_semver.segments.size > @segments.size
    (other_semver.segments.size - @segments.size).times {|_| segments_b << SemanticVersionSegment.new("0") }
  end

  (0..segments_a.size - 1).each {
    |i|
    if segments_a[i] != segments_b[i]
      return false
    end
  }
  true
end

#>(other_semver) ⇒ Object 



116
117
118
119
120
121
122
123
124
125
126
127
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 116

def >(other_semver)
  self_array, other_array = get_equalized_arrays_for(self, other_semver)
  (0..self_array.size - 1).each {
    |i|
    if self_array[i] > other_array[i]
      return true
    elsif self_array[i] < other_array[i]
      return false
    end
  }
  false
end

#>=(other_semver) ⇒ Object 



129
130
131
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 129

def >=(other_semver)
  self == other_semver || self > other_semver || self == other_semver
end

#_get_equalized_arrays_for(array_a, array_b) ⇒ Object 



59
60
61
62
63
64
65
66
67
68
69
70
71
72
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 59

def _get_equalized_arrays_for(array_a, array_b)
  first_array = array_a.clone()
  second_array = array_b.clone()
  if first_array.size < second_array.size
    (second_array.size - first_array.size).times do
      first_array << SemanticVersionSegment.new("0")
    end
  elsif first_array.size > second_array.size
    (first_array.size - second_array.size).times do
      second_array << SemanticVersionSegment.new("0")
    end
  end
  [first_array, second_array]
end

#cross_total ⇒ Object 



200
201
202
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 200

def cross_total()
  [self.major, self.minor, self.patch].reject { |i| i.empty? }.map { |i| i.to_i }.inject(0) { |sum, x| sum + x }
end

#diff(other_semver, abs = true) ⇒ Object 



163
164
165
166
167
168
169
170
171
172
173
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 163

def diff(other_semver, abs = true)
  diffs = []

  self_array, other_array = get_equalized_prefix_arrays_for(self, other_semver)
  (0..self_array.size - 1).each {
    |i|
    # diff semantic groups
    diffs << (self_array[i].diff(other_array[i], abs))
  }
  diffs
end

#get_equalized_arrays_for(semver_a, semver_b) ⇒ Object 



74
75
76
77
78
79
80
81
82
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 74

def get_equalized_arrays_for(semver_a, semver_b)
  first_array_prefix = semver_a.prefix_segments.clone()
  second_array_prefix = semver_b.prefix_segments.clone()
  first_array_suffix = semver_a.suffix_segments.clone()
  second_array_suffix = semver_b.suffix_segments.clone()
  first_array_prefix, second_array_prefix = _get_equalized_arrays_for(first_array_prefix, second_array_prefix)
  first_array_suffix, second_array_suffix = _get_equalized_arrays_for(first_array_suffix, second_array_suffix)
  [first_array_prefix.concat(first_array_suffix), second_array_prefix.concat(second_array_suffix)]
end

#get_equalized_prefix_arrays_for(semver_a, semver_b) ⇒ Object 



84
85
86
87
88
89
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 84

def get_equalized_prefix_arrays_for(semver_a, semver_b)
  first_array_prefix = semver_a.prefix_segments.clone()
  second_array_prefix = semver_b.prefix_segments.clone()
  first_array_prefix, second_array_prefix = _get_equalized_arrays_for(first_array_prefix, second_array_prefix)
  [first_array_prefix, second_array_prefix]
end

#is_successor_of?(other_semver) ⇒ Boolean

Returns:

  • (Boolean) 


195
196
197
198
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 195

def is_successor_of?(other_semver)
  filtered_segments = self.diff(other_semver, false).reject { |i| i.to_i == 0 }
  filtered_segments.size == 1 && filtered_segments.last.to_i == 1
end

#is_zero? ⇒ Boolean

Returns:

  • (Boolean) 


104
105
106
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 104

def is_zero?
  @prefix_segments.empty? || @prefix_segments.all? { |segment| segment.is_zero? }
end

#major ⇒ Object 



187
188
189
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 187

def major
  @prefix_segments.size >= 2 ? @prefix_segments[0].to_s : "0"
end

#minor ⇒ Object 



183
184
185
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 183

def minor
  @prefix_segments.size >= 1 ? @prefix_segments[1].to_s : "0"
end

#patch ⇒ Object 



191
192
193
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 191

def patch
  @prefix_segments.size >= 3 ? @prefix_segments[2].to_s : "0"
end

#post_release? ⇒ Boolean

Returns:

  • (Boolean) 


112
113
114
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 112

def post_release?
  @suffix_segments.any?(&:is_post_release)
end

#pre_release? ⇒ Boolean

Returns:

  • (Boolean) 


108
109
110
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 108

def pre_release?
  @suffix_segments.any?(&:is_pre_release)
end

#split_version_string!(version_string) ⇒ Object 



23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 23

def split_version_string!(version_string)
  delim_pattern = /[\.\-]/
  split_array = version_string.split(delim_pattern).map {
    |grp|
    grp.split(/(\d+)/).reject { |cell| cell.nil? || cell.empty? }
  }.flatten

  # go as far to the right as possible considering numbers and placeholders
  (0..split_array.size - 1).each do
    |i|
    if split_array[i].number? || split_array[i] == "X" || split_array[i] == "x"
      @prefix_delimiter = i
    else
      break
    end
  end

  # remove redundant trailing zeros
  @prefix_delimiter.downto(0).each do
    |i|
    if split_array[i] == "0"
      split_array.delete_at(i)
      @prefix_delimiter -= 1
    else
      break
    end
  end

  @prefix_segments = split_array[0..@prefix_delimiter].map { |group_string| SemanticVersionSegment.new(group_string) } unless @prefix_delimiter < 0
  if split_array.size - 1 >= @prefix_delimiter + 1
    @suffix_segments = split_array[@prefix_delimiter + 1, split_array.size].map { |group_string| SemanticVersionSegment.new(group_string) }
  end

  @prefix_segments.clone().concat(@suffix_segments)
end

#to_normalized_s ⇒ Object 



175
176
177
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 175

def to_normalized_s
  @segments.map { |group| group.to_normalized_s }.join(":").to_s
end

#to_s ⇒ Object 



179
180
181
 
# File 'lib/semver_dialects/semantic_version/semantic_version.rb', line 179

def to_s
  @segments.map { |group| group.to_s }.join(":").to_s
end