rsence 2.0.0.10.pre → 2.0.0.11

data/js/views/centerview/centerview.js

@@ -12,10 +12,15 @@
 // centered inside its parent by adjusting its "left" style property.
 // Designed to be used as a root-level view, listens to the resize event and
 // re-calculates the center position accordingly. Likely to evolve a lot still.
+var//RSence.Views
 HCenterView = HControl.extend({
   defaultEvents: {
     resize: true
   },
+  controlDefaults: HControlDefaults.extend({
+    centerX: true,
+    centerY: false
+  }),
   drawRect: function(_selfCalled){
     this.base();
     if(!_selfCalled){
@@ -23,10 +28,14 @@ HCenterView = HControl.extend({
     }
   },
   minLeft: false,
+  minTop: false,
   resize: function(){
     if(this.minLeft === false){
       this.minLeft = this.rect.left;
     }
+    if(this.minTop === false){
+      this.minTop = this.rect.top;
+    }
     var
     _rect = this.rect,
     _winSize = ELEM.windowSize(),
@@ -35,11 +44,32 @@ HCenterView = HControl.extend({
     _rectWidth = _rect.width,
     _rectWidthHalf = Math.floor(_rectWidth/2),
     _winWidthHalf = Math.floor(_winWidth/2),
-    _left = _winWidthHalf - _rectWidthHalf;
-    if( _left < this.minLeft ){
+    _left = _winWidthHalf - _rectWidthHalf,
+    _rectHeight = _rect.height,
+    _rectHeightHalf = Math.floor(_rectHeight/2),
+    _winHeightHalf = Math.floor(_winHeight/2),
+    _top = _winHeightHalf - _rectHeightHalf;
+    if (!this.options.centerX){
+      _left = _rect.left;
+    }
+    else if( _left < this.minLeft ){
       _left = this.minLeft;
     }
-    _rect.offsetTo( _left, _rect.top );
+    if (!this.options.centerY){
+      _top = _rect.top;
+    }
+    else if( _top < this.minTop ){
+      _top = this.minTop;
+    }
+    _rect.offsetTo( _left, _top );
     this.drawRect(true);
   }
 });
+
+var//RSence.Views
+HMiddleView = HCenterView.extend({
+  controlDefaults: HControlDefaults.extend({
+    centerX: false,
+    centerY: true
+  })
+});

data/js/views/inlineview/inlineview.js

@@ -7,6 +7,7 @@
  */
 
 // Simple view for inline content (relative positioning and inline view instead of block)
+var//RSence.Views
 HInlineView = HView.extend({
   isAbsolute: false,
   isRelative: true,

data/js/views/scrollview/scrollview.js

@@ -10,6 +10,7 @@
 // Uses two special options for setting scroll bar behavior:
 //  - scrollX: true | false | 'auto'
 //  - scrollY: true | false | 'auto'
+var//RSence.Views
 HScrollView = HControl.extend({
   controlDefaults: HControlDefaults.extend({
     scrollX: true,

data/lib/conf/argv.rb

@@ -1,4 +1,3 @@
-#--
 ##   RSence
  #   Copyright 2010 Riassence Inc.
  #   http://riassence.com/
@@ -6,44 +5,37 @@
  #   You should have received a copy of the GNU General Public License along
  #   with this software package. If not, contact licensing@riassence.com
  ##
- #++
 
-# --
 # Includes the Signal Communication utility.
 # Used to respond via special PID files in the run directory of the environment
-# ++
 require 'daemon/sigcomm'
 
-# --
-# Creates the RSence module. RSence classes are defined within.
-# ++
+
 module RSence
   
-  # Returns true, if platform fully supports POSIX standard signals.
+  # @private  Returns true, if platform fully supports POSIX standard signals.
   def self.pid_support?
     # true for non-windows
     return (not ['i386-mingw32','x86-mingw32'].include?(RUBY_PLATFORM))
   end
   
-  # ARGVParser is the "user interface" as a command-line argument parser.
-  # Handles every action of the 'rsence' command-line tool.
+  # @private  ARGVParser is the "user interface" as a command-line argument parser.
+  #           It parses the command-line arguments and sets up things accordingly.
   class ARGVParser
     
     # The RSence version string, read from the VERSION file in
     # the root directory of RSence.
     @@version = File.read( File.join( SERVER_PATH, 'VERSION' ) ).strip
     
-    # --
     # Makes various commands available depending on the platform.
     # The status/start/stop/restart/save -commands depend on an operating
     # system that fully implements POSIX standard signals.
     # These are necessary to send signals to the background process.
-    # ++
-    if RSence.pid_support?
+    if not RSence.pid_support?
+      @@cmds = [ :run, :initenv, :version, :help ]
+    else
       @@cmds = [ :run, :status, :start, :stop, :restart, :save,
                  :initenv, :version, :help ]
-    else
-      @@cmds = [ :run, :initenv, :version, :help ]
     end
     
     help_avail_cmds = @@cmds.map{|cmd|cmd.to_s}.join("\n       ")
@@ -531,7 +523,7 @@ module RSence
       end
     end
     
-    # asks y/n and returns boleans,
+    # asks y/n and returns booleans,
     # the default tells if which one is for just enter
     def yesno(default=false)
       if default
@@ -798,27 +790,46 @@ module RSence
   
   end
   
-  # This accessor enables RSence.argv method, which returns the ARGVParser instance
+  # @private  This accessor enables RSence.argv method, which returns the ARGVParser instance
   def self.argv;    @@argv_parser;    end
   
-  # This accessor enables RSence.cmd method, which returns the command the process was started with.
+  # @private  This accessor enables RSence.cmd method, which returns the command the process was started with.
   def self.cmd;     @@argv_parser.cmd;     end
   
-  # This accessor enables RSence.args method, which returns the parsed command-line arguments.
+  # Command line options parsed
+  # @return [Hash] Parsed command-line options:
+  # *Key* (Symbol):: *Value*
+  # +:env_path+:: (String) The directory of the environment.
+  # +:conf_files+:: (Array of Strings) Additional configuration files given with the +--conf+ command-line option. Default is +[]+.
+  # +:debug+:: (true or false) True, if the +-d+ or +--debug+ command-line option was given. Default is false.
+  # +:verbose+:: (true or false) True, if the +-v+ or +--verbose+ command-line option was given. Default is false.
+  # +:log_fg+:: (true or false) True, if the +-f+ or +--log-fg+ command-line option was given. Default is false.
+  # +:trace_js+:: (true or false) True, if the +--trace-js+ command-line option was given. Default is false.
+  # +:trace_delegate+:: (true or false) True, if the +--trace-delegate+ command-line option was given. Default is false.
+  # +:port+:: (String or nil) The TCP port number given with the +--port+ command-line option. Default is nil.
+  # +:addr+:: (String or nil) The TCP bind address given with the +--addr+ command-line option. Default is nil.
+  # +:server+:: (String or nil) The Rack http server handler given with the +--server+ command-line option. Default is nil.
+  # +:reset_ses+:: (true or false) True, if the +-r+ or +--reset-sessions+ command-line option was given. Default is false.
+  # +:autoupdate+:: (true or false) True, if the +-a+ or +--auto-update+ command-line option was given. Default is false.
+  # +:latency+:: (Number) Amount of milliseconds to sleep in each request given with the +--latency+ command-line option. Default is 0.
+  # +:say+:: (true or false) True, if the +-S+ or +--say+ command-line option was given. Default is false.
   def self.args;    @@argv_parser.args;    end
   
-  # This accessor enables RSence.startable? method, which returns true if a start-type command was given.
+  # @private  This accessor enables RSence.startable? method, which returns true if a start-type command was given.
   def self.startable?; @@argv_parser.startable?; end
   
-  # This accessor enables RSence.version method, which returns the RSence version number.
+  # @return [String] The version of RSence
   def self.version; @@argv_parser.version; end
   
-  # This accessor enables RSence.startup method, which starts RSence.
+  # @private  This accessor enables RSence.startup method, which starts RSence.
   def self.startup
     puts "Loading configuration..." if self.args[:verbose]
     # Use the default configuration:
     require 'conf/default'
     @@config = Configuration.new(self.args).config
+    
+    # RSence runtime configuration data
+    # @return [Hash] the active configuration structure as defined by the {file:default_conf default configuration} and overridden by local configuration files.
     def self.config
       @@config
     end
@@ -829,6 +840,7 @@ module RSence
     daemon.daemonize!
   end
   
+  # @private  The ARGVParser instance and its startup
   @@argv_parser = ARGVParser.new
   @@argv_parser.parse( ARGV )
 

data/lib/conf/default.rb

@@ -1,4 +1,3 @@
-#--
 ##   RSence
  #   Copyright 2008 Riassence Inc.
  #   http://riassence.com/
@@ -6,222 +5,215 @@
  #   You should have received a copy of the GNU General Public License along
  #   with this software package. If not, contact licensing@riassence.com
  ##
- #++
+
 
 require 'rubygems'
 require 'rack'
 require 'yaml'
 
-if RUBY_VERSION.to_f >= 1.9
-  # --
-  # Ruby 1.9 encoding defaults.
-  # This is clearly not enough but a good start for fixing the encoding madness.
-  # ++
-  Encoding.default_external = Encoding::BINARY
-  Encoding.default_internal = Encoding::BINARY
-  # --
-  # Ruby 1.9 doesn't have String#each anymore.
-  # This is a backwards-compatible work-around.
-  # ++
-  class String
-    def each 
-      self.split($/).each { |e| yield e } 
-    end 
-  end
-end
 
-# Configuration handles config files and such.
-class Configuration
+
+require 'util/ruby19_fixes' if RUBY_VERSION.to_f >= 1.9
+
+
+module RSence
+  
   
-  # Method for combining two arrays
-  def array_merge( target, source )
-    source.each do |item|
-      unless target.include?(item)
-        if item.class == Array
-          sub_arr = []
-          array_merge( sub_arr, item )
-          target.push( sub_arr )
-        elsif item.class == Hash
-          sub_hash = {}
-          hash_merge( sub_hash, item )
-          target.push( sub_hash )
-        else
-          target.push( item )
+  # Configuration handles config files and such.
+  class Configuration
+  
+    # Combines the Arrays `target` and `source` recursively.
+    # @param [Array] target Gets merged with `source`
+    # @param [Array] source Has its items pushed to `target` unless an identical item already exists in `target`. If an item class is a Hash, then uses {#hash_merge} to combine them.
+    def array_merge( target, source )
+      source.each do |item|
+        unless target.include?(item)
+          if item.class == Array
+            sub_arr = []
+            array_merge( sub_arr, item )
+            target.push( sub_arr )
+          elsif item.class == Hash
+            sub_hash = {}
+            hash_merge( sub_hash, item )
+            target.push( sub_hash )
+          else
+            target.push( item )
+          end
         end
       end
     end
-  end
   
-  # Method for combining two hashes.
-  def hash_merge( target, source )
-    source.each do |key,item|
-      if not target.has_key?key or target[key] != item
-        if item.class == Array
-          target[key] = [] unless target.has_key?(key)
-          array_merge( target[key], item )
-        elsif item.class == Hash
-          target[key] = {} unless target.has_key?key
-          hash_merge( target[key], item )
-        else
-          target[key] = item
+    # Combines the Hashes `target` and `source` recursively.
+    # @param [Hash] target Gets merged with `source`
+    # @param [Hash] source Has its items merged to `target` unless a key with an identical value already exists in `target`. If an item class is Array, then uses {#array_merge} to combine them.
+    def hash_merge( target, source )
+      source.each do |key,item|
+        if not target.has_key?key or target[key] != item
+          if item.class == Array
+            target[key] = [] unless target.has_key?(key)
+            array_merge( target[key], item )
+          elsif item.class == Hash
+            target[key] = {} unless target.has_key?key
+            hash_merge( target[key], item )
+          else
+            target[key] = item
+          end
         end
       end
     end
-  end
   
-  # The args structure comes from RSence::ARGVParser
-  # The dont_expand_path is for special cases, when
-  # Configuration is used without running RSence.
-  def initialize( args, dont_expand_path=false )
+    # @param args A parsed structure of the command-line arguments.
+    # @param dont_expand_path Is reserved for special cases, when Configuration is used without running RSence.
+    def initialize( args, dont_expand_path=false )
     
-    ## Paths for log and pid files
-    pidpath = File.join( args[:env_path], 'run' )
-    logpath = File.join( args[:env_path], 'log' )
+      ## Paths for log and pid files
+      pidpath = File.join( args[:env_path], 'run' )
+      logpath = File.join( args[:env_path], 'log' )
     
-    # The default configuration path, this one is distributed with the system.
-    yaml_conf_path = File.join( SERVER_PATH, 'conf', 'default_conf.yaml' )
+      # The default configuration path, this one is distributed with the system.
+      yaml_conf_path = File.join( SERVER_PATH, 'conf', 'default_conf.yaml' )
     
-    # Parses the default configuration from yaml first.
-    # This is used as the basis for overriding the defaults in various other config files.
-    config = YAML.load( File.read( yaml_conf_path ) )
+      # Parses the default configuration from yaml first.
+      # This is used as the basis for overriding the defaults in various other config files.
+      config = YAML.load( File.read( yaml_conf_path ) )
     
-    # The default strings for various messages, this one is distributed with the system.
-    yaml_strings_path = File.join( SERVER_PATH, 'conf', 'default_strings.yaml' )
-    strings = YAML.load( File.read( yaml_strings_path ) )
+      # The default strings for various messages, this one is distributed with the system.
+      yaml_strings_path = File.join( SERVER_PATH, 'conf', 'default_strings.yaml' )
+      strings = YAML.load( File.read( yaml_strings_path ) )
     
-    # Transporter-specific strings are set.
-    config[:transporter_conf][:messages] = strings[:messages][:transporter]
+      # Transporter-specific strings are set.
+      config[:transporter_conf][:messages] = strings[:messages][:transporter]
     
-    # Makes the distribution 'js' directory containing the client core the
-    # first client package source directory.
-    config[:client_pkg][:src_dirs].unshift( File.join( SERVER_PATH, 'js' ) )
+      # Makes the distribution 'js' directory containing the client core the
+      # first client package source directory.
+      config[:client_pkg][:src_dirs].unshift( File.join( SERVER_PATH, 'js' ) )
     
-    # The distributed standard plugins are in this directory.
-    default_plugins_path = File.join( SERVER_PATH, 'plugins' )
-    unless config[:plugin_paths].include? default_plugins_path
-      config[:plugin_paths].push( default_plugins_path )
-    end
+      # The distributed standard plugins are in this directory.
+      default_plugins_path = File.join( SERVER_PATH, 'plugins' )
+      unless config[:plugin_paths].include? default_plugins_path
+        config[:plugin_paths].push( default_plugins_path )
+      end
     
-    # Paths to add to $LOAD_PATH after all configuration files are read.
-    lib_paths  = []
+      # Paths to add to $LOAD_PATH after all configuration files are read.
+      lib_paths  = []
     
-    # List of configuration files to look for.
-    local_config_file_paths = [
-      File.join(SERVER_PATH,'conf','local_conf.yaml'),
-      '/etc/rsence/config.yaml',
-      File.expand_path('~/.rsence/config.yaml'),
-      File.join( File.split( SERVER_PATH )[0], 'conf', 'local_conf.yaml' )
-    ]
+      # List of configuration files to look for.
+      local_config_file_paths = [
+        File.join(SERVER_PATH,'conf','local_conf.yaml'),
+        '/etc/rsence/config.yaml',
+        File.expand_path('~/.rsence/config.yaml'),
+        File.join( File.split( SERVER_PATH )[0], 'conf', 'local_conf.yaml' )
+      ]
     
-    # Add the additional config files optionally specified in ARGVParser
-    args[:conf_files].each do |conf_file|
-      local_config_file_paths.push( conf_file )
-    end
+      # Add the additional config files optionally specified in ARGVParser
+      args[:conf_files].each do |conf_file|
+        local_config_file_paths.push( conf_file )
+      end
     
-    # Loads the configuration files
-    local_config_file_paths.each do |local_config_file_path|
-      if File.exists? local_config_file_path and File.file? local_config_file_path
-        if local_config_file_path.end_with? '.yaml'
-          puts "loading config file: #{local_config_file_path}" if args[:verbose]
-          local_conf = YAML.load( File.read( local_config_file_path ) )
-          unless local_conf.class == Hash
-            warn "invalid configuration file: #{local_config_file_path.inspect}"
-            next
+      # Loads the configuration files
+      local_config_file_paths.each do |local_config_file_path|
+        if File.exists? local_config_file_path and File.file? local_config_file_path
+          if local_config_file_path.end_with? '.yaml'
+            puts "loading config file: #{local_config_file_path}" if args[:verbose]
+            local_conf = YAML.load( File.read( local_config_file_path ) )
+            unless local_conf.class == Hash
+              warn "invalid configuration file: #{local_config_file_path.inspect}"
+              next
+            end
+            hash_merge( config, local_conf )
+          else
+            warn "Only Yaml configuration files are supported."
           end
-          hash_merge( config, local_conf )
-        else
-          warn "Only Yaml configuration files are supported."
         end
       end
-    end
     
-    # Adds the plugins directory of the environment
-    # to the configuration automatically
-    env_plugins_path = File.expand_path( 'plugins', args[:env_path] )
-    unless config[:plugin_paths].include? env_plugins_path
-      config[:plugin_paths].push( env_plugins_path )
-    end
+      # Adds the plugins directory of the environment
+      # to the configuration automatically
+      env_plugins_path = File.expand_path( 'plugins', args[:env_path] )
+      unless config[:plugin_paths].include? env_plugins_path
+        config[:plugin_paths].push( env_plugins_path )
+      end
     
-    # At this point, configuration files are read and ready.
+      # At this point, configuration files are read and ready.
     
-    puts "plugin paths: #{config[:plugin_paths].inspect}" if args[:debug]
+      puts "plugin paths: #{config[:plugin_paths].inspect}" if args[:debug]
     
-    # Override configuration options with command-line-options.
-    config[:trace] = true if args[:trace_js]
-    config[:debug_mode] = true if args[:debug]
-    config[:http_server][:latency] = args[:latency]
-    config[:http_server][:port] = args[:port] if args[:port]
-    config[:http_server][:bind_address] = args[:addr] if args[:addr]
-    config[:http_server][:rack_require] = args[:server] if args[:server]
-    config[:session_conf][:reset_sessions] = true if args[:reset_ses]
+      # Override configuration options with command-line-options.
+      config[:trace] = true if args[:trace_js]
+      config[:debug_mode] = true if args[:debug]
+      config[:http_server][:latency] = args[:latency]
+      config[:http_server][:port] = args[:port] if args[:port]
+      config[:http_server][:bind_address] = args[:addr] if args[:addr]
+      config[:http_server][:rack_require] = args[:server] if args[:server]
+      config[:session_conf][:reset_sessions] = true if args[:reset_ses]
     
-    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]
+      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]
     
-    # Sets the default pid and log paths used by the HTTPDaemon
-    config[:daemon][:pid_fn] = File.join(pidpath, "rsence.pid") unless config[:daemon].has_key?(:pid_fn)
-    config[:daemon][:log_fn] = File.join(logpath, "rsence") unless config[:daemon].has_key?(:log_fn)
+      # Sets the default pid and log paths used by the HTTPDaemon
+      config[:daemon][:pid_fn] = File.join(pidpath, "rsence.pid") unless config[:daemon].has_key?(:pid_fn)
+      config[:daemon][:log_fn] = File.join(logpath, "rsence") unless config[:daemon].has_key?(:log_fn)
     
-    # Check database path for sqlite databases.
-    if config[:database][:ses_db].start_with?('sqlite://') and not dont_expand_path
-      db_url = File.expand_path( config[:database][:ses_db].split('sqlite://')[1], args[:env_path] )
-      config[:database][:ses_db] = "sqlite://#{db_url}"
-    end
+      # Check database path for sqlite databases.
+      if config[:database][:ses_db].start_with?('sqlite://') and not dont_expand_path
+        db_url = File.expand_path( config[:database][:ses_db].split('sqlite://')[1], args[:env_path] )
+        config[:database][:ses_db] = "sqlite://#{db_url}"
+      end
     
-    # Sets the various standard url prefixes:
-    [   ## POST-requests
-        # broker_key      # default_uri
-        # The default responder for transporter requests.
-      [ :x,               File.join(config[:base_url],'x') ],
-        # The default responder for cookie-enabled "handshake" transporter requests
-      [ :hello,           File.join(config[:base_url],'hello') ],
-        # The default responder for file uploads
-      [ :u,               File.join(config[:base_url],'U') ],
+      # Sets the various standard url prefixes:
+      [   ## POST-requests
+          # broker_key      # default_uri
+          # The default responder for transporter requests.
+        [ :x,               File.join(config[:base_url],'x') ],
+          # The default responder for cookie-enabled "handshake" transporter requests
+        [ :hello,           File.join(config[:base_url],'hello') ],
+          # The default responder for file uploads
+        [ :u,               File.join(config[:base_url],'U') ],
       
-        ## GET-requests
-        # broker_key      # default_uri
-        # The default address of built javascript and theme packages
-      [ :h,               File.join(config[:base_url],'H/') ],
-        # The default address of the ticketserve :img -category
-      [ :i,               File.join(config[:base_url],'i/') ],
-        # The default address of the ticketserve :rsrc -category
-      [ :d,               File.join(config[:base_url],'d/') ],
-        # The default address of the ticketserve :file -category
-      [ :f,               File.join(config[:base_url],'f/') ],
-        # The default address of the ticketserve :blobobj -category
-      [ :b,               File.join(config[:base_url],'b/') ],
-      # The default address of the favicon
-      [ :favicon,         '/favicon.ico' ],
-      # The default address of the "empty" iframe of uploader
-      [ :uploader_iframe, File.join(config[:base_url],'U/iframe_html') ],
-    ].each do |broker_key, default_uri|
-      unless config[:broker_urls].has_key?( broker_key )
-        config[:broker_urls][broker_key] = default_uri
+          ## GET-requests
+          # broker_key      # default_uri
+          # The default address of built javascript and theme packages
+        [ :h,               File.join(config[:base_url],'H/') ],
+          # The default address of the ticketserve :img -category
+        [ :i,               File.join(config[:base_url],'i/') ],
+          # The default address of the ticketserve :rsrc -category
+        [ :d,               File.join(config[:base_url],'d/') ],
+          # The default address of the ticketserve :file -category
+        [ :f,               File.join(config[:base_url],'f/') ],
+          # The default address of the ticketserve :blobobj -category
+        [ :b,               File.join(config[:base_url],'b/') ],
+        # The default address of the favicon
+        [ :favicon,         '/favicon.ico' ],
+        # The default address of the "empty" iframe of uploader
+        [ :uploader_iframe, File.join(config[:base_url],'U/iframe_html') ],
+      ].each do |broker_key, default_uri|
+        unless config[:broker_urls].has_key?( broker_key )
+          config[:broker_urls][broker_key] = default_uri
+        end
       end
-    end
     
-    if RUBY_VERSION.to_f >= 1.9
-      # The encodings mess up compression when using ruby1.9
-      warn "Disabling gzip support for ruby 1.9" if args[:debug]
-      config[:no_gzip] = true
-    end
+      if RUBY_VERSION.to_f >= 1.9
+        # The encodings mess up compression when using ruby1.9
+        warn "Disabling gzip support for ruby 1.9" if args[:debug]
+        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
+      # 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
     
-    ## Uses the lib paths as search paths
-    lib_paths.merge( config[:lib_paths] ) if config.has_key?(:lib_paths)
-    lib_paths.each do |lib_path|
-      $LOAD_PATH << lib_path
-    end
+      ## Uses the lib paths as search paths
+      lib_paths.merge( config[:lib_paths] ) if config.has_key?(:lib_paths)
+      lib_paths.each do |lib_path|
+        $LOAD_PATH << lib_path
+      end
     
-    @config = config
-  end
+      @config = config
+    end
   
-  attr_reader :config
+    attr_reader :config
   
+  end
 end
 
-