2011-12-06 18:51:56 +00:00
|
|
|
require "docile/version"
|
2011-12-06 20:05:31 +00:00
|
|
|
require "docile/fallback_context_proxy"
|
2011-12-06 18:51:56 +00:00
|
|
|
|
|
|
|
module Docile
|
2011-12-06 19:46:46 +00:00
|
|
|
# Executes a block in the context of an object whose interface represents a DSL.
|
|
|
|
#
|
2011-12-06 20:05:31 +00:00
|
|
|
# Example of using an Array as a DSL:
|
|
|
|
# Docile.dsl_eval [] do
|
2011-12-06 19:46:46 +00:00
|
|
|
# push 1
|
|
|
|
# push 2
|
|
|
|
# pop
|
|
|
|
# push 3
|
|
|
|
# end
|
|
|
|
# #=> [1, 3]
|
|
|
|
#
|
|
|
|
# @param dsl [Object] an object whose methods represent a DSL
|
|
|
|
# @param block [Proc] a block to execute in the DSL context
|
|
|
|
# @return [Object] the given DSL object
|
|
|
|
def dsl_eval(dsl, &block)
|
|
|
|
block_context = eval("self", block.binding)
|
2011-12-06 20:05:31 +00:00
|
|
|
FallbackContextProxy.new(dsl, block_context).instance_eval(&block)
|
2011-12-06 19:46:46 +00:00
|
|
|
dsl
|
|
|
|
end
|
|
|
|
module_function :dsl_eval
|
2011-12-06 18:51:56 +00:00
|
|
|
end
|