Module: Vers::GoVersion

Extended by:

GoVersion

Included in:

GoVersion

Defined in:

lib/vers/semver_version.rb

Instance Method Summary

• #compare(left, right) ⇒ Object
• #normalize(value) ⇒ Object
• #parse(value) ⇒ Object
• #prerelease?(value) ⇒ Boolean
• #valid?(value) ⇒ Boolean
• #valid_core_part?(part) ⇒ Boolean
• #valid_identifiers?(value, build:) ⇒ Boolean

Instance Method Details

#compare(left, right) ⇒ Object

# File 'lib/vers/semver_version.rb', line 214

def compare(left, right)
  return SemverVersion.compare(left, right) unless left.start_with?("v") || right.start_with?("v")

  parsed_left = parse(left)
  parsed_right = parse(right)
  return 1 if parsed_left && !parsed_right
  return -1 if !parsed_left && parsed_right
  return 0 unless parsed_left && parsed_right

  parsed_left.core.zip(parsed_right.core).each do |left_part, right_part|
    comparison = VersionComparison.compare_numbers(left_part, right_part)
    return comparison unless comparison.zero?
  end

  SemverVersion.compare_prerelease(parsed_left.prerelease, parsed_right.prerelease)
end

#normalize(value) ⇒ Object

# File 'lib/vers/semver_version.rb', line 286

def normalize(value)
  SemverVersion.normalize(value.to_s.strip, preserve_v: true)
end

#parse(value) ⇒ Object

# File 'lib/vers/semver_version.rb', line 231

def parse(value)
  return nil unless value.start_with?("v")

  string = value.delete_prefix("v")
  core_end = string.index(/[-+]/) || string.length
  core = string[0...core_end].split(".", -1)
  return nil if core.empty? || core.length > 3
  return nil unless core.all? { |part| valid_core_part?(part) }
  return nil if core.length < 3 && core_end != string.length

  core << "0" while core.length < 3
  remainder = string[core_end..]
  prerelease = ""
  build = ""

  if remainder.start_with?("-")
    value = remainder.delete_prefix("-")
    prerelease_end = value.index("+") || value.length
    prerelease = value[0...prerelease_end]
    return nil unless valid_identifiers?(prerelease, build: false)

    remainder = value[prerelease_end..]
  end

  if remainder.start_with?("+")
    build = remainder.delete_prefix("+")
    return nil unless valid_identifiers?(build, build: true)

    remainder = ""
  end

  return nil unless remainder.empty?

  SemverVersion::Parsed.new(core.freeze, prerelease, build)
end

#prerelease?(value) ⇒ Boolean

Returns:

• (Boolean)

# File 'lib/vers/semver_version.rb', line 290

def prerelease?(value)
  SemverVersion.prerelease?(value.to_s.strip)
end

#valid?(value) ⇒ Boolean

Returns:

• (Boolean)

# File 'lib/vers/semver_version.rb', line 281

def valid?(value)
  string = value.to_s.strip
  string.start_with?("v") ? !parse(string).nil? : SemverVersion.valid?(string)
end

#valid_core_part?(part) ⇒ Boolean

Returns:

• (Boolean)

# File 'lib/vers/semver_version.rb', line 267

def valid_core_part?(part)
  VersionComparison.numeric?(part) && (part == "0" || !part.start_with?("0"))
end

#valid_identifiers?(value, build:) ⇒ Boolean

Returns:

• (Boolean)

# File 'lib/vers/semver_version.rb', line 271

def valid_identifiers?(value, build:)
  return false if value.empty?

  value.split(".", -1).all? do |identifier|
    next false unless identifier.match?(/\A[0-9A-Za-z-]+\z/)

    build || identifier == "0" || !VersionComparison.numeric?(identifier) || !identifier.start_with?("0")
  end
end