waves-stable 0.7.7

data/lib/views/base.rb

@@ -0,0 +1,9 @@
+module Waves
+  module Views
+    class Base
+      
+      include Waves::Views::Mixin
+      
+    end
+  end  
+end

data/lib/views/mixin.rb

@@ -0,0 +1,110 @@
+module Waves
+
+  # Views in Waves are ultimately responsible for generating the response body. Views mirror controllers - both have full access to the request and response, and both may modify the response and even short-circuit the request processing and return a result by calling redirect or calling Response#finish.
+  #
+  # Views, like controllers, are classes with methods that are invoked by a mapping block (see Waves::Mapping). View instance methods take an assigns hash that are typically converted into instance variables accesible from within a template.
+  #
+  # Like controllers, a default implementation is provided by the +waves+ command when you first create your application. This default can be overridden to change the behaviors for all views, or you can explicitly define a View class to provide specific behavior for one view.
+  #
+  # The default implementation simply determines which template to render and renders it, returning the result as a string. This machinery is provided by the View mixin, so it is easy to create your own View implementations.
+  #
+  # = Templates
+  #
+  # Although you won't typically need to modify or define View classes, you will often create and modify templates. Templates can be evaluated using any registered Renderer. Two are presently packaged with Waves: Markaby and Erubis. Templates have access to the assigns hash passed to the view method as instance variables. These can be explicitly defined by the mapping file or whomever is invoking the view.
+  #
+  # *Example*
+  #
+  #   # Find the story named 'home' and pass it as @story into the "story/show" template
+  #   use( :story ) | controller { find( 'home' ) } | view { |x| show( :story => x ) }
+  #
+  # = Helpers
+  #
+  # Helper methods can be defined for any view template by simply defining them within the default Helper module in <tt>helpers/default.rb</tt> of the generated application. Helpers specific to a particular View class can be explicitly defined by creating a helper module that corresponds to the View class. For examples, for the +User+ View class, you would define a helper module in <tt>user.rb</tt> named +User+.
+  #
+  # The default helper class initially includes a wide-variety of helpers, including helpers for layouts, Textile formatting, rendering forms, and nested views, as well as helpers for accessing the request and response objects. More helpers will be added in future releases, but in many cases, there is no need to include all of them in your application.
+  #
+  # = Layouts
+  #
+  # Layouts are defined using the +Layout+ view class, and layout templates are placed in the +layout+ directory of the +templates+ directory. Layouts are explicitly set within a template using the +layout+ method.
+  #
+  # *Example*
+  #
+  #   layout :default, :title => @story.title do
+  #     h1 @story.title
+  #     textile @story.content
+  #   end
+  #
+  #
+  # The layout method takes a name and an assigns hash that will be available within the layout template as instance variables. In this example, <tt>@title</tt> will be defined as <tt>@story.title</tt> within the layout template named 'default.'
+  #
+  # Any number of layouts may be included within a single view, and layouts may even be nested within layouts. This makes it possible to create large numbers of highly structured views that can be easily changed with minimal effort. For example, you might specify a layout associated with form elements. By incorporating this into your views as a +layout+ template, you can make changes across all your forms by changing this single template.
+  #
+  # = Nested Views
+  #
+  # It is easy to include one view inside another. A common use for this is to define one set of templates for reusable content 'fragments' (somewhat akin to partials in Rails) and another set that incorporate these fragments into specific layouts. Including a view from within another view is done, logically enough, using the +view+ method.
+  #
+  # *Example*
+  #
+  #   # include the summary view for Story
+  #   view :story, :summary, :story => @story
+  #
+  # = Request And Response Objects
+  #
+  # As always, the request and response objects, and a wide-variety of short-cut methods, are available within view templates via the Waves::ResponseMixin.
+  #
+
+  module Views
+
+    class NoTemplateError < Exception ; end
+
+    # A class method that returns the known Renderers, which is any module that is defined within Waves::Renderers and includes the Renderers::Mixin. You can define new Renderers simply be reopening Waves::Renderers and defining a module that mixes in Renderers::Mixin.
+    def Views.renderers
+      return [] if Renderers.constants.nil?
+      Renderers.constants.sort.inject([]) do |rx,cname|
+        ( Module === (c=Renderers.const_get(cname)) &&
+          c < Renderers::Mixin ) ? ( rx << c ) : rx
+      end
+    end
+
+    # The View mixin simply sets up the machinery for invoking a template, along with methods for accessing the request context and the standard interface for invoking a view method.
+    module Mixin
+
+      attr_reader :request
+
+      include Waves::ResponseMixin
+
+      def self.included( c )
+        def c.process( request, *args, &block )
+          self.new( request ).instance_exec( *args, &block )
+        end
+      end
+
+      def initialize( request )
+        @request = request
+        @layout = :default
+      end
+
+      # Return the first renderer for which a template file can be found.
+      # Uses Renderers::Mixin.filename to construct the filename for each renderer.
+      def renderer(path)
+        Views.renderers.find do |renderer|
+          File.exists?( renderer.filename( path ) )
+        end
+      end
+
+      def render( path, context = {} )
+        context.merge!( :request => request )
+        template = renderer( path ) || renderer( :generic / File.basename(path) )
+        raise NoTemplateError.new( path ) if template.nil?
+        template.render( path, context )
+      end
+
+      def method_missing(name,*args)
+        render( "/#{self.class.basename.snake_case}/#{name}", *args )
+      end
+
+    end
+
+  end
+
+end

