Roach 0.1 is the beginnings of what will become a stand alone application
server.  currently it's a useful framework.  or so i think :)  it's an
evolution from what used to be called rappsrv.

kick it around, i'd love to have some feedback and i hope someone will find
it useful as well.

also, i'm looking at the current ruby web servers, hoping to integrate one.
if you have any opinions about the ones about there (wwwd, wwwsrv) i'd love
to hear them.

thanks, enjoy,
 aaron



README: 

Roach 0.1   http://outerbody.com/var/ruby/roach/


This is a sample website using the Roach web application framework.  I call
it a framework now because it doesnt run as a daemon, but later I'll call it
an application server.

Roach is currently in use at outerbody.com if you'd like to see it living in
a larger setting.  

Visit the outerbody message boards <http://outerbody.com/bb/> for comments,
questions or suggestions...

enjoy...

---------------

Quick Start ...thats all there is right now :)


 * Install eruby.
 * Be sure that the first line of index.rb points to your ruby executable.
 * Edit app/conf/Config and add entries in the Config.actions.  The format
is:
	"<action name>"    => [ "<action classname>" , <args> ],
 * action name - is the cgi value of the 'do' property
 * action class - is the subclass of Action that is in the actions directory
(action name and filename must be the same).
 * args - which will be passed to the action's run() method

Basic Principles

 *  'Request' and 'Response' objects handle issues of input and output as
you'd expect.
 *  Sub classes of 'Action' are the handlers or *controllers*.  
 *  The content or *viewers* are rsp files in the app/rsp directory.
 *  Core Roach files are in the app/lib directory.
 *  Application specific non action sources go in app/src.

Upcoming Features

 * running in process (perhaps mod_ruby or wwwd)
 * built in user based access control
 * logging functions
 * form &amp; validation objects 
 * custom tags
 * more extensive samples
 * more elaborate documentation


Warranty

This software is provided "as is" and without any express or implied
warranties, including, without limitation, the implied warranties of
merchantibility and fitness for a particular purpose.  Furthermore, if you
suffer loss do to use, the author will likely be amused.