safe_clone 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c270e1501f513581f54e24e995dac45a3674108b
-  data.tar.gz: a0e903a567fb2cea836e8a9813dfed29a6004b34
+  metadata.gz: 6c47b359f673a690029ee7dc0388eb6bf1875d09
+  data.tar.gz: 34af503afe09f42a3278709c1a5c4f5f801dc06f
 SHA512:
-  metadata.gz: 57187deeb43c0dcc62f6cc503a596445e834aae18d3d378ac15a927e1f88a2cb58282d91a472597327c78eb81b744b3d4b29b728a354ac849d01d794c2e527e6
-  data.tar.gz: 61af8a6ea50fb4bbe924ca3e0e45a54a6802c2eae32b36cc666db9389d450777769414ef0f7b3728e9f67ac36aad305c89d5a636ab2c573f5c962fe806ea2b5b
+  metadata.gz: df8e974b0fa65e8da617f672616d816958c1253922e9c2e1a340b3de232de42156962cb4b249885dcd0b7b421106b51fef2fd3b6e37cf2cd31cbc576412cee2d
+  data.tar.gz: c46c03f29d95f418a2e19bbd609600e7c691e3a3b5cc587a02c2c6d326a8d11d2d0f94f8f63c12c0099b608a0339687d88b8d60277396231c1cab5bb8ed7bc0f

data/README.md

@@ -36,71 +36,107 @@ instead of
       foo = my_object
     end
 
-Further, when benchmarked under
+## Performance
+A reasonable question to raise is "How does safe clone compare with just
+catching the exception and handling it?" The benchmark sets a a realistic
+scenario where an array (whose contents may be varied) is having its
+_contents_ cloned. The benchmarking code follows:
+
+```ruby
+require "benchmark/ips"
+require 'safe_clone'
+
+class Array
+  def use_clone
+    self.map do |element|
+      begin
+        element.clone
+      rescue TypeError
+        element
+      end
+    end
+  end
+
+  def use_safe_clone
+    self.map {|element| element.safe_clone }
+  end
+end
+
+X = ["Test", :test, 43, true, nil, false]
+
+Benchmark.ips do |x|
+  x.report("Clone with standard clone method") { X.use_clone }
+  x.report("Clone with the safe clone method") { X.use_safe_clone }
+  x.compare!
+end
+```
+
+Ruby Version:
 
     ruby 1.9.3p484 (2013-11-22) [i386-mingw32]
 
-the following results are observed:
+Results:
 
     C:\Sites\safe_clone>ruby bench\bench.rb
     Warming up --------------------------------------
     Clone with standard clone method
-                             6.424k i/100ms
+                             1.247k i/100ms
     Clone with the safe clone method
-                            97.476k i/100ms
+                            35.027k i/100ms
     Calculating -------------------------------------
     Clone with standard clone method
-                             72.460k (± 8.5%) i/s -    366.168k
+                             12.957k (± 5.8%) i/s -     64.844k
     Clone with the safe clone method
-                              4.690M (±33.3%) i/s -     20.957M
+                            534.740k (± 8.9%) i/s -      2.662M
 
     Comparison:
-    Clone with the safe clone method:  4690305.8 i/s
-    Clone with standard clone method:    72460.2 i/s - 64.73x slower
+    Clone with the safe clone method:   534740.1 i/s
+    Clone with standard clone method:    12956.6 i/s - 41.27x slower
 
-With:
+Ruby Version:
 
     ruby 2.1.6p336 (2015-04-13 revision 50298) [i386-mingw32]
 
-the following results are observed:
+Results:
 
     C:\Sites\safe_clone>ruby bench\bench.rb
     Warming up --------------------------------------
     Clone with standard clone method
-                            20.607k i/100ms
+                             4.945k i/100ms
     Clone with the safe clone method
-                           107.236k i/100ms
+                            38.109k i/100ms
     Calculating -------------------------------------
     Clone with standard clone method
-                            298.041k (±11.1%) i/s -      1.484M
+                             54.491k (± 7.3%) i/s -    271.975k
     Clone with the safe clone method
-                              4.934M (±34.5%) i/s -     22.091M
+                            569.236k (±10.2%) i/s -      2.820M
 
     Comparison:
-    Clone with the safe clone method:  4933871.9 i/s
-    Clone with standard clone method:   298041.4 i/s - 16.55x slower
+    Clone with the safe clone method:   569236.4 i/s
+    Clone with standard clone method:    54491.3 i/s - 10.45x slower
 
-And with:
+Ruby Version:
 
     ruby 2.2.3p173 (2015-08-18 revision 51636) [i386-cygwin]
 
-we get:
+Results:
 
+    Peter Camilleri@NCC1701G /cygdrive/c/sites/safe_clone
     $ ruby bench/bench.rb
     Warming up --------------------------------------
     Clone with standard clone method
-                            15.876k i/100ms
+                             3.698k i/100ms
     Clone with the safe clone method
-                            70.638k i/100ms
+                            28.999k i/100ms
     Calculating -------------------------------------
     Clone with standard clone method
-                            219.593k (±10.7%) i/s -      1.095M
+                             40.076k (± 5.1%) i/s -    203.390k
     Clone with the safe clone method
-                              4.525M (± 0.9%) i/s -     22.675M
+                            481.524k (±10.0%) i/s -      2.407M
 
     Comparison:
-    Clone with the safe clone method:  4524862.8 i/s
-    Clone with standard clone method:   219593.0 i/s - 20.61x slower
+    Clone with the safe clone method:   481524.1 i/s
+    Clone with standard clone method:    40075.6 i/s - 12.02x slower
 
 
 Overall: Shorter code  _and_ faster. Winner, winner, chicken dinner!

data/bench/bench.rb

@@ -1,22 +1,26 @@
 require "benchmark/ips"
 require 'safe_clone'
 
-def use_clone
-  x = 42
-  y = begin
-        x.clone
-      rescue
-        x
+class Array
+  def use_clone
+    self.map do |element|
+      begin
+        element.clone
+      rescue TypeError
+        element
       end
-end
+    end
+  end
 
-def use_safe_clone
-  x = 42
-  y = x.safe_clone
+  def use_safe_clone
+    self.map {|element| element.safe_clone }
+  end
 end
 
+X = ["Test", :test, 43, true, nil, false]
+
 Benchmark.ips do |x|
-  x.report("Clone with standard clone method") { use_clone }
-  x.report("Clone with the safe clone method") { use_safe_clone }
+  x.report("Clone with standard clone method") { X.use_clone }
+  x.report("Clone with the safe clone method") { X.use_safe_clone }
   x.compare!
 end

data/lib/safe_clone/version.rb

@@ -1,3 +1,3 @@
 module SafeClone
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

data/safe_clone.gemspec

@@ -17,7 +17,7 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency 'minitest_visible', ">= 0.0.2"
+  spec.add_development_dependency 'minitest_visible', ">= 0.1.0"
 
   spec.add_development_dependency "bundler", "~> 1.3"
   spec.add_development_dependency "rake"

data/test/safe_clone_tests.rb

@@ -9,7 +9,7 @@ require          'minitest_visible'
 class SafeCloneTester < Minitest::Test
 
   #Track mini-test progress.
-  MinitestVisible.track self, __FILE__
+  include MinitestVisible
 
   def test_for_safe_value_cloning
     assert_equal((6).safe_clone, 6)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: safe_clone
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors:
 - Peter Camilleri
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-02-16 00:00:00.000000000 Z
+date: 2016-02-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest_visible
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.0.2
+        version: 0.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.0.2
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement