Contents

# frozen_string_literal: true

module Versionaire
  # An immutable, semantic version value object.
  class Version
    include Comparable
    attr_reader :major, :minor, :maintenance

    KEYS = %i[major minor maintenance].freeze
    DELIMITER = "."

    def self.regex
      /
        \A            # Start of string.
        \d{1,}        # Major version.
        #{DELIMITER}  # Delimiter.
        \d{1,}        # Minor version.
        #{DELIMITER}  # Delimiter.
        \d{1,}        # Maintenance version.
        \z            # End of string.
      /x
    end

    def self.arguments major, minor, maintenance
      Hash[KEYS.zip [major, minor, maintenance]]
    end

    def initialize major: 0, minor: 0, maintenance: 0
      @major = major
      @minor = minor
      @maintenance = maintenance
      validate
    end

    def + other
      klass = self.class
      klass.new klass.arguments(*reduce(other, :+))
    end

    def - other
      klass = self.class
      klass.new klass.arguments(*reduce(other, :-))
    end

    # :reek:FeatureEnvy
    def == other
      other.is_a?(Version) && to_s == other.to_s
    end

    alias eql? ==

    def <=> other
      to_s <=> other.to_s
    end

    def hash
      [major, minor, maintenance, self.class].hash
    end

    def to_s
      [major, minor, maintenance].join self.class::DELIMITER
    end

    alias to_str to_s

    def to_a
      [major, minor, maintenance]
    end

    def to_h
      {major: major, minor: minor, maintenance: maintenance}
    end

    private

    def validate
      fail(Errors::InvalidNumber) if to_a.any? { |number| !number.is_a? Integer }
      fail(Errors::NegativeNumber) if to_a.any?(&:negative?)
    end

    def reduce other, action
      to_a.zip(other.to_a).map { |pair| pair.reduce(action) }
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
versionaire-6.0.0	lib/versionaire/version.rb