Class: Net::SSH::Version

Inherits:
Object
  • Object
show all
Includes:
Comparable
Defined in:
lib/net/ssh/version.rb

Overview

A class for describing the current version of a library. The version consists of three parts: the major number, the minor number, and the tiny (or patch) number.

Two Version instances may be compared, so that you can test that a version of a library is what you require:

require 'net/ssh/version'

if Net::SSH::Version::CURRENT < Net::SSH::Version[2,1,0]
  abort "your software is too old!"
end

Constant Summary collapse

MAJOR =

The major component of this version of the Net::SSH library

2
MINOR =

The minor component of this version of the Net::SSH library

9
TINY =

The tiny component of this version of the Net::SSH library

3
PRE =

The prerelease component of this version of the Net::SSH library nil allowed

'beta1'
CURRENT =

The current version of the Net::SSH library as a Version instance

new(*[MAJOR, MINOR, TINY, PRE].compact)
STRING =

The current version of the Net::SSH library as a String

CURRENT.to_s

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(major, minor, tiny, pre = nil) ⇒ Version

Create a new Version object with the given components.


26
27
28
# File 'lib/net/ssh/version.rb', line 26

def initialize(major, minor, tiny, pre = nil)
  @major, @minor, @tiny, @pre = major, minor, tiny, pre
end

Instance Attribute Details

#majorObject (readonly)

Returns the value of attribute major


23
24
25
# File 'lib/net/ssh/version.rb', line 23

def major
  @major
end

#minorObject (readonly)

Returns the value of attribute minor


23
24
25
# File 'lib/net/ssh/version.rb', line 23

def minor
  @minor
end

#tinyObject (readonly)

Returns the value of attribute tiny


23
24
25
# File 'lib/net/ssh/version.rb', line 23

def tiny
  @tiny
end

Class Method Details

.[](major, minor, tiny, pre = nil) ⇒ Object

A convenience method for instantiating a new Version instance with the given major, minor, and tiny components.


19
20
21
# File 'lib/net/ssh/version.rb', line 19

def self.[](major, minor, tiny, pre = nil)
  new(major, minor, tiny, pre)
end

Instance Method Details

#<=>(version) ⇒ Object

Compare this version to the given version object.


31
32
33
# File 'lib/net/ssh/version.rb', line 31

def <=>(version)
  to_i <=> version.to_i
end

#to_iObject

Converts this version to a canonical integer that may be compared against other version objects.


43
44
45
# File 'lib/net/ssh/version.rb', line 43

def to_i
  @to_i ||= @major * 1_000_000 + @minor * 1_000 + @tiny
end

#to_sObject

Converts this version object to a string, where each of the three version components are joined by the '.' character. E.g., 2.0.0.


37
38
39
# File 'lib/net/ssh/version.rb', line 37

def to_s
  @to_s ||= [@major, @minor, @tiny, @pre].compact.join(".")
end