data/lib/waves.rb

@@ -0,0 +1,84 @@
+# External Dependencies
+require 'rubygems'
+
+# Some scripts need to be able to locate items relative to waves source.
+WAVES = "#{File.dirname(__FILE__)}/.." unless defined?(WAVES)
+
+require 'rack'
+require 'daemons'
+require 'live_console'
+require 'autocode'
+
+# for mimetypes only or when using as default handler
+require 'mongrel'
+
+# a bunch of handy stuff
+require 'extensions/all'
+require 'fileutils'
+require 'metaid'
+require 'forwardable'
+require 'date'
+require 'benchmark'
+# require 'memcache'
+require 'base64'
+
+# selected project-specific extensions
+require 'utilities/module'
+require 'utilities/string'
+require 'utilities/symbol'
+require 'utilities/object'
+require 'utilities/integer'
+require 'utilities/inflect'
+require 'utilities/proc'
+require 'utilities/hash'
+require 'utilities/tempfile'
+# waves Runtime
+require 'dispatchers/base'
+require 'dispatchers/default'
+require 'runtime/logger'
+require 'runtime/mime_types'
+require 'runtime/application'
+require 'runtime/console'
+require 'runtime/debugger'
+require 'runtime/server'
+require 'runtime/request'
+require 'runtime/response'
+require 'runtime/response_mixin'
+require 'runtime/response_proxy'
+require 'runtime/session'
+require 'runtime/blackboard'
+require 'runtime/configuration'
+
+# waves URI mapping
+require 'mapping/mapping'
+require 'mapping/pretty_urls'
+
+# waves mvc support
+require 'controllers/mixin'
+require 'controllers/base'
+require 'views/mixin'
+require 'views/base'
+require 'helpers/tag_helper'
+require 'helpers/url_helper'
+require 'helpers/common'
+require 'helpers/form'
+require 'helpers/formatting'
+require 'helpers/model'
+require 'helpers/view'
+require 'helpers/default'
+require 'helpers/asset_helper'
+require 'helpers/number_helper'
+require 'renderers/mixin'
+require 'renderers/erubis'
+require 'renderers/markaby'
+require 'renderers/haml'
+
+
+# waves foundations / layers
+require 'layers/simple'
+require 'layers/simple_errors'
+require 'foundations/simple'
+require 'layers/mvc'
+require 'layers/default_errors'
+require 'layers/inflect/english'
+require 'foundations/default'

data/samples/blog/Rakefile

@@ -0,0 +1,14 @@
+#!/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
+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 }
+

data/samples/blog/bin/waves-console

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

data/samples/blog/bin/waves-server

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

data/samples/blog/configurations/development.rb

@@ -0,0 +1,31 @@
+module Blog
+
+  module Configurations
+
+    class Development < Default
+
+      database :adapter => 'sqlite', :database => 'blog.db'
+
+      reloadable [ Blog ]
+
+      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' ], :root => 'public'
+        run ::Waves::Dispatchers::Default.new
+      end
+
+    end
+
+  end
+
+end

data/samples/blog/configurations/mapping.rb

