RubyGems - innate - Versions diffs - 2009.04 - Mend

innate 2009.04

Files changed (128) hide show

data/CHANGELOG +2981 -0
data/COPYING +18 -0
data/MANIFEST +127 -0
data/README.md +563 -0
data/Rakefile +35 -0
data/example/app/retro_games.rb +60 -0
data/example/app/todo/layout/default.xhtml +11 -0
data/example/app/todo/spec/todo.rb +63 -0
data/example/app/todo/start.rb +51 -0
data/example/app/todo/view/index.xhtml +39 -0
data/example/app/whywiki_erb/layout/wiki.html.erb +15 -0
data/example/app/whywiki_erb/spec/wiki.rb +19 -0
data/example/app/whywiki_erb/start.rb +42 -0
data/example/app/whywiki_erb/view/edit.erb +6 -0
data/example/app/whywiki_erb/view/index.erb +12 -0
data/example/custom_middleware.rb +35 -0
data/example/hello.rb +11 -0
data/example/howto_spec.rb +35 -0
data/example/link.rb +27 -0
data/example/provides.rb +31 -0
data/example/session.rb +38 -0
data/innate.gemspec +29 -0
data/lib/innate.rb +269 -0
data/lib/innate/action.rb +150 -0
data/lib/innate/adapter.rb +76 -0
data/lib/innate/cache.rb +134 -0
data/lib/innate/cache/api.rb +128 -0
data/lib/innate/cache/drb.rb +58 -0
data/lib/innate/cache/file_based.rb +41 -0
data/lib/innate/cache/marshal.rb +17 -0
data/lib/innate/cache/memory.rb +22 -0
data/lib/innate/cache/yaml.rb +17 -0
data/lib/innate/current.rb +37 -0
data/lib/innate/dynamap.rb +96 -0
data/lib/innate/helper.rb +183 -0
data/lib/innate/helper/aspect.rb +124 -0
data/lib/innate/helper/cgi.rb +54 -0
data/lib/innate/helper/flash.rb +36 -0
data/lib/innate/helper/link.rb +94 -0
data/lib/innate/helper/redirect.rb +85 -0
data/lib/innate/helper/render.rb +87 -0
data/lib/innate/helper/send_file.rb +26 -0
data/lib/innate/log.rb +20 -0
data/lib/innate/log/color_formatter.rb +43 -0
data/lib/innate/log/hub.rb +73 -0
data/lib/innate/middleware_compiler.rb +65 -0
data/lib/innate/mock.rb +49 -0
data/lib/innate/node.rb +1025 -0
data/lib/innate/options.rb +37 -0
data/lib/innate/options/dsl.rb +202 -0
data/lib/innate/options/stub.rb +7 -0
data/lib/innate/request.rb +141 -0
data/lib/innate/response.rb +23 -0
data/lib/innate/route.rb +110 -0
data/lib/innate/session.rb +121 -0
data/lib/innate/session/flash.rb +94 -0
data/lib/innate/spec.rb +23 -0
data/lib/innate/state.rb +27 -0
data/lib/innate/state/accessor.rb +130 -0
data/lib/innate/state/fiber.rb +74 -0
data/lib/innate/state/thread.rb +47 -0
data/lib/innate/traited.rb +85 -0
data/lib/innate/trinity.rb +18 -0
data/lib/innate/version.rb +3 -0
data/lib/innate/view.rb +60 -0
data/lib/innate/view/erb.rb +15 -0
data/lib/innate/view/etanni.rb +36 -0
data/lib/innate/view/none.rb +9 -0
data/spec/example/app/retro_games.rb +30 -0
data/spec/example/hello.rb +13 -0
data/spec/example/link.rb +25 -0
data/spec/example/provides.rb +16 -0
data/spec/example/session.rb +22 -0
data/spec/helper.rb +10 -0
data/spec/innate/action/layout.rb +107 -0
data/spec/innate/action/layout/file_layout.xhtml +1 -0
data/spec/innate/cache/common.rb +47 -0
data/spec/innate/cache/marshal.rb +5 -0
data/spec/innate/cache/memory.rb +5 -0
data/spec/innate/cache/yaml.rb +5 -0
data/spec/innate/dynamap.rb +22 -0
data/spec/innate/helper.rb +86 -0
data/spec/innate/helper/aspect.rb +75 -0
data/spec/innate/helper/cgi.rb +37 -0
data/spec/innate/helper/flash.rb +118 -0
data/spec/innate/helper/link.rb +139 -0
data/spec/innate/helper/redirect.rb +160 -0
data/spec/innate/helper/render.rb +133 -0
data/spec/innate/helper/send_file.rb +21 -0
data/spec/innate/helper/view/aspect_hello.xhtml +1 -0
data/spec/innate/helper/view/locals.xhtml +1 -0
data/spec/innate/helper/view/loop.xhtml +4 -0
data/spec/innate/helper/view/num.xhtml +1 -0
data/spec/innate/helper/view/partial.xhtml +1 -0
data/spec/innate/helper/view/recursive.xhtml +7 -0
data/spec/innate/mock.rb +84 -0
data/spec/innate/node/mapping.rb +37 -0
data/spec/innate/node/node.rb +134 -0
data/spec/innate/node/resolve.rb +82 -0
data/spec/innate/node/view/another_layout/another_layout.xhtml +3 -0
data/spec/innate/node/view/bar.xhtml +1 -0
data/spec/innate/node/view/foo.html.xhtml +1 -0
data/spec/innate/node/view/only_view.xhtml +1 -0
data/spec/innate/node/view/with_layout.xhtml +1 -0
data/spec/innate/node/wrap_action_call.rb +83 -0
data/spec/innate/options.rb +115 -0
data/spec/innate/parameter.rb +154 -0
data/spec/innate/provides.rb +99 -0
data/spec/innate/provides/list.html.xhtml +1 -0
data/spec/innate/provides/list.txt.xhtml +1 -0
data/spec/innate/request.rb +77 -0
data/spec/innate/route.rb +135 -0
data/spec/innate/session.rb +54 -0
data/spec/innate/state/fiber.rb +58 -0
data/spec/innate/state/thread.rb +40 -0
data/spec/innate/traited.rb +55 -0
data/tasks/bacon.rake +66 -0
data/tasks/changelog.rake +18 -0
data/tasks/gem.rake +22 -0
data/tasks/gem_installer.rake +76 -0
data/tasks/grancher.rake +12 -0
data/tasks/install_dependencies.rake +4 -0
data/tasks/manifest.rake +4 -0
data/tasks/rcov.rake +19 -0
data/tasks/release.rake +51 -0
data/tasks/reversion.rake +8 -0
data/tasks/setup.rake +28 -0
metadata +181 -0

@@ -0,0 +1,27 @@
+require 'innate'
+class Linking
+  Innate.node '/'
+  def index
+    "Index links to " + a('Help?', :help)
+  end
+  def help
+    "Help links to " + Different.a('A Different Node', :another)
+  end
+end
+class Different
+  Innate.node '/link_to'
+  def another
+    a('Another links even deeper', 'and/deeper')
+  end
+  def and__deeper
+    Linking.a('Back to Linking Node', :index)
+  end
+end
+Innate.start

data/example/provides.rb ADDED

@@ -0,0 +1,31 @@
+require 'rubygems'
+require 'innate'
+require 'yaml'
+ARTICLES = {
+  'hello' => {
+    :author => 'manveru',
+    :title => 'Hello, World!',
+    :text => 'Some text'
+  }
+}
+class BlogArticles
+  Innate.node('/')
+  # provide a content representation for requests to /<action>.yaml
+  # If you request `/list.yaml`, you will get the `ARTICLES object serialized
+  # to YAML.
+  provide(:yaml, :type => 'text/yaml'){|action, value| value.to_yaml }
+  # Since there will always be an `html` representation (the default), you have
+  # to take care of it. If you simply want to return an empty page, use following.
+  provide(:html){|action, value| '' }
+  # The return value of this method is the `value` in the provides above.
+  def list
+    return ARTICLES
+  end
+end
+Innate.start

data/example/session.rb ADDED

@@ -0,0 +1,38 @@
+require 'innate'
+class Hello
+  Innate.node '/'
+  TEMPLATE = '
+<html>
+  <head>
+    <title>Session example</title>
+  </head>
+  <body>
+    <h1>Session example</h1>
+    <p>
+      Value is: #{ session[:value] }<br />
+      #{ a :increment }<br />
+      #{ a :decrement }
+    </p>
+  </body>
+</html>
+'.strip
+  def index
+    session[:value] = 0
+    TEMPLATE
+  end
+  def increment
+    session[:value] = session[:value].to_i + 1
+    TEMPLATE
+  end
+  def decrement
+    session[:value] = session[:value].to_i - 1
+    TEMPLATE
+  end
+end
+Innate.start

data/innate.gemspec ADDED

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+Gem::Specification.new do |s|
+  s.name = %q{innate}
+  s.version = "2009.04"
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael 'manveru' Fellinger"]
+  s.date = %q{2009-04-26}
+  s.description = %q{Simple, straight-forward base for web-frameworks.}
+  s.email = %q{m.fellinger@gmail.com}
+  s.files = ["CHANGELOG", "COPYING", "MANIFEST", "README.md", "Rakefile", "example/app/retro_games.rb", "example/app/todo/layout/default.xhtml", "example/app/todo/spec/todo.rb", "example/app/todo/start.rb", "example/app/todo/view/index.xhtml", "example/app/whywiki_erb/layout/wiki.html.erb", "example/app/whywiki_erb/spec/wiki.rb", "example/app/whywiki_erb/start.rb", "example/app/whywiki_erb/view/edit.erb", "example/app/whywiki_erb/view/index.erb", "example/custom_middleware.rb", "example/hello.rb", "example/howto_spec.rb", "example/link.rb", "example/provides.rb", "example/session.rb", "innate.gemspec", "lib/innate.rb", "lib/innate/action.rb", "lib/innate/adapter.rb", "lib/innate/cache.rb", "lib/innate/cache/api.rb", "lib/innate/cache/drb.rb", "lib/innate/cache/file_based.rb", "lib/innate/cache/marshal.rb", "lib/innate/cache/memory.rb", "lib/innate/cache/yaml.rb", "lib/innate/current.rb", "lib/innate/dynamap.rb", "lib/innate/helper.rb", "lib/innate/helper/aspect.rb", "lib/innate/helper/cgi.rb", "lib/innate/helper/flash.rb", "lib/innate/helper/link.rb", "lib/innate/helper/redirect.rb", "lib/innate/helper/render.rb", "lib/innate/helper/send_file.rb", "lib/innate/log.rb", "lib/innate/log/color_formatter.rb", "lib/innate/log/hub.rb", "lib/innate/middleware_compiler.rb", "lib/innate/mock.rb", "lib/innate/node.rb", "lib/innate/options.rb", "lib/innate/options/dsl.rb", "lib/innate/options/stub.rb", "lib/innate/request.rb", "lib/innate/response.rb", "lib/innate/route.rb", "lib/innate/session.rb", "lib/innate/session/flash.rb", "lib/innate/spec.rb", "lib/innate/state.rb", "lib/innate/state/accessor.rb", "lib/innate/state/fiber.rb", "lib/innate/state/thread.rb", "lib/innate/traited.rb", "lib/innate/trinity.rb", "lib/innate/version.rb", "lib/innate/view.rb", "lib/innate/view/erb.rb", "lib/innate/view/etanni.rb", "lib/innate/view/none.rb", "spec/example/app/retro_games.rb", "spec/example/hello.rb", "spec/example/link.rb", "spec/example/provides.rb", "spec/example/session.rb", "spec/helper.rb", "spec/innate/action/layout.rb", "spec/innate/action/layout/file_layout.xhtml", "spec/innate/cache/common.rb", "spec/innate/cache/marshal.rb", "spec/innate/cache/memory.rb", "spec/innate/cache/yaml.rb", "spec/innate/dynamap.rb", "spec/innate/helper.rb", "spec/innate/helper/aspect.rb", "spec/innate/helper/cgi.rb", "spec/innate/helper/flash.rb", "spec/innate/helper/link.rb", "spec/innate/helper/redirect.rb", "spec/innate/helper/render.rb", "spec/innate/helper/send_file.rb", "spec/innate/helper/view/aspect_hello.xhtml", "spec/innate/helper/view/locals.xhtml", "spec/innate/helper/view/loop.xhtml", "spec/innate/helper/view/num.xhtml", "spec/innate/helper/view/partial.xhtml", "spec/innate/helper/view/recursive.xhtml", "spec/innate/mock.rb", "spec/innate/node/mapping.rb", "spec/innate/node/node.rb", "spec/innate/node/resolve.rb", "spec/innate/node/view/another_layout/another_layout.xhtml", "spec/innate/node/view/bar.xhtml", "spec/innate/node/view/foo.html.xhtml", "spec/innate/node/view/only_view.xhtml", "spec/innate/node/view/with_layout.xhtml", "spec/innate/node/wrap_action_call.rb", "spec/innate/options.rb", "spec/innate/parameter.rb", "spec/innate/provides.rb", "spec/innate/provides/list.html.xhtml", "spec/innate/provides/list.txt.xhtml", "spec/innate/request.rb", "spec/innate/route.rb", "spec/innate/session.rb", "spec/innate/state/fiber.rb", "spec/innate/state/thread.rb", "spec/innate/traited.rb", "tasks/bacon.rake", "tasks/changelog.rake", "tasks/gem.rake", "tasks/gem_installer.rake", "tasks/grancher.rake", "tasks/install_dependencies.rake", "tasks/manifest.rake", "tasks/rcov.rake", "tasks/release.rake", "tasks/reversion.rake", "tasks/setup.rake"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/manveru/innate}
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{innate}
+  s.rubygems_version = %q{1.3.2}
+  s.summary = %q{Powerful web-framework wrapper for Rack.}
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/innate.rb ADDED

