waves-stable 0.7.7

data/app/Rakefile

@@ -0,0 +1,72 @@
+#!/usr/bin/env ruby
+#
+# Warning:  This file is clobbered when you update your
+# application with the waves script.  Accordingly, you may
+# wish to keep your tasks in .rb or .rake files in lib/tasks
+
+begin
+  require 'startup'
+  Waves::Console.load(:mode => ENV['mode'])
+
+  # load tasks from waves framework
+  %w( cluster generate gem ).each { |task| require "tasks/#{task}.rb" }
+
+  # load tasks from this app's lib/tasks
+  Dir["lib/tasks/*.{rb,rake}"].each { |task| require task }
+  
+rescue LoadError => e
+  if e.message == 'no such file to load -- waves'
+    puts "Can't find Waves source.  Install gem, freeze Waves, or define WAVES in startup.rb"
+    puts
+  else
+    raise e
+  end
+end
+
+namespace :waves do
+  
+  desc "freeze src=<wherever> to ./waves"
+  task :freeze do
+
+    target = "#{Dir.pwd}/waves"
+    src = ENV['src']
+    raise "Please specify the location of waves using src=wherever" unless src
+    raise "No directory found at '#{src}'" unless File.directory?(src) 
+      
+    items = FileList["#{src}/*"]
+    puts "Freezing from: #{src}"
+    items.each do |item|
+      puts "copying #{item}"
+      cp_r item, target
+    end
+    
+  end
+  
+  desc "unfreeze (i.e. delete) the waves source at ./waves"
+  task :unfreeze do
+    frozen = "#{Dir.pwd}/waves"
+    rm_r frozen if File.exist?(frozen)
+  end
+  
+  # Convenience task to allow you to freeze the current Waves
+  # source without knowing where it is.  This task only gets
+  # defined when the Rakefile successfully loaded Waves and if
+  # there's nothing in the way at ./waves
+  if defined?(WAVES) && !File.exist?("#{Dir.pwd}/waves")
+    namespace :freeze do
+      desc "freeze current Waves source to ./waves"
+      task :current do
+        target = "#{Dir.pwd}/waves"
+        current = File.expand_path( WAVES )
+        items = FileList["#{current}/*"]
+        puts "Freezing from: #{current}"
+        items.each do |item|
+          puts "copying #{item}"
+          cp_r item, target
+        end
+
+      end
+    end
+  end
+  
+end

data/app/bin/waves-console

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'startup'
+require 'commands/waves-console'

data/app/bin/waves-server

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'startup'
+require 'commands/waves-server'

data/app/configurations/development.rb.erb

@@ -0,0 +1,31 @@
+module <%= @name %>
+
+  module Configurations
+
+    class Development < Default
+
+      database :adapter => 'sqlite', :database => '<%= @name.downcase %>'
+
+      reloadable [ <%= @name %> ]
+
+      log :level => :debug
+
+      host '127.0.0.1'
+
+      port 3000
+
+      handler ::Rack::Handler::Mongrel, :Host => host, :Port => port
+      # handler ::Rack::Handler::WEBrick, :BindAddress => host, :Port => port
+      # handler ::Rack::Handler::Thin, :Host => host, :Port => port
+
+      application do
+        use ::Rack::ShowExceptions
+        use ::Rack::Static, :urls => [ '/css/', '/javascript/', '/images/' ], :root => 'public'
+        run ::Waves::Dispatchers::Default.new
+      end
+
+    end
+
+  end
+
+end

data/app/configurations/mapping.rb.erb

@@ -0,0 +1,14 @@
+module <%= @name %>
+
+  module Configurations
+
+    module Mapping
+      extend Waves::Mapping
+      # your custom rules go here
+      include Waves::Mapping::PrettyUrls::RestRules
+      include Waves::Mapping::PrettyUrls::GetRules
+    end
+
+  end
+
+end

data/app/configurations/production.rb.erb

