RubyGems - rjspotter-innate - Versions diffs - 2009.06.29 - Mend

rjspotter-innate 2009.06.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (128) hide show

data/AUTHORS +10 -0
data/CHANGELOG +3261 -0
data/COPYING +18 -0
data/MANIFEST +127 -0
data/README.md +563 -0
data/Rakefile +39 -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 +41 -0
data/lib/innate.rb +269 -0
data/lib/innate/action.rb +137 -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 +44 -0
data/lib/innate/cache/marshal.rb +20 -0
data/lib/innate/cache/memory.rb +21 -0
data/lib/innate/cache/yaml.rb +20 -0
data/lib/innate/current.rb +35 -0
data/lib/innate/dynamap.rb +96 -0
data/lib/innate/helper.rb +185 -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 +152 -0
data/lib/innate/helper/send_file.rb +26 -0
data/lib/innate/log.rb +20 -0
data/lib/innate/log/color_formatter.rb +49 -0
data/lib/innate/log/hub.rb +77 -0
data/lib/innate/middleware_compiler.rb +65 -0
data/lib/innate/mock.rb +49 -0
data/lib/innate/node.rb +1029 -0
data/lib/innate/options.rb +37 -0
data/lib/innate/options/dsl.rb +205 -0
data/lib/innate/options/stub.rb +7 -0
data/lib/innate/request.rb +141 -0
data/lib/innate/response.rb +24 -0
data/lib/innate/route.rb +114 -0
data/lib/innate/session.rb +133 -0
data/lib/innate/session/flash.rb +94 -0
data/lib/innate/spec.rb +1 -0
data/lib/innate/spec/bacon.rb +28 -0
data/lib/innate/state.rb +26 -0
data/lib/innate/state/accessor.rb +130 -0
data/lib/innate/traited.rb +90 -0
data/lib/innate/trinity.rb +18 -0
data/lib/innate/version.rb +3 -0
data/lib/innate/view.rb +97 -0
data/lib/innate/view/erb.rb +14 -0
data/lib/innate/view/etanni.rb +33 -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 +121 -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 +115 -0
data/spec/innate/helper/link.rb +139 -0
data/spec/innate/helper/redirect.rb +171 -0
data/spec/innate/helper/render.rb +165 -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/modes.rb +61 -0
data/spec/innate/node/mapping.rb +37 -0
data/spec/innate/node/node.rb +135 -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 +123 -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 +79 -0
data/spec/innate/route.rb +135 -0
data/spec/innate/session.rb +58 -0
data/spec/innate/traited.rb +55 -0
data/tasks/authors.rake +30 -0
data/tasks/bacon.rake +66 -0
data/tasks/changelog.rake +18 -0
data/tasks/gem.rake +22 -0
data/tasks/gem_setup.rake +99 -0
data/tasks/grancher.rake +12 -0
data/tasks/manifest.rake +4 -0
data/tasks/rcov.rake +19 -0
data/tasks/release.rake +53 -0
data/tasks/reversion.rake +8 -0
data/tasks/setup.rake +6 -0
data/tasks/ycov.rake +84 -0
metadata +218 -0

data/example/link.rb ADDED

@@ -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,41 @@
+# -*- encoding: utf-8 -*-
+Gem::Specification.new do |s|
+  s.name = %q{innate}
+  s.version = "2009.06.29"
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael 'manveru' Fellinger"]
+  s.date = %q{2009-06-30}
+  s.description = %q{Simple, straight-forward base for web-frameworks.}
+  s.email = %q{m.fellinger@gmail.com}
+  s.files = ["AUTHORS", "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/spec/bacon.rb", "lib/innate/state.rb", "lib/innate/state/accessor.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/modes.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/traited.rb", "tasks/authors.rake", "tasks/bacon.rake", "tasks/changelog.rake", "tasks/gem.rake", "tasks/gem_setup.rake", "tasks/grancher.rake", "tasks/manifest.rake", "tasks/rcov.rake", "tasks/release.rake", "tasks/reversion.rake", "tasks/setup.rake", "tasks/ycov.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.1}
+  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 = 2
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rack>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<bacon>, [">= 1.1.0"])
+      s.add_development_dependency(%q<json>, ["~> 1.1.6"])
+      s.add_development_dependency(%q<rack-test>, [">= 0.3.0"])
+    else
+      s.add_dependency(%q<rack>, ["~> 1.0.0"])
+      s.add_dependency(%q<bacon>, [">= 1.1.0"])
+      s.add_dependency(%q<json>, ["~> 1.1.6"])
+      s.add_dependency(%q<rack-test>, [">= 0.3.0"])
+    end
+  else
+    s.add_dependency(%q<rack>, ["~> 1.0.0"])
+    s.add_dependency(%q<bacon>, [">= 1.1.0"])
+    s.add_dependency(%q<json>, ["~> 1.1.6"])
+    s.add_dependency(%q<rack-test>, [">= 0.3.0"])
+  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 'digest/sha1'
+  require 'digest/sha2'
+  require 'find'
+  require 'ipaddr'
+  require 'logger'
+  require 'pathname'
+  require 'pp'
+  require 'set'
+  require 'socket'
+  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::Head, Rack::ContentLength, Rack::CommonLogger,
+           Rack::ShowExceptions, Rack::ShowStatus, Rack::ConditionalGet)
+    m.use(Rack::Reloader, 2)
+    m.innate
+  end
+  middleware :live do |m|
+    m.apps(Rack::Head, Rack::ContentLength, Rack::CommonLogger,
+           Rack::ShowStatus, Rack::ConditionalGet)
+    m.innate
+  end
+end

data/lib/innate/action.rb ADDED

@@ -0,0 +1,137 @@
+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 Action#variables as instance variables into the given object.
+    # Defaults to copying the variables to self.
+    #
+    # @param [Object #instance_variable_set] object
+    # @return [NilClass] there is no indication of failure or success
+    # @see Action#render
+    # @author manveru
+    def copy_variables(object)
+      self.variables.each do |iv, value|
+        object.instance_variable_set("@#{iv}", value)
+      end
+    end
+    def render
+      self.instance = node.new
+      self.variables[:content] ||= nil
+      instance.wrap_action_call(self) do
+        copy_variables(self.instance) # this might need another position
+        self.method_value = instance.__send__(method, *params) if method
+        self.view_value = View.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.params = []
+      action.layout = nil
+      action.view_value = nil
+      action.sync_variables(self)
+      body, content_type = yield
+      action.sync_variables(self)
+      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