duck_puncher 2.5.1 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d79a3c56a872b1cf8fae50ea0828bd3deefb8804
-  data.tar.gz: 255d03afeb29676c3c1ed4bef631c5048848f143
+  metadata.gz: f9f681e5807943d40660685fd071fd2efd65d595
+  data.tar.gz: 24c64853a09c5f52516e8d2c5462919be3178e1a
 SHA512:
-  metadata.gz: 9c68f506755fc0ecf2c622d3c3b78b62396abdab23bef915f5496206f7ef1cdc89ed939c9b53169c9bf6ee37e8978a229fd3eb3abf47fe34c794473ccdb5c0c6
-  data.tar.gz: 9315f784c53760449790f9de0df096c77b11e5fc0ef24b751c8c7bdb36dd1539d23adb40a86fa70c1d9f315d66179af0387f52f553dab07b3e421d17501dab83
+  metadata.gz: c9e6c53ce21e6a8564e2b0e09b8b39a8fef2e1f5dcddf2225e9aeb807441fb9c85d22fc48dd012abbb493dd4736ce7cd8b7f3d52b7158d8368fa3ed54d8bd884
+  data.tar.gz: 34bb650e74c17f00b5bd4894653c42f29fe9c8a943e5035173dd345e160ba90fae5e0d5d07d118fbd2bf0314bbc85b52de7a733a02b9b9f21bf8683fe525a768

data/.ruby-version

@@ -1 +1 @@
-ruby-2.2.2
+ruby-2.3.0

data/.travis.yml

@@ -4,4 +4,5 @@ rvm:
   - 2.2.1
   - 2.2.2
   - 2.2.3
+  - 2.3.0
 before_install: gem install bundler -v 1.10.5

data/README.md

@@ -8,7 +8,7 @@ These are the ducks I love the most:
     Array#m             => `[].m(:to_s)` => `[].map(&:to_s)` 
     Array#mm            => `[].mm(:sub, /[aeiou]/, '*')` => `[].map { |x| x.sub(/[aeiou]/, '*') }` 
     Array#get           => `[].methods.get('ty?')` => [:empty?] 
-    Hash#seek           => `{a: 1, b: {c: 2}}.seek(:b, :c)` => 2
+    Hash#dig            => `{a: 1, b: {c: 2}}.dig(:b, :c)` => 2 (Now build into Ruby 2.3)
     Numeric#to_currency => `25.245.to_currency` => 25.25 
     Numeric#to_duration => `10_000.to_duration` => '2 h 46 min'
     Numeric#to_time_ago => `10_000.to_time_ago` => '2 hours ago'
@@ -40,7 +40,7 @@ Fetching: pry-0.10.3.gem (100%)
 [1] pry(main)>
 ```
 
-Try it out if your feeling frisky! However, I noticed it doesn't work well with bigger gems and those with native extensions.
+Pretty cool, right? Although, it doesn't work well with bigger gems or those with native extensions.
 
 ## Install
 
@@ -48,28 +48,39 @@ Try it out if your feeling frisky! However, I noticed it doesn't work well with
 
 ## Usage
 
-Ducks need to be _loaded_ before they can be punched! Maybe do this in an initializer?
+Ducks need to be _loaded_ before they can be punched! Maybe put this in an initializer:
 
 ```ruby
+# config/initializers/duck_puncher.rb
 DuckPuncher.punch_all!                  #=> punches all the ducks forever
 DuckPuncher.punch! :Hash, :Object       #=> only punches the Hash and Object ducks
