flap 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ecd779bcb03ad4e4d4611fedb7ab4037103a032a
-  data.tar.gz: 7aec48937813e3af6e3b854b8ec31515caefee40
+  metadata.gz: 218548f3e588ea9a8844809b21ce70319d829df2
+  data.tar.gz: f0c0a639432afc042a933b772bb1e27ce92e0e08
 SHA512:
-  metadata.gz: 8c614cc7264bcac00bf928cd3c8b9eddcf776b60f60908740f449ea19ffa7485fd1e48e58bfd875e2304620970118fd6e891e1c88f4c9b0e6929971f9b19a69d
-  data.tar.gz: ce2a6d0ad984addfcfb98b67c389aa9c27ceee53bf80be02b3e857225d58e81b5d90a59235a98966fbbcfbdf9789ec9f34be6462bebfa9b6682023ad6ca0fdeb
+  metadata.gz: c089770e5798a98609e2d757083951102ce5993fbf9727873845f202d8add950d49865a4a991909441e3e25ca5646164c0d1345439164c199a587960c15fe9c4
+  data.tar.gz: 4eefb23fbb54a134300c839a617aac17996d7c6c34a735eee6b75315e0962d963bd77aed07417a07e229dee7f93188170dae6df715fb3bf3c7ec3b1a993749e6

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Development
 
+## v0.2.0
+
+* Add instance_tap_eval and class_tap_eval ([@Sixeight])
+* Object#flap becomes deprecated ([@Sixeight])
+
 ## v0.1.1
 
 * Fixed Module#include is private at under Ruby 2.0 bug ([@Sixeight])

data/lib/flap/version.rb

@@ -1,3 +1,3 @@
 module Flap
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/flap.rb

@@ -1,10 +1,63 @@
 require "flap/version"
 
 module Flap
-  def flap(&block)
+  def self.included(base)
+    Module.__send__ :include, ModuleMethods
+  end
+
+  # Public: tap + instance_eval
+  #
+  # block - call in receiver's context
+  #
+  # Examples
+  #   hash = {a: 1, b: 2}
+  #   hash.instance_tap_eval { delete :a } #=> {:b => 2}
+  #
+  # Returns self
+  def instance_tap_eval(&block)
     self.instance_eval &block if block_given?
     self
   end
+
+  # Deprecated: same as instance_tap_eval
+  def flap(&block)
+    warn "[deprecated] this method will be removed."
+    instance_tap_eval &block
+  end
+
+  module ModuleMethods
+    # Public: tap + class_eval
+    #
+    # block - call in class context
+    #
+    # Examples
+    #   Klass = Class.new.class_tap_eval { include Awesome }
+    #   Klass.new.awesome_method
+    #
+    # Returns self
+    def class_tap_eval(&block)
+      class_eval &block if block_given?
+      self
+    end
+  end
+
+  # Public: define alias methods itap/ctap.
+  #
+  # Returns self
+  def self.enable_short_methods!
+    Object.__send__ :include, ShortMethods
+  end
+
+  module ShortMethods
+    def self.included(base)
+      base.class_eval do
+        alias_method :itap, :instance_tap_eval
+        Module.class_eval do
+          alias_method :ctap, :class_tap_eval
+        end
+      end
+    end
+  end
 end
 
 Object.__send__ :include, Flap

data/spec/flap_spec.rb

@@ -1,19 +1,61 @@
 require "spec_helper"
 
 describe Flap do
-  it "Object has flap method" do
-    expect(Object).to respond_to(:flap)
+  shared_examples_for "xxx_tap_eval" do
+    it "has method" do
+      expect(subject).to respond_to(meth)
+    end
+
+    it "returns self" do
+      expect(subject.public_send(meth)).to eql subject
+    end
+
+    it "block binded self context" do
+      ret = nil
+      subject.public_send(meth) { ret = self }
+      expect(ret).to eql subject
+    end
+  end
+
+  describe "instance_tap_eval" do
+    subject { Object.new }
+    let(:meth) { :instance_tap_eval }
+    it_behaves_like "xxx_tap_eval"
   end
 
-  let(:object) { "object" }
+  describe "class_tap_eval" do
+    subject { Module }
+    let(:meth) { :class_tap_eval }
+    it_behaves_like "xxx_tap_eval"
+  end
+
+  describe ".enable_short_methods!" do
+    before do
+      Flap.enable_short_methods!
+    end
 
-  it "returns self" do
-    expect(object.flap).to eql object
+    it "Object has :itap instance method" do
+      expect(Object.new).to respond_to(:itap)
+    end
+
+    it "Module has :ctap class method" do
+      expect(Module).to respond_to(:ctap)
+    end
   end
 
-  it "block binded self context" do
-    ret = nil
-    object.flap { ret = self }
-    expect(ret).to eql object
+  context "deprecated" do
+    let(:meth) { :flap }
+    it_behaves_like "xxx_tap_eval"
+
+    it "shows deprecated message" do
+      begin
+        original = $stderr
+        $stderr = result = StringIO.new
+        flap
+        expect(result.string).to match("deprecated")
+      ensure
+        $stderr = original
+      end
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: flap
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Tomohiro Nishimura
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-17 00:00:00.000000000 Z
+date: 2014-04-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler