casting 0.6.8 → 0.6.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 02fe7c29c8da27adba6036307ab658548bf6a20a
-  data.tar.gz: 1b674c20260d1e89830e088f0db5fe2dbee43639
+  metadata.gz: 817477d1f96444e97690553a806289ef4abfce2f
+  data.tar.gz: f50a67f05c760518b3e2b1b93e817db06c8a2adf
 SHA512:
-  metadata.gz: c86a535a9ae96e3e6b1034488cda5b487c76e51a028b7fce0f907ce96b580adb46d748f0b1a8231fc287b9a164f3d71171184d80776c7bba571dca60e0b59c36
-  data.tar.gz: 031bfc7f0989891cb12c48097e5990bbae8d95cb2e348e8b652fa4b84f652bca2b0cfab07ea34ec49c5506cc0ac45d96e6891ace776b52cf4f35feac1593797c
+  metadata.gz: 19dd0a57a2a785282fd3eb7bdce9ab973c332b13530000f8419a3fbc6ee69476fddd585073bf72d9b16318c960cdfe9c7c04b496071323a734bd2874e4977a9e
+  data.tar.gz: 88f35215738b381bdac0893fd3e4946c435e8aed8b62876e454f2674b316f53c31b07a93a956d412cc36d93190b2d5fd7ae648885d7f20e9ab29d013f91a52b3

data/README.md

@@ -91,7 +91,7 @@ _That's great, but why do I need to do these extra steps? I just want to run the
 
 Casting gives you the option to do what you want. You can run just a single method once, or alter your object to always delegate. Even better, you can alter your object to delegate temporarily...
 
-## Temporary Behavior
+### Temporary Behavior
 
 Casting also provides an option to temporarily apply behaviors to an object.
 
@@ -147,6 +147,42 @@ actor.hello_world # => NoMethodError
 
 These methods are only defined on your `Casting::Client` object when you tell it to `delegate_missing_methods`. Because these require `method_missing`, they do not exist until you opt-in.
 
+### Duck-typing with NullObject-like behavior
+
+Casting has a few modules built in to help with treating your objects like null objects.
+Take a look at the following example:
+
+```ruby
+module SpecialStuff
+  def special_link
+    # some link code
+  end
+end
+
+special_user.cast_as(SpecialStuff)
+special_user.special_link # outputs your link
+```
+
+If your app, for example, generates a list of info for a collection of users, how do you manage the objects which don't have the expected behavior?
+
+```ruby
+[normal_user, other_user, special_user].each do |user|
+  user.special_link #=> blows up for normal_user or other_user
+end
+```
+
+You can cast the other objects with `Casting::Null` or `Casting::Blank`:
+
+```ruby
+normal_user.cast_as(Casting::Null)
+other_user.cast_as(Casting::Blank)
+special_user.cast_as(SpecialStuff)
+
+[normal_user, other_user, special_user].each do |user|
+  user.special_link #=> normal_user yields nil, other_user yields "", and special_user yields the special_link
+end
+```
+
 ## I have a Rails app, how does this help me?
 
 Well, a common use for this behavior would be in using decorators.
@@ -191,6 +227,8 @@ end
 
 This keeps your code focused on the object you care about.
 
+Check out [Characterize](http://github.com/saturnflyer/characterize) for hooking into Rails automatically.
+
 ## Oh, my! Could this be used to add behavior like refinements?
 
 You can apply methods from a delegate to all instances of a class.
@@ -312,6 +350,12 @@ If you are using Bundler, add this line to your application's Gemfile:
 gem 'casting'
 ```
 
+If you're using Ruby 1.9, be sure to use a version lower than 0.7
+
+```ruby
+gem 'casting', '~> 0.6.9'
+```
+
 And then execute:
 
     $ bundle

data/lib/casting.rb

@@ -1,5 +1,6 @@
 require 'casting/client'
 require 'casting/super_delegate'
+require 'casting/null'
 
 module Casting
 

data/lib/casting/null.rb

@@ -0,0 +1,18 @@
+module Casting
+  module Null
+    def self.instance_method(name)
+      Empty.instance_method(:null)
+    end
+  end
+  module Blank
+    def self.instance_method(name)
+      Empty.instance_method(:blank)
+    end
+  end
+  module Empty
+    def null(*args, &block); end
+    def blank(*args, &block)
+      ""
+    end
+  end 
+end

data/lib/casting/version.rb

@@ -1,3 +1,3 @@
 module Casting
-  VERSION = '0.6.8'
+  VERSION = '0.6.9'
 end

data/test/null_module_test.rb

@@ -0,0 +1,23 @@
+require 'test_helper'
+
+if test_rebinding_methods?
+  describe Casting::Null do
+    it 'will answer to any method with nil' do
+      client = TestPerson.new
+      client.extend(Casting::Client)
+      attendant = Casting::Null
+
+      assert_nil client.delegate('greet', attendant)
+    end
+  end
+
+  describe Casting::Blank do
+    it 'will answer to any method with an empty string' do
+      client = TestPerson.new
+      client.extend(Casting::Client)
+      attendant = Casting::Blank
+
+      assert_empty client.delegate('greet', attendant)
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: casting
 version: !ruby/object:Gem::Version
-  version: 0.6.8
+  version: 0.6.9
 platform: ruby
 authors:
 - Jim Gay
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-06-18 00:00:00.000000000 Z
+date: 2014-06-26 00:00:00.000000000 Z
 dependencies: []
 description: |-
   Casting assists in method delegation which preserves the binding of 'self' to the object receiving a message.
@@ -26,6 +26,7 @@ files:
 - lib/casting/method_consolidator.rb
 - lib/casting/missing_method_client.rb
 - lib/casting/missing_method_client_class.rb
+- lib/casting/null.rb
 - lib/casting/prepared_delegation.rb
 - lib/casting/super_delegate.rb
 - lib/casting/version.rb
@@ -41,6 +42,7 @@ files:
 - test/delegation_test.rb
 - test/method_consolidator_test.rb
 - test/missing_method_client_test.rb
+- test/null_module_test.rb
 - test/module_cleanup_test.rb
 - test/super_test.rb
 homepage: http://github.com/saturnflyer/casting
@@ -77,5 +79,6 @@ test_files:
 - test/delegation_test.rb
 - test/method_consolidator_test.rb
 - test/missing_method_client_test.rb
+- test/null_module_test.rb
 - test/module_cleanup_test.rb
 - test/super_test.rb