0
@@ -1,5 +1,8 @@
0
 *2.3.0 [Edge]*
0
 
0
+* Object#tap shim for Ruby < 1.8.7. Similar to Object#returning, tap yields self then returns self.  [Jeremy Kemper]
0
+    array.select { ... }.tap(&:inspect).map { ... }
0
+
0
 * TimeWithZone#- gives correct result with wrapped DateTime, and with DateTime argument [Geoff Buesing]
0
 
0
 * Updated i18n gem to version 0.1.1 #1635 [Yaroslav Markin]

0
@@ -40,6 +40,21 @@ class Object
0
     value
0
   end
0
 
0
+  # Yields <code>x</code> to the block, and then returns <code>x</code>.
0
+  # The primary purpose of this method is to "tap into" a method chain,
0
+  # in order to perform operations on intermediate results within the chain.
0
+  #
0
+  #   (1..10).tap { |x| puts "original: #{x.inspect}" }.to_a.
0
+  #     tap    { |x| puts "array: #{x.inspect}" }.
0
+  #     select { |x| x%2 == 0 }.
0
+  #     tap    { |x| puts "evens: #{x.inspect}" }.
0
+  #     map    { |x| x*x }.
0
+  #     tap    { |x| puts "squares: #{x.inspect}" }
0
+  def tap
0
+    yield self
0
+    self
0
+  end unless Object.respond_to?(:tap)
0
+
0
   # An elegant way to factor duplication out of options passed to a series of
0
   # method calls. Each method called in the block, with the block variable as
0
   # the receiver, will have its options merged with the default +options+ hash