Class: Tins::StringVersion::Version

Inherits:
Object
  • Object
show all
Includes:
Comparable
Defined in:
lib/tins/string_version.rb

Overview

Represents a version string with semantic comparison capabilities

Examples:

Creating a Version object

version = Tins::StringVersion::Version.new("1.2.3")

Accessing components

v = "1.2.3".version
puts v.major # => 1
puts v.minor # => 2
puts v.build # => 3

Instance Method Summary collapse

Constructor Details

#initialize(string) ⇒ Version

Creates a new version object from a string representation

Examples:

Tins::StringVersion::Version.new("1.2.3")
# => #<Tins::StringVersion::Version:0x00007f8b8c0b0a80 @version="1.2.3">

Parameters:

  • string (String) —

    The version string (e.g., “1.2.3”)

Raises:

  • (ArgumentError) —

    If the string doesn’t match a valid version pattern



51
52
53
54
55
 
# File 'lib/tins/string_version.rb', line 51

def initialize(string)
  string =~ /\A\d+(\.\d+)*\z/ or
    raise ArgumentError, "#{string.inspect} isn't a version number"
  @version = string.frozen? ? string.dup : string
end

Instance Method Details

#<=>(other) ⇒ Integer

Compares this version with another

Parameters:

Returns:

  • (Integer) —

    -1 if self < other, 0 if equal, 1 if self > other



211
212
213
214
215
216
 
# File 'lib/tins/string_version.rb', line 211

def <=>(other)
  pairs = array.zip(other.array)
  pairs.map! { |a, b| [ a.to_i, b.to_i ] }
  a, b = pairs.transpose
  a <=> b
end

#==(other) ⇒ Boolean

Checks equality with another version

Parameters:

Returns:

  • (Boolean) —

    true if versions are equal



222
223
224
 
# File 'lib/tins/string_version.rb', line 222

def ==(other)
  (self <=> other).zero?
end

#[](level) ⇒ Integer

Gets a version component by index or symbol

Parameters:

  • level (Symbol, Integer) —

    The level to retrieve

Returns:

  • (Integer) —

    The version component value



170
171
172
 
# File 'lib/tins/string_version.rb', line 170

def [](level)
  array[level_of(level)]
end

#[]=(level, value) ⇒ Integer

Sets a version component by index or symbol

Parameters:

  • level (Symbol, Integer) —

    The level to set

  • value (Integer) —

    The new value for the component

Returns:

  • (Integer) —

    The updated value

Raises:

  • (ArgumentError) —

    If value is negative



180
181
182
183
184
185
186
187
188
189
 
# File 'lib/tins/string_version.rb', line 180

def []=(level, value)
  level = level_of(level)
  value = value.to_i
  value >= 0 or raise ArgumentError,
    "version numbers can't contain negative numbers like #{value}"
  a = array
  a[level] = value
  a.map!(&:to_i)
  @version.replace a * ?.
end

#array ⇒ Array<Integer> Also known as: to_a

Converts the version to an array of integers

Returns:

  • (Array<Integer>) —

    Array representation of the version



229
230
231
 
# File 'lib/tins/string_version.rb', line 229

def array
  @version.split(?.).map(&:to_i)
end

#build ⇒ Integer

Returns the build version component

Examples:

"1.2.3".version.build # => 3

Returns:

  • (Integer) —

    The build version number



102
103
104
 
# File 'lib/tins/string_version.rb', line 102

def build
  self[2]
end

#build=(new_level) ⇒ Integer

Sets the build version component

Examples:

v = "1.2.3".version
v.build = 5 # sets build to 5

Parameters:

  • new_level (Integer) —

    The new build version number

Returns:

  • (Integer) —

    The updated build version number



113
114
115
 
# File 'lib/tins/string_version.rb', line 113

def build=(new_level)
  self[2] = new_level
end

#bump(level = array.size - 1) ⇒ self

Increments a specified version component and resets subsequent components

Examples:

v = "1.2.3".version
v.bump(:minor) # => "1.3.0"
v.bump         # => "1.3.1" (bumps last component)

Parameters:

  • level (Symbol, Integer) (defaults to: array.size - 1) —

    The level to bump (default: last component)

Returns:

  • (self) —

    Returns self for chaining



145
146
147
148
149
150
151
152
 
# File 'lib/tins/string_version.rb', line 145

def bump(level = array.size - 1)
  level = level_of(level)
  self[level] += 1
  for l in level.succ..3
    self[l] &&= 0
  end
  self
end

#initialize_copy(source) ⇒ void

This method returns an undefined value.

Creates a copy of this version object

Parameters:



247
248
249
250
 
# File 'lib/tins/string_version.rb', line 247

def initialize_copy(source)
  super
  @version = source.instance_variable_get(:@version).dup
end

#level_of(specifier) ⇒ Integer

Converts a symbolic level to its numeric index

Parameters:

  • specifier (Symbol, Integer) —

    The level specification

Returns:

  • (Integer) —

    The corresponding numeric index



158
159
160
161
162
163
164
 
# File 'lib/tins/string_version.rb', line 158

def level_of(specifier)
  if specifier.respond_to?(:to_sym)
    LEVELS.fetch(specifier)
  else
    specifier
  end
end

#major ⇒ Integer

Returns the major version component

Examples:

"1.2.3".version.major # => 1

Returns:

  • (Integer) —

    The major version number



62
63
64
 
# File 'lib/tins/string_version.rb', line 62

def major
  self[0]
end

#major=(new_level) ⇒ Integer

Sets the major version component

Examples:

v = "1.2.3".version
v.major = 5 # sets major to 5

Parameters:

  • new_level (Integer) —

    The new major version number

Returns:

  • (Integer) —

    The updated major version number



73
74
75
 
# File 'lib/tins/string_version.rb', line 73

def major=(new_level)
  self[0] = new_level
end

#minor ⇒ Integer

Returns the minor version component

Examples:

"1.2.3".version.minor # => 2

Returns:

  • (Integer) —

    The minor version number



82
83
84
 
# File 'lib/tins/string_version.rb', line 82

def minor
  self[1]
end

#minor=(new_level) ⇒ Integer

Sets the minor version component

Examples:

v = "1.2.3".version
v.minor = 5 # sets minor to 5

Parameters:

  • new_level (Integer) —

    The new minor version number

Returns:

  • (Integer) —

    The updated minor version number



93
94
95
 
# File 'lib/tins/string_version.rb', line 93

def minor=(new_level)
  self[1] = new_level
end

#pred! ⇒ self

Decrements the last version component

Returns:

  • (self) —

    Returns self for chaining



202
203
204
205
 
# File 'lib/tins/string_version.rb', line 202

def pred!
  self[-1] -= 1
  self
end

#revision ⇒ Integer

Returns the revision version component

Examples:

"1.2.3".version.revision # => nil (no revision component)

Returns:

  • (Integer) —

    The revision version number



122
123
124
 
# File 'lib/tins/string_version.rb', line 122

def revision
  self[3]
end

#revision=(new_level) ⇒ Integer

Sets the revision version component

Examples:

v = "1.2.3".version
v.revision = 5 # sets revision to 5

Parameters:

  • new_level (Integer) —

    The new revision version number

Returns:

  • (Integer) —

    The updated revision version number



133
134
135
 
# File 'lib/tins/string_version.rb', line 133

def revision=(new_level)
  self[3] = new_level
end

#succ! ⇒ self

Increments the last version component

Returns:

  • (self) —

    Returns self for chaining



194
195
196
197
 
# File 'lib/tins/string_version.rb', line 194

def succ!
  self[-1] += 1
  self
end

#to_s ⇒ String Also known as: inspect

Returns the string representation of this version

Returns:

  • (String) —

    The version string



239
240
241
 
# File 'lib/tins/string_version.rb', line 239

def to_s
  @version
end