README.rdoc in sinatra-gen-0.3.0 vs README.rdoc in sinatra-gen-0.4.0

- old
+ new

@@ -7,29 +7,31 @@ sinatra-gen generates a common file structure and basic app files for a web app utilizing the sinatra framework. For more information on sinatra, check out http://sinatrarb.com == SYNOPSIS: -sinatra-gen has a bunch of different options (based loosley on merb-gen) to try to not lock the +sinatra-gen has a bunch of different options (based looseley on merb-gen) to try to not lock the user into any specific frameworks/dev practices. Run: sinatra-gen [appname] [options] [paths] e.g. sinatra-gen mysinatrapp --vendor --init --test=shoulda --views=haml get:/ post:/:id +! Note: As of version 0.4.0 by default the sinatra app is placed in lib/appname.rb and is a subclass of Sinatra::Application. If you want 'classic' style apps (no class/module) use the --tiny option. + === Actions For even faster app development you specify actions to include in your app when generating. Actions are written out as http_method:path -And are seperated by spaces. For example: +And are separated by spaces. For example: get:/ post:/:id put:/update/* Will be added you your app as: @@ -42,10 +44,26 @@ put '/update/*' do end It will also generate test skeletons in the test framework of your choosing. +=== Middleware + +You can specify middleware to include by passing the filename(s) or class name(s), seperated by commas. + + sinatra-gen myapp --middleware=rack/flash,Rack::Cache + +Will place both the 'require' and 'use' statements in your app. + + require 'rack/flash' + require 'rack/cache' + + #... + + use Rack::Flash + use Rack::Cache + === Options (can also be obtained by running sinatra-gen with no arguments): -v, --version Show the sinatra-gen version number and quit. @@ -56,10 +74,12 @@ Optionally, specify the path to the heroku bin --cap Adds config directory with basic capistrano deploy.rb --scripts Install the rubigen scripts (script/generate, script/destroy) --test=test_framework Specify your testing framework (bacon (default)/rspec/spec/shoulda/test) --views=view_framework Specify your view framework (haml (default)/erb/builder) + --middleware=rack-middleware Specify Rack Middleware to be required and included (comma delimited) + --vegas, --bin=[bin_name] Create an executable bin using Vegas. Pass an optional bin_name General Options: -h, --help Show this help message and quit. -p, --pretend Run but do not make any changes. -f, --force Overwrite files that already exist. -s, --skip Skip files that already exist. @@ -76,15 +96,18 @@ Big props to the Sinatra developers (http://github.com/bmizerany/sinatra/). Also, thanks to Dr. Nic (http://github.com/drnic) for the Rubigen and Newgem libraries == REQUIREMENTS: -To use the --vendor option, git must be installed. +To use the --vendor option, git must be installed. +To use the --bin/vegas option Vegas is required (sudo gem install vegas). +To use the --heroku option, a Heroku account and the heroku gem is required (sudo gem install heroku). + To run the app without using the vendor option, the sinatra gem must be installed. == INSTALL: - sudo gem install sintra-gen + sudo gem install sinatra-gen You can also install directly from github: sudo gem install quirkey-sinatra-gen -s http://gems.github.com