selfie_chain 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 033ae7411b48d5416bc91fa424357e9b1d317a99
-  data.tar.gz: 62f2ebc53dbc2d55cae58239cbee3dfda247e7e1
+  metadata.gz: 0e43376cb6c32cb841c0d9fb7dfac7352295aae5
+  data.tar.gz: 2639603a7f4d8fac95d09007a9c50cbccb6911a9
 SHA512:
-  metadata.gz: af27d883dbd70607629ab8d3ba6f0721fc1673b98b1f950f23d211132df60f725795248248cb1e580ecf882f7ff7d62158b55cd2deb887f6900e761113584693
-  data.tar.gz: a0565cb31fb1c7efc99ecc186e375ba28547642ba783b721b7d7b1b0d038d070d332a673d82ba6db8d9b0916fa73ba02698d4cb293e23e7dba56de5e7964a0a9
+  metadata.gz: f71b161f6e16d1fb7f95f01d42f3dc77a67f1118bc2ba62001145248e8b02ce35973854c7911e979a54328d0c24f98eeeed94dd7f1334412d32cc0bc256a0851
+  data.tar.gz: 13271f04584c5cee98eab03ef43d5ade3e971cbbbfcf3f855efb67cf26b8d3828a84b659afd5728004e110e5a7a3c4013337c65f3f8482b3ffc92e003161475f

data/README.md

@@ -1,6 +1,6 @@
 # SelfieChain
 