@@ -0,0 +1,23 @@
+module Blog
+
+  module Configurations
+
+    module Mapping
+      extend Waves::Mapping
+      
+      path '/', :method => :get do
+        redirect("/entries")
+      end
+      
+      path %r{^/comments/?$}, :method => :post do
+        resource( :comment ) do
+          controller { comment = create; redirect( "/entry/#{comment.entry.name}" ) }
+        end
+      end
+      include Waves::Mapping::PrettyUrls::RestRules
+      include Waves::Mapping::PrettyUrls::GetRules
+    end
+
+  end
+
+end

data/samples/blog/configurations/production.rb

@@ -0,0 +1,30 @@
+module Blog
+
+  module Configurations
+
+    class Production < Default
+
+      database :host => 'localhost', :adapter => 'mysql', :database => 'blog',
+        :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
+        run ::Waves::Dispatchers::Default.new
+      end
+
+    end
+  end
+end

data/samples/blog/lib/application.rb

@@ -0,0 +1,5 @@
+require 'layers/orm/sequel'
+module Blog
+  include Waves::Foundations::Default
+  include Waves::Layers::ORM::Sequel
+end

data/samples/blog/models/comment.rb

@@ -0,0 +1,14 @@
+module Blog
+
+  module Models
+
+    class Comment < Default
+      many_to_one :entry, :class => Blog::Models::Entry
+      before_save do
+        set_with_params(:updated_on => Time.now) if columns.include? :updated_on
+      end
+    end
+
+  end
+
+end

data/samples/blog/models/entry.rb

@@ -0,0 +1,14 @@
+module Blog
+
+  module Models
+
+    class Entry < Default
+      one_to_many :comments, :class => Blog::Models::Comment, :key => :entry_id, :order => :updated_on
+      before_save do
+        set_with_params(:updated_on => Time.now) if columns.include? :updated_on
+      end
+    end
+
+  end
+
+end

data/samples/blog/public/css/site.css

@@ -0,0 +1,2 @@
+body { font-family: Verdana, Arial, sans-serif; background-color: white; }
+h1, h2, h3, p, label, li { margin-bottom: 20px; }

data/samples/blog/public/javascript/site.js

@@ -0,0 +1,13 @@
+$(document).ready( function() {
+  $('a.delete').click( function() {
+    if ( confirm("Are you sure?") ) {
+      var href = $(this).attr('href');
+      $.ajax({ type: 'delete', url: href,
+        success: function() { window.location = '/entries'; }
+      });
+    }
+    // this isn't really a link ...
+    // so tell the browser we've handled it
+    return false;
+  });
+});

data/samples/blog/schema/migrations/001_initial_schema.rb

@@ -0,0 +1,17 @@
+class InitialSchema < Sequel::Migration
+
+  def up
+    create_table :entries do
+      primary_key :id
+      text :name
+      text :title
+      text :summary
+      text :content
+    end
+  end
+
+  def down
+    drop_table :entries
+  end
+
+end

data/samples/blog/schema/migrations/002_add_comments.rb

@@ -0,0 +1,18 @@
+class AddComments < Sequel::Migration
+
+  def up
+    create_table :comments do
+      primary_key :id
+      foreign_key :entry_id, :table => :entries
+      text :name
+      text :email
+      text :content
+      timestamp :updated_on
+    end
+  end
+
+  def down
+    drop_table :comments
+  end
+
+end

data/samples/blog/schema/migrations/templates/empty.rb.erb

@@ -0,0 +1,9 @@
+class <%= class_name %> < Sequel::Migration
+
+  def up
+  end
+
+  def down
+  end
+
+end

data/samples/blog/startup.rb

@@ -0,0 +1,6 @@
+WAVES = File.join(File.dirname(__FILE__), "..", "..")
+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/samples/blog/templates/comment/add.mab

@@ -0,0 +1,10 @@
+form :action => "/comments", :method => 'POST' do
+  input :type => :hidden, :name => 'comment.entry_id', :value => @entry.id
+  label 'Name'; br
+  input :type => :text, :name => 'comment.name'; br
+  label 'Email'; br
+  input :type => :text, :name => 'comment.email'; br
+  label 'Comment'; br
+  textarea :name => 'comment.content', :rows => 10, :cols => 80; br
+  input :type => :submit, :value => 'Save'
+end