tap-if 0.1.0

data/Gemfile

@@ -0,0 +1,9 @@
+source 'http://rubygems.org'
+
+group :development, :test do
+  gem 'rspec'
+  gem 'jeweler'
+  gem 'psych'
+  gem 'rake'
+end
+

data/Gemfile.lock

@@ -0,0 +1,32 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.6)
+    psych (1.3.4)
+    rake (10.0.3)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.12.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    rspec-core (2.12.1)
+    rspec-expectations (2.12.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.12.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  jeweler
+  psych
+  rake
+  rspec

data/LICENSE.md

@@ -0,0 +1,20 @@
+Copyright 2013 Brian Norton
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, clone, copy, modify, merge, publish,
+fork, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,35 @@
+# Tap If
+
+## Install
+
+In your `Gemfile` add: `gem 'tap_if'` Then run `bundle install`.
+
+##Examples
+
+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.
+
+```ruby
+# Update the user's account token if the user is an admin of the account.
+
+User.find(user_id).tap_if(:admin?, account) do |user|
+  user.update_token(account)
+end
+
+# Only update twitter/facebook if the post actually publishes.
+
+def publish
+  (post.pending? && post.update_attributes(:published => true)).tap_if do
+    the_update = "New blog post: #{post.title[0..100]}... #{post.link}"
+
+    Twitter.update(the_update)
+    Facebook.update(the_update)
+  end
+end
+```
+
+## License
+
+License: MIT-LICENSE (LICENSE.md)
+

data/Rakefile

@@ -0,0 +1,35 @@
+# encoding: UTF-8
+require 'rubygems'
+require 'bundler'
+
+begin
+  Bundler.setup(:default, :development, :test)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts 'Run `bundle install` to install missing gems'
+  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'
+  gem.homepage    = 'http://github.com/bnorton/tap-if'
+  gem.license     = 'MIT'
+  gem.summary     = 'Tap into an object but only execute the code if truthy.'
+  gem.description = 'Object#tap_if clarifies control flow in many circumstances.'
+  gem.email       = 'brian.nort@gmail.com'
+  gem.authors     = %w(bnorton)
+end
+
+Jeweler::RubygemsDotOrgTasks.new

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/tap_if.rb

@@ -0,0 +1,29 @@
+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.
+  #
+  # Update the user's account token if the user is an admin of the account.
+  #
+  # User.find(user_id).tap_if(:admin?, account) do |user|
+  #   user.update_token(account)
+  # end
+  #
+  # Only update twitter/facebook if the post actually publishes.
+  #
+  # def publish
+  #   (post.pending? && post.update_attributes(:published => true)).tap_if do
+  #     the_update = "New blog post: #{post.title[0..100]}... #{post.link}"
+  #
+  #     Twitter.update(the_update)
+  #     Facebook.update(the_update)
+  #   end
+  # end
+
+  def tap_if(*args, &block)
+    args.empty? && self || args.any? && self.send(*args) ?
+      self.tap(&block) : self
+  end
+end
+
+Object.send(:include, TapIf)

data/spec/lib/tap_if_spec.rb

@@ -0,0 +1,69 @@
+require "spec_helper"
+
+describe :tap_if 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_if)
+    Object.methods.should include(:tap_if)
+  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
+        @foo.should_receive(:bar)
+
+        type.tap_if(*args, &@block)
+      end
+
+      it "should return the value" do
+        type.tap_if(*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 not tap #{type.inspect}.#{args.first}" do
+        @foo.should_not_receive(:bar)
+
+        type.tap_if(*args, &@block)
+      end
+
+      it "should return the value" do
+        type.tap_if(*args, &@block).object_id.should == type.object_id
+      end
+    end
+  end
+
+  describe "when the target is truthy" do
+    [true, "", 1, [], {}, 0, :foo].each do |type|
+      it "should tap #{type.inspect}" do
+        @foo.should_receive(:bar)
+
+        type.tap_if(&@block)
+      end
+
+      it "should return the value" do
+        type.tap_if(&@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 not tap #{type.inspect}" do
+        @foo.should_not_receive(:bar)
+
+        type.tap_if(&@block)
+      end
+
+      it "should return the value" do
+        type.tap_if(&@block).object_id.should == type.object_id
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

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

data/tap-if.gemspec

@@ -0,0 +1,58 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "tap-if"
+  s.version = "0.1.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.description = "Object#tap_if clarifies control flow in many circumstances."
+  s.email = "brian.nort@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.md",
+    "README.md"
+  ]
+  s.files = [
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.md",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "lib/tap_if.rb",
+    "spec/lib/tap_if_spec.rb",
+    "spec/spec_helper.rb",
+    "tap-if.gemspec"
+  ]
+  s.homepage = "http://github.com/bnorton/tap-if"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.24"
+  s.summary = "Tap into an object but only execute the code if truthy."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<psych>, [">= 0"])
+      s.add_development_dependency(%q<rake>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<psych>, [">= 0"])
+      s.add_dependency(%q<rake>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<psych>, [">= 0"])
+    s.add_dependency(%q<rake>, [">= 0"])
+  end
+end
+

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification
+name: tap-if
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- bnorton
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-01-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: psych
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Object#tap_if clarifies control flow in many circumstances.
+email: brian.nort@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.md
+- README.md
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE.md
+- README.md
+- Rakefile
+- VERSION
+- lib/tap_if.rb
+- spec/lib/tap_if_spec.rb
+- spec/spec_helper.rb
+- tap-if.gemspec
+homepage: http://github.com/bnorton/tap-if
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1026261804445811438
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Tap into an object but only execute the code if truthy.
+test_files: []