Class: Version::Token Abstract Private

Inherits:
Object
  • Object
show all
Extended by:
T::Helpers, T::Sig
Includes:
Comparable
Defined in:
version.rb

Overview

This class is part of a private API. This class may only be used in the Homebrew/brew repository. Third parties should avoid using this class if possible, as it may be removed or changed without warning.

This class is abstract.

It cannont be directly instantiated. Subclasses must implement the abstract methods below.

A part of a Version.

Direct Known Subclasses

NumericToken, StringToken

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(value) ⇒ void

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

  • value (String, Integer, nil) 


60
61
62
 
# File 'version.rb', line 60

def initialize(value)
  @value = T.let(value, T.untyped)
end

Instance Attribute Details

#value ⇒ String, ... (readonly)

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



57
58
59
 
# File 'version.rb', line 57

def value
  @value
end

Class Method Details

.create(val) ⇒ Token

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

Returns:

Raises:

  • (TypeError) 


30
31
32
33
34
35
36
37
38
39
40
41
42
43
 
# File 'version.rb', line 30

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

  case val
  when /\A#{AlphaToken::PATTERN}\z/o   then AlphaToken
  when /\A#{BetaToken::PATTERN}\z/o    then BetaToken
  when /\A#{RCToken::PATTERN}\z/o      then RCToken
  when /\A#{PreToken::PATTERN}\z/o     then PreToken
  when /\A#{PatchToken::PATTERN}\z/o   then PatchToken
  when /\A#{PostToken::PATTERN}\z/o    then PostToken
  when /\A#{NumericToken::PATTERN}\z/o then NumericToken
  when /\A#{StringToken::PATTERN}\z/o  then StringToken
  end.new(val)
end

.from(val) ⇒ Token?

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

  • val (T.untyped)

Returns:



46
47
48
49
50
51
52
53
54
 
# File 'version.rb', line 46

def self.from(val)
  return NULL_TOKEN if val.nil? || (val.respond_to?(:null?) && val.null?)

  case val
  when Token   then val
  when String  then Token.create(val)
  when Integer then Token.create(val.to_s)
  end
end

Instance Method Details

#<=>(other) ⇒ Integer?

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

This method is abstract.

Parameters:

  • other (T.untyped)

Returns:

  • (Integer, nil) 


65
 
# File 'version.rb', line 65

def <=>(other); end

#hash ⇒ Integer

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Integer) 


73
74
75
 
# File 'version.rb', line 73

def hash
  value.hash
end

#inspect ⇒ String

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



68
69
70
 
# File 'version.rb', line 68

def inspect
  "#<#{self.class.name} #{value.inspect}>"
end

#null? ⇒ Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Boolean) 


99
100
101
 
# File 'version.rb', line 99

def null?
  false
end

#numeric? ⇒ Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Boolean) 


94
95
96
 
# File 'version.rb', line 94

def numeric?
  false
end

#to_f ⇒ Float

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Float) 


78
79
80
 
# File 'version.rb', line 78

def to_f
  value.to_f
end

#to_i ⇒ Integer

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

  • (Integer) 


83
84
85
 
# File 'version.rb', line 83

def to_i
  value.to_i
end

#to_s ⇒ String Also known as: to_str

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:



88
89
90
 
# File 'version.rb', line 88

def to_s
  value.to_s
end