Parasite: Turning Rails into Camping Generator
==============================================

Parasite turns Rails into a Camping creator. Use generators, config files, and rake tasks to build Camping apps faster and better.

Components
==========

Parasite is composed of two components: a generator to make new camping apps and a rake task to launch your camping apps using your rails environment (i.e. development, production, testing).

Usage is straightforward:

$ script/generate camping
Usage: script/generate camping CampingName [options] [ModelOne ModelTwo ...]

Options:
--scaffold Generate controllers and views
--session Add session support
--stylesheet Include a dynamic style sheet

General Options:
-p, --pretend Run but do not make any changes.
-f, --force Overwrite files that already exist.
-s, --skip Skip files that already exist.
-q, --quiet Suppress normal output.
-t, --backtrace Debugging: show backtrace on errors.
-h, --help Show this help message.
-c, --svn Modify files with subversion. (Note: svn must be in path)

Description:
The camping generator creates a new camping app in a single file in the /app
directory.

Example:
./script/generate camping Blog

This will create a Blog app with models, views, controllers, and the
appropriate pre-amble and post-amble.

For the rake task,

$ rake camping

will run all your .rb files in the /app directory. It uses the configuration found in /config/database.yml, so make sure to update this prior use using the rake task. You can also load only specific files using

$ rake camping app/my_file.rb app/my_other_app.rb ...

For now, this task can only serve the camping apps using WEBrick. Future versions will support Mongrel as well.

Future Development
==================

Right now, the camping generator works off of one giant template file. In future versions, this file will be split into the relevant parts (e.g. pre_amble.rb, views.rb, controllers.rb, etc). This will allow creation of specific component files for larger camping apps (e.g. myapp/controllers/controller1.rb, myapp/controllers/controller2.rb, etc). A rake task will also be created to locally install these generators over the usual rails generators, thus more fully turning the rails environment into a camping creator.