radius-spec 0.2.0 → 0.6.0

data/benchmarks/cover_vs_include.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+# Run from the command line: bundle exec ruby benchmarks/cover_vs_include.rb
+require_relative 'bm_setup'
+
+display_benchmark_header
+
+INT_RANGE = (0..15)
+INT_VAR = 10
+
+section "Integer ranges" do |bench|
+  bench.report('range#cover?') do
+    INT_RANGE.cover?(INT_VAR)
+  end
+
+  bench.report('range#include?') do
+    INT_RANGE.include?(INT_VAR)
+  end
+
+  bench.report('range#member?') do
+    INT_RANGE.member?(INT_VAR)
+  end
+
+  bench.report('plain compare') do
+    0 < INT_VAR && INT_VAR < 15
+  end
+end
+
+BEGIN_OF_JULY = Time.utc(2015, 7, 1)
+END_OF_JULY = Time.utc(2015, 7, 31)
+DAY_IN_JULY = Time.utc(2015, 7, 15)
+
+TIME_RANGE = (BEGIN_OF_JULY..END_OF_JULY)
+
+section "Time ranges" do |bench|
+  bench.report('range#cover?') do
+    TIME_RANGE.cover?(DAY_IN_JULY)
+  end
+
+  bench.report('range#include?') do
+    TIME_RANGE.include?(DAY_IN_JULY)
+  end
+
+  bench.report('range#member?') do
+    TIME_RANGE.member?(DAY_IN_JULY)
+  end
+
+  bench.report('plain compare') do
+    BEGIN_OF_JULY < DAY_IN_JULY && DAY_IN_JULY < END_OF_JULY
+  end
+end
+
+__END__
+
+### Environment
+
+ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-darwin16]
+GC Disabled: false
+
+### Test Cases
+
+#### Integer ranges
+
+```
+Warming up --------------------------------------
+        range#cover?   247.959k i/100ms
+      range#include?   251.846k i/100ms
+       range#member?   251.416k i/100ms
+       plain compare   305.858k i/100ms
+Calculating -------------------------------------
+        range#cover?      6.400M (± 0.8%) i/s -     31.987M in   5.008881s
+      range#include?      6.328M (± 0.8%) i/s -     31.733M in   5.025377s
+       range#member?      6.366M (± 0.6%) i/s -     31.930M in   5.022146s
+       plain compare     11.042M (± 0.8%) i/s -     55.054M in   4.999666s
+                   with 95.0% confidence
+
+Comparison:
+       plain compare: 11041684.3 i/s
+        range#cover?:  6399832.9 i/s - 1.73x  (± 0.02) slower
+       range#member?:  6366323.6 i/s - 1.73x  (± 0.02) slower
+      range#include?:  6327682.0 i/s - 1.75x  (± 0.02) slower
+                   with 95.0% confidence
+```
+
+#### Time ranges
+
+```
+Warming up --------------------------------------
+        range#cover?   249.380k i/100ms
+      range#include?   247.775k i/100ms
+       range#member?   247.446k i/100ms
+       plain compare   223.517k i/100ms
+Calculating -------------------------------------
+        range#cover?      5.942M (± 0.7%) i/s -     29.676M in   5.002164s
+      range#include?      5.724M (± 0.7%) i/s -     28.742M in   5.028509s
+       range#member?      5.771M (± 0.7%) i/s -     28.951M in   5.024809s
+       plain compare      4.751M (± 0.9%) i/s -     23.916M in   5.046978s
+                   with 95.0% confidence
+
+Comparison:
+        range#cover?:  5941582.8 i/s
+       range#member?:  5770708.7 i/s - 1.03x  (± 0.01) slower
+      range#include?:  5723795.5 i/s - 1.04x  (± 0.01) slower
+       plain compare:  4750545.5 i/s - 1.25x  (± 0.01) slower
+                   with 95.0% confidence
+```

