rsence 2.0.0.5.pre → 2.0.0.6.pre

data/lib/conf/default.rb

@@ -1,5 +1,5 @@
 #--
-##   Riassence Framework
+##   RSence
  #   Copyright 2008 Riassence Inc.
  #   http://riassence.com/
  #
@@ -13,7 +13,13 @@ require 'rack'
 require 'yaml'
 
 if RUBY_VERSION.to_f >= 1.9
-  Encoding.default_external = Encoding::ASCII_8BIT
+  # Encoding.default_external = Encoding::BINARY
+  # Encoding.default_internal = Encoding::BINARY
+  class String
+    def each 
+      self.split($/).each { |e| yield e } 
+    end 
+  end
 end
 
 # Legacy:
@@ -193,12 +199,17 @@ class Configuration
         config[:broker_urls][broker_key] = default_uri
       end
     end
-    
+    # if RUBY_VERSION.to_f >= 1.9
+    #   config[:no_gzip] = true
+    # end
     # The default address of the index_html plugin
     unless config[:index_html].has_key?(:respond_address)
       config[:index_html][:respond_address] = File.join(config[:base_url])
     end
     
+    config[:client_pkg][:no_obfuscation] = true if args[:client_pkg_no_obfuscation]
+    config[:client_pkg][:no_whitespace_removal] = true if args[:client_pkg_no_whitespace_removal]
+    
     ## Uses the lib paths as search paths
     lib_paths.each do |lib_path|
       $LOAD_PATH << lib_path

data/lib/daemon/daemon.rb

@@ -1,5 +1,5 @@
 #--
-##   Riassence Framework
+##   RSence
  #   Copyright 2008 Riassence Inc.
  #   http://riassence.com/
  #

data/lib/daemon/sigcomm.rb

@@ -1,5 +1,5 @@
 #--
-##   Riassence Framework
+##   RSence
  #   Copyright 2010 Riassence Inc.
  #   http://riassence.com/
  #

data/lib/http/broker.rb

@@ -1,5 +1,5 @@
 #--
-##   Riassence Framework
+##   RSence
  #   Copyright 2008 Riassence Inc.
  #   http://riassence.com/
  #
@@ -47,7 +47,9 @@ class Broker
     dispatcher = dispatcher_class.new( request, response )
     dispatcher.send(request_method)
     content_type = dispatcher.content_type
+    # puts "encoding: #{response.body.encoding.inspect}"
     response.header['Content-Length'] = response.body.length.to_s unless response.header.has_key?('Content-Length')
+    # puts [response.status, response.header, response.body].inspect
     return [response.status, response.header, response.body]
   end
   
@@ -71,7 +73,9 @@ class Broker
     end
     Thread.new do
       Thread.pass
+      puts "testing port.. #{host.inspect}"
       until RSence.argv.test_port( port, host )
+        puts "port tested"
         sleep 0.1
       end
       @@transporter.online = true

data/lib/http/rackup.rb

@@ -1,5 +1,5 @@
 #--
-##   Riassence Framework
+##   RSence
  #   Copyright 2008 Riassence Inc.
  #   http://riassence.com/
  #

data/lib/http/request.rb

@@ -1,5 +1,5 @@
 #--
-##   Riassence Framework
+##   RSence
  #   Copyright 2008 Riassence Inc.
  #   http://riassence.com/
  #

data/lib/http/response.rb

@@ -1,5 +1,5 @@
 #--
-##   Riassence Framework
+##   RSence
  #   Copyright 2008 Riassence Inc.
  #   http://riassence.com/
  #
@@ -26,7 +26,7 @@ class Response
     @status = 200
     @header = {
       'Content-Type' => 'text/plain',
-      'Server' => 'Riassence Framework'
+      'Server' => 'RSence'
     }
   end
   def body=(body_data)

data/lib/plugins/dependencies.rb

@@ -0,0 +1,36 @@
+##   RSence
+ #   Copyright 2010 Riassence Inc.
+ #   http://riassence.com/
+ #
+ #   You should have received a copy of the GNU General Public License along
+ #   with this software package. If not, contact licensing@riassence.com
+ ##
+
+module RSence
+  class Dependencies
+    def initialize( deps = [] )
+      @deps = deps
+      @depends_on = {
+        # :name => [ :dep1, :dep2, :dep3, ... ]
+      }
+      # ...additional initialization?
+    end
+    def set_deps( name, deps )
+      if not @depends_on.has_key?(name)
+        @depends_on[name] = deps
+      else
+        @depends_on[name].join( deps )
+      end
+      # ...additional checks?
+    end
+    alias set_dependencies set_deps
+    def deps
+      # calculate @depends_on and push items with
+      # resolved dependencies into @deps
+      # ...
+      return @deps
+    end
+    alias deps load_order
+  end
+end
+

