Class: Version

Inherits:

Object

• Object
• Version

Includes:

Comparable

Defined in:

Library/Homebrew/version.rb,
Library/Homebrew/version/null.rb

Direct Known Subclasses

HeadVersion, OS::Mac::Version, FromURL

Defined Under Namespace

Classes: AlphaToken, BetaToken, CompositeToken, FromURL, NullToken, NumericToken, PatchToken, PreToken, RCToken, StringToken, Token

Constant Summary

NULL_TOKEN =

NullToken.new

SCAN_PATTERN =

Regexp.union(
  AlphaToken::PATTERN,
  BetaToken::PATTERN,
  PreToken::PATTERN,
  RCToken::PATTERN,
  PatchToken::PATTERN,
  NumericToken::PATTERN,
  StringToken::PATTERN,
)

NULL =

Class.new do
  include Comparable

  def <=>(_other)
    -1
  end

  def eql?(_other)
    # Makes sure that the same instance of Version::NULL
    # will never equal itself; normally Comparable#==
    # will return true for this regardless of the return
    # value of #<=>
    false
  end

  def detected_from_url?
    false
  end

  def head?
    false
  end

  def null?
    true
  end

  def to_f
    Float::NAN
  end

  def to_i
    0
  end

  def to_s
    ""
  end
  alias_method :to_str, :to_s

  def inspect
    "#<Version::NULL>".freeze
  end
end.new

Class Method Summary

• .create(val) ⇒ Object
• .detect(url, specs) ⇒ Object
• .parse(spec) ⇒ Object

Instance Method Summary

• #<=>(other) ⇒ Object
• #detected_from_url? ⇒ Boolean
• #hash ⇒ Object
• #head? ⇒ Boolean
• #initialize(val) ⇒ Version constructor

  A new instance of Version.

• #null? ⇒ Boolean
• #to_f ⇒ Object
• #to_i ⇒ Object
• #to_s ⇒ Object (also: #to_str)

Constructor Details

#initialize(val) ⇒ Version

Returns a new instance of Version.

# File 'Library/Homebrew/version.rb', line 363

def initialize(val)
  unless val.respond_to?(:to_str)
    raise TypeError, "Version value must be a string; got a #{val.class} (#{val})"
  end
  @version = val.to_str
end

Class Method Details

.create(val) ⇒ Object

# File 'Library/Homebrew/version.rb', line 204

def self.create(val)
  unless val.respond_to?(:to_str)
    raise TypeError, "Version value must be a string; got a #{val.class} (#{val})"
  end

  if val.to_str.start_with?("HEAD")
    HeadVersion.new(val)
  else
    Version.new(val)
  end
end

.detect(url, specs) ⇒ Object

# File 'Library/Homebrew/version.rb', line 196

def self.detect(url, specs)
  if specs.key?(:tag)
    FromURL.new(specs[:tag][/((?:\d+\.)*\d+)/, 1])
  else
    FromURL.parse(url)
  end
end

.parse(spec) ⇒ Object

# File 'Library/Homebrew/version.rb', line 216

def self.parse(spec)
  version = _parse(spec)
  version.nil? ? NULL : new(version)
end

Instance Method Details

#<=>(other) ⇒ Object

# File 'Library/Homebrew/version.rb', line 382

def <=>(other)
  # Needed to retain API compatibility with older string comparisons
  # for compiler versions, etc.
  other = Version.new(other) if other.is_a? String
  # Used by the *_build_version comparisons, which formerly returned Fixnum
  other = Version.new(other.to_s) if other.is_a? Integer
  return 1 if other.nil?

  return unless other.is_a?(Version)
  return 0 if version == other.version
  return 1 if head? && !other.head?
  return -1 if !head? && other.head?
  return 0 if head? && other.head?

  ltokens = tokens
  rtokens = other.tokens
  max = max(ltokens.length, rtokens.length)
  l = r = 0

  while l < max
    a = ltokens[l] || NULL_TOKEN
    b = rtokens[r] || NULL_TOKEN

    if a == b
      l += 1
      r += 1
      next
    elsif a.numeric? && b.numeric?
      return a <=> b
    elsif a.numeric?
      return 1 if a > NULL_TOKEN
      l += 1
    elsif b.numeric?
      return -1 if b > NULL_TOKEN
      r += 1
    else
      return a <=> b
    end
  end

  0
end

#detected_from_url? ⇒ Boolean

Returns:

• (Boolean)

# File 'Library/Homebrew/version.rb', line 370

def detected_from_url?
  false
end

#hash ⇒ Object

# File 'Library/Homebrew/version.rb', line 426

def hash
  version.hash
end

#head? ⇒ Boolean

Returns:

• (Boolean)

# File 'Library/Homebrew/version.rb', line 374

def head?
  false
end

#null? ⇒ Boolean

Returns:

• (Boolean)

# File 'Library/Homebrew/version.rb', line 378

def null?
  false
end

#to_f ⇒ Object

# File 'Library/Homebrew/version.rb', line 430

def to_f
  version.to_f
end

#to_i ⇒ Object

# File 'Library/Homebrew/version.rb', line 434

def to_i
  version.to_i
end

#to_s ⇒ Object Also known as: to_str

# File 'Library/Homebrew/version.rb', line 438

def to_s
  version.dup
end