data/benchmarks/delete_vs_tr.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+# Run from the command line: bundle exec ruby benchmarks/delete_vs_tr.rb
+require_relative 'bm_setup'
+
+display_benchmark_header
+
+[
+  ["No Removal",         "Any String Chars", "m",   ""],
+  ["Single Removal",     "Any String Chars", "i",   ""],
+  ["Multiple Removal",   "Any String Chars", "n",   ""],
+  ["Multi-Char Removal", "Any String Chars", "nar", ""],
+].each do |title, str, pattern, replacement|
+  section title do |bench|
+    bench.report("delete") do
+      str.delete(pattern)
+    end
+
+    bench.report("tr") do
+      str.tr(pattern, replacement)
+    end
+  end
+end
+
+__END__
+
+### Environment
+
+ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-darwin16]
+GC Disabled: false
+
+### Test Cases
+
+#### No Removal
+
+```
+Warming up --------------------------------------
+              delete   164.989k i/100ms
+                  tr   163.504k i/100ms
+Calculating -------------------------------------
+              delete      2.578M (± 0.9%) i/s -     13.034M in   5.065099s
+                  tr      2.566M (± 0.8%) i/s -     12.917M in   5.039546s
+                   with 95.0% confidence
+
+Comparison:
+              delete:  2578043.5 i/s
+                  tr:  2565794.9 i/s - same-ish: difference falls within error
+                   with 95.0% confidence
+```
+
+#### Single Removal
+
+```
+Warming up --------------------------------------
+              delete   169.321k i/100ms
+                  tr   173.594k i/100ms
+Calculating -------------------------------------
+              delete      2.779M (± 1.1%) i/s -     13.884M in   5.010559s
+                  tr      2.721M (± 1.0%) i/s -     13.714M in   5.050566s
+                   with 95.0% confidence
+
+Comparison:
+              delete:  2778762.2 i/s
+                  tr:  2721121.1 i/s - 1.02x  (± 0.02) slower
+                   with 95.0% confidence
+```
+
+#### Multiple Removal
+
+```
+Warming up --------------------------------------
+              delete   173.074k i/100ms
+                  tr   171.824k i/100ms
+Calculating -------------------------------------
+              delete      2.804M (± 1.0%) i/s -     14.019M in   5.009616s
+                  tr      2.739M (± 1.0%) i/s -     13.746M in   5.030533s
+                   with 95.0% confidence
+
+Comparison:
+              delete:  2804348.9 i/s
+                  tr:  2739399.1 i/s - 1.02x  (± 0.01) slower
+                   with 95.0% confidence
+```
+
+#### Multi-Char Removal
+
+```
+Warming up --------------------------------------
+              delete   165.485k i/100ms
+                  tr   158.961k i/100ms
+Calculating -------------------------------------
+              delete      2.547M (± 1.3%) i/s -     12.742M in   5.019971s
+                  tr      2.507M (± 1.0%) i/s -     12.558M in   5.018688s
+                   with 95.0% confidence
+
+Comparison:
+              delete:  2547442.6 i/s
+                  tr:  2507427.2 i/s - same-ish: difference falls within error
+                   with 95.0% confidence
+```