data/lib/plugins/gui_plugin.rb

@@ -1,4 +1,4 @@
-##   Riassence Framework
+##   RSence
  #   Copyright 2009 Riassence Inc.
  #   http://riassence.com/
  #
@@ -26,104 +26,107 @@
 ##
 ##
 ##
-class GUIPlugin < Plugin
+module ::RSence
+  module Plugins
+    class GUIPluginTemplate < PluginTemplate
+      def self.bundle_type; :GUIPlugin; end
   
-  @@default_yaml_src = %{
+      @@default_yaml_src = <<-END
 type: GUITree
-version: 0.5
+version: 0.6
 
 class: HApplication
 options:
   label: "Dummy Application"
-}
+
+      END
   
-  # Automatically initializes an GUIParser instance as @gui
-  def init
-    super
-    yaml_src = file_read( "gui/#{@name}.yaml" )
-    yaml_src = file_read( "gui/main.yaml" ) unless yaml_src
-    yaml_src = @@default_yaml_src unless yaml_src
-    @gui = GUIParser.new( self, yaml_src )
-    @client_pkgs = false
-  end
+      # Automatically initializes an GUIParser instance as @gui
+      def init
+        super
+        yaml_src = file_read( "gui/#{@name}.yaml" )
+        yaml_src = file_read( "gui/main.yaml" ) unless yaml_src
+        yaml_src = @@default_yaml_src unless yaml_src
+        @gui = GUIParser.new( self, yaml_src )
+        @client_pkgs = false
+      end
   
-  # Extend this method to return custom params to GUIParser#init.
-  # Called from init_ui.
-  # By default assigns the session values as :values to use for 
-  # valueObjId: ":values.my_value_name" in the YAML GUI file.
-  def gui_params( msg )
-    return {
-      :values => @gui.values( get_ses( msg ) )
-    }
-  end
+      # Extend this method to return custom params to GUIParser#init.
+      # Called from init_ui.
+      # By default assigns the session values as :values to use for 
+      # valueObjId: ":values.my_value_name" in the YAML GUI file.
+      def gui_params( msg )
+        return {
+          :values => @gui.values( get_ses( msg ) )
+        }
+      end
   
-  def install_client_pkgs
-    if @client_pkgs
-      warn "install_client_pkgs: called with @client_pkgs defined; returning"
-      return
-    end
-    @client_pkgs = yaml_read( 'client_pkgs.yaml' )
-    if @client_pkgs
-      if @client_pkgs.has_key?(:src_dirs)
-        @client_pkgs[:src_dirs].each do |src_dir|
-          src_dir = bundle_path( src_dir[2..-1] ) if src_dir.start_with?('./')
-          @plugins.client_pkg.add_src_dir( src_dir )
+      def install_client_pkgs
+        if @client_pkgs
+          warn "install_client_pkgs: called with @client_pkgs defined; returning"
+          return
+        end
+        @client_pkgs = yaml_read( 'client_pkgs.yaml' )
+        if @client_pkgs
+          if @client_pkgs.has_key?(:src_dirs)
+            @client_pkgs[:src_dirs].each do |src_dir|
+              src_dir = bundle_path( src_dir[2..-1] ) if src_dir.start_with?('./')
+              @plugins.client_pkg.add_src_dir( src_dir )
+            end
+          end
+          @plugins.client_pkg.add_packages(       @client_pkgs[:packages      ] ) if @client_pkgs.has_key?(:packages      )
+          @plugins.client_pkg.add_themes(         @client_pkgs[:theme_names   ] ) if @client_pkgs.has_key?(:theme_names   )
+          @plugins.client_pkg.add_gfx_formats(    @client_pkgs[:gfx_formats   ] ) if @client_pkgs.has_key?(:gfx_formats   )
+          @plugins.client_pkg.add_reserved_names( @client_pkgs[:reserved_names] ) if @client_pkgs.has_key?(:reserved_names)
+          @plugins.client_pkg.rebuild_client
         end
       end
-      @plugins.client_pkg.add_packages(       @client_pkgs[:packages      ] ) if @client_pkgs.has_key?(:packages      )
-      @plugins.client_pkg.add_themes(         @client_pkgs[:theme_names   ] ) if @client_pkgs.has_key?(:theme_names   )
-      @plugins.client_pkg.add_gfx_formats(    @client_pkgs[:gfx_formats   ] ) if @client_pkgs.has_key?(:gfx_formats   )
-      @plugins.client_pkg.add_reserved_names( @client_pkgs[:reserved_names] ) if @client_pkgs.has_key?(:reserved_names)
-      @plugins.client_pkg.rebuild_client
-    end
-  end
   
-  def uninstall_client_pkgs
-    if not @client_pkgs
-      warn "uninstall_client_pkgs: called without @client_pkgs defined"
-    else
-      if @client_pkgs.has_key?(:src_dirs)
-        @client_pkgs[:src_dirs].each do |src_dir|
-          src_dir = bundle_path( src_dir[2..-1] ) if src_dir.start_with?('./')
-          @plugins.client_pkg.del_src_dir( src_dir )
+      def uninstall_client_pkgs
+        if not @client_pkgs
+          warn "uninstall_client_pkgs: called without @client_pkgs defined"
+        else
+          if @client_pkgs.has_key?(:src_dirs)
+            @client_pkgs[:src_dirs].each do |src_dir|
+              src_dir = bundle_path( src_dir[2..-1] ) if src_dir.start_with?('./')
+              @plugins.client_pkg.del_src_dir( src_dir )
+            end
+          end
+          @plugins.client_pkg.del_reserved_names( @client_pkgs[:reserved_names] ) if @client_pkgs.has_key?(:reserved_names)
+          @plugins.client_pkg.del_gfx_formats(    @client_pkgs[:gfx_formats   ] ) if @client_pkgs.has_key?(:gfx_formats   )
+          @plugins.client_pkg.del_themes(         @client_pkgs[:theme_names   ] ) if @client_pkgs.has_key?(:theme_names   )
+          @plugins.client_pkg.del_packages(       @client_pkgs[:packages].keys  ) if @client_pkgs.has_key?(:packages      )
+          @plugins.client_pkg.rebuild_client
         end
+        @client_pkgs = false
       end
-      @plugins.client_pkg.del_reserved_names( @client_pkgs[:reserved_names] ) if @client_pkgs.has_key?(:reserved_names)
-      @plugins.client_pkg.del_gfx_formats(    @client_pkgs[:gfx_formats   ] ) if @client_pkgs.has_key?(:gfx_formats   )
-      @plugins.client_pkg.del_themes(         @client_pkgs[:theme_names   ] ) if @client_pkgs.has_key?(:theme_names   )
-      @plugins.client_pkg.del_packages(       @client_pkgs[:packages].keys  ) if @client_pkgs.has_key?(:packages      )
-      @plugins.client_pkg.rebuild_client
-    end
-    @client_pkgs = false
-  end
   
-  def open
-    super
-    install_client_pkgs if File.exist? bundle_path( 'client_pkgs.yaml' )
-  end
-  
-  def close
-    super
-    uninstall_client_pkgs if @client_pkgs
-  end
+      def open
+        super
+        install_client_pkgs if File.exist? bundle_path( 'client_pkgs.yaml' )
+      end
   
-  # Sends gui specification to the main plugin
-  def spec_ui( msg )
-    # TODO
-  end
+      def close
+        super
+        uninstall_client_pkgs if @client_pkgs
+      end
   
-  # Automatically inits the UI using GUIParser#init.
-  # Passes on the return value of gui_params.
-  def init_ui( msg ); @gui.init( msg, gui_params( msg ) ); end
+      # Sends gui specification to the main plugin
+      def spec_ui( msg )
+        # TODO
+      end
   
-  # Automatically kills the UI using GUIParser#kill
-  def kill_ui( msg ); @gui.kill( msg ); end
+      # Automatically inits the UI using GUIParser#init.
+      # Passes on the return value of gui_params.
+      def init_ui( msg ); @gui.init( msg, gui_params( msg ) ); end
   
-  # Makes include_js public to enable calls to it from GUIParser
-  public :include_js, :read_js_once
+      # Automatically kills the UI using GUIParser#kill
+      def kill_ui( msg ); @gui.kill( msg ); end
   
-  attr_reader :plugins
+      # Makes include_js public to enable calls to it from GUIParser
+      public :include_js, :read_js_once
   
+      attr_reader :plugins
+    end
+  end
 end
-
-

data/lib/plugins/guiparser.rb

@@ -1,4 +1,4 @@
-##   Riassence Framework
+##   RSence
  #   Copyright 2009 Riassence Inc.
  #   http://riassence.com/
  #
@@ -6,6 +6,8 @@
  #   with this software package. If not, contact licensing@riassence.com
  ##
 
+module ::RSence
+module Plugins
 # This class automatically loads a YAML file from "gui" subdirectory of a plugin.
 # Extend your plugin from the GUIPlugin class instead of the Plugin class to make
 # this work automatically.
@@ -38,7 +40,8 @@ class GUIParser
       end
     end
     gui_name = @parent.name
-    msg.reply( "JSONRenderer.nu(#{gui_data.to_json});", true )
+    json_data = JSON.dump( gui_data )
+    msg.reply( "JSONRenderer.nu(#{json_data});", true )
   end
   
   # Use this method to extract all the value id's of the +ses+ hash.
@@ -111,4 +114,5 @@ private
   end
 
 end
-
+end
+end

data/lib/plugins/plugin.rb

@@ -1,4 +1,4 @@
-##   Riassence Framework
+##   RSence
  #   Copyright 2006 Riassence Inc.
  #   http://riassence.com/
  #
@@ -298,355 +298,356 @@
 ##    end
 ##    SessionLogger.new.register( 'ses_logger' )
 ##
-class Plugin
+module ::RSence
+  module Plugins
+    class PluginTemplate
+      include PluginUtil
+      def self.bundle_type; :Plugin; end
   
-  include PluginUtil
+      # The +names+ is a list of (usually just one) names the plugin is registered under.
+      attr_reader :name, :path, :info, :inited
   
-  # The +names+ is a list of (usually just one) names the plugin is registered under.
-  attr_reader :name, :path, :info, :inited
-  
-  # The constructor should not take any parameters. In most cases, it's better
-  # to extend the +#init+ method, because it's called after the plugin is set up.
-  def initialize
-    @inited  = false
-    @info    = @@bundle_info
-    @name    = @@bundle_name
-    @path    = @@bundle_path
-    @plugins = @@plugin_manager
-    register unless @info[:inits_self]
-  end
-  
-  # Extend this method to do any initial tasks before other methods are called.
-  # By default init_values is called to load the +values.yaml+ configuration file.
-  def init
-    @values = init_values
-  end
-  
-  # Extend this method to do any tasks every time the client makes a request.
-  def idle( msg )
-  end
+      # The constructor should not take any parameters. In most cases, it's better
+      # to extend the +#init+ method, because it's called after the plugin is set up.
+      def initialize( bundle_name, bundle_info, bundle_path, plugin_manager )
+        @inited  = false
+        @info    = bundle_info
+        @name    = bundle_name
+        @path    = bundle_path
+        @plugins = plugin_manager
+        register unless @info[:inits_self]
+      end
   
-  # Extend this method to invoke actions, when a new session is created.
-  # By default +#init_ses_values+ is called to initialize values defined in the 
-  # +values.yaml+ configuration file.
-  def init_ses( msg )
-    init_ses_values( msg )
-  end
+      # Extend this method to do any initial tasks before other methods are called.
+      # By default init_values is called to load the +values.yaml+ configuration file.
+      def init
+        @values = init_values
+      end
   
-  # Extend this method to invoke actions, when a previous session is restored.
-  # By default +#restore_ses_values+ is called to perform actions on values as
-  # defined in the +values.yaml+ configuration file.
-  def restore_ses( msg )
-    restore_ses_values( msg )
-  end
+      # Extend this method to do any tasks every time the client makes a request.
+      def idle( msg )
+      end
   
-  # Extend this method to invoke actions, when the session
-  # is a clone of another session. It's called once, just
-  # before +#restore_ses+ is called.
-  #
-  # A session is cloned, when a user opens a another browser
-  # window or tab, while the previous session is still active.
-  #
-  # The +source_ses+ is the actual previous session object, which
-  # was used as the source of the clone.
-  def cloned_target( msg, source_session )
-  end
+      # Extend this method to invoke actions, when a new session is created.
+      # By default +#init_ses_values+ is called to initialize values defined in the 
+      # +values.yaml+ configuration file.
+      def init_ses( msg )
+        init_ses_values( msg )
+      end
   
-  # Extend this method to invoke actions, when the session
-  # has been cloned to another session. It's called once, just
-  # before +#restore_ses+ is called on the first request after
-  # the cloning happened.
-  #
-  # A session is cloned, when a user opens a another browser
-  # window or tab, while the previous session is still active.
-  #
-  # The +target_ses+ is the actual cloned session object, which
-  # is a copy of the current session.
-  def cloned_source( msg, target_sessions )
-  end
+      # Extend this method to invoke actions, when a previous session is restored.
+      # By default +#restore_ses_values+ is called to perform actions on values as
+      # defined in the +values.yaml+ configuration file.
+      def restore_ses( msg )
+        restore_ses_values( msg )
+      end
   
-  # This method must be called to register the plugin instance
-  # into the system. Otherwise, it's subject to destruction
-  # and garbage collection. Use the +name+ parameter to 
-  # give the (unique) name of your plugin.
-  def register( name=false )
-    if @inited
-      @plugins.register_alias( @name, name )
-    else
-      if name
-        name = name.to_s
-      else
-        name = @name
+      # Extend this method to invoke actions, when the session
+      # is a clone of another session. It's called once, just
+      # before +#restore_ses+ is called.
+      #
+      # A session is cloned, when a user opens a another browser
+      # window or tab, while the previous session is still active.
+      #
+      # The +source_ses+ is the actual previous session object, which
+      # was used as the source of the clone.
+      def cloned_target( msg, source_session )
       end
-      @plugins.register_bundle( self, name )
-      @inited = true
-    end
-  end
   
-private
+      # Extend this method to invoke actions, when the session
+      # has been cloned to another session. It's called once, just
+      # before +#restore_ses+ is called on the first request after
+      # the cloning happened.
+      #
+      # A session is cloned, when a user opens a another browser
+      # window or tab, while the previous session is still active.
+      #
+      # The +target_ses+ is the actual cloned session object, which
+      # is a copy of the current session.
+      def cloned_source( msg, target_sessions )
+      end
   
-  # This method looks looks for a file called "values.yaml"
-  # in the plugin's bundle directory
-  #.
-  # If this file is found, it loads it for initial value definitions.
-  #
-  # These definitions are accessible as the +@values+ attribute.
-  def init_values
-    values_path = compose_plugin_path( 'values.yaml' )
-    return yaml_read( values_path )
-  end
+      # This method must be called to register the plugin instance
+      # into the system. Otherwise, it's subject to destruction
+      # and garbage collection. Use the +name+ parameter to 
+      # give the (unique) name of your plugin.
+      def register( name=false )
+        if @inited
+          @plugins.register_alias( @name, name )
+        else
+          if name
+            name = name.to_s
+          else
+            name = @name
+          end
+          @plugins.register_bundle( self, name )
+          @inited = true
+        end
+      end
   
-  # Returns all the names your plugin respond to.
-  # def name
-  #   return @names.first
-  # end
+    private
   
+      # This method looks looks for a file called "values.yaml"
+      # in the plugin's bundle directory
+      #.
+      # If this file is found, it loads it for initial value definitions.
+      #
+      # These definitions are accessible as the +@values+ attribute.
+      def init_values
+        values_path = compose_plugin_path( 'values.yaml' )
+        return yaml_read( values_path )
+      end
   
-  # Returns or creates a new session hash for the plugin.
-  #
-  # Uses the first name registered for the plugin and converts it to a symbol.
-  def get_ses( msg )
-    name_sym = name.to_sym
-    unless msg.session.has_key?( name_sym )
-      msg.session[ name_sym ] = {}
-    end
-    return msg.session[ name_sym ]
-  end
+      # Returns all the names your plugin respond to.
+      # def name
+      #   return @names.first
+      # end
   
-  # Returns the source code of the javascript file +name+ in the 'js'
-  # subdirectory of the plugin bundle.
-  def read_js( js_name )
-    file_read( compose_plugin_path( js_name, 'js', '.js' ) )
-  end
   
-  # Deprecated name of +#read_js+
-  alias require_js read_js
+      # Returns or creates a new session hash for the plugin.
+      #
+      # Uses the first name registered for the plugin and converts it to a symbol.
+      def get_ses( msg )
+        name_sym = name.to_sym
+        unless msg.session.has_key?( name_sym )
+          msg.session[ name_sym ] = {}
+        end
+        return msg.session[ name_sym ]
+      end
   
-  # Like +#read_js+, but reads the file only once per session.
-  #
-  # Returns the contents of the file on the first call,
-  # an empty string on the subsequent calls.
-  #
-  # Returns false otherwise.
-  def read_js_once( msg, js_name )
-    ses = msg.session
-    if not ses.has_key?(:deps)
-      ses[:deps] = []
-    end
-    path = compose_plugin_path( js_name, 'js', '.js' )
-    unless ses[:deps].include?( path )
-      ses[:deps].push( path )
-      return file_read( path )
-    else
-      return ''
-    end
-  end
+      # Returns the source code of the javascript file +name+ in the 'js'
+      # subdirectory of the plugin bundle.
+      def read_js( js_name )
+        file_read( compose_plugin_path( js_name, 'js', '.js' ) )
+      end
   
-  # Deprecated name of +#read_js_once+
-  alias require_js_once read_js_once
+      # Deprecated name of +#read_js+
+      alias require_js read_js
   
-  # Creates a new instance of HValue, assigns it as +value_name+ into the
-  # session and uses the +value_properties+ Hash to define the default
-  # value and value responders.
-  #
-  # This method is invoked automatically, when handling the properties
-  # of the +values.yaml+ configuration file of a new session.
-  #
-  # It's invoked by +#init_ses+ via +#init_ses_values+.
-  #
-  # Structure of +value_properties+, all top-level items are optional:
-  #
-  #   {
-  #     # Default value; defaults to 0
-  #     :value => 'foo',
-  #     
-  #     # A plugin method to call to define the default value instead of the one defined in :value
-  #     :value_call => {
-  #       :plugin => 'plugin_name', # defaults to the plugin where defined
-  #       :method => 'method_name', # mandatory; name of the method to call
-  #       :args => [ 1, 'foo', 3 ], # optional, list of parameter values for the :method
-  #       :uses_msg => true         # defaults to true; when false, doesn't pass the msg as the first parameter
-  #     },
-  #     
-  #     # Restore the default, when the session is restored; defaults to false
-  #     :restore_default => false,
-  #     
-  #     # List of value responder methods to bind.
-  #     :responders => [
-  #        {
-  #          :plugin => 'plugin_name', # defaults to the plugin where defined
-  #          :method => 'method_name'  # mandatory, name of the method to call
-  #        },
-  #        # You can supply as many responders as you like:
-  #        { :plugin => 'another_plugin', :method => 'another_method' }
-  #     ]
-  #   }
-  #
-  def init_ses_value( msg, value_name, value_properties )
-    ses = get_ses( msg )
-    if value_properties.has_key?(:value_call)
-      default_value = init_value_call( msg, value_properties[:value_call] )
-    elsif value_properties.has_key?(:value)
-      default_value = value_properties[:value]
-    else
-      default_value = 0
-    end
-    ses[value_name] = HValue.new( msg, default_value )
-    if value_properties.has_key?(:responders)
-      value_properties[:responders].each do |responder|
-        if responder.has_key?(:plugin)
-          responder_plugin = responder[:plugin]
-        else
-          responder_plugin = @name
+      # Like +#read_js+, but reads the file only once per session.
+      #
+      # Returns the contents of the file on the first call,
+      # an empty string on the subsequent calls.
+      #
+      # Returns false otherwise.
+      def read_js_once( msg, js_name )
+        ses = msg.session
+        if not ses.has_key?(:deps)
+          ses[:deps] = []
         end
-        if responder.has_key?(:method)
-          ses[value_name].bind( responder_plugin, responder[:method] )
+        path = compose_plugin_path( js_name, 'js', '.js' )
+        unless ses[:deps].include?( path )
+          ses[:deps].push( path )
+          return file_read( path )
+        else
+          return ''
         end
       end
-    end
-  end
   
-  # Initializes session values, if the contents of the +values.yaml+ 
-  # file is defined in the bundle directory and loaded in +#init_values+.
-  def init_ses_values( msg )
-    return unless @values
-    @values.each do | value_name, value_properties |
-      init_ses_value( msg, value_name, value_properties )
-    end
-  end
+      # Deprecated name of +#read_js_once+
+      alias require_js_once read_js_once
   
-  # Returns a value based on the :method and :plugin members of the
-  # +value_call+ hash.
-  #
-  # The call is made via msg.run if the method is not defined in
-  # the local plugin bundle.
-  #
-  # This method is called from +#init_ses_value+.
-  #
-  # Structure of the +value_call+ Hash:
-  #   { :plugin => 'plugin_name', # defaults to the plugin where defined
-  #     :method => 'method_name', # mandatory; name of the method to call
-  #     :args => [ 1, 'foo', 3 ], # optional, list of parameter values for the :method
-  #     :uses_msg => true         # defaults to true; when false, doesn't pass the msg as the first parameter
-  #   }
-  def init_value_call( msg, value_call )
-    value_call_method = value_call[:method]
-    if value_call.has_key?(:plugin)
-      value_call_plugin = value_call[:plugin]
-    else
-      value_call_plugin = false
-    end
-    if value_call.has_key?(:args)
-      if value_call.has_key?(:uses_msg) and value_call[:uses_msg] != false
-        if value_call_plugin
-          return msg.run( value_call_plugin, value_call_method, msg, *value_call[:args] )
+      # Creates a new instance of HValue, assigns it as +value_name+ into the
+      # session and uses the +value_properties+ Hash to define the default
+      # value and value responders.
+      #
+      # This method is invoked automatically, when handling the properties
+      # of the +values.yaml+ configuration file of a new session.
+      #
+      # It's invoked by +#init_ses+ via +#init_ses_values+.
+      #
+      # Structure of +value_properties+, all top-level items are optional:
+      #
+      #   {
+      #     # Default value; defaults to 0
+      #     :value => 'foo',
+      #     
+      #     # A plugin method to call to define the default value instead of the one defined in :value
+      #     :value_call => {
+      #       :plugin => 'plugin_name', # defaults to the plugin where defined
+      #       :method => 'method_name', # mandatory; name of the method to call
+      #       :args => [ 1, 'foo', 3 ], # optional, list of parameter values for the :method
+      #       :uses_msg => true         # defaults to true; when false, doesn't pass the msg as the first parameter
+      #     },
+      #     
+      #     # Restore the default, when the session is restored; defaults to false
+      #     :restore_default => false,
+      #     
+      #     # List of value responder methods to bind.
+      #     :responders => [
+      #        {
+      #          :plugin => 'plugin_name', # defaults to the plugin where defined
+      #          :method => 'method_name'  # mandatory, name of the method to call
+      #        },
+      #        # You can supply as many responders as you like:
+      #        { :plugin => 'another_plugin', :method => 'another_method' }
+      #     ]
+      #   }
+      #
+      def init_ses_value( msg, value_name, value_properties )
+        ses = get_ses( msg )
+        if value_properties.has_key?(:value_call)
+          default_value = init_value_call( msg, value_properties[:value_call] )
+        elsif value_properties.has_key?(:value)
+          default_value = value_properties[:value]
         else
-          return self.method( value_call_method ).call( msg, *value_call[:args] )
+          default_value = 0
         end
-      else
-        if value_call_plugin
-          return msg.run( value_call_plugin, value_call_method, *value_call[:args] )
-        else
-          return self.method( value_call_method ).call( *value_call[:args] )
+        ses[value_name] = HValue.new( msg, default_value, { :name => "#{@name}.#{value_name}" } )
+        if value_properties.has_key?(:responders)
+          value_properties[:responders].each do |responder|
+            if responder.has_key?(:plugin)
+              responder_plugin = responder[:plugin]
+            else
+              responder_plugin = @name
+            end
+            if responder.has_key?(:method)
+              ses[value_name].bind( responder_plugin, responder[:method] )
+            end
+          end
+        end
+      end
+  
+      # Initializes session values, if the contents of the +values.yaml+ 
+      # file is defined in the bundle directory and loaded in +#init_values+.
+      def init_ses_values( msg )
+        return unless @values
+        @values.each do | value_name, value_properties |
+          init_ses_value( msg, value_name, value_properties )
         end
       end
-    else
-      if value_call.has_key?(:uses_msg) and value_call[:uses_msg] != false
-        if value_call_plugin
-          return msg.run( value_call_plugin, value_call_method, msg )
+  
+      # Returns a value based on the :method and :plugin members of the
+      # +value_call+ hash.
+      #
+      # The call is made via msg.run if the method is not defined in
+      # the local plugin bundle.
+      #
+      # This method is called from +#init_ses_value+.
+      #
+      # Structure of the +value_call+ Hash:
+      #   { :plugin => 'plugin_name', # defaults to the plugin where defined
+      #     :method => 'method_name', # mandatory; name of the method to call
+      #     :args => [ 1, 'foo', 3 ], # optional, list of parameter values for the :method
+      #     :uses_msg => true         # defaults to true; when false, doesn't pass the msg as the first parameter
+      #   }
+      def init_value_call( msg, value_call )
+        value_call_method = value_call[:method]
+        if value_call.has_key?(:plugin)
+          value_call_plugin = value_call[:plugin]
         else
-          return self.method( value_call_method ).call( msg )
+          value_call_plugin = false
         end
-      else
-        if value_call_plugin
-          return msg.run( value_call_plugin, value_call_method )
+        if value_call.has_key?(:args)
+          if value_call.has_key?(:uses_msg) and value_call[:uses_msg] != false
+            if value_call_plugin
+              return msg.run( value_call_plugin, value_call_method, msg, *value_call[:args] )
+            else
+              return self.method( value_call_method ).call( msg, *value_call[:args] )
+            end
+          else
+            if value_call_plugin
+              return msg.run( value_call_plugin, value_call_method, *value_call[:args] )
+            else
+              return self.method( value_call_method ).call( *value_call[:args] )
+            end
+          end
         else
-          return self.method( value_call_method ).call( )
+          if value_call.has_key?(:uses_msg) and value_call[:uses_msg] != false
+            if value_call_plugin
+              return msg.run( value_call_plugin, value_call_method, msg )
+            else
+              return self.method( value_call_method ).call( msg )
+            end
+          else
+            if value_call_plugin
+              return msg.run( value_call_plugin, value_call_method )
+            else
+              return self.method( value_call_method ).call( )
+            end
+          end
         end
       end
-    end
-  end
   
-  # Restores session values to default, unless specified otherwise.
-  #
-  # Called from +#restore_ses+
-  def restore_ses_values( msg )
-    return unless @values
-    ses = get_ses( msg )
-    @values.each do | value_name, value_properties |
-      if ses.has_key?( value_name ) and ses[ value_name ].class == HValue
-        unless value_properties[:restore_default] == false
-          if value_properties.has_key?(:value_call)
-            default_value = init_value_call( msg, value_properties[:value_call] )
-          elsif value_properties.has_key?(:value)
-            default_value = value_properties[:value]
+      # Restores session values to default, unless specified otherwise.
+      #
+      # Called from +#restore_ses+
+      def restore_ses_values( msg )
+        return unless @values
+        ses = get_ses( msg )
+        @values.each do | value_name, value_properties |
+          if ses.has_key?( value_name ) and ses[ value_name ].class == HValue
+            unless value_properties[:restore_default] == false
+              if value_properties.has_key?(:value_call)
+                default_value = init_value_call( msg, value_properties[:value_call] )
+              elsif value_properties.has_key?(:value)
+                default_value = value_properties[:value]
+              else
+                default_value = 0
+              end
+              ses[value_name].set( msg, default_value )
+            end
           else
