Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
4 changed files
with
85 additions
and
80 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,80 +1,3 @@ | ||
class Object | ||
# Returns +value+ after yielding +value+ to the block. This simplifies the | ||
# process of constructing an object, performing work on the object, and then | ||
# returning the object from a method. It is a Ruby-ized realization of the K | ||
# combinator, courtesy of Mikael Brockman. | ||
# | ||
# ==== Examples | ||
# | ||
# # Without returning | ||
# def foo | ||
# values = [] | ||
# values << "bar" | ||
# values << "baz" | ||
# return values | ||
# end | ||
# | ||
# foo # => ['bar', 'baz'] | ||
# | ||
# # returning with a local variable | ||
# def foo | ||
# returning values = [] do | ||
# values << 'bar' | ||
# values << 'baz' | ||
# end | ||
# end | ||
# | ||
# foo # => ['bar', 'baz'] | ||
# | ||
# # returning with a block argument | ||
# def foo | ||
# returning [] do |values| | ||
# values << 'bar' | ||
# values << 'baz' | ||
# end | ||
# end | ||
# | ||
# foo # => ['bar', 'baz'] | ||
def returning(value) | ||
yield(value) | ||
value | ||
end | ||
|
||
# Yields <code>x</code> to the block, and then returns <code>x</code>. | ||
# The primary purpose of this method is to "tap into" a method chain, | ||
# in order to perform operations on intermediate results within the chain. | ||
# | ||
# (1..10).tap { |x| puts "original: #{x.inspect}" }.to_a. | ||
# tap { |x| puts "array: #{x.inspect}" }. | ||
# select { |x| x%2 == 0 }. | ||
# tap { |x| puts "evens: #{x.inspect}" }. | ||
# map { |x| x*x }. | ||
# tap { |x| puts "squares: #{x.inspect}" } | ||
def tap | ||
yield self | ||
self | ||
end unless Object.respond_to?(:tap) | ||
|
||
# An elegant way to factor duplication out of options passed to a series of | ||
# method calls. Each method called in the block, with the block variable as | ||
# the receiver, will have its options merged with the default +options+ hash | ||
# provided. Each method called on the block variable must take an options | ||
# hash as its final argument. | ||
# | ||
# with_options :order => 'created_at', :class_name => 'Comment' do |post| | ||
# post.has_many :comments, :conditions => ['approved = ?', true], :dependent => :delete_all | ||
# post.has_many :unapproved_comments, :conditions => ['approved = ?', false] | ||
# post.has_many :all_comments | ||
# end | ||
# | ||
# Can also be used with an explicit receiver: | ||
# | ||
# map.with_options :controller => "people" do |people| | ||
# people.connect "/people", :action => "index" | ||
# people.connect "/people/:id", :action => "show" | ||
# end | ||
# | ||
def with_options(options) | ||
yield ActiveSupport::OptionMerger.new(self, options) | ||
end | ||
end | ||
require 'active_support/core_ext/object/returning' | ||
require 'active_support/core_ext/object/tap' | ||
require 'active_support/core_ext/object/with_options' |
42 changes: 42 additions & 0 deletions
42
activesupport/lib/active_support/core_ext/object/returning.rb
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
class Object | ||
# Returns +value+ after yielding +value+ to the block. This simplifies the | ||
# process of constructing an object, performing work on the object, and then | ||
# returning the object from a method. It is a Ruby-ized realization of the K | ||
# combinator, courtesy of Mikael Brockman. | ||
# | ||
# ==== Examples | ||
# | ||
# # Without returning | ||
# def foo | ||
# values = [] | ||
# values << "bar" | ||
# values << "baz" | ||
# return values | ||
# end | ||
# | ||
# foo # => ['bar', 'baz'] | ||
# | ||
# # returning with a local variable | ||
# def foo | ||
# returning values = [] do | ||
# values << 'bar' | ||
# values << 'baz' | ||
# end | ||
# end | ||
# | ||
# foo # => ['bar', 'baz'] | ||
# | ||
# # returning with a block argument | ||
# def foo | ||
# returning [] do |values| | ||
# values << 'bar' | ||
# values << 'baz' | ||
# end | ||
# end | ||
# | ||
# foo # => ['bar', 'baz'] | ||
def returning(value) | ||
yield(value) | ||
value | ||
end | ||
end |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,16 @@ | ||
class Object | ||
# Yields <code>x</code> to the block, and then returns <code>x</code>. | ||
# The primary purpose of this method is to "tap into" a method chain, | ||
# in order to perform operations on intermediate results within the chain. | ||
# | ||
# (1..10).tap { |x| puts "original: #{x.inspect}" }.to_a. | ||
# tap { |x| puts "array: #{x.inspect}" }. | ||
# select { |x| x%2 == 0 }. | ||
# tap { |x| puts "evens: #{x.inspect}" }. | ||
# map { |x| x*x }. | ||
# tap { |x| puts "squares: #{x.inspect}" } | ||
def tap | ||
yield self | ||
self | ||
end unless Object.respond_to?(:tap) | ||
end |
24 changes: 24 additions & 0 deletions
24
activesupport/lib/active_support/core_ext/object/with_options.rb
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
class Object | ||
# An elegant way to factor duplication out of options passed to a series of | ||
# method calls. Each method called in the block, with the block variable as | ||
# the receiver, will have its options merged with the default +options+ hash | ||
# provided. Each method called on the block variable must take an options | ||
# hash as its final argument. | ||
# | ||
# with_options :order => 'created_at', :class_name => 'Comment' do |post| | ||
# post.has_many :comments, :conditions => ['approved = ?', true], :dependent => :delete_all | ||
# post.has_many :unapproved_comments, :conditions => ['approved = ?', false] | ||
# post.has_many :all_comments | ||
# end | ||
# | ||
# Can also be used with an explicit receiver: | ||
# | ||
# map.with_options :controller => "people" do |people| | ||
# people.connect "/people", :action => "index" | ||
# people.connect "/people/:id", :action => "show" | ||
# end | ||
# | ||
def with_options(options) | ||
yield ActiveSupport::OptionMerger.new(self, options) | ||
end | ||
end |