rsence 2.0.0.0.pre

data/js/foundation/view/viewdefaults/viewdefaults.js

@@ -0,0 +1,25 @@
+/*   Riassence Framework
+ *   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
+ */
+
+/*** = Description
+  ** Define default HView setting here. Will be used, when no or invalid constructor
+  ** options are supplied.
+  ***/
+HViewDefaults = HClass.extend({
+  
+/** The default label. A label is the "visual value" of a component that
+  * operates on a "hidden" value.
+  **/
+  label:    "",
+
+/** The default initial visibility of the component.
+  **/
+  visible:  true
+  
+});
+

data/js/views/centerview/centerview.js

@@ -0,0 +1,45 @@
+/*   Riassence Framework
+ *   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
+ */
+
+// Simple view for centering a view.
+// The rect's left position is used as the minimum left position, the rects
+// top and width are used as-is and the HCenterView itself is geometrically
+// 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.
+HCenterView = HControl.extend({
+  defaultEvents: {
+    resize: true
+  },
+  drawRect: function(_selfCalled){
+    this.base();
+    if(!_selfCalled){
+      this.resize();
+    }
+  },
+  minLeft: false,
+  resize: function(){
+    if(this.minLeft === false){
+      this.minLeft = this.rect.left;
+    }
+    var
+    _rect = this.rect,
+    _winSize = ELEM.windowSize(),
+    _winWidth = _winSize[0],
+    _winHeight = _winSize[1],
+    _rectWidth = _rect.width,
+    _rectWidthHalf = Math.floor(_rectWidth/2),
+    _winWidthHalf = Math.floor(_winWidth/2),
+    _left = _winWidthHalf - _rectWidthHalf;
+    if( _left < this.minLeft ){
+      _left = this.minLeft;
+    }
+    _rect.offsetTo( _left, _rect.top );
+    this.drawRect(true);
+  }
+});

data/js/views/inlineview/inlineview.js

@@ -0,0 +1,14 @@
+/*   Riassence Framework
+ *   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
+ */
+
+// Simple view for inline content (relative positioning and inline view instead of block)
+HInlineView = HView.extend({
+  isAbsolute: false,
+  isRelative: true,
+  displayMode: 'inline'
+});

data/js/views/scrollview/scrollview.js

@@ -0,0 +1,39 @@
+/*   Riassence Framework
+ *   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
+ */
+
+// Simple view for scrolling purposes.
+// Uses two special options for setting scroll bar behavior:
+//  - scrollX: true | false | 'auto'
+//  - scrollY: true | false | 'auto'
+HScrollView = HControl.extend({
+  controlDefaults: HControlDefaults.extend({
+    scrollX: true,
+    scrollY: true
+  }),
+  drawSubviews: function(){
+    if(!this.options.scrollX){
+      this.setStyle('overflow-x','hidden');
+    }
+    else if(this.options.scrollX === 'auto'){
+      this.setStyle('overflow-x','auto');
+    }
+    else {
+      this.setStyle('overflow-x','scroll');
+    }
+    if(!this.options.scrollY){
+      this.setStyle('overflow-y','hidden');
+    }
+    else if(this.options.scrollY === 'auto'){
+      this.setStyle('overflow-y','auto');
+    }
+    else {
+      this.setStyle('overflow-y','scroll');
+    }
+  }
+});
+

data/lib/conf/default.rb

@@ -0,0 +1,220 @@
+#--
+##   Riassence Framework
+ #   Copyright 2008 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
+ ##
+ #++
+
+require 'rubygems'
+require 'rack'
+require 'yaml'
+
+# Legacy:
+LIB_PATHS = []
+PIDPATH = File.join(SERVER_PATH,'var','run')
+LOGPATH = File.join(SERVER_PATH,'var','log')
+def load_legacy( local_config_file_path )
+  require local_config_file_path[0..-4]
+end
+
+module RSence
+
+class Configuration
+  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
+  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
+  def initialize
+    ## Paths for log and pid files
+    pidpath = File.join(SERVER_PATH,'var','run')
+    logpath = File.join(SERVER_PATH,'var','log')
+    
+    yaml_conf_path = File.join( SERVER_PATH, 'conf', 'default_conf.yaml' )
+    
+    yaml_strings_path = File.join( SERVER_PATH, 'conf', 'default_strings.yaml' )
+    strings = YAML.load( File.read( yaml_strings_path ) )
+    
+    ## Global configuration hash
+    config = YAML.load( File.read( yaml_conf_path ) )
+    config[:transporter_conf][:messages] = strings[:messages][:transporter]
+    
+    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 of server libraries
+    lib_paths  = [
+      ## already included in launch.rb; override this one in local config, if needed
+      #File.join( SERVER_PATH, 'lib' )
+    ]
+    
+    ## Create default local configuratation override file, if it does not exist:
+    local_config_file_paths = [
+      File.join(SERVER_PATH,'conf','local_conf.yaml'),
+      File.join( File.split( SERVER_PATH )[0], 'conf', 'local_conf.yaml' ),
+      File.join( Dir.pwd, 'conf', 'local_conf.yaml' ),
+      File.join(SERVER_PATH,'conf','local_conf.rb'),
+      File.join( File.split( SERVER_PATH )[0], 'conf', 'local_conf.rb' ),
+      File.join( Dir.pwd, 'conf', 'local_conf.rb' )
+    ]
+    if ARGV.include?('--config')
+      argv_conf_file = ARGV[ARGV.index('--config')+1]
+      if not argv_conf_file.begin_with? '/'
+        argv_conf_file = File.join( Dir.pwd, conf_file )
+      end
+      local_config_file_paths.push( argv_conf_file )
+    end
+    
+    local_config_file_path_found = false
+    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'
+          local_conf = YAML.load( File.read( local_config_file_path ) )
+          hash_merge( config, local_conf )
+          local_config_file_path_found = true
+        elsif local_config_file_path.end_with? '.rb'
+          # Legacy work-arounds
+          prev_pidpath = PIDPATH
+          prev_logpath = LOGPATH
+          # /Legacy work-arounds
+          load_legacy( local_config_file_path )
+          # Legacy work-arounds
+          pidpath = PIDPATH if PIDPATH != prev_pidpath
+          logpath = LOGPATH if LOGPATH != prev_logpath
+          # /Legacy work-arounds
+          local_config_file_path_found = true
+        else
+          warn "Only Yaml and Ruby configuration files are allowed at this time."
+        end
+      end
+    end
+    
+    if not local_config_file_path_found or ARGV.include? '--run-wizard'
+      puts "NOTE:  No local configuration file found, running the, configuration wizard." unless ARGV.include? '--run-wizard'
+      puts "Please answer the following questions, blank lines equal to the default in brackets:"
+      require 'conf/wizard'
+      if File.directory?( File.join( Dir.pwd, 'conf' ) )
+        wizard_conf_file = File.join( Dir.pwd, 'conf', 'local_conf.yaml' )
+      else
+        wizard_conf_file = File.join( SERVER_PATH, 'conf', 'local_conf.yaml' )
+      end
+      wizard_config_data = ConfigWizard.new(config).run( wizard_conf_file )
+      config.merge!( wizard_config_data )
+    end
+    
+    if not config[:database].has_key?( :ses_db ) and config[:database].has_key?( :auth_setup )
+      warn "WARNING: The database is not configured with a :ses_db url."
+      warn "         You are advised to convert the :root_setup and :auth_setup keys of"
+      warn "         config[:database] to the new url format."
+      db_auth = config[:database][:auth_setup]
+      config[:database][:ses_db] = "mysql://#{db_auth[:user]}:#{db_auth[:pass]}@#{db_auth[:host]}:#{db_auth[:port]}/#{db_auth[:db]}"
+      warn "      -> Performed automatic conversion of :auth_setup as"
+      warn "         config[:database][:ses_db] = #{config[:database][:ses_db].inspect}"
+    end
+    
+    
+    config[:trace] = true if ARGV.include?('--trace-js')
+    config[:debug_mode] = true if ARGV.include?('-d') or ARGV.include?('--debug')
+    config[:http_server][:latency] = ARGV[ARGV.index('--latency')+1].to_i if ARGV.include?('--latency')
+    config[:http_server][:port] = ARGV[ARGV.index('--port')+1].to_i if ARGV.include?('--port')
+    config[:http_server][:bind_address] = ARGV[ARGV.index('--addr')+1] if ARGV.include?('--addr')
+    config[:http_server][:rack_require] = ARGV[ARGV.index('--server')+1] if ARGV.include?('--server')
+    config[:session_conf][:reset_sessions] = true if ARGV.include?('--reset-sessions=true') or ARGV.include?('--reset-sessions')
+    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)
+    
+    
+    ## Broker configuration
+    [   ## 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 SOAP -requests
+      [ :soap,            File.join(config[:base_url],'SOAP') ],
+        # 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
+      end
+    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.each do |lib_path|
+      $LOAD_PATH << lib_path
+    end
+    
+    ## Legacy:
+    LIB_PATHS.each do |lib_path|
+      $LOAD_PATH << lib_path
+    end
+    
+    @config = config
+  end
+  attr_reader :config
+end
+@@config = Configuration.new.config
+def self.config
+  @@config
+end
+
+end
+
+

data/lib/conf/wizard.rb

@@ -0,0 +1,303 @@
+#--
+##   Riassence Framework
+ #   Copyright 2008 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
+ ##
+ #++
+
+
+require 'rubygems'
+require 'highline/import'
+
+require 'randgen'
+
+class ConfigWizard
+  
+  # returns a deep copy of source_hash using Marshal
+  # (I wish there was a better way)
+  def hash_deep_copy(source_hash)
+    return Marshal.restore( Marshal.dump(source_hash) )
+  end
+  
+  # returns a pound ('#') char, unless @conf and @config values differ
+  def cdiff(confkeys)
+    conf1 = @conf
+    conf2 = @config
+    # recurse into config hash
+    confkeys.each do |confkey|
+      conf1 = conf1[confkey]
+      conf2 = conf2[confkey]
+    end
+    # return '' if the values differ, '#' if they are the same
+    #puts "#{conf1.inspect} vs #{conf2.inspect}"
+    if conf1 != conf2
+      return ''
+    else
+      return '#'
+    end
+  end
+  
+  # makes a copy of the default configuration for comparisons
+  def initialize( config )
+    @config = config
+    @conf = {
+      :database      => hash_deep_copy( config[:database] ),
+      :http_server   => hash_deep_copy( config[:http_server] )
+    }
+  end
+  
+  # asks y/n and returns boleans,
+  # the default tells if which one is for just enter
+  def yesno(default=false)
+    if default
+      question = "Y/n? "
+    else
+      question = "y/N? "
+    end
+    print question
+    answer = $stdin.gets.strip.downcase[0]
+    answer = answer.chr if answer
+    if answer == 'n'
+      return false
+    elsif answer == 'y'
+      return true
+    elsif answer == nil
+      return default
+    else
+      return nil
+    end
+  end
+  
+  # configuration dialog for database connectivity
+  def ask_about_mysql
+    puts "-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-"
+    puts " MySQL configuration"
+    puts 
+    puts "  This feature requires an mysql account with "
+    puts "  sufficient privileges of creating databases,"
+    puts "  tables and users. "
+    puts
+    puts "  This account is used for persistent session storage "
+    puts "  and it is also the default database for plugins."
+    puts
+    puts " The default rsence account is configured as:"
+    puts
+    puts " Hostname: #{@conf[:database][:auth_setup][:host].inspect}"
+    puts " Username: #{@conf[:database][:auth_setup][:user].inspect}"
+    puts " Password: #{@conf[:database][:auth_setup][:pass].inspect}"
+    puts " Database: #{@conf[:database][:auth_setup][:db].inspect}"
+    puts " Port: #{@conf[:database][:auth_setup][:port].inspect}"
+    puts
+    print " Correct, "
+    is_correct = nil
+    is_correct = yesno(true) until is_correct != nil
+    unless is_correct
+      @conf[:database][:auth_setup][:host] = ask("Hostname (or IP address)?") do |q|
+        q.default = @conf[:database][:auth_setup][:host]
+      end
+      @conf[:database][:auth_setup][:user] = ask("Username?") do |q|
+        q.default = @conf[:database][:auth_setup][:user]
+      end
+      @conf[:database][:auth_setup][:pass] = ask("Password?") do |q|
+        q.default = @conf[:database][:auth_setup][:pass]
+      end
+      @conf[:database][:auth_setup][:db] = ask("Database?") do |q|
+        q.default = @conf[:database][:auth_setup][:db]
+      end
+      @conf[:database][:auth_setup][:port] = ask("Port?") do |q|
+        q.default = @conf[:database][:auth_setup][:port]
+      end
+    end
+    puts
+    print " Re-edit these settings, "
+    re_edit = yesno(false) until re_edit != nil
+    if re_edit
+      ask_about_mysql
+    else
+      db_auth = @conf[:database][:auth_setup]
+      return "mysql://#{db_auth[:user]}:#{db_auth[:pass]}@#{db_auth[:host]}:#{db_auth[:port]}/#{db_auth[:db]}"
+    end
+  end
+  
+  # configuration dialog for the web server
+  def ask_about_httpd
+    puts "-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-"
+    puts " HTTP Server configuration"
+    puts 
+    puts "  Riassence Framework runs its HTTP Server as:"
+    puts
+    puts "  Server: #{@conf[:http_server][:rack_require].inspect}"
+    puts " Address: #{@conf[:http_server][:bind_address].inspect}"
+    puts "    Port: #{@conf[:http_server][:port].inspect}"
+    puts
+    puts
+    print " Correct, "
+    is_correct = yesno(true) until is_correct != nil
+    unless is_correct
+      server_type = ''
+      until ['mongrel','webrick','thin','ebb'].include?(server_type)
+        server_type = ask("Server Type? (valid: mongrel, webrick, thin, ebb)") do |q|
+          q.default = @conf[:http_server][:rack_require]
+        end
+      end
+      @conf[:http_server][:rack_require] = server_type
+      @conf[:http_server][:bind_address] = ask("Address? (0.0.0.0 binds to all)") do |q|
+        q.default = @conf[:http_server][:bind_address]
+      end
+      @conf[:http_server][:port] = ask("Port number?") do |q|
+        q.default = @conf[:http_server][:port]
+      end
+    end
+  end
+  
+  def file_ok?(path)
+    return false if path == ''
+    if File.exist?(File.split(path)[0])
+      if File.directory?(File.split(path)[0])
+        if File.writable?(File.split(path)[0])
+          if File.exist?(path)
+            if File.file?(path)
+              return true if File.writable?(path) and File.readable?(path)
+              puts " Invalid path; #{path} is not writable or readable."
+              return false
+            end
+            puts " Invalid path; #{path} exists and is not a file."
+            return false
+          end
+          return true
+        end
+        puts " Invalid path; the directory #{File.split(path)[0]} is not writable."
+        return false
+      end
+      puts " Invalid path; the parent directory #{File.split(path)[0]} is not a directory."
+      return false
+    end
+    puts " Invalid path; the parent directory #{File.split(path)[0]} does not exist."
+    return false
+  end
+  
+  def ask_about_sqlite
+    sqlite_path = File.join(SERVER_PATH,'var','db','rsence_ses.db')
+    puts "-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-"
+    puts " SQLite database configuration"
+    puts
+    puts "  SQLite is configured using file names. The default is:"
+    puts "  #{sqlite_path.inspect}"
+    puts
+    print " Correct, "
+    is_correct = yesno(true) until is_correct != nil
+    unless is_correct
+      new_sqlite_path = ''
+      until file_ok?(new_sqlite_path)
+        new_sqlite_path = ask(" Database file path? ") do |q|
+          q.default = sqlite_path
+        end
+      end
+      sqlite_path = new_sqlite_path
+    end
+    return "sqlite://#{sqlite_path}"
+  end
+  
+  def ask_about_other_db( other_db_string = '' )
+    puts "-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-"
+    puts " All Sequel-compatible database drivers are supported."
+    puts
+    puts "  To configure another database engine, please enter a db url."
+    puts "  The format is usually: 'engine://username:password@host:port/database_name'"
+    puts "  For more details, see: http://sequel.rubyforge.org/rdoc/files/doc/opening_databases_rdoc.html"
+    puts
+    input_db_string = ''
+    until input_db_string != ''
+      input_db_string = ask(" Database connection string: ") do |q|
+        q.default = other_db_string
+      end
+    end
+    other_db_string = input_db_string
+    print "Correct, "
+    is_correct = yesno(true) until is_correct != nil
+    if is_correct
+      return other_db_string
+    else
+      ask_about_other_db( other_db_string )
+    end
+  end
+  
+  def ask_about_db
+    puts "-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-"
+    puts " Session database configuration"
+    puts
+    puts "  Riassence Framework requires a database for persistant"
+    puts "  session storage. This feature allows the server"
+    puts "  to be restarted without losing user sessions."
+    puts
+    puts " The default database engine is SQLite."
+    puts
+    puts " Select one of the following:"
+    puts "   1 - SQLite"
+    puts "   2 - MySQL"
+    puts "   3 - Other (custom Sequel database url)"
+    db_type = ''
+    until ['1','2','3'].include?(db_type)
+      db_type = ask("Database engine? ") do |q|
+        q.default = '1'
+      end
+    end
+    if db_type == '1'
+      db_connection_string = ask_about_sqlite
+    elsif db_type == '2'
+      db_connection_string = ask_about_mysql
+    elsif db_type == '3'
+      db_connection_string = ask_about_other_db
+    end
+    puts
+    puts " The database connection string is:"
+    puts "  #{db_connection_string}"
+    puts
+    print " Correct, "
+    db_ok = yesno(true) until db_ok != nil
+    if not db_ok
+      ask_about_db
+    else
+      @conf[:database][:ses_db] = db_connection_string
+    end
+  end
+  
+  def run( local_config_file_path )
+    puts
+    puts
+    puts "-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-"
+    puts " This Riassence Framework instance is not configured."
+    puts
+    puts " To configure, create a configuration file:"
+    puts "  #{local_config_file_path}"
+    puts
+    puts " You may also answer a few simple questions to create"
+    puts " a configuration file template."
+    puts
+    print " Do you want to run the configuration tool, "
+    configure_now = yesno(true) until configure_now != nil
+    unless configure_now
+      puts
+      puts " OK. No configuration at this time. Can't continue; exit."
+      exit
+    end
+    ask_about_db
+    ask_about_httpd
+    puts
+    puts "Configuration done!"
+    puts
+    puts "Writing #{local_config_file_path.inspect}..."
+    f = File.open( local_config_file_path, 'w' )
+    f.write( YAML.dump( @conf ) )
+    f.close
+    puts
+    puts "Edit #{local_config_file_path} to change the configuration."
+    puts
+    return @conf
+  end
+end
+
+