@@ -0,0 +1,31 @@
+module <%= @name %>
+
+  module Configurations
+
+    class Production < Default
+
+      database :host => 'localhost', :adapter => 'mysql', :database => '<%= @name.downcase %>',
+        :user => 'root', :password => ''
+
+      reloadable []
+
+      log :level => :error,
+        :output => ( :log / "waves.#{$$}" ),
+        :rotation => :weekly
+
+      host '0.0.0.0'
+
+      port 80
+
+    handler ::Rack::Handler::Mongrel, :Host => host, :Port => port
+      # handler ::Rack::Handler::WEBrick, :BindAddress => host, :Port => port
+      # handler ::Rack::Handler::Thin, :Host => host, :Port => port
+
+      application do
+        use ::Rack::Static, :urls => [ '/css/', '/javascript/', '/images/' ], :root => 'public'
+        run ::Waves::Dispatchers::Default.new
+      end
+
+    end
+  end
+end

data/app/lib/application.rb.erb

@@ -0,0 +1,5 @@
+<%= @orm_require %>
+module <%= @name %>
+  include Waves::Foundations::Default
+  <%= @orm_include %>
+end

data/app/startup.rb

@@ -0,0 +1,5 @@
+lambda {
+  waves = ( ( WAVES if defined? WAVES ) || ENV['WAVES'] || File.join(File.dirname(__FILE__), 'waves') )
+  $:.unshift(File.join( waves, "lib" )) if File.exist? waves
+}.call
+require 'waves'

data/app/templates/errors/not_found_404.mab

@@ -0,0 +1,2 @@
+h1 '404'
+p %q( That URL does not exist on this server. )

data/app/templates/errors/server_error_500.mab

@@ -0,0 +1,2 @@
+h1 '500'
+p %q( Internal server error. Sorry, but your request could not be processed. )

data/app/templates/layouts/default.mab

@@ -0,0 +1,14 @@
+doctype :html4_strict
+
+html do
+
+  head do
+    title @title
+  end
+
+  body do
+    layout_content
+  end
+
+end
+

data/bin/waves

@@ -0,0 +1,84 @@
+#!/usr/bin/env ruby
+
+# = Generate or update a Waves application
+# 
+# The +waves+ script generates a new Waves application or updates an existing app.  The script uses {RakeGen}[http://github.com/automatthew/rakegen] for file copies and template processing, and the current version of RakeGen requires you to affirm that you want to clobber each and every file when doing an update.
+#
+# == Usage
+# 
+#   # Generate a Waves app using the default ORM layer, which is currently Sequel
+#   waves /path/to/app  
+#
+#   # Generate an app using the default ORM layer, which is currently Sequel
+#   waves /path/to/app --orm=active_record
+#
+#   # Generate an app that does not include an ORM layer
+#   waves /path/to/app -o none 
+
+require 'rubygems'
+require 'choice'
+require 'rakegen'
+
+
+
+# if we're in the waves source, prepend it to the load path
+waves_lib = File.expand_path( "#{File.dirname(__FILE__)}/../../waves/lib" )
+$:.unshift waves_lib if File.exist?(waves_lib)
+require 'waves'
+
+begin
+  require 'utilities/string'
+rescue LoadError
+  require File.join(File.dirname(__FILE__), '..', 'lib', 'utilities', 'string')
+end
+
+Choice.options do
+  banner 'Usage:  waves path/to/app [-h]'
+  option :help  do
+    long '--help'
+    desc 'Show this message'
+  end
+  
+  option :orm do
+    short '-o'
+    long '--orm=ORM'
+    desc "Select an ORM (e.g. active_record, sequel, none)"
+    default "sequel"
+  end
+  
+end
+
+orm = Choice.choices.orm.snake_case
+orm_require, orm_include = case orm
+when 'sequel'
+  ["require 'layers/orm/sequel'", "include Waves::Layers::ORM::Sequel"]
+when 'active_record'
+  ["require 'layers/orm/active_record'", "include Waves::Layers::ORM::ActiveRecord"]
+when 'none'
+  ['', '# This app was generated without an ORM layer']
+end
+
+app_path = ARGV[0]
+app_name = File.basename(app_path)
+if app_name =~ /[^\w\d_]/
+  raise ArgumentError, <<-TEXT
+  Unusable name: \"#{app_name}\"
+  Application names may contain only letters, numbers, and underscores."
+TEXT
+end
+
+template = "#{WAVES}/app"
+
+generator = Rakegen.new("waves:app") do |gen|
+  gen.source = template
+  gen.target = app_path
+  gen.template_assigns = {:name => app_name.camel_case, :orm_require => orm_require, :orm_include => orm_include }
+  gen.executables = %w{ bin/waves-console  bin/waves-server}
+end
+
+puts "** Creating new Waves application ..."
+
+Rake::Task["waves:app"].invoke
+
+puts "** Application created!"
+

