creative_rails_utilities 0.4.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: df58ca7b40c5342a60e7870b8dc7eb7981a5658e
-  data.tar.gz: ac593955b0f0414407b126202593840fd96b12a1
+  metadata.gz: 620bfb4a460b454df919b37aab5763681d8d40aa
+  data.tar.gz: 219d14e7b22adec3b646e0228b1ae9526d27308f
 SHA512:
-  metadata.gz: 96eb6862958090754f5c7d6dc40a0a32ff52db575dbfc594ee2006d0c4939c512a9ce114c80784907a8ff2fe54d79661fbd822b67a6803e71327c3224dcd848d
-  data.tar.gz: 472ec2660a18dda63c7eb0fee2694fa287cc5cd1067cf525add8d2d5ebf23dd1d60826bc29a195b34583fe6c7141f2d12d0616ced5c495746c5d65361976ece8
+  metadata.gz: f769642de2b237235ccdb934993bbdca02b0932008fc8dc1b2c1a56a5d355d935e11c8c7c8eecbd985b4d3715723427fb7dd058372a1311d349753be18d39a68
+  data.tar.gz: 734ce1eaed645703c867ac60d4defcec7b43996197dceb3f8da9ae4d9ef80966376513d4a3ac8eae18a90441a928a978c22d2da0f4f30290e54e79d339f9a7fa

data/.gitignore

@@ -7,3 +7,4 @@
 /pkg/
 /spec/reports/
 /tmp/
+spec/failures.txt

data/CHANGELOG.md

@@ -8,6 +8,11 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 -
 ```
 
+## [0.4.2] - 2016-06-17
+### Added
+- Object.chain_if
+- Object#chain_if
+
 ## [0.4.1] - 2016-05-02
 ### Added
 - Numeric#safe_per

data/README.md

@@ -69,6 +69,7 @@ some_hash.fast_sort_keys #=> some_sorted_hash
 # integer into letters
 1.to_s26 #=> "a"
 28.to_s26 #=> "ab"
+# NB, not to be confused with 28.to_s(26) which operates as base (n) interpretation and starts with numbers.
 ```
 
 ```ruby
@@ -105,6 +106,25 @@ some_hash.fast_sort_keys #=> some_sorted_hash
 (Time.zone.now.to_i - 3.minutes.ago.to_i).to_time_hash #=> {days: 0, hours: 0, minutes: 3, seconds: 0}
 ```
 
+##### Object
+
+__Object.chain_if(switch, operator, *args)__
+__Object#chain_if(switch, operator, *args)__
+```rb
+# Allows smart conditional chaining of method calls or Procs
+# Works on any type of object, class or instance
+
+String.chain_if(true, :new, "abc") #=> "abc"
+String.chain_if(false, :new, "abc") #=> String
+String.chain_if(true, Proc.new{|a| a.new("abc") }) #=> "abc"
+String.chain_if(false, Proc.new{|a| a.new("abc") }) #=> String
+
+1.chain_if(false, Proc.new{raise}, 0).chain_if("yes", :*, 2).chain_if(!nil, Proc.new{|a| a.to_s}) #=> "2"
+# Here `chain_if(false, Proc.new{raise}, 0)` would raise, but it is set to false, so it is skipped.
+# `chain_if("yes", :*, 2)` multiplies by 2, and is ON (since "yes" is truthy)
+# Finally, `chain_if(!nil, Proc.new{|a| a.to_s})` turns result to a string and also is ON.
+```
+
 ##### String
 
 ```ruby

data/lib/creative_rails_utilities/object.rb

@@ -0,0 +1,36 @@
+class Object
+
+  def self.chain_if(switch, operator, *args)
+    raise_chain_if_argument_error unless operator.class == Proc || operator.respond_to?(:to_sym)
+
+    return self unless switch
+
+    if operator.class == Proc
+      operator.call(self)
+    elsif operator.respond_to?(:to_sym)
+      return self.public_send(operator.to_sym, *args)
+    else
+      raise_chain_if_argument_error
+    end
+  end
+
+  def chain_if(switch, operator, *args)
+    raise_chain_if_argument_error unless operator.class == Proc || operator.respond_to?(:to_sym)
+
+    return self unless switch
+
+    if operator.class == Proc
+      operator.call(self)
+    elsif operator.respond_to?(:to_sym)
+      return self.public_send(operator.to_sym, *args)
+    else
+      raise_chain_if_argument_error
+    end
+  end
+
+  private
+    def raise_chain_if_argument_error
+      raise ArgumentError.new(":operator argument is bad, use a Proc ar a Symbol.")
+    end
+
+end

data/lib/creative_rails_utilities/version.rb

@@ -1,3 +1,3 @@
 module CreativeRailsUtilities
-  VERSION = "0.4.1"
+  VERSION = "0.4.2"
 end

data/lib/creative_rails_utilities.rb

@@ -8,6 +8,7 @@ require "creative_rails_utilities/error_helper"
 require "creative_rails_utilities/hash"
 require "creative_rails_utilities/date"
 require "creative_rails_utilities/numeric"
+require "creative_rails_utilities/object"
 require "creative_rails_utilities/string"
 require "creative_rails_utilities/version"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: creative_rails_utilities
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.2
 platform: ruby
 authors:
 - Creative
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-05-02 00:00:00.000000000 Z
+date: 2016-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -175,6 +175,7 @@ files:
 - lib/creative_rails_utilities/error_helper.rb
 - lib/creative_rails_utilities/hash.rb
 - lib/creative_rails_utilities/numeric.rb
+- lib/creative_rails_utilities/object.rb
 - lib/creative_rails_utilities/railtie.rb
 - lib/creative_rails_utilities/string.rb
 - lib/creative_rails_utilities/version.rb