Class: Raketeer::SemVer

Inherits:
Object
  • Object
show all
Defined in:
lib/raketeer/sem_ver.rb

Overview

Semantic Version

This is a non-strict version of Semantic Versioning v2.0.0.

See Also:

Since:

  • 0.2.4

Direct Known Subclasses

BumpVer

Constant Summary collapse

REGEX =

Since:

  • 0.2.4

/\d+(\.\d+)?(\.\d+)?(-[0-9A-Za-z\-.]+)?(\+[0-9A-Za-z\-.]+)?/.freeze
STRICT_REGEX =

Since:

  • 0.2.4

/\d+\.\d+\.\d+(-[0-9A-Za-z\-.]+)?(\+[0-9A-Za-z\-.]+)?/.freeze

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(major: nil, minor: nil, patch: nil, prerelease: nil, build_meta: nil) ⇒ SemVer

Returns a new instance of SemVer.

Since:

  • 0.2.4



29
30
31
32
33
34
35
36
 
# File 'lib/raketeer/sem_ver.rb', line 29

def initialize(major: nil,minor: nil,patch: nil,prerelease: nil,build_meta: nil)
  @build_meta = build_meta
  @major = major
  @minor = minor
  @patch = patch
  @prerelease = prerelease
  @version = nil
end

Instance Attribute Details

#build_meta ⇒ Object

Since:

  • 0.2.4



22
23
24
 
# File 'lib/raketeer/sem_ver.rb', line 22

def build_meta
  @build_meta
end

#major ⇒ Object

Since:

  • 0.2.4



23
24
25
 
# File 'lib/raketeer/sem_ver.rb', line 23

def major
  @major
end

#minor ⇒ Object

Since:

  • 0.2.4



24
25
26
 
# File 'lib/raketeer/sem_ver.rb', line 24

def minor
  @minor
end

#patch ⇒ Object

Since:

  • 0.2.4



25
26
27
 
# File 'lib/raketeer/sem_ver.rb', line 25

def patch
  @patch
end

#prerelease ⇒ Object

Since:

  • 0.2.4



26
27
28
 
# File 'lib/raketeer/sem_ver.rb', line 26

def prerelease
  @prerelease
end

#version ⇒ Object

If not nil, #to_s will only return this.

Since:

  • 0.2.4



27
28
29
 
# File 'lib/raketeer/sem_ver.rb', line 27

def version
  @version
end

Class Method Details

.parse(str) ⇒ Object

Since:

  • 0.2.4



57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
 
# File 'lib/raketeer/sem_ver.rb', line 57

def self.parse(str)
  # Parsing backwards makes the logic easier.
  build_meta = str.split('+',2)
  prerelease = build_meta[0].split('-',2)
  numbers = prerelease[0].split('.',3)

  sem_ver = SemVer.new
  sem_ver.major = numbers[0].to_i # There must always be a major version.

  if numbers.length >= 2
    minor = numbers[1].strip
    sem_ver.minor = minor.to_i unless minor.empty?

    if numbers.length == 3
      patch = numbers[2].strip
      sem_ver.patch = patch.to_i unless patch.empty?
    end
  end

  if prerelease.length == 2
    prerelease = prerelease[1].strip
    sem_ver.prerelease = prerelease unless prerelease.empty?
  end

  if build_meta.length == 2
    build_meta = build_meta[1].strip
    sem_ver.build_meta = build_meta unless build_meta.empty?
  end

  return sem_ver
end

.parse_line(line, strict: false) ⇒ Object

Since:

  • 0.2.4



89
90
91
92
93
94
 
# File 'lib/raketeer/sem_ver.rb', line 89

def self.parse_line(line,strict: false)
  str = line[regex(strict)]

  return nil if str.nil? || (str = str.strip).empty?
  return parse(str)
end

.regex(strict = false) ⇒ Object

Since:

  • 0.2.4



105
106
107
 
# File 'lib/raketeer/sem_ver.rb', line 105

def self.regex(strict = false)
  return strict ? STRICT_REGEX : REGEX
end

Instance Method Details

#empty? ⇒ Boolean

Returns:

  • (Boolean)

Since:

  • 0.2.4



96
97
98
99
100
101
102
103
 
# File 'lib/raketeer/sem_ver.rb', line 96

def empty?
  return @build_meta.nil? &&
         @major.nil? &&
         @minor.nil? &&
         @patch.nil? &&
         @prerelease.nil? &&
         @version.nil?
end

#init_copy(_orig, copy) ⇒ Object

Since:

  • 0.2.4



48
49
50
51
52
53
54
55
 
# File 'lib/raketeer/sem_ver.rb', line 48

def init_copy(_orig,copy)
  @build_meta = @build_meta.__send__(copy)
  @major = @major.__send__(copy)
  @minor = @minor.__send__(copy)
  @patch = @patch.__send__(copy)
  @prerelease = @prerelease.__send__(copy)
  @version = @version.__send__(copy)
end

#initialize_clone(orig) ⇒ Object

Since:

  • 0.2.4



43
44
45
46
 
# File 'lib/raketeer/sem_ver.rb', line 43

def initialize_clone(orig)
  super
  init_copy(orig,:clone)
end

#initialize_dup(orig) ⇒ Object

Since:

  • 0.2.4



38
39
40
41
 
# File 'lib/raketeer/sem_ver.rb', line 38

def initialize_dup(orig)
  super
  init_copy(orig,:dup)
end

#to_s ⇒ Object

Since:

  • 0.2.4



109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
 
# File 'lib/raketeer/sem_ver.rb', line 109

def to_s
  s = ''.dup

  if !@version.nil?
    s << @version.to_s
  elsif !@major.nil?
    s << @major.to_s
    s << ".#{@minor}" unless @minor.nil?
    s << ".#{@patch}" unless @patch.nil?
    s << "-#{@prerelease}" unless @prerelease.nil?
    s << "+#{@build_meta}" unless @build_meta.nil?
  end

  return s
end