data/bin/waves-console

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'startup'
+require 'commands/waves-console'

data/bin/waves-server

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'startup'
+require 'commands/waves-server'

data/doc/HISTORY

@@ -0,0 +1,44 @@
+0.7.7
+- ActiveRecord ORM layer
+- base controller helpers that rely on a particular ORM are now defined in the ORM layers
+- Sequel requires moved into the self.included block, to help with the mem footprint
+- rake generate:model reappeared
+- rake waves:freeze and waves:unfreeze
+- Rack::Static declared for /css, /javascript, and /images in generated applications
+- added Lawrence Pit's Haml renderer
+- English inflector pulled into its own layer, in the hope of allowing localization someday
+- utility monkeypatches pulled into modules where possible, for better troubleshooting
+- docs, samples, and verify now actually included in the gem
+- monkeypatch to Tempfile to work around problem with file uploading and Rack.
+0.7.6
+- added metaid as gem dependency
+- Special handling in Windows for interrupts ('cause Windows has trouble with those)
+- Fixed query param destructuring to work for 3+ levels
+0.7.5
+- Foundations and Layers
+- Sequel ORM is now a Layer, instead of being baked in
+- Almost all boilerplate code removed from generated app, by virtue of the Layers refactoring
+- Configuration attribute for selecting a Rack handler
+- Mapping#handle method to register blocks that handle exceptions (e.g. NotFoundError)
+- Blackboard, a very simple shared storaged usable during request processing.
+- Fixed waves script to work when installed as gem (regression)
+- Revised and extended documentation
+- Expanded spec coverage
+0.7.3:
+- Added explicit require for daemons gem
+- Added support for running off source
+- Added support for using SQLite
+- Improved inflection
+- Windows support for waves, waves-server, and waves-console
+0.7.2:
+- Minor bug fixes, improved documentation
+0.7.1:
+- Minor bug fixes, improved documentation
+0.7.0:
+- Minor bug fixes, improved documentation
+0.6.9:
+- Minor bug fixes, improved documentation
+0.6.8:
+- Minor bug fixes, improved documentation
+0.6.7:
+- Initial gem release.

data/doc/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2007-8 Dan Yoder
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/lib/commands/waves-console.rb

@@ -0,0 +1,21 @@
+require 'choice'
+
+Choice.options do
+  header 'Run waves in console mode.'
+  header ''
+  option :mode do
+    short '-c'
+    long '--config=CONFIG'
+    desc 'Configuration to use.'
+    desc 'Defaults to development.'
+    cast Symbol
+  end
+  separator ''
+end
+
+console = Waves::Console.load( Choice.choices )
+Object.send(:define_method, :waves) { console }
+require 'irb'
+require 'irb/completion'
+ARGV.clear
+IRB.start

data/lib/commands/waves-server.rb

@@ -0,0 +1,55 @@
+require 'choice'
+
+Choice.options do
+  header 'Run a waves application server.'
+  header ''
+  option :port  do
+    short '-p'
+    long '--port=PORT'
+    desc 'Port to listen on.'
+    desc 'Defaults to value given in configuration.'
+    cast Integer
+  end
+  separator ''
+  option :host do
+    short '-h'
+    long '--host=HOST'
+    desc 'Host or IP address of the host to bind.'
+    desc 'Defaults to value given in configuration.'
+  end
+  separator ''
+  option :mode do
+    short '-c'
+    long '--config=CONFIG'
+    desc 'Configuration to use.'
+    desc 'Defaults to development.'
+    cast Symbol
+  end
+  separator ''
+  option :directory do
+    short '-D'
+    long '--dir=DIR'
+    desc 'Directory containing the application.'
+    desc 'Defaults to the current directory.'
+  end
+  separator ''
+  option :daemon do
+    short '-d'
+    long '--daemon'
+    desc 'Run as a daemon.'
+  end
+  separator ''
+  option :debugger do
+    short '-u'
+    long '--debugger'
+    desc 'Enable ruby-debug.'
+  end
+  separator ''
+  option :startup do
+    short '-s'
+    long '--startup'
+    desc 'Startup file to load.'
+    desc 'Defaults to "lib/startup.rb"'
+  end
+end
+Waves::Server.run( Choice.choices )