tap-if 0.4.0 → 0.5.0

data/README.md

@@ -1,4 +1,4 @@
-#Tap If [![Build Status](https://travis-ci.org/bnorton/tap_if.png?branch=master)](https://travis-ci.org/bnorton/tap_if)
+#Tap If and Tap Unless [![Build Status](https://travis-ci.org/bnorton/tap_if.png?branch=master)](https://travis-ci.org/bnorton/tap_if)
 
 ## Install
 
@@ -10,6 +10,7 @@ Then run:
 
 Before you use it:  
     `require 'tap_if'`  
+    `require 'tap_unless'`
 
 ##Usage
 
@@ -41,6 +42,12 @@ end
 AccountUser.where(:account_id => account.id, :user_id => user.id).tap_if(:empty?) do |user|
   account.users << user
 end
+
+# OR
+
+AccountUser.where(:account_id => account.id, :user_id => user.id).tap_unless(:any?) do |user|
+  account.users << user
+end
 ```
 
 ##The Motivation

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.5.0

data/lib/tap_unless.rb

@@ -0,0 +1,12 @@
+module TapUnless
+  ##
+  # See TapIf
+  #
+  def tap_unless(*args)
+    yield self if ((args.empty? && !self) || (args.any? && respond_to?(args.first) && !send(*args)))
+    #
+    self
+  end
+end
+
+Object.send(:include, TapUnless)

data/spec/lib/tap_if_spec.rb

@@ -1,4 +1,5 @@
-require "spec_helper"
+require 'spec_helper'
+require 'tap_if'
 
 describe :tap_if do
   before do

data/spec/lib/tap_unless_spec.rb

@@ -0,0 +1,107 @@
+require 'spec_helper'
+require 'tap_unless'
+
+describe :tap_unless do
+  before do
+    @foo = mock("foo", :bar => nil)
+    @block = lambda {|*| @foo.bar }
+  end
+
+  it "should be a method on all objects" do
+    Object.new.methods.should include(:tap_unless)
+    Object.methods.should include(:tap_unless)
+  end
+
+  describe 'when the block takes no arguments' do
+    it 'should execute the block' do
+      @foo.should_receive(:bar)
+
+      false.tap_unless { @foo.bar }
+    end
+  end
+
+  describe 'when the block takes some arguments' do
+    before do
+      @value = nil
+      @block = lambda {|t| @value = t; @foo.bar }
+    end
+
+    it 'should execute the block' do
+      @foo.should_receive(:bar)
+
+      false.tap_unless(&@block)
+    end
+
+    it 'should yield the caller' do
+      false.tap_unless(&@block)
+
+      @value.should == false
+    end
+  end
+
+  describe "when the method evaluates to true" do
+    [[Array.new, :empty?], [{:f => :d}, :key?, :f]].each do |type, *args|
+      it "should not tap #{type.inspect}.#{args.first}" do
+        @foo.should_not_receive(:bar)
+
+        type.tap_unless(*args, &@block)
+      end
+
+      it "should return the value" do
+        type.tap_unless(*args, &@block).object_id.should == type.object_id
+      end
+    end
+  end
+
+  describe "when the method evaluates to false" do
+    [[Array.new, :any?], [{:f => :d}, :key?, :x]].each do |type, *args|
+      it "should tap #{type.inspect}.#{args.first}" do
+        @foo.should_receive(:bar)
+
+        type.tap_unless(*args, &@block)
+        end
+
+      it "should return the value" do
+        type.tap_unless(*args, &@block).object_id.should == type.object_id
+      end
+    end
+  end
+
+  describe "when the method is not defined" do
+    [[nil, :any?], [[], :keys]].each do |type, *args|
+      it "should not tap #{type.inspect}.#{args.first}" do
+        @foo.should_not_receive(:bar)
+
+        type.tap_unless(*args, &@block)
+      end
+    end
+  end
+
+  describe "when the target is truthy" do
+    [true, "", 1, [], {}, 0, :foo].each do |type|
+      it "should not tap #{type.inspect}" do
+        @foo.should_not_receive(:bar)
+
+        type.tap_unless(&@block)
+      end
+
+      it "should return the value" do
+        type.tap_unless(&@block).object_id.should == type.object_id
+      end
+    end
+  end
+
+  describe "when the target is falsey" do
+    [false, nil, def method; end].each do |type|
+      it "should tap #{type.inspect}" do
+        @foo.should_receive(:bar)
+
+        type.tap_unless(&@block)
+      end
+
+      it "should return the value" do
+        type.tap_unless(&@block).object_id.should == type.object_id
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,7 +1,6 @@
 ENV["RAILS_ENV"] ||= 'test'
 
 require 'rspec'
-require 'tap_if'
 
 RSpec.configure do |c|
   c.mock_with :rspec

data/tap-if.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "tap-if"
-  s.version = "0.4.0"
+  s.version = "0.5.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["bnorton"]
-  s.date = "2013-02-06"
+  s.date = "2013-02-09"
   s.description = "Object#tap_if clarifies control flow in many circumstances."
   s.email = "brian.nort@gmail.com"
   s.extra_rdoc_files = [
@@ -25,7 +25,9 @@ Gem::Specification.new do |s|
     "Rakefile",
     "VERSION",
     "lib/tap_if.rb",
+    "lib/tap_unless.rb",
     "spec/lib/tap_if_spec.rb",
+    "spec/lib/tap_unless_spec.rb",
     "spec/spec_helper.rb",
     "tap-if.gemspec"
   ]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tap-if
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-06 00:00:00.000000000 Z
+date: 2013-02-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -91,7 +91,9 @@ files:
 - Rakefile
 - VERSION
 - lib/tap_if.rb
+- lib/tap_unless.rb
 - spec/lib/tap_if_spec.rb
+- spec/lib/tap_unless_spec.rb
 - spec/spec_helper.rb
 - tap-if.gemspec
 homepage: http://github.com/bnorton/tap-if
@@ -109,7 +111,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2778854339072605407
+      hash: 87678209533408017
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: