BigW Consortium Gitlab

delta.rb 856 Bytes
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
module Gitlab
  module Metrics
    # Class for calculating the difference between two numeric values.
    #
    # Every call to `compared_with` updates the internal value. This makes it
    # possible to use a single Delta instance to calculate the delta over time
    # of an ever increasing number.
    #
    # Example usage:
    #
    #     delta = Delta.new(0)
    #
    #     delta.compared_with(10) # => 10
    #     delta.compared_with(15) # => 5
    #     delta.compared_with(20) # => 5
    class Delta
      def initialize(value = 0)
        @value = value
      end

      # new_value - The value to compare with as a Numeric.
      #
      # Returns a new Numeric (depending on the type of `new_value`).
      def compared_with(new_value)
        delta  = new_value - @value
        @value = new_value

        delta
      end
    end
  end
end