benchmark-ips 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 21b099f60a4072356c1870798deab178dc6fe7f5
-  data.tar.gz: 173c42ebe9730b48a3cf019b8f92c093066cd497
+  metadata.gz: 2b0795c8f86b241fbf0e02d13401e209cac488ad
+  data.tar.gz: bd46b20f496f074e93c33a378da27e7ae225fe62
 SHA512:
-  metadata.gz: cd342a80b701d34c2034462a3ee765ac92ef809e2345fac3be3a05673fa34662c1db4ad618065eafd74c50078ab77081ccf3f70efdd63045efc4156a88dd88cb
-  data.tar.gz: 09e2598b1fb76dde4abe095703d3ffea4f5f8dcd30b53492168e69b437d04ca59198d003da417637cc09beecc2f87d025754522fe30915e499606389865fe85a
+  metadata.gz: f7d3b4ca509f2fcca1ec8f5eef9b0f2d0e2bc218abe7d69b359f9c41a64767dc19b16f8be1ee6bafd3c33d1f738ae0cc54fdbb12922d67cecd0092f885dc8c42
+  data.tar.gz: 3ca470bf622922c813cf8f6f6a82a4124b681d172cb1662488507a020ea314244ad012ee6ae724c81509135b8ce24539da4492dc8f0a7711c80b98f98974310d

data/History.txt

@@ -1,3 +1,14 @@
+=== 2.1.0 / 2014-11-10
+
+* Documentation changes:
+  * Many documentation fixes by Juanito Fatas!
+  * Minor readme fix by Will Leinweber
+
+* 2 minor features:
+  * Displaying the total runtime for a job is suppressed unless interesting
+  * Formatting of large values improved (human vs raw mode)
+    * Contributed by Charles Oliver Nutter
+
 === 2.0.0 / 2014-06-18
 
 * The 'Davy Stevenson' release!

data/Manifest.txt

@@ -4,7 +4,6 @@ Manifest.txt
 README.md
 Rakefile
 lib/benchmark/compare.rb
-lib/benchmark/helpers.rb
 lib/benchmark/ips.rb
 lib/benchmark/ips/report.rb
 lib/benchmark/ips/job.rb

data/README.md