-Now every object can take a selfie. SelfieChain is an attempt to one-shot-complement ruby's ternary operator, null guard and somehow extend Rails' :try method (but you don't need Rails). I realised that there are use cases, that the above mentioned tools fail to address in sufficently elegant way. Look below for some explanatory examples and start taking selfies :)
+Now every object can take a selfie. SelfieChain is an attempt to complement ruby's ternary operator, null guard and somehow extend Rails' :try method (but you don't need Rails), all in one-shot. I realised that there are use cases, that the above mentioned tools fail to address in sufficently elegant way. Look below for some explanatory examples and start taking selfies :)
 
 ## Installation
 
@@ -20,7 +20,7 @@ Or install it yourself as:
 
 ## Usage
 
-SelfieChain adds a :selfie method to Object class (as well as a SelfieChain < BasicObject class). Calling it with or without a block changes it's behavior as follows:
+SelfieChain adds a :selfie method to Object class (as well as a SelfieChain:Wrapper < BasicObject class). Calling it with or without a block changes it's behavior as follows:
 
 ####1. With block (and one optional argument that defaults to nil). 
 
@@ -47,9 +47,24 @@ This let's you stop worrying about checking for possible nil every time you chai
 This time selfie returns SelfieChain.new(self) - instance of SelfieChain < BasicObject class that wraps the receiver. This wrapper delegates every method call (except for :share_selfie and those defined by BasicObject)
 to the wrapped object - and swaps it with the result unless the wrapped object doesn't respond_to? the method, in which case the wrapper stores nil. NOTE, that once the wrapped object hits nil, it always stays nil (this conforms to the Rails' :try method mechanics). You can end this method calling chain party and retrieve the result by calling :share_selfie.
 
-________________________________
+####3. Share_selfie with block (from v.1.1.0)
+
+Now you can pass a block to share selfie:
+
+	h[:a][:b][:c] = {"d" => "14"}
+	h.selfie[:a][:b][:c]["d"].to_i.share_selfie(-1) {|x| false} => -1
+	
+It works just like (...).share_selfie.selfie(-1) {|x| false} with the only exception, that when share_selfie is to yield nil, it still yields nil no matter what the given block evaluates to:
+
+	h[:a][:b] = {c: "14"}
+	h.selfie[:a][:b][:c]["d"].to_i.share_selfie(-1) {|x| false} => nil
+	h.selfie[:a][:b][:c]["d"].to_i.share_selfie.selfie(-1) {|x| false} => -1
+
+
+----------------------------
 * Here we use string "d" instead of symbol :d to avoid known "no implicit conversion of Symbol into Integer" exception raised by calling "14"[:d].
 
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/selfie_chain.rb

@@ -1,21 +1,5 @@
 require "selfie_chain/version"
-
-class SelfieChain < BasicObject
-
-	def initialize(subject)
-		@subject = subject
-	end
-
-	def method_missing(method, *args, &block)
-		@subject = !@subject.nil? && @subject.respond_to?(method) ? @subject.public_send(method, *args, &block) : nil
-		self
-	end
-
-	def share_selfie
-		@subject
-	end
-
-end
+require "selfie_chain/wrapper"
 
 class Object
 
@@ -23,7 +7,8 @@ class Object
 		if block_given?
 			yield(self) ? self : other
 		else
-			SelfieChain.new(self)
+			SelfieChain::Wrapper.new(self)
 		end
 	end
+
 end

data/lib/selfie_chain/version.rb

@@ -1,4 +1,4 @@
-class SelfieChain < BasicObject
-  VERSION = "1.0.1"
+module SelfieChain
+  VERSION = "1.1.0"
 end
 	

data/lib/selfie_chain/wrapper.rb

@@ -0,0 +1,29 @@
+module SelfieChain
+	class Wrapper < BasicObject
+
+		def initialize(subject)
+			@subject = subject
+		end
+
+		def method_missing(method, *args, &block)
+			if !@subject.nil? && @subject.respond_to?(method)
+				@subject = @subject.public_send(method, *args, &block)
+			end
+			self
+		end
+
+		# returns @subject or other, if the optional block evaluates to true (and @subject is not nil)
+		def share_selfie(other = nil, &block)
+			# this means it's NOT equivalent to .share_selfie.selfie(other, &block)
+			return if @subject.nil?
+
+			# block_given? isn't defined on BasicObject
+			if block.nil?
+				@subject
+			else
+				yield(@subject) ? @subject : other
+			end
+		end
+
+	end
+end

data/selfie_chain.gemspec

@@ -9,8 +9,8 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Maciej Satkiewicz"]
   spec.email         = ["msatkiewicz@gmail.com"]
 
-  spec.summary       = %q{Adds Object#selfie (and SelfieChain < BasicObject) to complement ternary operator, null guard and Rails' :try method at once}
-  spec.description   = %q{Complements ternary operator, null guard and Rails' :try method by adding simple Object#selfie and SelfieChain < BasicObject}
+  spec.summary       = %q{Adds Object#selfie (and SelfieChain::Wrapper < BasicObject) to complement ternary operator, null guard and Rails' :try method at once}
+  spec.description   = %q{Complements ternary operator, null guard and Rails' :try method by adding simple Object#selfie and SelfieChain::Wrapper < BasicObject}
   spec.homepage      = "https://github.com/swarzkopf314/selfie_chain"
   spec.license       = "MIT"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: selfie_chain
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Maciej Satkiewicz
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-08-30 00:00:00.000000000 Z
+date: 2015-09-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -67,7 +67,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 description: Complements ternary operator, null guard and Rails' :try method by adding
-  simple Object#selfie and SelfieChain < BasicObject
+  simple Object#selfie and SelfieChain::Wrapper < BasicObject
 email:
 - msatkiewicz@gmail.com
 executables: []
@@ -84,6 +84,7 @@ files:
 - bin/setup
 - lib/selfie_chain.rb
 - lib/selfie_chain/version.rb
+- lib/selfie_chain/wrapper.rb
 - selfie_chain.gemspec
 homepage: https://github.com/swarzkopf314/selfie_chain
 licenses:
@@ -108,6 +109,6 @@ rubyforge_project:
 rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
-summary: Adds Object#selfie (and SelfieChain < BasicObject) to complement ternary
-  operator, null guard and Rails' :try method at once
+summary: Adds Object#selfie (and SelfieChain::Wrapper < BasicObject) to complement
+  ternary operator, null guard and Rails' :try method at once
 test_files: []