0
@@ -32,7 +32,45 @@
0
   delete '/' do
0
     .. annihilate something ..
0
   end
0
+  
0
+  head '/' do
0
+  
0
+  end
0
 
0
+NOTE:  <tt>put</tt> and <tt>delete</tt> are triggered when a <tt>_method</tt> param is set to PUT or DELETE and the HTTP_REQUEST_METHOD is a POST
0
+
0
+= Routes
0
+
0
+NOTE: Routes are looked up in order of declaration
0
+
0
+Simple
0
+
0
+  get '/hi' do
0
+    ...
0
+  end
0
+  
0
+With params
0
+
0
+  get '/:name' do
0
+    # matches /sinatra and the like and sets params[:name]
0
+  end
0
+  
0
+Splat'n
0
+
0
+  get '/message/*' do
0
+    # matches /message/1/2/3/4/5
0
+  end
0
+  
0
+Get an agent!
0
+  
0
+  get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do
0
+    "You're using Songbird version #{params[:agent][0]}"
0
+  end
0
+
0
+  get '/foo' do
0
+    # matches non-songbird browsers
0
+  end
0
+
0
 = Views (if you need MVC)
0
 
0
 All views are looked up in:
0
0
@@ -98,9 +136,15 @@
0
     end
0
     
0
   end
0
+  
0
+  get '/:name' do
0
+    bar(params[:name])
0
+  end
0
 
0
 = Before filters
0
 
0
+These are run in Sinatra::EventContext
0
+
0
   before do
0
     .. this code will run before each event ..
0
   end
0
@@ -150,4 +194,139 @@
0
   end
0
 
0
 Get the gist?  If you want more fun with this then checkout <tt>to_result</tt> on Array, Symbol, Fixnum, NilClass.
0
+
0
+= Configuration & Re-loading
0
+
0
+Sinatra supports multiple environments and re-loading.  Re-loading happens on every request when in :development.  Wrap your configurations in <tt>configure</tt> (i.e. Database connections, Constants, etc.) to protect them from re-loading and to only work in certain environments.
0
+
0
+All environments:
0
+
0
+  configure do
0
+  
0
+  end
0
+  
0
+Production
0
+
0
+  configure :production do
0
+  
0
+  end
0
+  
0
+Two at a time:
0
+
0
+  configure :production, :test do
0
+  
0
+  end
0
+  
0
+This is also really nifty for error handling.
0
+
0
+= Error handling
0
+
0
+=== Not Found
0
+
0
+Remember:  These are run inside the Sinatra::EventContext which means you get all the goodies is has to offer (i.e. haml, erb, :halt, etc.)
0
+
0
+Whenever NotFound is raised this will be called
0
+
0
+  not_found do
0
+    'This is nowhere to be found'
0
+  end
0
+  
0
+=== Error
0
+  
0
+  error do
0
+    # this is where the error is stored for you to grab
0
+    name = env['sinatra.error'].class.name  
0
+    'ah shizzle! ' + name
0
+  end
0
+  
0
+Because Sinatra give you a default <tt>not_found</tt> and <tt>error</tt> do :production that are secure.  If you want to customize only for :production but want to keep the friendly helper screens for :development then do this:
0
+
0
+  configure :production do
0
+
0
+    not_found do
0
+      "We're so sorry, but we don't what this is"
0
+    end
0
+    
0
+    error do
0
+      "Something really nasty happened.  We're on it!"
0
+    end
0
+  
0
+  end
0
+
0
+= Testing
0
+
0
+=== Test/Unit
0
+
0
+  require 'my_sinatra_app'
0
+  require 'sinatra/test/unit'
0
+  
0
+  class MyAppTest < Test::Unit::TestCase
0
+    
0
+    def test_my_default
0
+      get_it '/'
0
+      assert_equal 'My Default Page!', @response.body
0
+    end
0
+    
0
+    def test_with_agent
0
+      get_it '/', :agent => 'Songbird'
0
+      assert_equal 'You're in Songbird!', @response.body
0
+    end
0
+    
0
+    ...
0
+    
0
+  end
0
+  
0
+=== Test/Spec
0
+
0
+  require 'my_sinatra_app'
0
+  require 'sinatra/test/spec'
0
+
0
+  context 'My app'
0
+  
0
+    should "show a default page" do
0
+      get_it '/'
0
+      should.be.ok
0
+      @response.body.should.equal 'My Default Page!'
0
+    end
0
+    ...
0
+  
0
+  end
0
+  
0
+== Test helpers
0
+
0
+See Sinatra::Test::Methods
0
+
0
+= Irb
0
+
0
+This will be back in soon
0
+
0
+= Command line
0
+
0
+Run your sinatra file like:
0
+  
0
+  ruby myapp.rb [options]
0
+
0
+Options are:
0
+
0
+  -h # help
0
+  -p # set the port (default is 4567)
0
+  -e # set the environment (default is development)
0
+  -x # turn on the mutext lock (default is off)
0
+
0
+= Contribute
0
+
1
+  cd where/you/keep/your/projects
0
+  git clone git://github.com/bmizerany/sinatra.git
0
+  cd your_project
0
+  ln -s ../sinatra/
0
+
0
+at the top of your sinatra.rb file
0
+
0
+  $:.unshift File.dirname(__FILE__) + '/sinatra/lib'
0
+  require 'sinatra'
0
+
0
+  get '/about' do
0
+    "I'm running on Version " + Sinatra::Version.combined
0
+  end
0
+  

0
@@ -76,6 +76,15 @@
0
 module Sinatra
0
   extend self
0
 
0
+  module Version
0
+    MAJOR = '0'
0
+    MINOR = '2'
0
+    REVISION = '0'
0
+    def self.combined
0
+      [MAJOR, MINOR, REVISION].join('.')
0
+    end
0
+  end
0
+
0
   class NotFound < RuntimeError; end
0
   class ServerError < RuntimeError; end
0