@@ -1,12 +1,16 @@
-[![Build Status](https://secure.travis-ci.org/evanphx/benchmark-ips.png)](http://travis-ci.org/evanphx/benchmark-ips)
+[![Gem Version](https://badge.fury.io/rb/benchmark-ips.svg)](http://badge.fury.io/rb/benchmark-ips)
+[![Build Status](https://secure.travis-ci.org/evanphx/benchmark-ips.svg)](http://travis-ci.org/evanphx/benchmark-ips)
+[![Inline docs](http://inch-ci.org/github/evanphx/benchmark-ips.svg)](http://inch-ci.org/github/evanphx/benchmark-ips)
 
 # benchmark-ips
 
-* http://github.com/evanphx/benchmark-ips
+* https://github.com/evanphx/benchmark-ips
+
+* [documentation](http://rubydoc.info/gems/benchmark-ips)
 
 ## DESCRIPTION:
 
-A iterations per second enhancement to Benchmark
+A iterations per second enhancement to Benchmark.
 
 ## FEATURES/PROBLEMS:
 
@@ -21,7 +25,7 @@ require 'benchmark/ips'
 
 Benchmark.ips do |x|
   # Configure the number of seconds used during
-  # the warmup phase and calculation phase
+  # the warmup phase (default 2) and calculation phase (default 5)
   x.config(:time => 5, :warmup => 2)
 
   # These parameters can also be configured this way
@@ -60,13 +64,23 @@ This will generate the following report:
 
 ```
 Calculating -------------------------------------
-   addition    147625 i/100ms
-  addition2    151046 i/100ms
-  addition3    172914 i/100ms
+            addition     71254 i/100ms
+           addition2     68658 i/100ms
+           addition3     83079 i/100ms
+addition-test-long-label
+                         70129 i/100ms
 -------------------------------------------------
-   addition  9247039.5 (±13.2%) i/s -   45320875 in   5.009003s
-  addition2 26436533.8 (±22.1%) i/s -  124461904 in   4.994989s
-  addition3 32227427.9 (±13.0%) i/s -  157524654 in   5.002928s
+            addition  4955278.9 (±8.7%) i/s -   24155106 in   5.002163s
+           addition2 24011974.8 (±9.5%) i/s -  114246912 in   4.995446s
+           addition3 23958619.8 (±9.9%) i/s -  115064415 in   4.996349s
+addition-test-long-label
+                      5014756.0 (±9.1%) i/s -   24545150 in   5.009754s
+
+Comparison:
+           addition2: 24011974.8 i/s
+           addition3: 23958619.8 i/s - 1.00x slower
+addition-test-long-label:  5014756.0 i/s - 4.79x slower
+            addition:  4955278.9 i/s - 4.85x slower
 ```
 
 Benchmark/ips will report the number of iterations per second for a given block
@@ -96,8 +110,6 @@ After checking out the source, run:
 This task will install any missing dependencies, run the tests/specs,
 and generate the RDoc.
 
-Run the example file `bin/benchmark_ips` to test that everything is working properly.
-
 ## LICENSE:
 
 (The MIT License)

data/lib/benchmark/compare.rb

@@ -1,6 +1,34 @@
 module Benchmark
+  # Functionality of performaing comparison between reports.
+  #
+  # Usage:
+  #
+  # Add +x.compare!+ to perform comparison between reports.
+  #
+  # Example:
+  #   > Benchmark.ips do |x|
+  #     x.report('Reduce using tag')     { [*1..10].reduce(:+) }
+  #     x.report('Reduce using to_proc') { [*1..10].reduce(&:+) }
+  #     x.compare!
+  #   end
+  #
+  #   Calculating -------------------------------------
+  #       Reduce using tag     19216 i/100ms
+  #   Reduce using to_proc     17437 i/100ms
+  #   -------------------------------------------------
+  #       Reduce using tag   278950.0 (±8.5%) i/s -    1402768 in   5.065112s
+  #   Reduce using to_proc   247295.4 (±8.0%) i/s -    1238027 in   5.037299s
+  #
+  #   Comparison:
+  #       Reduce using tag:   278950.0 i/s
+  #   Reduce using to_proc:   247295.4 i/s - 1.13x slower
+  #
+  # Besides regular Calculating report, this will also indicates which one is slower.
   module Compare
 
+    # Compare between reports, prints out facts of each report:
+    # runtime, comparative speed difference.
+    # @param reports [Array<Report>] Reports to compare.
     def compare(*reports)
       return if reports.size < 2
 
@@ -16,12 +44,12 @@ module Benchmark
 
       best = sorted.shift
 
-      STDOUT.puts "\nComparison:"
+      $stdout.puts "\nComparison:"
 
       if iter
-        STDOUT.printf "%20s: %10.1f i/s\n", best.label, best.ips
+        $stdout.printf "%20s: %10.1f i/s\n", best.label, best.ips
       else
-        STDOUT.puts "#{best.rjust(20)}: #{best.runtime}s"
+        $stdout.puts "#{best.rjust(20)}: #{best.runtime}s"
       end
 
       sorted.each do |report|
@@ -29,14 +57,14 @@ module Benchmark
 
         if iter
           x = (best.ips.to_f / report.ips.to_f)
-          STDOUT.printf "%20s: %10.1f i/s - %.2fx slower\n", name, report.ips, x
+          $stdout.printf "%20s: %10.1f i/s - %.2fx slower\n", name, report.ips, x
         else
           x = "%.2f" % (report.ips.to_f / best.ips.to_f)
-          STDOUT.puts "#{name.rjust(20)}: #{report.runtime}s - #{x}x slower"
+          $stdout.puts "#{name.rjust(20)}: #{report.runtime}s - #{x}x slower"
         end
       end
 
-      STDOUT.puts
+      $stdout.puts
     end
   end
 

data/lib/benchmark/ips.rb

@@ -4,11 +4,23 @@ require 'benchmark/compare'
 require 'benchmark/ips/report'
 require 'benchmark/ips/job'
 
+# Performance benchmarking library
 module Benchmark
+  # Benchmark in iterations per second, no more guessing!
+  # @see https://github.com/evanphx/benchmark-ips
   module IPS
-    VERSION = "2.0.0"
+
+    # Benchmark-ips Gem version.
+    VERSION = "2.1.0"
+
+    # CODENAME of current version.
     CODENAME = "Springtime Hummingbird Dance"
 
+    # Measure code in block, each code's benchmarked result will display in
+    # iteration per second with standard deviation in given time.
+    # @param time [Integer] Specify how long should benchmark your code in seconds.
+    # @param warmup [Integer] Specify how long should Warmup time run in seconds.
+    # @return [Report]
     def ips(time=nil, warmup=nil)
       suite = nil
 
@@ -48,7 +60,34 @@ module Benchmark
 
       return job.full_report
     end
+
+    # Set options for running the benchmarks.
+    # :format => [:human, :raw]
+    #    :human format narrows precision and scales results for readability
+    #    :raw format displays 6 places of precision and exact iteration counts
+    def self.options
+      @options ||= {:format => :human}
+    end
+
+    module Helpers
+      def scale(value)
+        scale = (Math.log10(value) / 3).to_i
+        suffix = case scale
+        when 1; 'k'
+        when 2; 'M'
+        when 3; 'B'
+        when 4; 'T'
+        when 5; 'Q'
+        else
+          # < 1000 or > 10^15, no scale or suffix
+          scale = 0
+          ' '
+        end
+        "%10.3f#{suffix}" % (value.to_f / (1000 ** scale))
+      end
+      module_function :scale
+    end
   end
 
-  extend Benchmark::IPS
+  extend Benchmark::IPS # make ips available as module-level method
 end

data/lib/benchmark/ips/job.rb

@@ -1,11 +1,21 @@
 module Benchmark
   module IPS
+    # Benchmark jobs.
     class Job
-
+      # Microseconds per 100 millisecond.
       MICROSECONDS_PER_100MS = 100_000
+      # Microseconds per second.
       MICROSECONDS_PER_SECOND = 1_000_000
+      # The percentage of the expected runtime to allow
+      # before reporting a weird runtime
+      MAX_TIME_SKEW = 0.05
 
+      # Entries in Benchmark Jobs.
       class Entry
+        # Instantiate the Benchmark::IPS::Job::Entry.
+        # @param label [String] Label of Benchmarked code.
+        # @param action [String, Proc] Code to be benchmarked.
+        # @raise [ArgumentError] Raises when action is not String or not responding to +call+.
         def initialize(label, action)
           @label = label
 
@@ -30,8 +40,17 @@ module Benchmark
           end
         end
 
-        attr_reader :label, :action
+        # The label of benchmarking action.
+        # @return [String] Label of action.
+        attr_reader :label
+
+        # The benchmarking action.
+        # @return [String, Proc] Code to be called, could be String / Proc.
+        attr_reader :action
 
+        # Add padding to label's right if label's length < 20,
+        # Otherwise add a new line and 20 whitespaces.
+        # @return [String] Right justified label.
         def label_rjust
           if @label.size > 20
             "#{@label}\n#{' ' * 20}"
@@ -40,10 +59,9 @@ module Benchmark
           end
         end
 
-        def as_action?
-          @as_action
-        end
-
+        # Call action by given times, return if +@call_loop+ is present.
+        # @param times [Integer] Times to call +@action+.
+        # @return [Integer] Number of times the +@action+ has been called.
         def call_times(times)
           return @action.call(times) if @call_loop
 
@@ -56,6 +74,9 @@ module Benchmark
           end
         end
 
+        # Compile code into +call_times+ method.
+        # @param str [String] Code to be compiled.
+        # @return [Symbol] :call_times.
         def compile(str)
           m = (class << self; self; end)
           code = <<-CODE
@@ -69,20 +90,37 @@ module Benchmark
           CODE
           m.class_eval code
         end
-      end
+      end # End of Entry
+
+      # class Job
 
-      # An array of 2-element arrays, consisting of label and block pairs.
+      # Two-element arrays, consisting of label and block pairs.
+      # @return [Array<Entry>] list of entries
       attr_reader :list
 
-      # Boolean determining whether to run comparison utility
+      # Determining whether to run comparison utility.
+      # @return [Boolean] true if needs to run compare.
       attr_reader :compare
 
-      # Report object containing information about the run
+      # Report object containing information about the run.
+      # @return [Report] the report object.
       attr_reader :full_report
 
-      attr_accessor :warmup, :time
+      # Storing Iterations in time period.
+      # @return [Hash]
       attr_reader :timing
 
+      # Warmup time setter and getter (in seconds).
+      # @return [Integer]
+      attr_accessor :warmup
+
+      # Calculation time setter and getter (in seconds).
+      # @return [Integer]
+      attr_accessor :time
+
+      # Instantiate the Benchmark::IPS::Job.
+      # @option opts [Benchmark::Suite] (nil) :suite Specify Benchmark::Suite.
+      # @option opts [Boolean] (false) :quiet Suppress the printing of information.
       def initialize opts={}
         @suite = opts[:suite] || nil
         @quiet = opts[:quiet] || false
@@ -92,27 +130,36 @@ module Benchmark
         @timing = {}
         @full_report = Report.new
 
-        # defaults
+        # Default warmup and calculation time in seconds.
         @warmup = 2
         @time = 5
       end
 
+      # Job configuration options, set +@warmup+ and +@time+.
+      # @option opts [Integer] :warmup Warmup time.
+      # @option opts [Integer] :time Calculation time.
       def config opts
         @warmup = opts[:warmup] if opts[:warmup]
         @time = opts[:time] if opts[:time]
       end
 
+      # Return true if job needs to be compared.
+      # @return [Boolean] Need to compare?
       def compare?
         @compare
       end
 
+      # Set @compare to true.
       def compare!
         @compare = true
       end
 
-      #
       # Registers the given label and block pair in the job list.
-      #
+      # @param label [String] Label of benchmarked code.
+      # @param str [String] Code to be benchamrked.
+      # @param blk [Proc] Code to be benchamrked.
+      # @raise [ArgumentError] Raises if str and blk are both present.
+      # @raise [ArgumentError] Raises if str and blk are both absent.
       def item(label="", str=nil, &blk) # :yield:
         if blk and str
           raise ArgumentError, "specify a block and a str, but not both"
@@ -126,26 +173,35 @@ module Benchmark
       end
       alias_method :report, :item
 
-      # calculate the cycles needed to run for approx 100ms
-      # given the number of iterations to run the given time
+      # Calculate the cycles needed to run for approx 100ms,
+      # given the number of iterations to run the given time.
+      # @param [Float] time_msec Each iteration's time in ms.
+      # @param [Integer] iters Iterations.
+      # @return [Integer] Cycles per 100ms.
       def cycles_per_100ms time_msec, iters
         cycles = ((MICROSECONDS_PER_100MS / time_msec) * iters).to_i
         cycles = 1 if cycles <= 0
         cycles
       end
 
-      # calculate the difference in microseconds between
-      # before and after
+      # Calculate the time difference of before and after in microseconds.
+      # @param [Time] before time.
+      # @param [Time] after time.
+      # @return [Float] Time difference of before and after.
       def time_us before, after
         (after.to_f - before.to_f) * MICROSECONDS_PER_SECOND
       end
 
-      # calculate the interations per second given the number
-      # of cycles run and the time in microseconds that elapsed
+      # Calculate the interations per second given the number
+      # of cycles run and the time in microseconds that elapsed.
+      # @param [Integer] cycles Cycles.
+      # @param [Integer] time_us Time in microsecond.
+      # @return [Float] Iteration per second.
       def iterations_per_sec cycles, time_us
         MICROSECONDS_PER_SECOND * (cycles.to_f / time_us.to_f)
       end
 
+      # Run warmup.
       def run_warmup
         @list.each do |item|
           @suite.warming item.label, @warmup if @suite
@@ -172,12 +228,18 @@ module Benchmark
 
           @timing[item] = cycles_per_100ms warmup_time_us, warmup_iter
 
-          $stdout.printf "%10d i/100ms\n", @timing[item] unless @quiet
+          case Benchmark::IPS.options[:format]
+          when :human
+            $stdout.printf "%s i/100ms\n", Helpers.scale(@timing[item]) unless @quiet
+          else
+            $stdout.printf "%10d i/100ms\n", @timing[item] unless @quiet
+          end
 
           @suite.warmup_stats warmup_time_us, @timing[item] if @suite
         end
       end
 
+      # Run calculation.
       def run
         @list.each do |item|
           @suite.running item.label, @time if @suite
@@ -194,7 +256,7 @@ module Benchmark
 
           measurements_us = []
 
-          # running this number of cycles should take around 100ms
+          # Running this number of cycles should take around 100ms.
           cycles = @timing[item]
 
           while Time.now < target
@@ -204,7 +266,6 @@ module Benchmark
 
             # If for some reason the timing said this took no time (O_o)
             # then ignore the iteration entirely and start another.
-            #
             iter_us = time_us before, after
             next if iter_us <= 0.0
 
@@ -213,6 +274,8 @@ module Benchmark
             measurements_us << iter_us
           end
 
+          final_time = Time.now
+
           measured_us = measurements_us.inject(0) { |a,i| a + i }
 
           all_ips = measurements_us.map { |time_us|
@@ -224,20 +287,31 @@ module Benchmark
 
           rep = create_report(item, measured_us, iter, avg_ips, sd_ips, cycles)
 
+          if (final_time - target).abs >= (@time.to_f * MAX_TIME_SKEW)
+            rep.show_total_time!
+          end
+
           $stdout.puts " #{rep.body}" unless @quiet
 
           @suite.add_report rep, caller(1).first if @suite
         end
       end
 
+      # Run comparison of entries in +@full_report+.
       def run_comparison
         @full_report.run_comparison
       end
 
+      # Create report by add entry to +@full_report+.
+      # @param item [Benchmark::IPS::Job::Entry] Report item.
+      # @param measured_us [Integer] Measured time in microsecond.
+      # @param iter [Integer] Iterations.
+      # @param avg_ips [Float] Average iterations per second.
+      # @param sd_ips [Float] Standard deviation iterations per second.
+      # @param cycles [Integer] Number of Cycles.
       def create_report(item, measured_us, iter, avg_ips, sd_ips, cycles)
         @full_report.add_entry item.label, measured_us, iter, avg_ips, sd_ips, cycles
       end
-
     end
   end
 end

data/lib/benchmark/ips/report.rb

@@ -1,10 +1,21 @@
 # encoding: utf-8
+
 module Benchmark
   module IPS
+
+    # Report contains benchamrking entries.
+    # Perform operations like add new entry, run comparison between entries.
     class Report
 
+      # Represents benchmarking code data for Report.
       class Entry
-
+        # Instantiate the Benchmark::IPS::Report::Entry.
+        # @param [String] label Label of entry.
+        # @param [Integer] us Measured time in microsecond.
+        # @param [Integer] iters Iterations.
+        # @param [Float] ips Iterations per second.
+        # @param [Float] ips_sd Standard deviation of iterations per second.
+        # @param [Integer] cycles Number of Cycles.
         def initialize(label, us, iters, ips, ips_sd, cycles)
           @label = label
           @microseconds = us
@@ -12,53 +23,126 @@ module Benchmark
           @ips = ips
           @ips_sd = ips_sd
           @measurement_cycle = cycles
+          @show_total_time = false
         end
 
-        attr_reader :label, :microseconds, :iterations, :ips, :ips_sd, :measurement_cycle
+        # Label of entry.
+        # @return [String] the label of entry.
+        attr_reader :label
+
+        # Measured time in microsecond.
+        # @return [Integer] number of microseconds.
+        attr_reader :microseconds
+
+        # Number of Iterations.
+        # @return [Integer] number of iterations.
+        attr_reader :iterations
+
+        # Iterations per second.
+        # @return [Float] number of iterations per second.
+        attr_reader :ips
+
+        # Standard deviation of iteration per second.
+        # @return [Float] standard deviation of iteration per second.
+        attr_reader :ips_sd
+
+        # Number of Cycles.
+        # @return [Integer] number of cycles.
+        attr_reader :measurement_cycle
 
+        # Control if the total time the job took is reported.
+        # Typically this value is not significant because it's very
+        # close to the expected time, so it's supressed by default.
+        def show_total_time!
+          @show_total_time = true
+        end
+
+        # Return entry's microseconds in seconds.
+        # @return [Float] +@microseconds+ in seconds.
         def seconds
           @microseconds.to_f / 1_000_000.0
         end
 
+        # Return entry's standard deviation of iteration per second in percentage.
+        # @return [Float] +@ips_sd+ in percentage.
         def stddev_percentage
           100.0 * (@ips_sd.to_f / @ips.to_f)
         end
 
         alias_method :runtime, :seconds
 
+        # Return Entry body text with left padding.
+        # Body text contains information of iteration per second with
+        # percentage of standard deviation, iterations in runtime.
+        # @return [String] Left justified body.
         def body
-          left = "%10.1f (±%.1f%%) i/s" % [ips, stddev_percentage]
-          left.ljust(20) + (" - %10d in %10.6fs" % [@iterations, runtime])
+          case Benchmark::IPS.options[:format]
+          when :human
+            left = "%s (±%4.1f%%) i/s" % [Helpers.scale(ips), stddev_percentage]
+            iters = Helpers.scale(@iterations)
+
+            if @show_total_time
+              left.ljust(20) + (" - %s in %10.6fs" % [iters, runtime])
+            else
+              left.ljust(20) + (" - %s" % iters)
+            end
+          else
+            left = "%10.1f (±%.1f%%) i/s" % [ips, stddev_percentage]
+
+            if @show_total_time
+              left.ljust(20) + (" - %10d in %10.6fs" % [@iterations, runtime])
+            else
+              left.ljust(20) + (" - %10d" % @iterations)
+            end
+          end
         end
 
+        # Return header with padding if +@label+ is < length of 20.
+        # @return [String] Right justified header (+@label+).
         def header
           @label.rjust(20)
         end
 
+        # Return string repesentation of Entry object.
+        # @return [String] Header and body.
         def to_s
           "#{header} #{body}"
         end
 
+        # Print entry to current standard output ($stdout).
         def display
           $stdout.puts to_s
         end
-      end
+      end # End of Entry
+
+      # class Report
 
+      # Entry to represent each benchamarked code in Report.
+      # @return [Array<Entry>] Entries in Report.
       attr_reader :entries
 
+      # Instantiate the Report.
       def initialize
         @entries = []
       end
 
+      # Add entry to report.
+      # @param label [String] Entry label.
+      # @param microseconds [Integer] Measured time in microsecond.
+      # @param iters [Integer] Iterations.
+      # @param ips [Float] Average Iterations per second.
+      # @param ips_sd [Float] Standard deviation of iterations per second.
+      # @param measurement_cycle [Integer] Number of cycles.
+      # @return [Entry] Last added entry.
       def add_entry label, microseconds, iters, ips, ips_sd, measurement_cycle
         @entries << Entry.new(label, microseconds, iters, ips, ips_sd, measurement_cycle)
         @entries.last
       end
 
+      # Run comparison of entries.
       def run_comparison
         Benchmark.compare(*@entries)
       end
-
     end
   end
 end

data/lib/benchmark/timing.rb

@@ -1,10 +1,18 @@
 module Benchmark
+  # Perform caclulations on Timing results.
   module Timing
+
+    # Calculate (arithmetic) mean of given samples.
+    # @param [Array] samples Samples to calculate mean.
+    # @return [Float] Mean of given samples.
     def self.mean(samples)
       sum = samples.inject(0) { |acc, i| acc + i }
       sum / samples.size
     end
 
+    # Calculate variance of given samples.
+    # @param [Float] m Optional mean (Expected value).
+    # @return [Float] Variance of given samples.
     def self.variance(samples, m=nil)
       m ||= mean(samples)
 
@@ -13,10 +21,17 @@ module Benchmark
       total / samples.size
     end
 
+    # Calculate standard deviation of given samples.
+    # @param [Array] samples Samples to calculate standard deviation.
+    # @param [Float] m Optional mean (Expected value).
+    # @return [Float] standard deviation of given samples.
     def self.stddev(samples, m=nil)
       Math.sqrt variance(samples, m)
     end
 
+    # Resample mean of given samples.
+    # @param [Integer] resample_times Resample times, defaults to 100.
+    # @return [Array] Resampled samples.
     def self.resample_mean(samples, resample_times=100)
       resamples = []
 
@@ -28,6 +43,7 @@ module Benchmark
       resamples
     end
 
+    # Recycle unsed objects by starting Garbage Collector.
     def self.clean_env
       # rbx
       if GC.respond_to? :run

data/test/test_benchmark_ips.rb

@@ -28,7 +28,7 @@ class TestBenchmarkIPS < Minitest::Test
     assert_in_delta 4.0, rep1.ips, 0.2
 
     assert_equal "sleep 0.05", rep2.label
-    assert_equal 20, rep2.iterations
+    assert_in_delta 20.0, rep2.iterations.to_f, 1.0
     assert_in_delta 20.0, rep2.ips, 1.0
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: benchmark-ips
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - Evan Phoenix
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-06-18 00:00:00.000000000 Z
+date: 2014-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.3'
+        version: '5.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.3'
+        version: '5.4'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -44,15 +44,15 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.12'
+        version: '3.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.12'
-description: A iterations per second enhancement to Benchmark
+        version: '3.13'
+description: A iterations per second enhancement to Benchmark.
 email:
 - evan@phx.io
 executables: []
@@ -69,13 +69,12 @@ files:
 - README.md
 - Rakefile
 - lib/benchmark/compare.rb
-- lib/benchmark/helpers.rb
 - lib/benchmark/ips.rb
 - lib/benchmark/ips/job.rb
 - lib/benchmark/ips/report.rb
 - lib/benchmark/timing.rb
 - test/test_benchmark_ips.rb
-homepage: http://github.com/evanphx/benchmark-ips
+homepage: https://github.com/evanphx/benchmark-ips
 licenses:
 - MIT
 metadata: {}
@@ -100,6 +99,6 @@ rubyforge_project:
 rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
-summary: A iterations per second enhancement to Benchmark
+summary: A iterations per second enhancement to Benchmark.
 test_files:
 - test/test_benchmark_ips.rb

data/lib/benchmark/helpers.rb

@@ -1,46 +0,0 @@
-module Benchmark
-  module Helpers
-
-    def fixnum_max
-      if Object.const_defined?(:RUBY_ENGINE)
-        case RUBY_ENGINE
-        when "ruby"
-          2 ** (wordsize - 2) - 1
-        when "rbx"
-          Fixnum::MAX
-        when "jruby"
-          9223372036854775807
-        else
-          raise "Maximum Fixnum size now known yet for #{RUBY_ENGINE}"
-        end
-      else
-        2 ** (wordsize - 2) - 1
-      end
-    end
-    module_function :fixnum_max
-
-    def fixnum_min
-      if Object.const_defined?(:RUBY_ENGINE)
-        case RUBY_ENGINE
-        when "ruby"
-          - 2 ** (wordsize - 2)
-        when "rbx"
-          Fixnum::MIN
-        when "jruby"
-          -9223372036854775808
-        else
-          raise "Minimum Fixnum size now known yet for #{RUBY_ENGINE}"
-        end
-      else
-        - 2 ** (wordsize - 2)
-      end
-    end
-    module_function :fixnum_min
-
-    def wordsize
-      8 * 1.size
-    end
-    module_function :wordsize
-
-  end
-end