Class: Versionify::VersionSpec

Inherits:
Array
  • Object
show all
Includes:
Comparable
Defined in:
lib/versionify/version_spec.rb

Constant Summary collapse

NONE_STR =

/ ‘unknown’

'none'.freeze

Instance Method Summary collapse

Constructor Details

#initialize(arg) ⇒ VersionSpec

v = VersionSpec.new( ‘1.2.3’ ) v = VersionSpec.new( nil ) v = VersionSpec.new( false )



67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
 
# File 'lib/versionify/version_spec.rb', line 67

def initialize( arg )
  if arg
    if arg.kind_of?( ::String )
      parts = arg.to_s.strip.split('.').map( & :to_i )
    elsif arg.kind_of?( ::Array )
      parts = arg.map( & :to_i )
    else
      raise ::ArgumentError.new( "Expected a String or Array, #{arg.class.name} given." )
    end
  else
    parts = []
  end
  
  super( parts )
end

Instance Method Details

#!=(other) ⇒ Object 



108
109
110
 
# File 'lib/versionify/version_spec.rb', line 108

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

#<=>(other) ⇒ Object 



112
113
114
115
116
117
118
119
 
# File 'lib/versionify/version_spec.rb', line 112

def <=>( other )
  if other.kind_of?( ::String )
    other = self.class.new( other )
  end
  return nil  if (! other.kind_of?( self.class ))
  return nil  if (null? || other.null?)
  super
end

#==(other) ⇒ Object 



97
98
99
100
101
102
103
104
105
106
 
# File 'lib/versionify/version_spec.rb', line 97

def ==( other )
  cmp = (self <=> other)
  #return case cmp
  #  when 0      ; true
  #  when [-1,1] ; false
  #  when nil    ; false
  #  else        ; false
  #end
  return cmp == 0
end

#at(index) ⇒ Object 



165
166
167
 
# File 'lib/versionify/version_spec.rb', line 165

def at( index )
  super
end

#comparable? ⇒ Boolean

Returns:

  • (Boolean) 


93
94
95
 
# File 'lib/versionify/version_spec.rb', line 93

def comparable?
  ! self.null?
end

#empty? ⇒ Boolean

Returns:

  • (Boolean) 


143
144
145
 
# File 'lib/versionify/version_spec.rb', line 143

def empty?
  super
end

#fetch(idx, *args) ⇒ Object 



169
170
171
 
# File 'lib/versionify/version_spec.rb', line 169

def fetch( idx, *args )
  super
end

#freeze ⇒ Object 



181
182
183
 
# File 'lib/versionify/version_spec.rb', line 181

def freeze
  super
end

#freeze! ⇒ Object 



185
186
187
 
# File 'lib/versionify/version_spec.rb', line 185

def freeze!
  freeze
end

#frozen? ⇒ Boolean

Returns:

  • (Boolean) 


177
178
179
 
# File 'lib/versionify/version_spec.rb', line 177

def frozen?
  super
end

#inspect ⇒ Object 



129
130
131
 
# File 'lib/versionify/version_spec.rb', line 129

def inspect
  "%s( %s )" % [ self.class.name, self.to_s.inspect ]
end

#join(separator = '.') ⇒ Object 



121
122
123
 
# File 'lib/versionify/version_spec.rb', line 121

def join( separator='.' )
  super( separator )
end

#length ⇒ Object Also known as: size, count 



155
156
157
 
# File 'lib/versionify/version_spec.rb', line 155

def length
  super
end

#null? ⇒ Boolean

v = VersionSpec.parse( ‘1.2.3’ ) def self.parse( arg ) self.new( arg ) end

Returns:

  • (Boolean) 


88
89
90
91
 
# File 'lib/versionify/version_spec.rb', line 88

def null?
  #self.count == 0
  self.empty?
end

#pack(fmt) ⇒ Object 



173
174
175
 
# File 'lib/versionify/version_spec.rb', line 173

def pack( fmt )
  super
end

#slice(*args) ⇒ Object 



161
162
163
 
# File 'lib/versionify/version_spec.rb', line 161

def slice( *args )
  super
end

#to_a ⇒ Object 



147
148
149
 
# File 'lib/versionify/version_spec.rb', line 147

def to_a
  super
end

#to_ary ⇒ Object 



151
152
153
 
# File 'lib/versionify/version_spec.rb', line 151

def to_ary
  to_a
end

#to_display ⇒ Object

Like to_s(), but don’t return an empty string in case there are no parts.



135
136
137
 
# File 'lib/versionify/version_spec.rb', line 135

def to_display
  comparable? ? self.to_s : NONE_STR
end

#to_s ⇒ Object 



125
126
127
 
# File 'lib/versionify/version_spec.rb', line 125

def to_s
  self.join('.')
end

#to_s_nil ⇒ Object 



139
140
141
 
# File 'lib/versionify/version_spec.rb', line 139

def to_s_nil
  comparable? ? self.to_s : nil
end