@@ -0,0 +1,269 @@
+# What can be done with fewer assumptions is done in vain with more.
+# -- William of Ockham (ca. 1285-1349)
+#
+# Name-space of Innate, just about everything goes in here.
+#
+# The only exception is Logger::ColorFormatter.
+#
+module Innate
+  ROOT = File.expand_path(File.dirname(__FILE__))
+  unless $LOAD_PATH.any?{|lp| File.expand_path(lp) == ROOT }
+    $LOAD_PATH.unshift(ROOT)
+  end
+  # stdlib
+  require 'pp'
+  require 'set'
+  require 'pathname'
+  require 'digest/sha1'
+  require 'digest/sha2'
+  require 'ipaddr'
+  require 'socket'
+  require 'logger'
+  require 'uri'
+  # 3rd party
+  require 'rack'
+  # innate core
+  require 'innate/version'
+  require 'innate/traited'
+  require 'innate/trinity'
+  require 'innate/middleware_compiler'
+  require 'innate/options/dsl'
+  require 'innate/options/stub'
+  require 'innate/dynamap'
+  # innate full
+  require 'innate/cache'
+  require 'innate/node'
+  require 'innate/options'
+  require 'innate/log'
+  require 'innate/state'
+  require 'innate/current'
+  require 'innate/mock'
+  require 'innate/adapter'
+  require 'innate/action'
+  require 'innate/helper'
+  require 'innate/view'
+  require 'innate/session'
+  require 'innate/session/flash'
+  require 'innate/route'
+  extend Trinity
+  # Contains all the module functions for Innate, we keep them in a module so
+  # Ramaze can simply use them as well.
+  module SingletonMethods
+    PROXY_OPTIONS = { :port => 'adapter.port', :host => 'adapter.host',
+                      :adapter => 'adapter.handler' }
+    # The method that starts the whole business.
+    #
+    # Call Innate.start after you defined your application.
+    #
+    # Usually, this is a blocking call and will not return until the adapter
+    # has finished, which usually happens when you kill the application or hit
+    # ^C.
+    #
+    # We do return if options.started is true, which indicates that all you
+    # wanted to do is setup the environment and update options.
+    #
+    # @example usage
+    #
+    #   # passing options
+    #   Innate.start :adapter => :mongrel, :mode => :live
+    #
+    #   # defining custom middleware
+    #   Innate.start do |m|
+    #     m.innate
+    #   end
+    #
+    # @return [nil] if options.started is true
+    # @yield [MiddlewareCompiler]
+    # @param [Proc] block will be passed to {middleware!}
+    #
+    # @option param :host    [String]  ('0.0.0.0')
+    #   IP address or hostname that we respond to - 0.0.0.0 for all
+    # @option param :port    [Fixnum]  (7000)
+    #   Port for the server
+    # @option param :started [boolean] (false)
+    #   Indicate that calls Innate::start will be ignored
+    # @option param :adapter [Symbol]  (:webrick)
+    #   Web server to run on
+    # @option param :setup   [Array]   ([Innate::Cache, Innate::Node])
+    #   Will send ::setup to each element during Innate::start
+    # @option param :header  [Hash]    ({'Content-Type' => 'text/html'})
+    #   Headers that will be merged into the response before Node::call
+    # @option param :trap    [String]  ('SIGINT')
+    #   Trap this signal to issue shutdown, nil/false to disable trap
+    # @option param :state   [Symbol]  (:Fiber)
+    #   Keep state in Thread or Fiber, fall back to Thread if Fiber not available
+    # @option param :mode    [Symbol]  (:dev)
+    #   Indicates which default middleware to use, (:dev|:live)
+    def start(given_options = {}, &block)
+      root = given_options.delete(:root)
+      file = given_options.delete(:file)
+      found_root = go_figure_root(caller, :root => root, :file => file)
+      Innate.options.roots = [found_root] if found_root
+      # Convert some top-level option keys to the internal ones that we use.
+      PROXY_OPTIONS.each{|k,v| given_options[v] = given_options.delete(k) }
+      given_options.delete_if{|k,v| v.nil? }
+      # Merge the user's given options into our existing set, which contains defaults.
+      options.merge!(given_options)
+      setup_dependencies
+      middleware!(options.mode, &block) if block_given?
+      return if options.started
+      options.started = true
+      signal = options.trap
+      trap(signal){ stop(10) } if signal
+      start!
+    end
+    def start!(mode = options[:mode])
+      Adapter.start(middleware(mode))
+    end
+    def stop(wait = 3)
+      Log.info("Shutdown within #{wait} seconds")
+      Timeout.timeout(wait){ teardown_dependencies }
+      Timeout.timeout(wait){ exit }
+    ensure
+      exit!
+    end
+    def setup_dependencies
+      options[:setup].each{|obj| obj.setup if obj.respond_to?(:setup) }
+    end
+    def teardown_dependencies
+      options[:setup].each{|obj| obj.teardown if obj.respond_to?(:teardown) }
+    end
+    # Treat Innate like a rack application, pass the rack +env+ and optionally
+    # the +mode+ the application runs in.
+    #
+    # @param [Hash] env rack env
+    # @param [Symbol] mode indicates the mode of the application
+    # @default mode options.mode
+    # @return [Array] with [body, header, status]
+    # @author manveru
+    def call(env, mode = options[:mode])
+      middleware(mode).call(env)
+    end
+    def middleware(mode = options[:mode], &block)
+      options[:middleware_compiler].build(mode, &block)
+    end
+    def middleware!(mode = options[:mode], &block)
+      options[:middleware_compiler].build!(mode, &block)
+    end
+    def middleware_recompile(mode = options[:mode])
+      options[:middleware_compiler]::COMPILED[mode].compile!
+    end
+    # @example Innate can be started by:
+    #
+    #   Innate.start :file => __FILE__
+    #   Innate.start :root => File.dirname(__FILE__)
+    #
+    # Either setting will surpress the warning that might show up on startup
+    # and tells you it couldn't find an explicit root.
+    #
+    # In case these options are not passed we will try to figure out a file named
+    # `start.rb` in the process' working directory and assume it's a valid point.
+    def go_figure_root(backtrace, options)
+      if root = options[:root]
+        root
+      elsif file = options[:file]
+        File.dirname(file)
+      elsif File.file?('start.rb')
+        Dir.pwd
+      else
+        root = File.dirname(backtrace[0][/^(.*?):\d+/, 1])
+        Log.warn "No explicit root folder found, assuming it is #{root}"
+        root
+      end
+    end
+  end
+  extend SingletonMethods
+  # This sets up the default modes.
+  # The Proc to use is determined by the value of options.mode.
+  # The Proc value is passed to setup_middleware if no block is given to
+  # Innate::start.
+  #
+  # A quick overview over the middleware used here:
+  #
+  #   * Rack::CommonLogger
+  #     Logs a line in Apache common log format or <tt>rack.errors</tt>.
+  #
+  #   * Rack::ShowExceptions
+  #     Catches all exceptions raised from the app it wraps. It shows a useful
+  #     backtrace with the sourcefile and clickable context, the whole Rack
+  #     environment and the request data.
+  #     Be careful when you use this on public-facing sites as it could reveal
+  #     information helpful to attackers.
+  #
+  #   * Rack::ShowStatus
+  #     Catches all empty responses the app it wraps and replaces them with a
+  #     site explaining the error.
+  #     Additional details can be put into <tt>rack.showstatus.detail</tt> and
+  #     will be shown as HTML. If such details exist, the error page is always
+  #     rendered, even if the reply was not empty.
+  #
+  #   * Rack::ConditionalGet
+  #     Middleware that enables conditional GET using If-None-Match and
+  #     If-Modified-Since. The application should set either or both of the
+  #     Last-Modified or Etag response headers according to RFC 2616. When
+  #     either of the conditions is met, the response body is set to be zero
+  #     length and the response status is set to 304 Not Modified.
+  #
+  #   * Rack::Head
+  #     Removes the body of the response for HEAD requests.
+  #
+  #   * Rack::Reloader
+  #     Pure ruby source reloader, runs on every request with a configurable
+  #     cooldown period.
+  #
+  #   * Rack::Lint
+  #     Rack::Lint validates your application and the requests and responses
+  #     according to the Rack spec.
+  #
+  # Note that `m.innate` takes away most of the boring part and leaves it up to
+  # you to select your middleware in your application.
+  #
+  # `m.innate` expands to:
+  #
+  #   use Rack::Cascade.new([
+  #     Rack::File.new('public'),
+  #     Innate::Current.new(
+  #       Rack::Cascade.new([
+  #         Innate::Rewrite.new(Innate::DynaMap),
+  #         Innate::Route.new(Innate::DynaMap)])))
+  #
+  # @see Rack::MiddlewareCompiler
+  middleware :dev do |m|
+    m.apps(Rack::Lint, Rack::CommonLogger, Rack::ShowExceptions,
+           Rack::ShowStatus, Rack::ConditionalGet, Rack::ContentLength,
+           Rack::Head)
+    m.use(Rack::Reloader, 2)
+    m.innate
+  end
+  middleware :live do |m|
+    m.apps(Rack::CommonLogger, Rack::ShowStatus, Rack::ConditionalGet,
+           Rack::ContentLength, Rack::Head)
+    m.innate
+  end
+end