data/benchmarks/double_negation.rb

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+# Run from the command line: bundle exec ruby benchmarks/double_negation.rb
+require_relative 'bm_setup'
+require 'active_support'
+require 'active_support/core_ext/object/blank'
+
+display_benchmark_header
+
+# rubocop:disable Style/NonNilCheck
+# As this is basically a micro-benchmark we use the block with `while` idiom
+[nil, [], Object.new].each do |x|
+  section x.inspect do |bench|
+    bench.report("!!") do |times|
+      i = 0
+      while i < times
+        !!x
+        i += 1
+      end
+    end
+
+    bench.report("!nil?") do |times|
+      i = 0
+      while i < times
+        !x.nil?
+        i += 1
+      end
+    end
+
+    bench.report("nil !=") do |times|
+      i = 0
+      while i < times
+        nil != x
+        i += 1
+      end
+    end
+
+    bench.report("present?") do |times|
+      i = 0
+      while i < times
+        x.present?
+        i += 1
+      end
+    end
+  end
+end
+
+# When performing the initial testing we used `x == nil`. However, that was
+# shockingly slow for the empty array case. Because of that we inverted the
+# conditional in the above condition. However, as proof of this oddity and to
+# allow us to track behavior in future versions we include this additional
+# benchmark showing the issue.
+section "Empty array `nil` comparison" do |bench|
+  x = []
+
+  bench.report("!= nil") do |times|
+    i = 0
+    while i < times
+      nil != x
+      i += 1
+    end
+  end
+
+  bench.report("nil !=") do |times|
+    i = 0
+    while i < times
+      x != nil
+      i += 1
+    end
+  end
+end
+# rubocop:enable Style/NonNilCheck
+
+__END__
+
+### Environment
+
+ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-darwin16]
+GC Disabled: true
+
+### Test Cases
+
+#### nil
+
+```
+Warming up --------------------------------------
+                  !!   320.852k i/100ms
+               !nil?   313.833k i/100ms
+              nil !=   330.298k i/100ms
+            present?   294.813k i/100ms
+Calculating -------------------------------------
+                  !!     41.841M (± 0.6%) i/s -    207.591M in   5.000435s
+               !nil?     30.851M (± 0.7%) i/s -    153.464M in   5.005301s
+              nil !=     38.424M (± 0.5%) i/s -    191.573M in   5.007580s
+            present?     19.660M (± 0.7%) i/s -     97.878M in   4.999761s
+                   with 95.0% confidence
+
+Comparison:
+                  !!: 41841263.8 i/s
+              nil !=: 38424408.4 i/s - 1.09x  (± 0.01) slower
+               !nil?: 30850983.5 i/s - 1.36x  (± 0.01) slower
+            present?: 19660459.4 i/s - 2.13x  (± 0.02) slower
+                   with 95.0% confidence
+```
+
+#### []
+
+```
+Warming up --------------------------------------
+                  !!   317.562k i/100ms
+               !nil?   311.181k i/100ms
+              nil !=   319.266k i/100ms
+            present?   293.159k i/100ms
+Calculating -------------------------------------
+                  !!     42.487M (± 0.6%) i/s -    211.179M in   5.005333s
+               !nil?     31.078M (± 0.5%) i/s -    154.968M in   5.005557s
+              nil !=     38.313M (± 0.6%) i/s -    190.283M in   5.000799s
+            present?     21.854M (± 0.7%) i/s -    108.762M in   5.002198s
+                   with 95.0% confidence
+
+Comparison:
+                  !!: 42487427.1 i/s
+              nil !=: 38312618.0 i/s - 1.11x  (± 0.01) slower
+               !nil?: 31078123.9 i/s - 1.37x  (± 0.01) slower
+            present?: 21854143.8 i/s - 1.94x  (± 0.02) slower
+                   with 95.0% confidence
+```
+
+#### #<Object:0x00007f9c0a968310>
+
+```
+Warming up --------------------------------------
+                  !!   328.432k i/100ms
+               !nil?   307.084k i/100ms
+              nil !=   324.749k i/100ms
+            present?   261.758k i/100ms
+Calculating -------------------------------------
+                  !!     40.897M (± 0.5%) i/s -    203.628M in   5.005426s
+               !nil?     30.242M (± 0.6%) i/s -    150.471M in   5.000563s
+              nil !=     39.610M (± 0.6%) i/s -    197.123M in   5.005610s
+            present?     12.163M (± 0.8%) i/s -     60.728M in   5.011771s
+                   with 95.0% confidence
+
+Comparison:
+                  !!: 40897495.2 i/s
+              nil !=: 39610078.3 i/s - 1.03x  (± 0.01) slower
+               !nil?: 30242403.1 i/s - 1.35x  (± 0.01) slower
+            present?: 12162705.7 i/s - 3.36x  (± 0.03) slower
+                   with 95.0% confidence
+```
+
+#### Empty array `nil` comparison
+
+```
+Warming up --------------------------------------
+              != nil   326.024k i/100ms
+              nil !=   270.805k i/100ms
+Calculating -------------------------------------
+              != nil     40.133M (± 0.5%) i/s -    199.853M in   5.004102s
+              nil !=     11.551M (± 0.9%) i/s -     57.681M in   5.020992s
+                   with 95.0% confidence
+
+Comparison:
+              != nil: 40133046.7 i/s
+              nil !=: 11551012.8 i/s - 3.47x  (± 0.04) slower
+                   with 95.0% confidence
+```

data/benchmarks/empty_literal.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Run from the command line: bundle exec ruby benchmarks/empty_literal.rb
+require_relative 'bm_setup'
+
+display_benchmark_header
+
+# rubocop:disable Style/EmptyLiteral
+section "[] vs Array.new" do |bench|
+  bench.report("Array.new") do
+    Array.new
+    nil
+  end
+
+  bench.report("[]") do
+    []
+    nil
+  end
+end
+
+section "{} vs Hash.new" do |bench|
+  bench.report("Hash.new") do
+    Hash.new
+    nil
+  end
+
+  bench.report("{}") do
+    {}
+    nil
+  end
+end
+# rubocop:enable Style/EmptyLiteral
+
+__END__
+
+### Environment
+
+ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-darwin16]
+GC Disabled: false
+
+### Test Cases
+
+#### [] vs Array.new
+
+```
+Warming up --------------------------------------
+           Array.new   238.371k i/100ms
+                  []   336.249k i/100ms
+Calculating -------------------------------------
+           Array.new      6.298M (± 1.0%) i/s -     31.465M in   5.014660s
+                  []     14.157M (± 0.8%) i/s -     70.612M in   5.004166s
+                   with 95.0% confidence
+
+Comparison:
+                  []: 14157286.9 i/s
+           Array.new:  6297668.8 i/s - 2.25x  (± 0.03) slower
+                   with 95.0% confidence
+```
+
+#### {} vs Hash.new
+
+```
+Warming up --------------------------------------
+            Hash.new   140.548k i/100ms
+                  {}   348.340k i/100ms
+Calculating -------------------------------------
+            Hash.new      2.203M (± 1.1%) i/s -     11.103M in   5.056212s
+                  {}     14.285M (± 0.6%) i/s -     71.410M in   5.010915s
+                   with 95.0% confidence
+
+Comparison:
+                  {}: 14285184.2 i/s
+            Hash.new:  2202622.4 i/s - 6.49x  (± 0.08) slower
+                   with 95.0% confidence
+```