Class: Version Private
- Includes:
- Comparable
- Defined in:
- version.rb,
version/parser.rb
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.
Direct Known Subclasses
Defined Under Namespace
Classes: AlphaToken, BetaToken, CompositeToken, NumericToken, Parser, PatchToken, PostToken, PreToken, RCToken, RegexParser, StemParser, StringToken, Token, UrlParser
Constant Summary collapse
- NULL_TOKEN =
This constant is part of a private API. This constant may only be used in the Homebrew/brew repository. Third parties should avoid using this constant if possible, as it may be removed or changed without warning.
Represents the absence of a token.
T.let(NullToken.new.freeze, NullToken)
Class Method Summary collapse
- .detect(url, **specs) ⇒ Version private
- .formula_optionally_versioned_regex(name, full: true) ⇒ Regexp private
- .parse(spec, detected_from_url: false) ⇒ Version private
Instance Method Summary collapse
-
#commit ⇒ String?
Return the commit for a HEAD version.
- #compare(comparator, other) ⇒ Boolean private
- #detected_from_url? ⇒ Boolean private
- #freeze ⇒ T.self_type private
-
#head? ⇒ Boolean
Check if this is a HEAD version.
- #initialize(val, detected_from_url: false) ⇒ void constructor private
-
#major ⇒ Token?
The major version.
-
#major_minor ⇒ T.self_type
The major and minor version.
-
#major_minor_patch ⇒ T.self_type
The major, minor and patch version.
-
#minor ⇒ Token?
The minor version.
- #null? ⇒ Boolean private
-
#patch ⇒ Token?
The patch version.
- #respond_to?(method, include_all = false) ⇒ Boolean private
-
#to_f ⇒ Float
Convert the version to a floating-point number.
-
#to_i ⇒ Integer
Convert the version to an integer.
- #to_json(*options) ⇒ String private
- #to_str ⇒ String
-
#update_commit(commit) ⇒ void
private
Update the commit for a HEAD version.
Constructor Details
#initialize(val, detected_from_url: false) ⇒ 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.
496 497 498 499 500 501 502 |
# File 'version.rb', line 496 def initialize(val, detected_from_url: false) version = val.to_str raise ArgumentError, "Version must not be empty" if version.blank? @version = T.let(version, String) @detected_from_url = detected_from_url end |
Class Method Details
.detect(url, **specs) ⇒ Version
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.
343 344 345 |
# File 'version.rb', line 343 def self.detect(url, **specs) parse(specs.fetch(:tag, url), detected_from_url: true) end |
.formula_optionally_versioned_regex(name, full: true) ⇒ Regexp
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.
11 12 13 |
# File 'version.rb', line 11 def self.formula_optionally_versioned_regex(name, full: true) /#{"^" if full}#{Regexp.escape(name)}(@\d[\d.]*)?#{"$" if full}/ end |
.parse(spec, detected_from_url: false) ⇒ Version
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.
348 349 350 351 352 353 354 355 356 357 358 359 360 |
# File 'version.rb', line 348 def self.parse(spec, detected_from_url: false) # This type of full-URL decoding is not technically correct but we only need a rough decode for version parsing. spec = URI.decode_www_form_component(spec.to_s) if detected_from_url spec = Pathname(spec) VERSION_PARSERS.each do |parser| version = parser.parse(spec) return new(version, detected_from_url:) if version.present? end NULL end |
Instance Method Details
#commit ⇒ String?
Return the commit for a HEAD version.
524 525 526 |
# File 'version.rb', line 524 def commit version&.match(HEAD_VERSION_REGEX)&.[](:commit) end |
#compare(comparator, other) ⇒ 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.
546 547 548 549 550 551 552 553 554 555 556 |
# File 'version.rb', line 546 def compare(comparator, other) case comparator when ">=" then self >= other when ">" then self > other when "<" then self < other when "<=" then self <= other when "==" then self == other when "!=" then self != other else raise ArgumentError, "Unknown comparator: #{comparator}" end end |
#detected_from_url? ⇒ 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.
505 506 507 |
# File 'version.rb', line 505 def detected_from_url? @detected_from_url end |
#freeze ⇒ T.self_type
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.
752 753 754 755 |
# File 'version.rb', line 752 def freeze tokens # Determine and store tokens before freezing super end |
#head? ⇒ Boolean
Check if this is a HEAD version.
516 517 518 |
# File 'version.rb', line 516 def head? version&.match?(HEAD_VERSION_REGEX) || false end |
#major ⇒ Token?
The major version.
651 652 653 654 655 |
# File 'version.rb', line 651 def major return NULL_TOKEN if null? tokens.first end |
#major_minor ⇒ T.self_type
The major and minor version.
681 682 683 684 685 686 |
# File 'version.rb', line 681 def major_minor return self if null? major_minor = T.must(tokens[0..1]) major_minor.empty? ? NULL : self.class.new(major_minor.join(".")) end |
#major_minor_patch ⇒ T.self_type
The major, minor and patch version.
692 693 694 695 696 697 |
# File 'version.rb', line 692 def major_minor_patch return self if null? major_minor_patch = T.must(tokens[0..2]) major_minor_patch.empty? ? NULL : self.class.new(major_minor_patch.join(".")) end |
#minor ⇒ Token?
The minor version.
661 662 663 664 665 |
# File 'version.rb', line 661 def minor return NULL_TOKEN if null? tokens.second 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.
541 542 543 |
# File 'version.rb', line 541 def null? version.nil? end |
#patch ⇒ Token?
The patch version.
671 672 673 674 675 |
# File 'version.rb', line 671 def patch return NULL_TOKEN if null? tokens.third end |
#respond_to?(method, include_all = false) ⇒ 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.
738 739 740 741 742 |
# File 'version.rb', line 738 def respond_to?(method, include_all = false) return !null? if ["to_str", :to_str].include?(method) super end |
#to_f ⇒ Float
Convert the version to a floating-point number.
708 709 710 711 712 |
# File 'version.rb', line 708 def to_f return Float::NAN if null? version.to_f end |
#to_i ⇒ Integer
Convert the version to an integer.
718 719 720 |
# File 'version.rb', line 718 def to_i version.to_i end |
#to_json(*options) ⇒ 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.
735 |
# File 'version.rb', line 735 def to_json(*) = version.to_json(*) |
#to_str ⇒ String
724 725 726 727 728 |
# File 'version.rb', line 724 def to_str raise NoMethodError, "undefined method `to_str' for #{self.class}:NULL" if null? T.must(version).to_str end |
#update_commit(commit) ⇒ 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.
This method returns an undefined value.
Update the commit for a HEAD version.
530 531 532 533 534 535 536 537 538 |
# File 'version.rb', line 530 def update_commit(commit) raise ArgumentError, "Cannot update commit for non-HEAD version." unless head? @version = if commit "HEAD-#{commit}" else "HEAD" end end |