data/lib/innate/action.rb ADDED

@@ -0,0 +1,150 @@
+module Innate
+  ACTION_MEMBERS = [ :node, :instance, :method, :params, :method_value, :view,
+    :view_value, :layout, :wish, :options, :variables, :engine, :path ]
+  class Action < Struct.new(*ACTION_MEMBERS)
+    # Create a new Action instance.
+    # Note that the default cannot be a constant as assigning the value objects
+    # to the struct would modify them and might lead to bugs due to persisting
+    # action contents.
+    #
+    # @param [Hash, #to_hash] hash used to seed new Action instance
+    # @return [Action] action with the given defaults from hash
+    # @api stable
+    # @author manveru
+    def self.create(hash = {})
+      default = {:options => {}, :variables => {}, :params => []}
+      new(*default.merge(hash.to_hash).values_at(*ACTION_MEMBERS))
+    end
+    def merge!(hash)
+      hash.each_pair{|key, value| send("#{key}=", value) }
+      self
+    end
+    # Call the Action instance, will insert itself temporarily into
+    # Current.actions during the render operation so even in nested calls one
+    # can still access all other Action instances.
+    # Will initialize the assigned node and call Action#render
+    #
+    # @return [String] The rendition of all nested calls
+    # @see Action#render Node#action_found
+    # @api stable
+    # @author manveru
+    def call
+      Current.actions ? wrap_in_current{ render } : render
+    end
+    # @return [Binding] binding of the instance for this Action
+    # @see Node#binding
+    # @api stable
+    # @author manveru
+    def binding
+      instance.binding
+    end
+    # Copy the instance variable names and values from given
+    # from_action#instance into the Action#variables of the action this method
+    # is called on.
+    #
+    # @param [Action #instance] from_action
+    # @return [Action] from_action
+    # @see Action#wrap_in_layout
+    # @api unstable
+    # @author manveru
+    def sync_variables(from_action)
+      instance = from_action.instance
+      instance.instance_variables.each{|iv|
+        iv_value = instance.instance_variable_get(iv)
+        iv_name = iv.to_s[1..-1]
+        self.variables[iv_name.to_sym] = iv_value
+      }
+      from_action
+    end
+    COPY_VARIABLES = '
+      STATE[:action_variables].each do |iv, value|
+        instance_variable_set("@#{iv}", value)
+      end'.strip.freeze
+    # Copy Action#variables as instance variables into the given binding.
+    #
+    # This relies on Innate::STATE, so should be thread-safe and doesn't depend
+    # on Innate::Current::actions order.
+    # So we avoid nasty business with Objectspace#_id2ref which may not work on
+    # all ruby implementations and seems to cause other problems as well.
+    #
+    # @param [Binding #eval] binding
+    # @return [NilClass] there is no indication of failure or success
+    # @see View::ERB::render
+    # @author manveru
+    def copy_variables(binding = self.binding)
+      return unless variables.any?
+      STATE.sync do
+        STATE[:action_variables] = self.variables
+        eval(COPY_VARIABLES, binding)
+        STATE[:action_variables] = nil
+      end
+    end
+    def render
+      self.instance = node.new
+      self.variables[:content] ||= nil
+      instance.wrap_action_call(self) do
+        copy_variables # this might need another position after all
+        self.method_value = instance.__send__(method, *params) if method
+        self.view_value = ::File.read(view) if view
+        body, content_type = wrap_in_layout{
+          engine.call(self, view_value || method_value || '') }
+        options[:content_type] ||= content_type if content_type
+        body
+      end
+    end
+    def wrap_in_layout
+      return yield unless layout
+      action = dup
+      action.view, action.method = layout_view_or_method(*layout)
+      action.layout = nil
+      action.view_value = nil
+      action.sync_variables(self)
+      body, content_type = yield
+      action.variables[:content] = body
+      return action.call, content_type
+    end
+    def layout_view_or_method(name, arg)
+      [:layout, :view].include?(name) ? [arg, nil] : [nil, arg]
+    end
+    def wrap_in_current
+      Current.actions << self
+      yield
+    ensure
+      Current.actions.delete(self)
+    end
+    # Try to figure out a sane name for current action.
+    def name
+      File.basename((method || view).to_s).split('.').first
+    end
+    # Path to this action, including params, with the mapping of the current
+    # controller prepended.
+    def full_path
+      File.join(node.mapping, path)
+    end
+    def valid?
+      node.needs_method? ? (method && view) : (method || view)
+    end
+  end
+end