add content for RackMiddleware

Signed-off-by: Chris Schneider <chris@christopher-schneider.com>
cschneid · Dec 28, 2008 · afb57f8 · afb57f8
1 parent 94751c0
commit afb57f8
Show file tree

Hide file tree

Showing 22 changed files with 25 additions and 3 deletions.
diff --git a/.gitignore b/.gitignore
diff --git a/CONTRIBUTING b/CONTRIBUTING
diff --git a/TODO b/TODO
diff --git a/assets/book.css b/assets/book.css
diff --git a/book-order.txt b/book-order.txt
diff --git a/book/.gitignore b/book/.gitignore
diff --git a/book/Configuration.markdown b/book/Configuration.markdown
diff --git a/book/Contributing.markdown b/book/Contributing.markdown
diff --git a/book/Deployment.markdown b/book/Deployment.markdown
diff --git a/book/ErrorHandling.markdown b/book/ErrorHandling.markdown
diff --git a/book/Filters.markdown b/book/Filters.markdown
diff --git a/book/Handlers.markdown b/book/Handlers.markdown
diff --git a/book/Helpers.markdown b/book/Helpers.markdown
diff --git a/book/Introduction.markdown b/book/Introduction.markdown
diff --git a/book/Models.markdown b/book/Models.markdown
diff --git a/book/RackMiddleware.markdown b/book/RackMiddleware.markdown
@@ -1,8 +1,30 @@
 Rack Middleware
 ===============
 
-"use"
+Sinatra rides on [Rack][rack], a minimal standard interface for Ruby web frameworks. One of Rack’s most interesting capabilities for application developers is support for “middleware” — components that sit between the server and your application monitoring and/or manipulating the HTTP request/response to provide various types of common functionality.
------
 
-// TODO: What useful rack middleware is out there?  Is there any 3rd party stuff available outside of the builtin ones?
+Sinatra makes building Rack middleware pipelines a cinch via a top-level "use" method:
+
+	require 'sinatra'
+	require 'my_custom_middleware'
+
+	use Rack::Lint
+	use MyCustomMiddleware
+
+	get '/hello' do
+	    'Hello World'
+	end
+
+
+The semantics of "use" are identical to those defined for the [Rack::Builder][rack_builder]  DSL (most frequently used from rackup files). For example, the use  method accepts multiple/variable args as well as blocks:
+
+	use Rack::Auth::Basic do |username, password|
+	   username == 'admin' && password == 'secret'
+	end
+
+
+Rack is distributed with a variety of standard middleware for logging, debugging, URL routing, authentication, and session handling. Sinatra uses many of of these components automatically based on configuration so you typically don’t have to use them explicitly.
+
+[rack]: http://rack.rubyforge.org/
+[rack_builder]: http://rack.rubyforge.org/doc/classes/Rack/Builder.html
 
diff --git a/book/Routes.markdown b/book/Routes.markdown
diff --git a/book/TOC.markdown b/book/TOC.markdown
diff --git a/book/Views.markdown b/book/Views.markdown
diff --git a/images/.gitignore b/images/.gitignore
diff --git a/sinatra-book.thor b/sinatra-book.thor
diff --git a/source/.gitignore b/source/.gitignore