first_of 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bfa6409aeab593f113e0a33c7101b4436e48a376
-  data.tar.gz: 7819687d70b99d685eb4b558a2650849250f6df5
+  metadata.gz: 0a26712d5e174fa9c5c61029edd9abc2e65059b5
+  data.tar.gz: 4e3159d3fc6d1a3ff7c71cb769e49f34719158db
 SHA512:
-  metadata.gz: 520d9061901771af7850f611e2696376a090447d6a236f6dc6d28819a176d00924ccb7c0b4b520990e1e37e9bed6a1fc3d8cb982b352874d8fb79787990202ac
-  data.tar.gz: 0b218207ef65993a280fa96b1ffc79728350a954ab43075214165c6fd9747c47cfcd4d9896f80457ecf5c8e400065593ec1ed62301914cfe2d3a472125a87661
+  metadata.gz: d742cc1e16c2811b4f091d1e45b0a34472ad28cb8e41c24dcd3c62228786f02c689f37d67316e0a69cd339e6c8d77e626fb67eef28a6c25acb1abb56a8707c0e
+  data.tar.gz: 00e45ca8b4d912bde4a646521cf6a3422c1f5a2760952bda06daeb80aa62b82649709a57e55807c543aabe0905845a2aaa5c9062ea1d9451876bacea06ca0a9f

data/README.md

@@ -1,6 +1,11 @@
 # FirstOf
 
-TODO: Write a gem description
+FirstOf can be used when multiple values can be reduced into a single return value.
+This is common in things like XML/JSON where the "intended" value is available in
+2 fields and is determined by the presence of a value in the document and is often
+prioritized (first check field 1, then field 2, then field x)
+
+FirstOf handles calling methods/lambdas and prioritizing them.
 
 ## Installation
 
@@ -18,7 +23,37 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+```ruby
+  require 'first_of'
+
+  class Widget
+    include ::FirstOf
+
+    def nothing; nil; end
+    def selfie; self; end
+    def something; "something"; end
+  end
+
+  widget = Widget.new
+
+  # Use it to get to something usable on self
+  widget.first_of(:nothing, :something, :self) # => "something"
+  widget.first_of(:nothing, :self, :something) # => self
+  widget.first_of(:nothing, :nothing, :something) # => "something"
+
+  # Wrap calls in an Array to `try_chain` them
+  widget.first_of([:self, :nothing], :something) # => "something"
+
+  # Wrap a call in a lambda (or any callable) to delay execution
+  widget.first_of(:something, lambda { "derp" }) # => "something"
+  widget.first_of(lambda { "derp" }, :something) # => "derp"
+  widget.first_of(lambda { nothing }, :something) # => "something"
+
+  # Prioritize the calls/call chains if desired
+  widget.first_of(2 => :something, 1 => lambda { "derp" }) # => "derp"
+  widget.first_of(2 => lambda { "derp" }, 1 => :something) # => "something"
+  widget.first_of(2 => lambda { nothing }, 1 => :something) # => "something"
+```
 
 ## Contributing
 

data/lib/first_of.rb

@@ -16,28 +16,29 @@ module FirstOf
   # first_of(1 => :symbol1, 2 => 4) # will prioritize and return value (4) if first not present
   # first_of(lambda { _call }, 1 => :symbol1, 2 => :symbol2)
   def first_of(*args)
-    extract_hash = args.extract_options!        
+    return _first_of(*args, :try_chain, :proxy_try_chain)
+  end
 
-    # Don't care if the hash is empty or not because of #each call
-    sorted_keys = extract_hash.keys.sort
-    sorted_keys.each do |key|
-      args << extract_hash[key]
-    end
+  def first_of!(*args)
+    return _first_of(*args, :try_chain!, :proxy_try_chain!)
+  end
 
-    args.each do |argument|
-      if argument.respond_to?(:call)
-        value = argument.call
+  private
+
+  def _extract_from_message_chain(methods_or_value, try_method = :try_chain, proxy_try_method = :proxy_try_chain)
+    case methods_or_value
+    when Symbol, Array then
+      if self.respond_to?(:try_chain)
+        self.__send__(try_method, *methods_or_value)
       else
-        value = _extract_from_message_chain(argument) # calls try_chain if array, or try if symbol, or returns value
+        ::TryChain.__send__(proxy_try_method, self, *methods_or_value)
       end
-
-      return value if _valid_value?(value) # return value if found
+    else
+      methods_or_value
     end
-
-    return nil
   end
 
-  def first_of!(*args)
+  def _first_of(*args, try_method, proxy_try_method)
     extract_hash = args.extract_options!        
 
     # Don't care if the hash is empty or not because of #each call
@@ -50,7 +51,7 @@ module FirstOf
       if argument.respond_to?(:call)
         value = argument.call
       else
-        value = _extract_from_message_chain(argument, :try_chain!, :proxy_try_chain!) # calls try_chain if array, or try if symbol, or returns value
+        value = _extract_from_message_chain(argument, try_method, proxy_try_method)
       end
 
       return value if _valid_value?(value) # return value if found
@@ -59,21 +60,6 @@ module FirstOf
     return nil
   end
 
-  private
-
-  def _extract_from_message_chain(methods_or_value, try_method = :try_chain, proxy_try_method = :proxy_try_chain)
-    case methods_or_value
-    when Symbol, Array then
-      if self.respond_to?(:try_chain)
-        self.__send__(try_method, *methods_or_value)
-      else
-        ::TryChain.__send__(proxy_try_method, self, *methods_or_value)
-      end
-    else
-      methods_or_value
-    end
-  end
-
   def _valid_value?(value)
     value.present? || [true, false].include?(value)
   end

data/lib/first_of/version.rb

@@ -1,3 +1,3 @@
 module FirstOf
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: first_of
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Brandon Dewitt
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-19 00:00:00.000000000 Z
+date: 2013-11-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport