waves 0.7.3 → 0.7.5

data/lib/runtime/session.rb

@@ -1,56 +1,66 @@
 module Waves
-  
+
   # Encapsulates the session associated with a given request. A session has an expiration
-  # and path. You must set these in your configuration file. See Waves::Configuration for
-  # more information. 
-  #
-	class Session
-		
-		# Create a new session object using the given request. This is not necessarily the
-		# same as constructing a new session. The session_id cookie for the request domain
-		# is used to store a session id. The actual session data will be stored in a directory
-		# specified by the application's configuration file.
-		def initialize( request )
-			@request = request
-			@data ||= ( File.exist?( session_path  ) ? load_session : {} )
-		end
-		
-		# Save the session data. You shouldn't typically have to call this directly, since it
-		# is called by Waves::Response#finish.
-		def save
-			if @data && @data.length > 0
-				File.write( session_path, @data.to_yaml )
-				@request.response.set_cookie( 'session_id', 
-					:value => session_id, :path => '/', 
-					:expires => Time.now + Waves::Server.config.session[:duration] )
-			end
-		end
-		
-		# Access a given data element of the session using the given key.
-		def [](key) ; @data[key] ; end
-		# Set the given data element of the session using the given key and value.
-		def []=(key,val) ; @data[key] = val ; end
-		
-		private
-		
-		def session_id
-			@session_id ||= ( @request.cookies['session_id'] || generate_session_id )
-		end
-		
-		def generate_session_id # from Camping ...
-			chars = [*'A'..'Z'] + [*'0'..'9'] + [*'a'..'z']
-			(0..48).inject(''){|s,x| s+=chars[ rand(chars.length) ] }
-		end
-		
-		def session_path
-		  Waves::Server.config.session[:path] / session_id
-		end
-		
-		def load_session
-			YAML.load( File.read( session_path ) )
-		end
-		
-	end
-	
+  # and path, which must be provided in a Waves::Configuration. Sensible defaults are defined
+  # in Waves::Configurations::Default
+  class Session
+    
+    # Concoct a (probably) unique session id
+    def self.generate_session_id 
+      # from Camping ...
+      chars = [*'A'..'Z'] + [*'0'..'9'] + [*'a'..'z']
+      (0..48).inject(''){|s,x| s+=chars[ rand(chars.length) ] }
+    end
+
+    # Create a new session object using the given request. This is not necessarily the
+    # same as constructing a new session. The session_id cookie for the request domain
+    # is used to store a session id. The actual session data will be stored in a directory
+    # specified by the application's configuration file.
+    def initialize( request )
+      @request = request
+      @data ||= ( File.exist?( session_path  ) ? load_session : {} )
+    end
+    
+    # Return the session data as a hash
+    def to_hash
+      @data.to_hash
+    end
+    
+    def self.base_path
+      Waves::Application.instance.config.session[:path]
+    end
+
+    # Save the session data. You shouldn't typically have to call this directly, since it
+    # is called by Waves::Response#finish.
+    def save
+      if @data && @data.length > 0
+        File.write( session_path, @data.to_yaml )
+        @request.response.set_cookie( 'session_id',
+          :value => session_id, :path => '/',
+          :expires => Time.now + Waves::Server.config.session[:duration] )
+      end
+    end
+
+    # Access a given data element of the session using the given key.
+    def [](key) ; @data[key] ; end
+    # Set the given data element of the session using the given key and value.
+    def []=(key,val) ; @data[key] = val ; end
+
+    private
+
+    def session_id
+      @session_id ||= ( @request.cookies['session_id'] || Waves::Session.generate_session_id )
+    end
+
+    def session_path
+      Waves::Session.base_path / session_id
+    end
+
+    def load_session
+      YAML.load( File.read( session_path ) )
+    end
+
+  end
+
 end
-		
+

data/lib/tasks/cluster.rb

@@ -0,0 +1,26 @@
+namespace :cluster do
+
+  desc 'Start a cluster of waves applications.'
+  task :start do |task|
+    using_waves_src = defined?(WAVES) || ENV['WAVES'] || File.exist( File.dirname(__FILE__) / :waves )
+    script = using_waves_src ? :bin / 'waves-server' : 'waves-server'
+    ( Waves::Console.config.ports || [ Waves::Console.config.port ] ).each do |port|
+      cmd = "#{script} -p #{port} -c #{ENV['mode']||'development'} -d"
+      puts cmd ; `#{cmd}`
+    end
+  end
+
+  desc 'Stop a cluster of waves applications.'
+  task :stop do |task|
+     Dir[ :log / '*.pid' ].each do |pidfile|
+       pid = File.read(pidfile).to_i
+       puts "Stopping process #{pid} ..."
+       Process.kill( 'INT', pid ) rescue nil
+    end
+  end
+
+  desc 'Restart a cluster of waves applications.'
+  task :restart => [ :stop, :start ] do |task|
+  end
+
+end

data/lib/tasks/gem.rb

@@ -0,0 +1,31 @@
+namespace :gem do
+  desc "freeze a gem using gem=<gem name> [version=<gem version>]"
+  task :freeze do
+    raise "No gem specified" unless gem_name = ENV['gem']
+
+    require 'rubygems'
+    Gem.manage_gems
+
+    gem = (version = ENV['version']) ?
+      Gem.cache.search(gem_name, "= #{version}").first :
+      Gem.cache.search(gem_name).sort_by { |g| g.version }.last
+
+    version ||= gem.version.version rescue nil
+
+    target_dir = File.join(Waves::Configurations::Default.root, 'gems')
+    mkdir_p target_dir
+    sh "gem install #{gem_name} --version #{version} -i #{target_dir} --no-rdoc --no-ri"
+
+    puts "Unpacked #{gem_name} #{version} to '#{target_dir}'"
+  end
+
+  desc "unfreeze a gem using gem=<gem>"
+  task :unfreeze do
+    raise "No gem specified" unless gem_name = ENV['gem']
+
+    target_dir = File.join(Waves::Configurations::Default.root, 'gems')
+    ENV['GEM_HOME'] = target_dir # no install_dir option for gem uninstall
+
+    sh "gem uninstall #{gem_name}"
+  end
+end

data/lib/tasks/generate.rb

@@ -0,0 +1,80 @@
+namespace :generate do
+
+  desc 'Generate a new controller, with name=<name>'
+  task :controller do |task|
+    name = ENV['name']
+    controller_name = name.camel_case
+    raise "Cannot generate Default yet" if controller_name == 'Default'
+    
+    filename = File.expand_path "controllers/#{name}.rb"
+    if File.exist?(filename)
+      $stderr.puts "#{filename} already exists" 
+      exit
+    end
+
+    controller = <<TEXT
+module #{Waves.application.name}
+  module Controllers
+    class #{controller_name} < Default
+
+    end
+  end
+end
+TEXT
+
+    File.write( filename, controller )
+  end
+  
+  desc 'Generate new view, with name=<name>'
+  task :view do |task|
+    name = ENV['name']
+    view_name = name.camel_case
+    raise "Cannot generate Default yet" if view_name == 'Default'
+    
+    filename = File.expand_path "views/#{name}.rb"
+    if File.exist?(filename)
+      $stderr.puts "#{filename} already exists" 
+      exit
+    end
+
+    view = <<TEXT
+module #{Waves.application.name}
+  module Views
+    class #{view_name} < Default
+
+    end
+  end
+end
+TEXT
+
+    File.write( filename, view )
+  end
+ 
+  desc 'Generate a new helper, with name=<name>'
+  task :helper do |task|
+    name = ENV['name']
+    helper_name = name.camel_case
+    raise "Cannot generate Default yet" if helper_name == 'Default'
+    
+    filename = File.expand_path "helpers/#{name}.rb"
+    if File.exist?(filename)
+      $stderr.puts "#{filename} already exists" 
+      exit
+    end
+    
+    helper = <<TEXT
+module #{Waves.application.name}
+  module Helpers
+    module #{helper_name}
+      include Waves::Helpers::Default
+      
+    end
+  end
+end
+TEXT
+
+    File.write( filename, helper )
+  end
+  
+  
+end

data/lib/utilities/hash.rb

@@ -0,0 +1,22 @@
+class Hash
+
+  def stringify_keys
+    inject({}) do |options, (key, value)|
+      options[key.to_s] = value
+      options
+    end
+  end
+
+  # Destructively convert all keys to symbols.
+  def symbolize_keys!
+    keys.each do |key|
+      unless key.is_a?(Symbol)
+        self[key.to_sym] = self[key]
+        delete(key)
+      end
+    end
+    self
+  end
+
+
+end

data/lib/utilities/inflect.rb

@@ -0,0 +1,194 @@
+# Much love to Facets (more specifically English) for this module
+# http://english.rubyforge.org/
+# changed slightly in the hopes of one day implementing a different set
+# of rules for different languages
+# NOTE: this is NOT implemented yet.
+# plural and singular work directly with the English class
+
+module Inflect # :nodoc:
+  module InflectorMethods
+
+    # Define a general exception.
+    def word(singular, plural=nil)
+      plural = singular unless plural
+      singular_word(singular, plural)
+      plural_word(singular, plural)
+    end
+
+    # Define a singularization exception.
+    def singular_word(singular, plural)
+      @singular_of[plural] = singular
+    end
+
+    # Define a pluralization exception.
+    def plural_word(singular, plural)
+      @plural_of[singular] = plural
+    end
+
+    # Define a general rule.
+    def rule(singular, plural)
+      singular_rule(singular, plural)
+      plural_rule(singular, plural)
+    end
+
+    # Define a singularization rule.
+    def singular_rule(singular, plural)
+      @singular_rules << [singular, plural]
+    end
+
+    # Define a plurualization rule.
+    def plural_rule(singular, plural)
+      @plural_rules << [singular, plural]
+    end
+
+    # Read prepared singularization rules.
+    def singularization_rules
+      return @singularization_rules if @singularization_rules
+      sorted = @singular_rules.sort_by{ |s, p| "#{p}".size }.reverse
+      @singularization_rules = sorted.collect do |s, p|
+        [ /#{p}$/, "#{s}" ]
+      end
+    end
+
+    # Read prepared pluralization rules.
+    def pluralization_rules
+      return @pluralization_rules if @pluralization_rules
+      sorted = @plural_rules.sort_by{ |s, p| "#{s}".size }.reverse
+      @pluralization_rules = sorted.collect do |s, p|
+        [ /#{s}$/, "#{p}" ]
+      end
+    end
+
+    #
+    def plural_of
+      @plural_of
+    end
+
+    #
+    def singular_of
+      @singular_of
+    end
+
+    # Convert an English word from plurel to singular.
+    #
+    #   "boys".singular      #=> boy
+    #   "tomatoes".singular  #=> tomato
+    #
+    def singular(word)
+      if result = singular_of[word]
+        return result.dup
+      end
+      result = word.dup
+      singularization_rules.each do |(match, replacement)|
+        break if result.gsub!(match, replacement)
+      end
+      return result
+    end
+
+    # Convert an English word from singular to plurel.
+    #
+    #   "boy".plural     #=> boys
+    #   "tomato".plural  #=> tomatoes
+    #
+    def plural(word)
+      if result = plural_of[word]
+        return result.dup
+      end
+      #return self.dup if /s$/ =~ self # ???
+      result = word.dup
+      pluralization_rules.each do |(match, replacement)|
+        break if result.gsub!(match, replacement)
+      end
+      return result
+    end
+  end
+
+  class English # :nodoc:
+    @singular_of = {}
+    @plural_of = {}
+
+    @singular_rules = []
+    @plural_rules = []
+
+    class << self
+      include InflectorMethods
+    end
+
+    # One argument means singular and plural are the same.
+    word 'equipment'
+    word 'information'
+    word 'money'
+    word 'species'
+    word 'series'
+    word 'fish'
+    word 'sheep'
+    word 'moose'
+    word 'hovercraft'
+
+    # Two arguments defines a singular and plural exception.
+    word 'Swiss'     , 'Swiss'
+    word 'life'      , 'lives'
+    word 'wife'      , 'wives'
+    word 'virus'     , 'viri'
+    word 'octopus'   , 'octopi'
+    word 'cactus'    , 'cacti'
+    word 'goose'     , 'geese'
+    word 'criterion' , 'criteria'
+    word 'alias'     , 'aliases'
+    word 'status'    , 'statuses'
+    word 'axis'      , 'axes'
+    word 'crisis'    , 'crises'
+    word 'testis'    , 'testes'
+    word 'child'     , 'children'
+    word 'person'    , 'people'
+    word 'potato'    , 'potatoes'
+    word 'tomato'    , 'tomatoes'
+    word 'buffalo'   , 'buffaloes'
+    word 'torpedo'   , 'torpedoes'
+    word 'quiz'      , 'quizes'
+    word 'matrix'    , 'matrices'
+    word 'vertex'    , 'vetices'
+    word 'index'     , 'indices'
+    word 'ox'        , 'oxen'
+    word 'mouse'     , 'mice'
+    word 'louse'     , 'lice'
+    word 'thesis'    , 'theses'
+    word 'thief'     , 'thieves'
+    word 'analysis'  , 'analyses'
+
+    # One-way singularization exception (convert plural to singular).
+    singular_word 'cactus', 'cacti'
+
+    # General rules.
+    rule 'hive' , 'hives'
+    rule 'rf'   , 'rves'
+    rule 'af'   , 'aves'
+    rule 'ero'  , 'eroes'
+    rule 'man'  , 'men'
+    rule 'ch'   , 'ches'
+    rule 'sh'   , 'shes'
+    rule 'ss'   , 'sses'
+    rule 'ta'   , 'tum'
+    rule 'ia'   , 'ium'
+    rule 'ra'   , 'rum'
+    rule 'ay'   , 'ays'
+    rule 'ey'   , 'eys'
+    rule 'oy'   , 'oys'
+    rule 'uy'   , 'uys'
+    rule 'y'    , 'ies'
+    rule 'x'    , 'xes'
+    rule 'lf'   , 'lves'
+    rule 'us'   , 'uses'
+    rule ''     , 's'
+
+    # One-way singular rules.
+    singular_rule 'of' , 'ofs' # proof
+    singular_rule 'o'  , 'oes' # hero, heroes
+    singular_rule 'f'  , 'ves'
+
+    # One-way plural rules.
+    plural_rule 'fe' , 'ves' # safe, wife
+    plural_rule 's'  , 'ses'
+  end
+end
+