tap-if 0.2.0 → 0.4.0

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - rbx-19mode
+branches:
+  only:
+    - master
+notifications:
+  email:
+    recipients:
+      - brian.nort@gmail.com
+matrix:
+  allow_failures:
+    - rvm: rbx-19mode

data/README.md

@@ -1,15 +1,21 @@
-# Tap If
+#Tap If [![Build Status](https://travis-ci.org/bnorton/tap_if.png?branch=master)](https://travis-ci.org/bnorton/tap_if)
 
-## Install / Use
+## Install
 
-In your `Gemfile` add: `gem 'tap_if'`  
-Then run `bundle install`.  
-Add `require 'tap_if'` before you use it.  
+In your Gemfile:  
+    `gem 'tap_if'`  
 
-##Examples
+Then run:  
+    `$ bundle install`  
 
-Delegates to Object#tap if the `caller` is truthy or given the `method name + args` evaluate to
-a truthy value. Useful for clarity - always return the caller but only
+Before you use it:  
+    `require 'tap_if'`  
+
+##Usage
+
+Yields to the block if the `caller` is truthy or given the `method name + args` evaluate to
+a truthy value.  
+Useful for clarity - always return the caller but only
 execute the block when the condition passes.
 
 ```ruby
@@ -19,7 +25,7 @@ User.find(user_id).tap_if(:admin?, account) do |user|
   user.update_token(account)
 end
 
-# Only update twitter/facebook if the post actually publishes.
+# Only update twitter/facebook if the post actually updates/publishes.
 
 def publish
   (post.pending? && post.update_attributes(:published => true)).tap_if do
@@ -29,6 +35,12 @@ def publish
     Facebook.update(the_update)
   end
 end
+
+# Only add a user to an account if the user is not a member.
+
+AccountUser.where(:account_id => account.id, :user_id => user.id).tap_if(:empty?) do |user|
+  account.users << user
+end
 ```
 
 ##The Motivation

data/Rakefile

@@ -10,17 +10,6 @@ rescue Bundler::BundlerError => e
   exit e.status_code
 end
 
-require 'rake'
-require 'rdoc/task'
-require 'rake/testtask'
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << 'lib'
-  t.libs << 'spec'
-  t.pattern = 'spec/**/*_spec.rb'
-  t.verbose = false
-end
-
 require 'jeweler'
 Jeweler::Tasks.new do |gem|
   gem.name        = 'tap-if'
@@ -33,3 +22,7 @@ Jeweler::Tasks.new do |gem|
 end
 
 Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+task :default => :spec

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.4.0

data/lib/tap_if.rb

@@ -1,7 +1,9 @@
 module TapIf
-  # Delegates to Object#tap if the `caller` is truthy or given the `method name + args` evaluate to
-  # a truthy value. Useful for clarity - always return the caller but only
-  # execute the block when the condition passes.
+  # Executes the given block if the `caller` is truthy or given the `method name + args` evaluate to
+  #   a truthy value.
+  #
+  # Useful for clarity - always return the caller but only
+  #   execute the block when the condition passes.
   #
   # Update the user's account token if the user is an admin of the account.
   #
@@ -20,9 +22,10 @@ module TapIf
   #   end
   # end
 
-  def tap_if(*args, &block)
-    args.empty? && self || args.any? && self.respond_to?(args.first) && self.send(*args) ?
-      self.tap(&block) : self
+  def tap_if(*args)
+    yield self if (args.empty? && self || args.any? && respond_to?(args.first) && send(*args))
+
+    self
   end
 end
 

data/spec/lib/tap_if_spec.rb

@@ -11,6 +11,33 @@ describe :tap_if do
     Object.methods.should include(:tap_if)
   end
 
+  describe 'when the block takes no arguments' do
+    it 'should execute the block' do
+      @foo.should_receive(:bar)
+
+      true.tap_if { @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)
+
+      true.tap_if(&@block)
+    end
+
+    it 'should yield the caller' do
+      "foo-true".tap_if(&@block)
+
+      @value.should == "foo-true"
+    end
+  end
+
   describe "when the method evaluates to true" do
     [[Array.new, :empty?], [{:f => :d}, :key?, :f]].each do |type, *args|
       it "should tap #{type.inspect}.#{args.first}" do

data/tap-if.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "tap-if"
-  s.version = "0.2.0"
+  s.version = "0.4.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["bnorton"]
-  s.date = "2013-01-24"
+  s.date = "2013-02-06"
   s.description = "Object#tap_if clarifies control flow in many circumstances."
   s.email = "brian.nort@gmail.com"
   s.extra_rdoc_files = [
@@ -17,6 +17,7 @@ Gem::Specification.new do |s|
     "README.md"
   ]
   s.files = [
+    ".travis.yml",
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.md",
@@ -31,7 +32,7 @@ Gem::Specification.new do |s|
   s.homepage = "http://github.com/bnorton/tap-if"
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.24"
+  s.rubygems_version = "1.8.25"
   s.summary = "Tap into an object but only execute the code if truthy."
 
   if s.respond_to? :specification_version then

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tap-if
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-24 00:00:00.000000000 Z
+date: 2013-02-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -83,6 +83,7 @@ extra_rdoc_files:
 - LICENSE.md
 - README.md
 files:
+- .travis.yml
 - Gemfile
 - Gemfile.lock
 - LICENSE.md
@@ -108,7 +109,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -1728875354126093151
+      hash: -2778854339072605407
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -117,7 +118,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 1.8.25
 signing_key: 
 specification_version: 3
 summary: Tap into an object but only execute the code if truthy.