-            default_value = 0
+            init_ses_value( msg, value_name, value_properties )
           end
-          ses[value_name].set( msg, default_value )
         end
-      else
-        init_ses_value( msg, value_name, value_properties )
       end
-    end
-  end
   
-  # Extracts +HValue+ references as javascript from the session Hash.
-  # The +ses+ parameter is used for supplying a hash with the +HValue+
-  # instances. It's optional and defaults to the current plugin node in
-  # the active session.
-  # 
-  # The return value is a string representing a js object similar to
-  # the ruby Hash +ses+.
-  # 
-  # Sample usage:
-  #
-  #   values_js( msg, msg.session[:main] )
-  #
-  def values_js( msg, ses=false )
-    # backwards-compatible with pre-1.3 behaviour
-    ses = msg if msg.class == Hash
-    # gets the session automatically, if false
-    ses = get_ses( msg ) unless ses
-    js_references = []
-    ses.each_key do |key_name|
-      if ses[key_name].class == HValue
-        js_references.push( "#{key_name.to_s}:HVM.values['#{ses[key_name].val_id}']" )
+      # Extracts +HValue+ references as javascript from the session Hash.
+      # The +ses+ parameter is used for supplying a hash with the +HValue+
+      # instances. It's optional and defaults to the current plugin node in
+      # the active session.
+      # 
+      # The return value is a string representing a js object similar to
+      # the ruby Hash +ses+.
+      # 
+      # Sample usage:
+      #
+      #   values_js( msg, msg.session[:main] )
+      #
+      def values_js( msg, ses=false )
+        # backwards-compatible with pre-1.3 behaviour
+        ses = msg if msg.class == Hash
+        # gets the session automatically, if false
+        ses = get_ses( msg ) unless ses
+        js_references = []
+        ses.each_key do |key_name|
+          if ses[key_name].class == HValue
+            js_references.push( "#{key_name.to_s}:HVM.values['#{ses[key_name].val_id}']" )
+          end
+        end
+        return "{#{js_references.join(',')}}"
       end
-    end
-    return "{#{js_references.join(',')}}"
-  end
   
-  # Deprecated name of +#values_js+
-  alias extract_hvalues_from_hash values_js
+      # Deprecated name of +#values_js+
+      alias extract_hvalues_from_hash values_js
   
-  # Tells the js client framework to load a list of dependency packages.
-  # It keeps track of what's loaded, so nothing library loaded twice.
-  #
-  # The +dependencies+ parameter is an Array of dependencies.
-  #
-  # Sample usage:
-  #
-  #   include_js( msg, [ 'default_theme', 'controls', 'lists', 'datetime' ] )
-  #
-  def include_js( msg, dependencies=[] )
-    ses = msg.session
-    # check, if the session has a dependency array
-    if not ses.has_key?( :deps )
-      # make an array of dependencies for this session, if not already done
-      ses[:deps] = []
-    end
-    dependencies = [dependencies] if dependencies.class == String
-    # Check the required dependencies until everything is loaded.
-    dependencies.each do |dependency|
-      unless ses[:deps].include?( dependency )
-        ses[:deps].push( dependency )
-        msg.reply(%{jsLoader.load("#{dependency}");})
+      # Tells the js client framework to load a list of dependency packages.
+      # It keeps track of what's loaded, so nothing library loaded twice.
+      #
+      # The +dependencies+ parameter is an Array of dependencies.
+      #
+      # Sample usage:
+      #
+      #   include_js( msg, [ 'default_theme', 'controls', 'lists', 'datetime' ] )
+      #
+      def include_js( msg, dependencies=[] )
+        ses = msg.session
+        # check, if the session has a dependency array
+        if not ses.has_key?( :deps )
+          # make an array of dependencies for this session, if not already done
+          ses[:deps] = []
+        end
+        dependencies = [dependencies] if dependencies.class == String
+        # Check the required dependencies until everything is loaded.
+        dependencies.each do |dependency|
+          unless ses[:deps].include?( dependency )
+            ses[:deps].push( dependency )
+            msg.reply(%{jsLoader.load("#{dependency}");})
+          end
+        end
       end
     end
   end
-  
-  
 end
 
-