+```
+
+Create a new class of your favorite duck pre-punched:
+
+```ruby
 DuckPuncher.punch :String               #=> returns an anonymous punched duck that inherits from String
 DuckString = DuckPuncher.punch :String  #=> give the anonymous duck a name, so that you can use it!
 DuckString.new.respond_to? :underscore  #=> true
 ```
 
-DuckPuncher defines a global `punch` method. This method creates and caches a delegation class pre-punched with only the
-ducks you want!
+That works, but it's pretty verbose and not real pactical to be managing potentially a bunch of custom classes. That's
++why DuckPuncher defines a global `punch` method. This makes it easy to decorate your ducks on demand:
+
+```ruby
+punch(:String, "yes").to_boolean
+```
+
+The new method isn't persisted on the String class. Instead it creates (and caches) a String delegation 
+class. This class is pre-punched with the available string extensions! :punch:
 
-Here's an example of how to use it:
+Using a combination of `Array#mm` and `Hash#dig`:
 
 ```ruby
->> a = punch :Array, [punch(:String, 'foo'), punch(:String, 'bar')]
-=> ["foo", "bar"]
->> a.m :upcase
-=> ["FOO", "BAR"]
->> a.mm :pluralize, 2
-=> ["foos", "bars"]
+params = { users: [{ id: 1, profile: { name: 'ryan' }}, { id: 2, profile: { name: 'kawika' }}, { id: 3 }] }
+list = punch :Array, params[:users].map { |u| punch(:Hash, u) }
+list.mm :dig, :profile, :name
+#=> ["ryan", "kawika", nil]
 ```
 
 ## Contributing

data/duck_puncher.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_development_dependency "bundler", "~> 1.3"
-  spec.add_development_dependency "rake", '~> 10.1', '>= 10.1.1'
+  spec.add_development_dependency "rake", '~> 10.1'
   spec.add_development_dependency "minitest", '~> 5.0'
-  spec.add_development_dependency "minitest-reporters", '~> 1.1', '>= 1.1.0'
+  spec.add_development_dependency "minitest-reporters", '~> 1.1'
 end

data/lib/duck_puncher/ducks/hash.rb

@@ -2,7 +2,7 @@ module DuckPuncher
   module Ducks
     module Hash
       # http://coryodaniel.com/index.php/2009/12/30/ruby-getting-deeply-nested-values-from-a-hash-in-one-line-of-code/
-      def seek(*_keys_)
+      def dig(*_keys_)
         last_level = self
         sought_value = nil
 
@@ -19,7 +19,7 @@ module DuckPuncher
         end
 
         sought_value
-      end
+      end unless method_defined?(:dig)
     end
   end
 end

data/lib/duck_puncher/version.rb

@@ -1,3 +1,3 @@
 module DuckPuncher
-  VERSION = '2.5.1'.freeze
+  VERSION = '2.6.0'.freeze
 end

data/test/duck_puncher/hash_test.rb

@@ -2,11 +2,11 @@ require_relative '../test_helper'
 DuckPuncher.punch! :Hash
 
 class HashTest < MiniTest::Test
-  def test_seek
+  def test_dig
     my_hash = { a: 1, b: { c: 2 } }
-    assert_equal my_hash.seek(:a), 1
-    assert_equal my_hash.seek(:b, :a), nil
-    assert_equal my_hash.seek(:b, :c), 2
-    assert_equal my_hash.seek(:b), { c: 2 }
+    assert_equal my_hash.dig(:a), 1
+    assert_equal my_hash.dig(:b, :a), nil
+    assert_equal my_hash.dig(:b, :c), 2
+    assert_equal my_hash.dig(:b), { c: 2 }
   end
 end

data/test/duck_puncher/method_test.rb

@@ -11,14 +11,14 @@ class MethodTest < MiniTest::Test
   end
 
   def test_to_instruct
-    assert_match /RubyVM::InstructionSequence:to_a/, @subject.method(:to_a).to_instruct
+    assert_match /:to_a/, @subject.method(:to_a).to_instruct
     assert_match /newarray/, @subject.method(:to_a).to_instruct
     assert_match /opt_plus/, @subject.method(:to_a).to_instruct
     assert_equal nil, [].method(:to_s).to_instruct
   end
 
   def test_to_instruct_single_line
-    assert_match /RubyVM::InstructionSequence:to_f/, @subject.method(:to_f).to_instruct
+    assert_match /:to_f/, @subject.method(:to_f).to_instruct
     assert_match /getconstant\s*:INFINITY/, @subject.method(:to_f).to_instruct
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: duck_puncher
 version: !ruby/object:Gem::Version
-  version: 2.5.1
+  version: 2.6.0
 platform: ruby
 authors:
 - Ryan Buckley
@@ -31,9 +31,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '10.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 10.1.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -41,9 +38,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '10.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 10.1.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -65,9 +59,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -75,9 +66,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.1.0
 description: Duck punches Ruby with some of my favorite class extensions
 email:
 - arebuckley@gmail.com
@@ -138,7 +126,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.8
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: Duck punches Ruby