Unpack rack-1.0.1 into vendor/gems directory
This allows msfweb to be run without requiring rack to be pre-installed as a gem. git-svn-id: file:///home/svn/framework3/trunk@8031 4d416f70-5f16-0410-b530-b9f4589650daunstable
parent
829b239b22
commit
29920bc94b
|
@ -4,7 +4,7 @@
|
|||
ENV['RAILS_ENV'] = 'production'
|
||||
|
||||
# Specifies gem version of Rails to use when vendor/rails is not present
|
||||
RAILS_GEM_VERSION = '2.3.2' unless defined? RAILS_GEM_VERSION
|
||||
RAILS_GEM_VERSION = '2.3.5' unless defined? RAILS_GEM_VERSION
|
||||
|
||||
|
||||
#
|
||||
|
|
|
@ -0,0 +1,18 @@
|
|||
Copyright (c) 2007, 2008, 2009 Christian Neukirchen <purl.org/net/chneukirchen>
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to
|
||||
deal in the Software without restriction, including without limitation the
|
||||
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
|
||||
sell copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in
|
||||
all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
||||
THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
@ -0,0 +1,18 @@
|
|||
= Known issues with Rack and Web servers
|
||||
|
||||
* Lighttpd sets wrong SCRIPT_NAME and PATH_INFO if you mount your
|
||||
FastCGI app at "/". This can be fixed by using this middleware:
|
||||
|
||||
class LighttpdScriptNameFix
|
||||
def initialize(app)
|
||||
@app = app
|
||||
end
|
||||
|
||||
def call(env)
|
||||
env["PATH_INFO"] = env["SCRIPT_NAME"].to_s + env["PATH_INFO"].to_s
|
||||
env["SCRIPT_NAME"] = ""
|
||||
@app.call(env)
|
||||
end
|
||||
end
|
||||
|
||||
Of course, use this only when your app runs at "/".
|
|
@ -0,0 +1,428 @@
|
|||
|
||||
== Rack::Auth::Basic
|
||||
* should challenge correctly when no credentials are specified
|
||||
* should rechallenge if incorrect credentials are specified
|
||||
* should return application output if correct credentials are specified
|
||||
* should return 400 Bad Request if different auth scheme used
|
||||
* realm as optional constructor arg
|
||||
|
||||
== Rack::Auth::Digest::MD5
|
||||
* should challenge when no credentials are specified
|
||||
* should return application output if correct credentials given
|
||||
* should return application output if correct credentials given (hashed passwords)
|
||||
* should rechallenge if incorrect username given
|
||||
* should rechallenge if incorrect password given
|
||||
* should rechallenge with stale parameter if nonce is stale
|
||||
* should return 400 Bad Request if incorrect qop given
|
||||
* should return 400 Bad Request if incorrect uri given
|
||||
* should return 400 Bad Request if different auth scheme used
|
||||
* should not require credentials for unprotected path
|
||||
* should challenge when no credentials are specified for protected path
|
||||
* should return application output if correct credentials given for protected path
|
||||
* should return application output if correct credentials given for POST
|
||||
* should return application output if correct credentials given for PUT (using method override of POST)
|
||||
* realm as optional constructor arg
|
||||
|
||||
== Rack::Auth::OpenID
|
||||
* realm uri should be valid
|
||||
* should be able to check if a uri is within the realm (empty)
|
||||
* return_to should be valid
|
||||
* extensions should have required constants defined
|
||||
* extensions should have Request and Response defined and inherit from OpenID::Extension
|
||||
|
||||
== Rack::Builder
|
||||
* chains apps by default
|
||||
* has implicit #to_app
|
||||
* supports blocks on use
|
||||
* has explicit #to_app
|
||||
* apps are initialized once
|
||||
|
||||
== Rack::Adapter::Camping
|
||||
* works with GET
|
||||
* works with POST
|
||||
|
||||
== Rack::Cascade
|
||||
* should dispatch onward on 404 by default
|
||||
* should dispatch onward on whatever is passed
|
||||
* should fail if empty
|
||||
* should append new app
|
||||
|
||||
== Rack::Handler::CGI
|
||||
* startup (empty)
|
||||
* should respond
|
||||
* should be a lighttpd
|
||||
* should have rack headers
|
||||
* should have CGI headers on GET
|
||||
* should have CGI headers on POST
|
||||
* should support HTTP auth
|
||||
* should set status
|
||||
* shutdown
|
||||
|
||||
== Rack::Chunked
|
||||
* chunks responses with no Content-Length
|
||||
* chunks empty bodies properly
|
||||
* does not modify response when Content-Length header present
|
||||
* does not modify response when client is HTTP/1.0
|
||||
* does not modify response when Transfer-Encoding header already present
|
||||
* does not modify response when status code is 100
|
||||
* does not modify response when status code is 204
|
||||
* does not modify response when status code is 304
|
||||
|
||||
== Rack::CommonLogger
|
||||
* should log to rack.errors by default
|
||||
* should log to anything with <<
|
||||
|
||||
== Rack::ConditionalGet
|
||||
* should set a 304 status and truncate body when If-Modified-Since hits
|
||||
* should set a 304 status and truncate body when If-None-Match hits
|
||||
* should not affect non-GET/HEAD requests
|
||||
|
||||
== Rack::ContentLength
|
||||
* sets Content-Length on String bodies if none is set
|
||||
* sets Content-Length on Array bodies if none is set
|
||||
* does not set Content-Length on variable length bodies
|
||||
* does not change Content-Length if it is already set
|
||||
* does not set Content-Length on 304 responses
|
||||
* does not set Content-Length when Transfer-Encoding is chunked
|
||||
|
||||
== Rack::ContentType
|
||||
* sets Content-Type to default text/html if none is set
|
||||
* sets Content-Type to chosen default if none is set
|
||||
* does not change Content-Type if it is already set
|
||||
* case insensitive detection of Content-Type
|
||||
|
||||
== Rack::Deflater
|
||||
* should be able to deflate bodies that respond to each
|
||||
* should be able to deflate String bodies
|
||||
* should be able to gzip bodies that respond to each
|
||||
* should be able to fallback to no deflation
|
||||
* should be able to skip when there is no response entity body
|
||||
* should handle the lack of an acceptable encoding
|
||||
* should handle gzip response with Last-Modified header
|
||||
* should do nothing when no-transform Cache-Control directive present
|
||||
|
||||
== Rack::Directory
|
||||
* serves directory indices
|
||||
* passes to app if file found
|
||||
* serves uri with URL encoded filenames
|
||||
* does not allow directory traversal
|
||||
* 404s if it can't find the file
|
||||
|
||||
== Rack::Handler::FastCGI
|
||||
* startup (empty)
|
||||
* should respond
|
||||
* should be a lighttpd
|
||||
* should have rack headers
|
||||
* should have CGI headers on GET
|
||||
* should have CGI headers on POST
|
||||
* should support HTTP auth
|
||||
* should set status
|
||||
* shutdown
|
||||
|
||||
== Rack::File
|
||||
* serves files
|
||||
* sets Last-Modified header
|
||||
* serves files with URL encoded filenames
|
||||
* does not allow directory traversal
|
||||
* does not allow directory traversal with encoded periods
|
||||
* 404s if it can't find the file
|
||||
* detects SystemCallErrors
|
||||
* returns bodies that respond to #to_path
|
||||
|
||||
== Rack::Handler
|
||||
* has registered default handlers
|
||||
* handler that doesn't exist should raise a NameError
|
||||
* should get unregistered, but already required, handler by name
|
||||
* should register custom handler
|
||||
* should not need registration for properly coded handlers even if not already required
|
||||
|
||||
== Rack::Head
|
||||
* response (empty)
|
||||
* passes GET, POST, PUT, DELETE, OPTIONS, TRACE requests
|
||||
* removes body from HEAD requests
|
||||
|
||||
== Rack::Lint
|
||||
* passes valid request
|
||||
* notices fatal errors
|
||||
* notices environment errors
|
||||
* notices input errors
|
||||
* notices error errors
|
||||
* notices status errors
|
||||
* notices header errors
|
||||
* notices content-type errors
|
||||
* notices content-length errors
|
||||
* notices body errors
|
||||
* notices input handling errors
|
||||
* notices error handling errors
|
||||
* notices HEAD errors
|
||||
* passes valid read calls
|
||||
|
||||
== Rack::Lint::InputWrapper
|
||||
* delegates :size to underlying IO object
|
||||
* delegates :rewind to underlying IO object
|
||||
|
||||
== Rack::Lobster::LambdaLobster
|
||||
* should be a single lambda
|
||||
* should look like a lobster
|
||||
* should be flippable
|
||||
|
||||
== Rack::Lobster
|
||||
* should look like a lobster
|
||||
* should be flippable
|
||||
* should provide crashing for testing purposes
|
||||
|
||||
== Rack::Lock
|
||||
* should call synchronize on lock
|
||||
* should set multithread flag to false
|
||||
* should reset original multithread flag when exiting lock
|
||||
|
||||
== Rack::MethodOverride
|
||||
* should not affect GET requests
|
||||
* _method parameter should modify REQUEST_METHOD for POST requests
|
||||
* X-HTTP-Method-Override header should modify REQUEST_METHOD for POST requests
|
||||
* should not modify REQUEST_METHOD if the method is unknown
|
||||
* should not modify REQUEST_METHOD when _method is nil
|
||||
* should store the original REQUEST_METHOD prior to overriding
|
||||
|
||||
== Rack::MockRequest
|
||||
* should return a MockResponse
|
||||
* should be able to only return the environment
|
||||
* should provide sensible defaults
|
||||
* should allow GET/POST/PUT/DELETE
|
||||
* should set content length
|
||||
* should allow posting
|
||||
* should use all parts of an URL
|
||||
* should behave valid according to the Rack spec
|
||||
|
||||
== Rack::MockResponse
|
||||
* should provide access to the HTTP status
|
||||
* should provide access to the HTTP headers
|
||||
* should provide access to the HTTP body
|
||||
* should provide access to the Rack errors
|
||||
* should optionally make Rack errors fatal
|
||||
|
||||
== Rack::Handler::Mongrel
|
||||
* should respond
|
||||
* should be a Mongrel
|
||||
* should have rack headers
|
||||
* should have CGI headers on GET
|
||||
* should have CGI headers on POST
|
||||
* should support HTTP auth
|
||||
* should set status
|
||||
* should provide a .run
|
||||
* should provide a .run that maps a hash
|
||||
* should provide a .run that maps a urlmap
|
||||
* should provide a .run that maps a urlmap restricting by host
|
||||
* should stream #each part of the response
|
||||
|
||||
== Rack::Recursive
|
||||
* should allow for subrequests
|
||||
* should raise error on requests not below the app
|
||||
* should support forwarding
|
||||
|
||||
== Rack::Request
|
||||
* wraps the rack variables
|
||||
* can figure out the correct host
|
||||
* can parse the query string
|
||||
* can parse POST data
|
||||
* can parse POST data with explicit content type
|
||||
* does not parse POST data when media type is not form-data
|
||||
* rewinds input after parsing POST data
|
||||
* cleans up Safari's ajax POST body
|
||||
* can get value by key from params with #[]
|
||||
* can set value to key on params with #[]=
|
||||
* values_at answers values by keys in order given
|
||||
* referrer should be extracted correct
|
||||
* can cache, but invalidates the cache
|
||||
* can figure out if called via XHR
|
||||
* can parse cookies
|
||||
* parses cookies according to RFC 2109
|
||||
* provides setters
|
||||
* provides the original env
|
||||
* can restore the URL
|
||||
* can restore the full path
|
||||
* can handle multiple media type parameters
|
||||
* can parse multipart form data
|
||||
* can parse big multipart form data
|
||||
* can detect invalid multipart form data
|
||||
* shouldn't try to interpret binary as utf8
|
||||
* should work around buggy 1.8.* Tempfile equality
|
||||
* does conform to the Rack spec
|
||||
* should parse Accept-Encoding correctly
|
||||
* should provide ip information
|
||||
* should allow subclass request to be instantiated after parent request
|
||||
* should allow parent request to be instantiated after subclass request
|
||||
|
||||
== Rack::Response
|
||||
* has sensible default values
|
||||
* can be written to
|
||||
* can set and read headers
|
||||
* can set cookies
|
||||
* formats the Cookie expiration date accordingly to RFC 2109
|
||||
* can set secure cookies
|
||||
* can set http only cookies
|
||||
* can delete cookies
|
||||
* can do redirects
|
||||
* has a useful constructor
|
||||
* has a constructor that can take a block
|
||||
* doesn't return invalid responses
|
||||
* knows if it's empty
|
||||
* should provide access to the HTTP status
|
||||
* should provide access to the HTTP headers
|
||||
* does not add or change Content-Length when #finish()ing
|
||||
* updates Content-Length when body appended to using #write
|
||||
|
||||
== Rack::RewindableInput
|
||||
=== given an IO object that is already rewindable
|
||||
* should be able to handle to read()
|
||||
* should be able to handle to read(nil)
|
||||
* should be able to handle to read(length)
|
||||
* should be able to handle to read(length, buffer)
|
||||
* should be able to handle to read(nil, buffer)
|
||||
* should rewind to the beginning when #rewind is called
|
||||
* should be able to handle gets
|
||||
* should be able to handle each
|
||||
* should not buffer into a Tempfile if no data has been read yet
|
||||
* should buffer into a Tempfile when data has been consumed for the first time
|
||||
* should close the underlying tempfile upon calling #close
|
||||
* should be possibel to call #close when no data has been buffered yet (empty)
|
||||
* should be possible to call #close multiple times (empty)
|
||||
=== given an IO object that is not rewindable
|
||||
* should be able to handle to read()
|
||||
* should be able to handle to read(nil)
|
||||
* should be able to handle to read(length)
|
||||
* should be able to handle to read(length, buffer)
|
||||
* should be able to handle to read(nil, buffer)
|
||||
* should rewind to the beginning when #rewind is called
|
||||
* should be able to handle gets
|
||||
* should be able to handle each
|
||||
* should not buffer into a Tempfile if no data has been read yet
|
||||
* should buffer into a Tempfile when data has been consumed for the first time
|
||||
* should close the underlying tempfile upon calling #close
|
||||
* should be possibel to call #close when no data has been buffered yet (empty)
|
||||
* should be possible to call #close multiple times (empty)
|
||||
=== given an IO object whose rewind method raises Errno::ESPIPE
|
||||
* should be able to handle to read()
|
||||
* should be able to handle to read(nil)
|
||||
* should be able to handle to read(length)
|
||||
* should be able to handle to read(length, buffer)
|
||||
* should be able to handle to read(nil, buffer)
|
||||
* should rewind to the beginning when #rewind is called
|
||||
* should be able to handle gets
|
||||
* should be able to handle each
|
||||
* should not buffer into a Tempfile if no data has been read yet
|
||||
* should buffer into a Tempfile when data has been consumed for the first time
|
||||
* should close the underlying tempfile upon calling #close
|
||||
* should be possibel to call #close when no data has been buffered yet (empty)
|
||||
* should be possible to call #close multiple times (empty)
|
||||
|
||||
== Rack::Session::Cookie
|
||||
* creates a new cookie
|
||||
* loads from a cookie
|
||||
* survives broken cookies
|
||||
* barks on too big cookies
|
||||
* creates a new cookie with integrity hash
|
||||
* loads from a cookie wih integrity hash
|
||||
* ignores tampered with session cookies
|
||||
|
||||
== Rack::Session::Memcache
|
||||
* MemCache can connect to existing server (empty)
|
||||
* faults on no connection
|
||||
* creates a new cookie
|
||||
* determines session from a cookie
|
||||
* survives nonexistant cookies
|
||||
* maintains freshness
|
||||
* deletes cookies with :drop option
|
||||
* provides new session id with :renew option
|
||||
* omits cookie with :defer option
|
||||
* multithread: should cleanly merge sessions (empty)
|
||||
|
||||
== Rack::Session::Pool
|
||||
* creates a new cookie
|
||||
* determines session from a cookie
|
||||
* survives nonexistant cookies
|
||||
* deletes cookies with :drop option
|
||||
* provides new session id with :renew option
|
||||
* omits cookie with :defer option
|
||||
* multithread: should merge sessions (empty)
|
||||
|
||||
== Rack::ShowExceptions
|
||||
* catches exceptions
|
||||
|
||||
== Rack::ShowStatus
|
||||
* should provide a default status message
|
||||
* should let the app provide additional information
|
||||
* should not replace existing messages
|
||||
* should pass on original headers
|
||||
* should replace existing messages if there is detail
|
||||
|
||||
== Rack::Static
|
||||
* serves files
|
||||
* 404s if url root is known but it can't find the file
|
||||
* calls down the chain if url root is not known
|
||||
|
||||
== Rack::Handler::Thin
|
||||
* should respond
|
||||
* should be a Thin
|
||||
* should have rack headers
|
||||
* should have CGI headers on GET
|
||||
* should have CGI headers on POST
|
||||
* should support HTTP auth
|
||||
* should set status
|
||||
|
||||
== Rack::URLMap
|
||||
* dispatches paths correctly
|
||||
* dispatches hosts correctly
|
||||
* should be nestable
|
||||
* should route root apps correctly
|
||||
|
||||
== Rack::Utils
|
||||
* should escape correctly
|
||||
* should escape correctly for multibyte characters
|
||||
* should unescape correctly
|
||||
* should parse query strings correctly
|
||||
* should parse nested query strings correctly
|
||||
* should build query strings correctly
|
||||
* should figure out which encodings are acceptable
|
||||
* should return the bytesize of String
|
||||
|
||||
== Rack::Utils::HeaderHash
|
||||
* should retain header case
|
||||
* should check existence of keys case insensitively
|
||||
* should merge case-insensitively
|
||||
* should overwrite case insensitively and assume the new key's case
|
||||
* should be converted to real Hash
|
||||
* should convert Array values to Strings when converting to Hash
|
||||
* should be able to delete the given key case-sensitively
|
||||
* should be able to delete the given key case-insensitively
|
||||
* should return the deleted value when #delete is called on an existing key
|
||||
* should return nil when #delete is called on a non-existant key
|
||||
|
||||
== Rack::Utils::Context
|
||||
* should set context correctly
|
||||
* should alter app on recontexting
|
||||
* should run different apps
|
||||
|
||||
== Rack::Utils::Multipart
|
||||
* should return nil if content type is not multipart
|
||||
* should parse multipart upload with text file
|
||||
* should parse multipart upload with nested parameters
|
||||
* should parse multipart upload with binary file
|
||||
* should parse multipart upload with empty file
|
||||
* should parse multipart upload with filename with semicolons
|
||||
* should not include file params if no file was selected
|
||||
* should parse IE multipart upload and clean up filename
|
||||
* rewinds input after parsing upload
|
||||
|
||||
== Rack::Handler::WEBrick
|
||||
* should respond
|
||||
* should be a WEBrick
|
||||
* should have rack headers
|
||||
* should have CGI headers on GET
|
||||
* should have CGI headers on POST
|
||||
* should support HTTP auth
|
||||
* should set status
|
||||
* should correctly set cookies
|
||||
* should provide a .run
|
||||
|
||||
335 specifications, 13 empty (1196 requirements), 0 failures
|
|
@ -0,0 +1,364 @@
|
|||
= Rack, a modular Ruby webserver interface
|
||||
|
||||
Rack provides a minimal, modular and adaptable interface for developing
|
||||
web applications in Ruby. By wrapping HTTP requests and responses in
|
||||
the simplest way possible, it unifies and distills the API for web
|
||||
servers, web frameworks, and software in between (the so-called
|
||||
middleware) into a single method call.
|
||||
|
||||
The exact details of this are described in the Rack specification,
|
||||
which all Rack applications should conform to.
|
||||
|
||||
== Specification changes in this release
|
||||
|
||||
With Rack 1.0, the Rack specification (found in SPEC) changed in the
|
||||
following backward-incompatible ways. This was done to properly
|
||||
support Ruby 1.9 and to deprecate some problematic techniques:
|
||||
|
||||
* Rack::VERSION has been pushed to [1,0].
|
||||
* Header values must be Strings now, split on "\n".
|
||||
* rack.input must be rewindable and support reading into a buffer,
|
||||
wrap with Rack::RewindableInput if it isn't.
|
||||
* Content-Length can be missing, in this case chunked transfer
|
||||
encoding is used.
|
||||
* Bodies can now additionally respond to #to_path with a filename to
|
||||
be served.
|
||||
* String bodies are deprecated and will not work with Ruby 1.9, use an
|
||||
Array with a single String instead.
|
||||
* rack.session is now specified.
|
||||
|
||||
== Supported web servers
|
||||
|
||||
The included *handlers* connect all kinds of web servers to Rack:
|
||||
* Mongrel
|
||||
* EventedMongrel
|
||||
* SwiftipliedMongrel
|
||||
* WEBrick
|
||||
* FCGI
|
||||
* CGI
|
||||
* SCGI
|
||||
* LiteSpeed
|
||||
* Thin
|
||||
|
||||
These web servers include Rack handlers in their distributions:
|
||||
* Ebb
|
||||
* Fuzed
|
||||
* Phusion Passenger (which is mod_rack for Apache and for nginx)
|
||||
* Unicorn
|
||||
|
||||
Any valid Rack app will run the same on all these handlers, without
|
||||
changing anything.
|
||||
|
||||
== Supported web frameworks
|
||||
|
||||
The included *adapters* connect Rack with existing Ruby web frameworks:
|
||||
* Camping
|
||||
|
||||
These frameworks include Rack adapters in their distributions:
|
||||
* Camping
|
||||
* Coset
|
||||
* Halcyon
|
||||
* Mack
|
||||
* Maveric
|
||||
* Merb
|
||||
* Racktools::SimpleApplication
|
||||
* Ramaze
|
||||
* Ruby on Rails
|
||||
* Rum
|
||||
* Sinatra
|
||||
* Sin
|
||||
* Vintage
|
||||
* Waves
|
||||
* Wee
|
||||
|
||||
Current links to these projects can be found at
|
||||
http://wiki.ramaze.net/Home#other-frameworks
|
||||
|
||||
== Available middleware
|
||||
|
||||
Between the server and the framework, Rack can be customized to your
|
||||
applications needs using middleware, for example:
|
||||
* Rack::URLMap, to route to multiple applications inside the same process.
|
||||
* Rack::CommonLogger, for creating Apache-style logfiles.
|
||||
* Rack::ShowException, for catching unhandled exceptions and
|
||||
presenting them in a nice and helpful way with clickable backtrace.
|
||||
* Rack::File, for serving static files.
|
||||
* ...many others!
|
||||
|
||||
All these components use the same interface, which is described in
|
||||
detail in the Rack specification. These optional components can be
|
||||
used in any way you wish.
|
||||
|
||||
== Convenience
|
||||
|
||||
If you want to develop outside of existing frameworks, implement your
|
||||
own ones, or develop middleware, Rack provides many helpers to create
|
||||
Rack applications quickly and without doing the same web stuff all
|
||||
over:
|
||||
* Rack::Request, which also provides query string parsing and
|
||||
multipart handling.
|
||||
* Rack::Response, for convenient generation of HTTP replies and
|
||||
cookie handling.
|
||||
* Rack::MockRequest and Rack::MockResponse for efficient and quick
|
||||
testing of Rack application without real HTTP round-trips.
|
||||
|
||||
== rack-contrib
|
||||
|
||||
The plethora of useful middleware created the need for a project that
|
||||
collects fresh Rack middleware. rack-contrib includes a variety of
|
||||
add-on components for Rack and it is easy to contribute new modules.
|
||||
|
||||
* http://github.com/rack/rack-contrib
|
||||
|
||||
== rackup
|
||||
|
||||
rackup is a useful tool for running Rack applications, which uses the
|
||||
Rack::Builder DSL to configure middleware and build up applications
|
||||
easily.
|
||||
|
||||
rackup automatically figures out the environment it is run in, and
|
||||
runs your application as FastCGI, CGI, or standalone with Mongrel or
|
||||
WEBrick---all from the same configuration.
|
||||
|
||||
== Quick start
|
||||
|
||||
Try the lobster!
|
||||
|
||||
Either with the embedded WEBrick starter:
|
||||
|
||||
ruby -Ilib lib/rack/lobster.rb
|
||||
|
||||
Or with rackup:
|
||||
|
||||
bin/rackup -Ilib example/lobster.ru
|
||||
|
||||
By default, the lobster is found at http://localhost:9292.
|
||||
|
||||
== Installing with RubyGems
|
||||
|
||||
A Gem of Rack is available. You can install it with:
|
||||
|
||||
gem install rack
|
||||
|
||||
I also provide a local mirror of the gems (and development snapshots)
|
||||
at my site:
|
||||
|
||||
gem install rack --source http://chneukirchen.org/releases/gems/
|
||||
|
||||
== Running the tests
|
||||
|
||||
Testing Rack requires the test/spec testing framework:
|
||||
|
||||
gem install test-spec
|
||||
|
||||
There are two rake-based test tasks:
|
||||
|
||||
rake test tests all the fast tests (no Handlers or Adapters)
|
||||
rake fulltest runs all the tests
|
||||
|
||||
The fast testsuite has no dependencies outside of the core Ruby
|
||||
installation and test-spec.
|
||||
|
||||
To run the test suite completely, you need:
|
||||
|
||||
* camping
|
||||
* fcgi
|
||||
* memcache-client
|
||||
* mongrel
|
||||
* ruby-openid
|
||||
* thin
|
||||
|
||||
The full set of tests test FCGI access with lighttpd (on port
|
||||
9203) so you will need lighttpd installed as well as the FCGI
|
||||
libraries and the fcgi gem:
|
||||
|
||||
Download and install lighttpd:
|
||||
|
||||
http://www.lighttpd.net/download
|
||||
|
||||
Installing the FCGI libraries:
|
||||
|
||||
curl -O http://www.fastcgi.com/dist/fcgi-2.4.0.tar.gz
|
||||
tar xzvf fcgi-2.4.0.tar.gz
|
||||
cd fcgi-2.4.0
|
||||
./configure --prefix=/usr/local
|
||||
make
|
||||
sudo make install
|
||||
cd ..
|
||||
|
||||
Installing the Ruby fcgi gem:
|
||||
|
||||
gem install fcgi
|
||||
|
||||
Furthermore, to test Memcache sessions, you need memcached (will be
|
||||
run on port 11211) and memcache-client installed.
|
||||
|
||||
== History
|
||||
|
||||
* March 3rd, 2007: First public release 0.1.
|
||||
|
||||
* May 16th, 2007: Second public release 0.2.
|
||||
* HTTP Basic authentication.
|
||||
* Cookie Sessions.
|
||||
* Static file handler.
|
||||
* Improved Rack::Request.
|
||||
* Improved Rack::Response.
|
||||
* Added Rack::ShowStatus, for better default error messages.
|
||||
* Bug fixes in the Camping adapter.
|
||||
* Removed Rails adapter, was too alpha.
|
||||
|
||||
* February 26th, 2008: Third public release 0.3.
|
||||
* LiteSpeed handler, by Adrian Madrid.
|
||||
* SCGI handler, by Jeremy Evans.
|
||||
* Pool sessions, by blink.
|
||||
* OpenID authentication, by blink.
|
||||
* :Port and :File options for opening FastCGI sockets, by blink.
|
||||
* Last-Modified HTTP header for Rack::File, by blink.
|
||||
* Rack::Builder#use now accepts blocks, by Corey Jewett.
|
||||
(See example/protectedlobster.ru)
|
||||
* HTTP status 201 can contain a Content-Type and a body now.
|
||||
* Many bugfixes, especially related to Cookie handling.
|
||||
|
||||
* August 21st, 2008: Fourth public release 0.4.
|
||||
* New middleware, Rack::Deflater, by Christoffer Sawicki.
|
||||
* OpenID authentication now needs ruby-openid 2.
|
||||
* New Memcache sessions, by blink.
|
||||
* Explicit EventedMongrel handler, by Joshua Peek <josh@joshpeek.com>
|
||||
* Rack::Reloader is not loaded in rackup development mode.
|
||||
* rackup can daemonize with -D.
|
||||
* Many bugfixes, especially for pool sessions, URLMap, thread safety
|
||||
and tempfile handling.
|
||||
* Improved tests.
|
||||
* Rack moved to Git.
|
||||
|
||||
* January 6th, 2009: Fifth public release 0.9.
|
||||
* Rack is now managed by the Rack Core Team.
|
||||
* Rack::Lint is stricter and follows the HTTP RFCs more closely.
|
||||
* Added ConditionalGet middleware.
|
||||
* Added ContentLength middleware.
|
||||
* Added Deflater middleware.
|
||||
* Added Head middleware.
|
||||
* Added MethodOverride middleware.
|
||||
* Rack::Mime now provides popular MIME-types and their extension.
|
||||
* Mongrel Header now streams.
|
||||
* Added Thin handler.
|
||||
* Official support for swiftiplied Mongrel.
|
||||
* Secure cookies.
|
||||
* Made HeaderHash case-preserving.
|
||||
* Many bugfixes and small improvements.
|
||||
|
||||
* January 9th, 2009: Sixth public release 0.9.1.
|
||||
* Fix directory traversal exploits in Rack::File and Rack::Directory.
|
||||
|
||||
* April 25th, 2009: Seventh public release 1.0.0.
|
||||
* SPEC change: Rack::VERSION has been pushed to [1,0].
|
||||
* SPEC change: header values must be Strings now, split on "\n".
|
||||
* SPEC change: Content-Length can be missing, in this case chunked transfer
|
||||
encoding is used.
|
||||
* SPEC change: rack.input must be rewindable and support reading into
|
||||
a buffer, wrap with Rack::RewindableInput if it isn't.
|
||||
* SPEC change: rack.session is now specified.
|
||||
* SPEC change: Bodies can now additionally respond to #to_path with
|
||||
a filename to be served.
|
||||
* NOTE: String bodies break in 1.9, use an Array consisting of a
|
||||
single String instead.
|
||||
* New middleware Rack::Lock.
|
||||
* New middleware Rack::ContentType.
|
||||
* Rack::Reloader has been rewritten.
|
||||
* Major update to Rack::Auth::OpenID.
|
||||
* Support for nested parameter parsing in Rack::Response.
|
||||
* Support for redirects in Rack::Response.
|
||||
* HttpOnly cookie support in Rack::Response.
|
||||
* The Rakefile has been rewritten.
|
||||
* Many bugfixes and small improvements.
|
||||
|
||||
* October 18th, 2009: Eighth public release 1.0.1.
|
||||
* Bump remainder of rack.versions.
|
||||
* Support the pure Ruby FCGI implementation.
|
||||
* Fix for form names containing "=": split first then unescape components
|
||||
* Fixes the handling of the filename parameter with semicolons in names.
|
||||
* Add anchor to nested params parsing regexp to prevent stack overflows
|
||||
* Use more compatible gzip write api instead of "<<".
|
||||
* Make sure that Reloader doesn't break when executed via ruby -e
|
||||
* Make sure WEBrick respects the :Host option
|
||||
* Many Ruby 1.9 fixes.
|
||||
|
||||
== Contact
|
||||
|
||||
Please mail bugs, suggestions and patches to
|
||||
<mailto:rack-devel@googlegroups.com>.
|
||||
|
||||
Mailing list archives are available at
|
||||
<http://groups.google.com/group/rack-devel>.
|
||||
|
||||
There is a bug tracker at <http://rack.lighthouseapp.com/>.
|
||||
|
||||
Git repository (send Git patches to the mailing list):
|
||||
* http://github.com/rack/rack
|
||||
* http://git.vuxu.org/cgi-bin/gitweb.cgi?p=rack.git
|
||||
|
||||
You are also welcome to join the #rack channel on irc.freenode.net.
|
||||
|
||||
== Thanks
|
||||
|
||||
The Rack Core Team, consisting of
|
||||
|
||||
* Christian Neukirchen (chneukirchen)
|
||||
* James Tucker (raggi)
|
||||
* Josh Peek (josh)
|
||||
* Michael Fellinger (manveru)
|
||||
* Ryan Tomayko (rtomayko)
|
||||
* Scytrin dai Kinthra (scytrin)
|
||||
|
||||
would like to thank:
|
||||
|
||||
* Adrian Madrid, for the LiteSpeed handler.
|
||||
* Christoffer Sawicki, for the first Rails adapter and Rack::Deflater.
|
||||
* Tim Fletcher, for the HTTP authentication code.
|
||||
* Luc Heinrich for the Cookie sessions, the static file handler and bugfixes.
|
||||
* Armin Ronacher, for the logo and racktools.
|
||||
* Aredridel, Ben Alpert, Dan Kubb, Daniel Roethlisberger, Matt Todd,
|
||||
Tom Robinson, Phil Hagelberg, and S. Brent Faulkner for bug fixing
|
||||
and other improvements.
|
||||
* Brian Candler, for Rack::ContentType.
|
||||
* Graham Batty, for improved handler loading.
|
||||
* Stephen Bannasch, for bug reports and documentation.
|
||||
* Gary Wright, for proposing a better Rack::Response interface.
|
||||
* Jonathan Buch, for improvements regarding Rack::Response.
|
||||
* Armin Röhrl, for tracking down bugs in the Cookie generator.
|
||||
* Alexander Kellett for testing the Gem and reviewing the announcement.
|
||||
* Marcus Rückert, for help with configuring and debugging lighttpd.
|
||||
* The WSGI team for the well-done and documented work they've done and
|
||||
Rack builds up on.
|
||||
* All bug reporters and patch contributers not mentioned above.
|
||||
|
||||
== Copyright
|
||||
|
||||
Copyright (C) 2007, 2008, 2009 Christian Neukirchen <http://purl.org/net/chneukirchen>
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to
|
||||
deal in the Software without restriction, including without limitation the
|
||||
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
|
||||
sell copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in
|
||||
all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
||||
THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
|
||||
== Links
|
||||
|
||||
Rack:: <http://rack.rubyforge.org/>
|
||||
Rack's Rubyforge project:: <http://rubyforge.org/projects/rack>
|
||||
Official Rack repositories:: <http://github.com/rack>
|
||||
rack-devel mailing list:: <http://groups.google.com/group/rack-devel>
|
||||
|
||||
Christian Neukirchen:: <http://chneukirchen.org/>
|
||||
|
|
@ -0,0 +1,164 @@
|
|||
# Rakefile for Rack. -*-ruby-*-
|
||||
require 'rake/rdoctask'
|
||||
require 'rake/testtask'
|
||||
|
||||
|
||||
desc "Run all the tests"
|
||||
task :default => [:test]
|
||||
|
||||
|
||||
desc "Make an archive as .tar.gz"
|
||||
task :dist => [:chmod, :changelog, :rdoc, "SPEC", "rack.gemspec"] do
|
||||
FileUtils.touch("RDOX")
|
||||
sh "git archive --format=tar --prefix=#{release}/ HEAD^{tree} >#{release}.tar"
|
||||
sh "pax -waf #{release}.tar -s ':^:#{release}/:' RDOX SPEC ChangeLog doc rack.gemspec"
|
||||
sh "gzip -f -9 #{release}.tar"
|
||||
end
|
||||
|
||||
desc "Make an official release"
|
||||
task :officialrelease do
|
||||
puts "Official build for #{release}..."
|
||||
sh "rm -rf stage"
|
||||
sh "git clone --shared . stage"
|
||||
sh "cd stage && rake officialrelease_really"
|
||||
sh "mv stage/#{release}.tar.gz stage/#{release}.gem ."
|
||||
end
|
||||
|
||||
task :officialrelease_really => [:fulltest, "RDOX", "SPEC", :dist, :gem] do
|
||||
sh "sha1sum #{release}.tar.gz #{release}.gem"
|
||||
end
|
||||
|
||||
|
||||
def version
|
||||
abort "You need to pass VERSION=... to build packages." unless ENV["VERSION"]
|
||||
ENV["VERSION"]
|
||||
end
|
||||
|
||||
def release
|
||||
"rack-#{version}"
|
||||
end
|
||||
|
||||
def manifest
|
||||
`git ls-files`.split("\n")
|
||||
end
|
||||
|
||||
|
||||
desc "Make binaries executable"
|
||||
task :chmod do
|
||||
Dir["bin/*"].each { |binary| File.chmod(0775, binary) }
|
||||
Dir["test/cgi/test*"].each { |binary| File.chmod(0775, binary) }
|
||||
end
|
||||
|
||||
desc "Generate a ChangeLog"
|
||||
task :changelog do
|
||||
File.open("ChangeLog", "w") { |out|
|
||||
`git log -z`.split("\0").map { |chunk|
|
||||
author = chunk[/Author: (.*)/, 1].strip
|
||||
date = chunk[/Date: (.*)/, 1].strip
|
||||
desc, detail = $'.strip.split("\n", 2)
|
||||
detail ||= ""
|
||||
detail = detail.gsub(/.*darcs-hash:.*/, '')
|
||||
detail.rstrip!
|
||||
out.puts "#{date} #{author}"
|
||||
out.puts " * #{desc.strip}"
|
||||
out.puts detail unless detail.empty?
|
||||
out.puts
|
||||
}
|
||||
}
|
||||
end
|
||||
|
||||
|
||||
desc "Generate RDox"
|
||||
task "RDOX" do
|
||||
sh "specrb -Ilib:test -a --rdox >RDOX"
|
||||
end
|
||||
|
||||
desc "Generate Rack Specification"
|
||||
task "SPEC" do
|
||||
File.open("SPEC", "wb") { |file|
|
||||
IO.foreach("lib/rack/lint.rb") { |line|
|
||||
if line =~ /## (.*)/
|
||||
file.puts $1
|
||||
end
|
||||
}
|
||||
}
|
||||
end
|
||||
|
||||
desc "Run all the fast tests"
|
||||
task :test do
|
||||
sh "specrb -Ilib:test -w #{ENV['TEST'] || '-a'} #{ENV['TESTOPTS'] || '-t "^(?!Rack::Handler|Rack::Adapter|Rack::Session::Memcache|Rack::Auth::OpenID)"'}"
|
||||
end
|
||||
|
||||
desc "Run all the tests"
|
||||
task :fulltest => [:chmod] do
|
||||
sh "specrb -Ilib:test -w #{ENV['TEST'] || '-a'} #{ENV['TESTOPTS']}"
|
||||
end
|
||||
|
||||
begin
|
||||
require 'rubygems'
|
||||
rescue LoadError
|
||||
# Too bad.
|
||||
else
|
||||
task "rack.gemspec" do
|
||||
spec = Gem::Specification.new do |s|
|
||||
s.name = "rack"
|
||||
s.version = version
|
||||
s.platform = Gem::Platform::RUBY
|
||||
s.summary = "a modular Ruby webserver interface"
|
||||
|
||||
s.description = <<-EOF
|
||||
Rack provides minimal, modular and adaptable interface for developing
|
||||
web applications in Ruby. By wrapping HTTP requests and responses in
|
||||
the simplest way possible, it unifies and distills the API for web
|
||||
servers, web frameworks, and software in between (the so-called
|
||||
middleware) into a single method call.
|
||||
|
||||
Also see http://rack.rubyforge.org.
|
||||
EOF
|
||||
|
||||
s.files = manifest + %w(SPEC RDOX rack.gemspec)
|
||||
s.bindir = 'bin'
|
||||
s.executables << 'rackup'
|
||||
s.require_path = 'lib'
|
||||
s.has_rdoc = true
|
||||
s.extra_rdoc_files = ['README', 'SPEC', 'RDOX', 'KNOWN-ISSUES']
|
||||
s.test_files = Dir['test/{test,spec}_*.rb']
|
||||
|
||||
s.author = 'Christian Neukirchen'
|
||||
s.email = 'chneukirchen@gmail.com'
|
||||
s.homepage = 'http://rack.rubyforge.org'
|
||||
s.rubyforge_project = 'rack'
|
||||
|
||||
s.add_development_dependency 'test-spec'
|
||||
|
||||
s.add_development_dependency 'camping'
|
||||
s.add_development_dependency 'fcgi'
|
||||
s.add_development_dependency 'memcache-client'
|
||||
s.add_development_dependency 'mongrel'
|
||||
s.add_development_dependency 'ruby-openid', '~> 2.0.0'
|
||||
s.add_development_dependency 'thin'
|
||||
end
|
||||
|
||||
File.open("rack.gemspec", "w") { |f| f << spec.to_ruby }
|
||||
end
|
||||
|
||||
task :gem => ["rack.gemspec", "SPEC"] do
|
||||
FileUtils.touch("RDOX")
|
||||
sh "gem build rack.gemspec"
|
||||
end
|
||||
end
|
||||
|
||||
desc "Generate RDoc documentation"
|
||||
task :rdoc do
|
||||
sh(*%w{rdoc --line-numbers --main README
|
||||
--title 'Rack\ Documentation' --charset utf-8 -U -o doc} +
|
||||
%w{README KNOWN-ISSUES SPEC RDOX} +
|
||||
Dir["lib/**/*.rb"])
|
||||
end
|
||||
|
||||
task :pushsite => [:rdoc] do
|
||||
sh "cd site && git gc"
|
||||
sh "rsync -avz doc/ chneukirchen@rack.rubyforge.org:/var/www/gforge-projects/rack/doc/"
|
||||
sh "rsync -avz site/ chneukirchen@rack.rubyforge.org:/var/www/gforge-projects/rack/"
|
||||
sh "cd site && git push"
|
||||
end
|
|
@ -0,0 +1,164 @@
|
|||
This specification aims to formalize the Rack protocol. You
|
||||
can (and should) use Rack::Lint to enforce it.
|
||||
When you develop middleware, be sure to add a Lint before and
|
||||
after to catch all mistakes.
|
||||
= Rack applications
|
||||
A Rack application is an Ruby object (not a class) that
|
||||
responds to +call+.
|
||||
It takes exactly one argument, the *environment*
|
||||
and returns an Array of exactly three values:
|
||||
The *status*,
|
||||
the *headers*,
|
||||
and the *body*.
|
||||
== The Environment
|
||||
The environment must be an true instance of Hash (no
|
||||
subclassing allowed) that includes CGI-like headers.
|
||||
The application is free to modify the environment.
|
||||
The environment is required to include these variables
|
||||
(adopted from PEP333), except when they'd be empty, but see
|
||||
below.
|
||||
<tt>REQUEST_METHOD</tt>:: The HTTP request method, such as
|
||||
"GET" or "POST". This cannot ever
|
||||
be an empty string, and so is
|
||||
always required.
|
||||
<tt>SCRIPT_NAME</tt>:: The initial portion of the request
|
||||
URL's "path" that corresponds to the
|
||||
application object, so that the
|
||||
application knows its virtual
|
||||
"location". This may be an empty
|
||||
string, if the application corresponds
|
||||
to the "root" of the server.
|
||||
<tt>PATH_INFO</tt>:: The remainder of the request URL's
|
||||
"path", designating the virtual
|
||||
"location" of the request's target
|
||||
within the application. This may be an
|
||||
empty string, if the request URL targets
|
||||
the application root and does not have a
|
||||
trailing slash. This value may be
|
||||
percent-encoded when I originating from
|
||||
a URL.
|
||||
<tt>QUERY_STRING</tt>:: The portion of the request URL that
|
||||
follows the <tt>?</tt>, if any. May be
|
||||
empty, but is always required!
|
||||
<tt>SERVER_NAME</tt>, <tt>SERVER_PORT</tt>:: When combined with <tt>SCRIPT_NAME</tt> and <tt>PATH_INFO</tt>, these variables can be used to complete the URL. Note, however, that <tt>HTTP_HOST</tt>, if present, should be used in preference to <tt>SERVER_NAME</tt> for reconstructing the request URL. <tt>SERVER_NAME</tt> and <tt>SERVER_PORT</tt> can never be empty strings, and so are always required.
|
||||
<tt>HTTP_</tt> Variables:: Variables corresponding to the
|
||||
client-supplied HTTP request
|
||||
headers (i.e., variables whose
|
||||
names begin with <tt>HTTP_</tt>). The
|
||||
presence or absence of these
|
||||
variables should correspond with
|
||||
the presence or absence of the
|
||||
appropriate HTTP header in the
|
||||
request.
|
||||
In addition to this, the Rack environment must include these
|
||||
Rack-specific variables:
|
||||
<tt>rack.version</tt>:: The Array [1,0], representing this version of Rack.
|
||||
<tt>rack.url_scheme</tt>:: +http+ or +https+, depending on the request URL.
|
||||
<tt>rack.input</tt>:: See below, the input stream.
|
||||
<tt>rack.errors</tt>:: See below, the error stream.
|
||||
<tt>rack.multithread</tt>:: true if the application object may be simultaneously invoked by another thread in the same process, false otherwise.
|
||||
<tt>rack.multiprocess</tt>:: true if an equivalent application object may be simultaneously invoked by another process, false otherwise.
|
||||
<tt>rack.run_once</tt>:: true if the server expects (but does not guarantee!) that the application will only be invoked this one time during the life of its containing process. Normally, this will only be true for a server based on CGI (or something similar).
|
||||
Additional environment specifications have approved to
|
||||
standardized middleware APIs. None of these are required to
|
||||
be implemented by the server.
|
||||
<tt>rack.session</tt>:: A hash like interface for storing request session data.
|
||||
The store must implement:
|
||||
store(key, value) (aliased as []=);
|
||||
fetch(key, default = nil) (aliased as []);
|
||||
delete(key);
|
||||
clear;
|
||||
The server or the application can store their own data in the
|
||||
environment, too. The keys must contain at least one dot,
|
||||
and should be prefixed uniquely. The prefix <tt>rack.</tt>
|
||||
is reserved for use with the Rack core distribution and other
|
||||
accepted specifications and must not be used otherwise.
|
||||
The environment must not contain the keys
|
||||
<tt>HTTP_CONTENT_TYPE</tt> or <tt>HTTP_CONTENT_LENGTH</tt>
|
||||
(use the versions without <tt>HTTP_</tt>).
|
||||
The CGI keys (named without a period) must have String values.
|
||||
There are the following restrictions:
|
||||
* <tt>rack.version</tt> must be an array of Integers.
|
||||
* <tt>rack.url_scheme</tt> must either be +http+ or +https+.
|
||||
* There must be a valid input stream in <tt>rack.input</tt>.
|
||||
* There must be a valid error stream in <tt>rack.errors</tt>.
|
||||
* The <tt>REQUEST_METHOD</tt> must be a valid token.
|
||||
* The <tt>SCRIPT_NAME</tt>, if non-empty, must start with <tt>/</tt>
|
||||
* The <tt>PATH_INFO</tt>, if non-empty, must start with <tt>/</tt>
|
||||
* The <tt>CONTENT_LENGTH</tt>, if given, must consist of digits only.
|
||||
* One of <tt>SCRIPT_NAME</tt> or <tt>PATH_INFO</tt> must be
|
||||
set. <tt>PATH_INFO</tt> should be <tt>/</tt> if
|
||||
<tt>SCRIPT_NAME</tt> is empty.
|
||||
<tt>SCRIPT_NAME</tt> never should be <tt>/</tt>, but instead be empty.
|
||||
=== The Input Stream
|
||||
The input stream is an IO-like object which contains the raw HTTP
|
||||
POST data.
|
||||
When applicable, its external encoding must be "ASCII-8BIT" and it
|
||||
must be opened in binary mode, for Ruby 1.9 compatibility.
|
||||
The input stream must respond to +gets+, +each+, +read+ and +rewind+.
|
||||
* +gets+ must be called without arguments and return a string,
|
||||
or +nil+ on EOF.
|
||||
* +read+ behaves like IO#read. Its signature is <tt>read([length, [buffer]])</tt>.
|
||||
If given, +length+ must be an non-negative Integer (>= 0) or +nil+, and +buffer+ must
|
||||
be a String and may not be nil. If +length+ is given and not nil, then this method
|
||||
reads at most +length+ bytes from the input stream. If +length+ is not given or nil,
|
||||
then this method reads all data until EOF.
|
||||
When EOF is reached, this method returns nil if +length+ is given and not nil, or ""
|
||||
if +length+ is not given or is nil.
|
||||
If +buffer+ is given, then the read data will be placed into +buffer+ instead of a
|
||||
newly created String object.
|
||||
* +each+ must be called without arguments and only yield Strings.
|
||||
* +rewind+ must be called without arguments. It rewinds the input
|
||||
stream back to the beginning. It must not raise Errno::ESPIPE:
|
||||
that is, it may not be a pipe or a socket. Therefore, handler
|
||||
developers must buffer the input data into some rewindable object
|
||||
if the underlying input stream is not rewindable.
|
||||
* +close+ must never be called on the input stream.
|
||||
=== The Error Stream
|
||||
The error stream must respond to +puts+, +write+ and +flush+.
|
||||
* +puts+ must be called with a single argument that responds to +to_s+.
|
||||
* +write+ must be called with a single argument that is a String.
|
||||
* +flush+ must be called without arguments and must be called
|
||||
in order to make the error appear for sure.
|
||||
* +close+ must never be called on the error stream.
|
||||
== The Response
|
||||
=== The Status
|
||||
This is an HTTP status. When parsed as integer (+to_i+), it must be
|
||||
greater than or equal to 100.
|
||||
=== The Headers
|
||||
The header must respond to +each+, and yield values of key and value.
|
||||
The header keys must be Strings.
|
||||
The header must not contain a +Status+ key,
|
||||
contain keys with <tt>:</tt> or newlines in their name,
|
||||
contain keys names that end in <tt>-</tt> or <tt>_</tt>,
|
||||
but only contain keys that consist of
|
||||
letters, digits, <tt>_</tt> or <tt>-</tt> and start with a letter.
|
||||
The values of the header must be Strings,
|
||||
consisting of lines (for multiple header values, e.g. multiple
|
||||
<tt>Set-Cookie</tt> values) seperated by "\n".
|
||||
The lines must not contain characters below 037.
|
||||
=== The Content-Type
|
||||
There must be a <tt>Content-Type</tt>, except when the
|
||||
+Status+ is 1xx, 204 or 304, in which case there must be none
|
||||
given.
|
||||
=== The Content-Length
|
||||
There must not be a <tt>Content-Length</tt> header when the
|
||||
+Status+ is 1xx, 204 or 304.
|
||||
=== The Body
|
||||
The Body must respond to +each+
|
||||
and must only yield String values.
|
||||
The Body itself should not be an instance of String, as this will
|
||||
break in Ruby 1.9.
|
||||
If the Body responds to +close+, it will be called after iteration.
|
||||
If the Body responds to +to_path+, it must return a String
|
||||
identifying the location of a file whose contents are identical
|
||||
to that produced by calling +each+; this may be used by the
|
||||
server as an alternative, possibly more efficient way to
|
||||
transport the response.
|
||||
The Body commonly is an Array of Strings, the application
|
||||
instance itself, or a File-like object.
|
||||
== Thanks
|
||||
Some parts of this specification are adopted from PEP333: Python
|
||||
Web Server Gateway Interface
|
||||
v1.0 (http://www.python.org/dev/peps/pep-0333/). I'd like to thank
|
||||
everyone involved in that effort.
|
|
@ -0,0 +1,176 @@
|
|||
#!/usr/bin/env ruby
|
||||
# -*- ruby -*-
|
||||
|
||||
$LOAD_PATH.unshift File.expand_path("#{__FILE__}/../../lib")
|
||||
autoload :Rack, 'rack'
|
||||
|
||||
require 'optparse'
|
||||
|
||||
automatic = false
|
||||
server = nil
|
||||
env = "development"
|
||||
daemonize = false
|
||||
pid = nil
|
||||
options = {:Port => 9292, :Host => "0.0.0.0", :AccessLog => []}
|
||||
|
||||
# Don't evaluate CGI ISINDEX parameters.
|
||||
# http://hoohoo.ncsa.uiuc.edu/cgi/cl.html
|
||||
ARGV.clear if ENV.include?("REQUEST_METHOD")
|
||||
|
||||
opts = OptionParser.new("", 24, ' ') { |opts|
|
||||
opts.banner = "Usage: rackup [ruby options] [rack options] [rackup config]"
|
||||
|
||||
opts.separator ""
|
||||
opts.separator "Ruby options:"
|
||||
|
||||
lineno = 1
|
||||
opts.on("-e", "--eval LINE", "evaluate a LINE of code") { |line|
|
||||
eval line, TOPLEVEL_BINDING, "-e", lineno
|
||||
lineno += 1
|
||||
}
|
||||
|
||||
opts.on("-d", "--debug", "set debugging flags (set $DEBUG to true)") {
|
||||
$DEBUG = true
|
||||
}
|
||||
opts.on("-w", "--warn", "turn warnings on for your script") {
|
||||
$-w = true
|
||||
}
|
||||
|
||||
opts.on("-I", "--include PATH",
|
||||
"specify $LOAD_PATH (may be used more than once)") { |path|
|
||||
$LOAD_PATH.unshift(*path.split(":"))
|
||||
}
|
||||
|
||||
opts.on("-r", "--require LIBRARY",
|
||||
"require the library, before executing your script") { |library|
|
||||
require library
|
||||
}
|
||||
|
||||
opts.separator ""
|
||||
opts.separator "Rack options:"
|
||||
opts.on("-s", "--server SERVER", "serve using SERVER (webrick/mongrel)") { |s|
|
||||
server = s
|
||||
}
|
||||
|
||||
opts.on("-o", "--host HOST", "listen on HOST (default: 0.0.0.0)") { |host|
|
||||
options[:Host] = host
|
||||
}
|
||||
|
||||
opts.on("-p", "--port PORT", "use PORT (default: 9292)") { |port|
|
||||
options[:Port] = port
|
||||
}
|
||||
|
||||
opts.on("-E", "--env ENVIRONMENT", "use ENVIRONMENT for defaults (default: development)") { |e|
|
||||
env = e
|
||||
}
|
||||
|
||||
opts.on("-D", "--daemonize", "run daemonized in the background") { |d|
|
||||
daemonize = d ? true : false
|
||||
}
|
||||
|
||||
opts.on("-P", "--pid FILE", "file to store PID (default: rack.pid)") { |f|
|
||||
pid = File.expand_path(f)
|
||||
}
|
||||
|
||||
opts.separator ""
|
||||
opts.separator "Common options:"
|
||||
|
||||
opts.on_tail("-h", "--help", "Show this message") do
|
||||
puts opts
|
||||
exit
|
||||
end
|
||||
|
||||
opts.on_tail("--version", "Show version") do
|
||||
puts "Rack #{Rack.version}"
|
||||
exit
|
||||
end
|
||||
|
||||
opts.parse! ARGV
|
||||
}
|
||||
|
||||
require 'pp' if $DEBUG
|
||||
|
||||
config = ARGV[0] || "config.ru"
|
||||
if !File.exist? config
|
||||
abort "configuration #{config} not found"
|
||||
end
|
||||
|
||||
if config =~ /\.ru$/
|
||||
cfgfile = File.read(config)
|
||||
if cfgfile[/^#\\(.*)/]
|
||||
opts.parse! $1.split(/\s+/)
|
||||
end
|
||||
inner_app = eval "Rack::Builder.new {( " + cfgfile + "\n )}.to_app",
|
||||
nil, config
|
||||
else
|
||||
require config
|
||||
inner_app = Object.const_get(File.basename(config, '.rb').capitalize)
|
||||
end
|
||||
|
||||
unless server = Rack::Handler.get(server)
|
||||
# Guess.
|
||||
if ENV.include?("PHP_FCGI_CHILDREN")
|
||||
server = Rack::Handler::FastCGI
|
||||
|
||||
# We already speak FastCGI
|
||||
options.delete :File
|
||||
options.delete :Port
|
||||
elsif ENV.include?("REQUEST_METHOD")
|
||||
server = Rack::Handler::CGI
|
||||
else
|
||||
begin
|
||||
server = Rack::Handler::Mongrel
|
||||
rescue LoadError => e
|
||||
server = Rack::Handler::WEBrick
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
p server if $DEBUG
|
||||
|
||||
case env
|
||||
when "development"
|
||||
app = Rack::Builder.new {
|
||||
use Rack::CommonLogger, $stderr unless server.name =~ /CGI/
|
||||
use Rack::ShowExceptions
|
||||
use Rack::Lint
|
||||
run inner_app
|
||||
}.to_app
|
||||
|
||||
when "deployment"
|
||||
app = Rack::Builder.new {
|
||||
use Rack::CommonLogger, $stderr unless server.name =~ /CGI/
|
||||
run inner_app
|
||||
}.to_app
|
||||
|
||||
when "none"
|
||||
app = inner_app
|
||||
|
||||
end
|
||||
|
||||
if $DEBUG
|
||||
pp app
|
||||
pp inner_app
|
||||
end
|
||||
|
||||
if daemonize
|
||||
if RUBY_VERSION < "1.9"
|
||||
exit if fork
|
||||
Process.setsid
|
||||
exit if fork
|
||||
Dir.chdir "/"
|
||||
File.umask 0000
|
||||
STDIN.reopen "/dev/null"
|
||||
STDOUT.reopen "/dev/null", "a"
|
||||
STDERR.reopen "/dev/null", "a"
|
||||
else
|
||||
Process.daemon
|
||||
end
|
||||
|
||||
if pid
|
||||
File.open(pid, 'w'){ |f| f.write("#{Process.pid}") }
|
||||
at_exit { File.delete(pid) if File.exist?(pid) }
|
||||
end
|
||||
end
|
||||
|
||||
server.run app, options
|
File diff suppressed because one or more lines are too long
After Width: | Height: | Size: 35 KiB |
|
@ -0,0 +1,4 @@
|
|||
require 'rack/lobster'
|
||||
|
||||
use Rack::ShowExceptions
|
||||
run Rack::Lobster.new
|
|
@ -0,0 +1,14 @@
|
|||
require 'rack'
|
||||
require 'rack/lobster'
|
||||
|
||||
lobster = Rack::Lobster.new
|
||||
|
||||
protected_lobster = Rack::Auth::Basic.new(lobster) do |username, password|
|
||||
'secret' == password
|
||||
end
|
||||
|
||||
protected_lobster.realm = 'Lobster 2.0'
|
||||
|
||||
pretty_protected_lobster = Rack::ShowStatus.new(Rack::ShowExceptions.new(protected_lobster))
|
||||
|
||||
Rack::Handler::WEBrick.run pretty_protected_lobster, :Port => 9292
|
|
@ -0,0 +1,8 @@
|
|||
require 'rack/lobster'
|
||||
|
||||
use Rack::ShowExceptions
|
||||
use Rack::Auth::Basic, "Lobster 2.0" do |username, password|
|
||||
'secret' == password
|
||||
end
|
||||
|
||||
run Rack::Lobster.new
|
|
@ -0,0 +1,90 @@
|
|||
# Copyright (C) 2007, 2008, 2009 Christian Neukirchen <purl.org/net/chneukirchen>
|
||||
#
|
||||
# Rack is freely distributable under the terms of an MIT-style license.
|
||||
# See COPYING or http://www.opensource.org/licenses/mit-license.php.
|
||||
|
||||
path = File.expand_path(File.dirname(__FILE__))
|
||||
$:.unshift(path) unless $:.include?(path)
|
||||
|
||||
|
||||
# The Rack main module, serving as a namespace for all core Rack
|
||||
# modules and classes.
|
||||
#
|
||||
# All modules meant for use in your application are <tt>autoload</tt>ed here,
|
||||
# so it should be enough just to <tt>require rack.rb</tt> in your code.
|
||||
|
||||
module Rack
|
||||
# The Rack protocol version number implemented.
|
||||
VERSION = [1,0]
|
||||
|
||||
# Return the Rack protocol version as a dotted string.
|
||||
def self.version
|
||||
VERSION.join(".")
|
||||
end
|
||||
|
||||
# Return the Rack release as a dotted string.
|
||||
def self.release
|
||||
"1.0"
|
||||
end
|
||||
|
||||
autoload :Builder, "rack/builder"
|
||||
autoload :Cascade, "rack/cascade"
|
||||
autoload :Chunked, "rack/chunked"
|
||||
autoload :CommonLogger, "rack/commonlogger"
|
||||
autoload :ConditionalGet, "rack/conditionalget"
|
||||
autoload :ContentLength, "rack/content_length"
|
||||
autoload :ContentType, "rack/content_type"
|
||||
autoload :File, "rack/file"
|
||||
autoload :Deflater, "rack/deflater"
|
||||
autoload :Directory, "rack/directory"
|
||||
autoload :ForwardRequest, "rack/recursive"
|
||||
autoload :Handler, "rack/handler"
|
||||
autoload :Head, "rack/head"
|
||||
autoload :Lint, "rack/lint"
|
||||
autoload :Lock, "rack/lock"
|
||||
autoload :MethodOverride, "rack/methodoverride"
|
||||
autoload :Mime, "rack/mime"
|
||||
autoload :Recursive, "rack/recursive"
|
||||
autoload :Reloader, "rack/reloader"
|
||||
autoload :ShowExceptions, "rack/showexceptions"
|
||||
autoload :ShowStatus, "rack/showstatus"
|
||||
autoload :Static, "rack/static"
|
||||
autoload :URLMap, "rack/urlmap"
|
||||
autoload :Utils, "rack/utils"
|
||||
|
||||
autoload :MockRequest, "rack/mock"
|
||||
autoload :MockResponse, "rack/mock"
|
||||
|
||||
autoload :Request, "rack/request"
|
||||
autoload :Response, "rack/response"
|
||||
|
||||
module Auth
|
||||
autoload :Basic, "rack/auth/basic"
|
||||
autoload :AbstractRequest, "rack/auth/abstract/request"
|
||||
autoload :AbstractHandler, "rack/auth/abstract/handler"
|
||||
autoload :OpenID, "rack/auth/openid"
|
||||
module Digest
|
||||
autoload :MD5, "rack/auth/digest/md5"
|
||||
autoload :Nonce, "rack/auth/digest/nonce"
|
||||
autoload :Params, "rack/auth/digest/params"
|
||||
autoload :Request, "rack/auth/digest/request"
|
||||
end
|
||||
end
|
||||
|
||||
module Session
|
||||
autoload :Cookie, "rack/session/cookie"
|
||||
autoload :Pool, "rack/session/pool"
|
||||
autoload :Memcache, "rack/session/memcache"
|
||||
end
|
||||
|
||||
# *Adapters* connect Rack with third party web frameworks.
|
||||
#
|
||||
# Rack includes an adapter for Camping, see README for other
|
||||
# frameworks supporting Rack in their code bases.
|
||||
#
|
||||
# Refer to the submodules for framework-specific calling details.
|
||||
|
||||
module Adapter
|
||||
autoload :Camping, "rack/adapter/camping"
|
||||
end
|
||||
end
|
|
@ -0,0 +1,22 @@
|
|||
module Rack
|
||||
module Adapter
|
||||
class Camping
|
||||
def initialize(app)
|
||||
@app = app
|
||||
end
|
||||
|
||||
def call(env)
|
||||
env["PATH_INFO"] ||= ""
|
||||
env["SCRIPT_NAME"] ||= ""
|
||||
controller = @app.run(env['rack.input'], env)
|
||||
h = controller.headers
|
||||
h.each_pair do |k,v|
|
||||
if v.kind_of? URI
|
||||
h[k] = v.to_s
|
||||
end
|
||||
end
|
||||
[controller.status, controller.headers, [controller.body.to_s]]
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,37 @@
|
|||
module Rack
|
||||
module Auth
|
||||
# Rack::Auth::AbstractHandler implements common authentication functionality.
|
||||
#
|
||||
# +realm+ should be set for all handlers.
|
||||
|
||||
class AbstractHandler
|
||||
|
||||
attr_accessor :realm
|
||||
|
||||
def initialize(app, realm=nil, &authenticator)
|
||||
@app, @realm, @authenticator = app, realm, authenticator
|
||||
end
|
||||
|
||||
|
||||
private
|
||||
|
||||
def unauthorized(www_authenticate = challenge)
|
||||
return [ 401,
|
||||
{ 'Content-Type' => 'text/plain',
|
||||
'Content-Length' => '0',
|
||||
'WWW-Authenticate' => www_authenticate.to_s },
|
||||
[]
|
||||
]
|
||||
end
|
||||
|
||||
def bad_request
|
||||
return [ 400,
|
||||
{ 'Content-Type' => 'text/plain',
|
||||
'Content-Length' => '0' },
|
||||
[]
|
||||
]
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,37 @@
|
|||
module Rack
|
||||
module Auth
|
||||
class AbstractRequest
|
||||
|
||||
def initialize(env)
|
||||
@env = env
|
||||
end
|
||||
|
||||
def provided?
|
||||
!authorization_key.nil?
|
||||
end
|
||||
|
||||
def parts
|
||||
@parts ||= @env[authorization_key].split(' ', 2)
|
||||
end
|
||||
|
||||
def scheme
|
||||
@scheme ||= parts.first.downcase.to_sym
|
||||
end
|
||||
|
||||
def params
|
||||
@params ||= parts.last
|
||||
end
|
||||
|
||||
|
||||
private
|
||||
|
||||
AUTHORIZATION_KEYS = ['HTTP_AUTHORIZATION', 'X-HTTP_AUTHORIZATION', 'X_HTTP_AUTHORIZATION']
|
||||
|
||||
def authorization_key
|
||||
@authorization_key ||= AUTHORIZATION_KEYS.detect { |key| @env.has_key?(key) }
|
||||
end
|
||||
|
||||
end
|
||||
|
||||
end
|
||||
end
|
|
@ -0,0 +1,58 @@
|
|||
require 'rack/auth/abstract/handler'
|
||||
require 'rack/auth/abstract/request'
|
||||
|
||||
module Rack
|
||||
module Auth
|
||||
# Rack::Auth::Basic implements HTTP Basic Authentication, as per RFC 2617.
|
||||
#
|
||||
# Initialize with the Rack application that you want protecting,
|
||||
# and a block that checks if a username and password pair are valid.
|
||||
#
|
||||
# See also: <tt>example/protectedlobster.rb</tt>
|
||||
|
||||
class Basic < AbstractHandler
|
||||
|
||||
def call(env)
|
||||
auth = Basic::Request.new(env)
|
||||
|
||||
return unauthorized unless auth.provided?
|
||||
|
||||
return bad_request unless auth.basic?
|
||||
|
||||
if valid?(auth)
|
||||
env['REMOTE_USER'] = auth.username
|
||||
|
||||
return @app.call(env)
|
||||
end
|
||||
|
||||
unauthorized
|
||||
end
|
||||
|
||||
|
||||
private
|
||||
|
||||
def challenge
|
||||
'Basic realm="%s"' % realm
|
||||
end
|
||||
|
||||
def valid?(auth)
|
||||
@authenticator.call(*auth.credentials)
|
||||
end
|
||||
|
||||
class Request < Auth::AbstractRequest
|
||||
def basic?
|
||||
:basic == scheme
|
||||
end
|
||||
|
||||
def credentials
|
||||
@credentials ||= params.unpack("m*").first.split(/:/, 2)
|
||||
end
|
||||
|
||||
def username
|
||||
credentials.first
|
||||
end
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,124 @@
|
|||
require 'rack/auth/abstract/handler'
|
||||
require 'rack/auth/digest/request'
|
||||
require 'rack/auth/digest/params'
|
||||
require 'rack/auth/digest/nonce'
|
||||
require 'digest/md5'
|
||||
|
||||
module Rack
|
||||
module Auth
|
||||
module Digest
|
||||
# Rack::Auth::Digest::MD5 implements the MD5 algorithm version of
|
||||
# HTTP Digest Authentication, as per RFC 2617.
|
||||
#
|
||||
# Initialize with the [Rack] application that you want protecting,
|
||||
# and a block that looks up a plaintext password for a given username.
|
||||
#
|
||||
# +opaque+ needs to be set to a constant base64/hexadecimal string.
|
||||
#
|
||||
class MD5 < AbstractHandler
|
||||
|
||||
attr_accessor :opaque
|
||||
|
||||
attr_writer :passwords_hashed
|
||||
|
||||
def initialize(*args)
|
||||
super
|
||||
@passwords_hashed = nil
|
||||
end
|
||||
|
||||
def passwords_hashed?
|
||||
!!@passwords_hashed
|
||||
end
|
||||
|
||||
def call(env)
|
||||
auth = Request.new(env)
|
||||
|
||||
unless auth.provided?
|
||||
return unauthorized
|
||||
end
|
||||
|
||||
if !auth.digest? || !auth.correct_uri? || !valid_qop?(auth)
|
||||
return bad_request
|
||||
end
|
||||
|
||||
if valid?(auth)
|
||||
if auth.nonce.stale?
|
||||
return unauthorized(challenge(:stale => true))
|
||||
else
|
||||
env['REMOTE_USER'] = auth.username
|
||||
|
||||
return @app.call(env)
|
||||
end
|
||||
end
|
||||
|
||||
unauthorized
|
||||
end
|
||||
|
||||
|
||||
private
|
||||
|
||||
QOP = 'auth'.freeze
|
||||
|
||||
def params(hash = {})
|
||||
Params.new do |params|
|
||||
params['realm'] = realm
|
||||
params['nonce'] = Nonce.new.to_s
|
||||
params['opaque'] = H(opaque)
|
||||
params['qop'] = QOP
|
||||
|
||||
hash.each { |k, v| params[k] = v }
|
||||
end
|
||||
end
|
||||
|
||||
def challenge(hash = {})
|
||||
"Digest #{params(hash)}"
|
||||
end
|
||||
|
||||
def valid?(auth)
|
||||
valid_opaque?(auth) && valid_nonce?(auth) && valid_digest?(auth)
|
||||
end
|
||||
|
||||
def valid_qop?(auth)
|
||||
QOP == auth.qop
|
||||
end
|
||||
|
||||
def valid_opaque?(auth)
|
||||
H(opaque) == auth.opaque
|
||||
end
|
||||
|
||||
def valid_nonce?(auth)
|
||||
auth.nonce.valid?
|
||||
end
|
||||
|
||||
def valid_digest?(auth)
|
||||
digest(auth, @authenticator.call(auth.username)) == auth.response
|
||||
end
|
||||
|
||||
def md5(data)
|
||||
::Digest::MD5.hexdigest(data)
|
||||
end
|
||||
|
||||
alias :H :md5
|
||||
|
||||
def KD(secret, data)
|
||||
H([secret, data] * ':')
|
||||
end
|
||||
|
||||
def A1(auth, password)
|
||||
[ auth.username, auth.realm, password ] * ':'
|
||||
end
|
||||
|
||||
def A2(auth)
|
||||
[ auth.method, auth.uri ] * ':'
|
||||
end
|
||||
|
||||
def digest(auth, password)
|
||||
password_hash = passwords_hashed? ? password : H(A1(auth, password))
|
||||
|
||||
KD(password_hash, [ auth.nonce, auth.nc, auth.cnonce, QOP, H(A2(auth)) ] * ':')
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,51 @@
|
|||
require 'digest/md5'
|
||||
|
||||
module Rack
|
||||
module Auth
|
||||
module Digest
|
||||
# Rack::Auth::Digest::Nonce is the default nonce generator for the
|
||||
# Rack::Auth::Digest::MD5 authentication handler.
|
||||
#
|
||||
# +private_key+ needs to set to a constant string.
|
||||
#
|
||||
# +time_limit+ can be optionally set to an integer (number of seconds),
|
||||
# to limit the validity of the generated nonces.
|
||||
|
||||
class Nonce
|
||||
|
||||
class << self
|
||||
attr_accessor :private_key, :time_limit
|
||||
end
|
||||
|
||||
def self.parse(string)
|
||||
new(*string.unpack("m*").first.split(' ', 2))
|
||||
end
|
||||
|
||||
def initialize(timestamp = Time.now, given_digest = nil)
|
||||
@timestamp, @given_digest = timestamp.to_i, given_digest
|
||||
end
|
||||
|
||||
def to_s
|
||||
[([ @timestamp, digest ] * ' ')].pack("m*").strip
|
||||
end
|
||||
|
||||
def digest
|
||||
::Digest::MD5.hexdigest([ @timestamp, self.class.private_key ] * ':')
|
||||
end
|
||||
|
||||
def valid?
|
||||
digest == @given_digest
|
||||
end
|
||||
|
||||
def stale?
|
||||
!self.class.time_limit.nil? && (@timestamp - Time.now.to_i) < self.class.time_limit
|
||||
end
|
||||
|
||||
def fresh?
|
||||
!stale?
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,55 @@
|
|||
module Rack
|
||||
module Auth
|
||||
module Digest
|
||||
class Params < Hash
|
||||
|
||||
def self.parse(str)
|
||||
split_header_value(str).inject(new) do |header, param|
|
||||
k, v = param.split('=', 2)
|
||||
header[k] = dequote(v)
|
||||
header
|
||||
end
|
||||
end
|
||||
|
||||
def self.dequote(str) # From WEBrick::HTTPUtils
|
||||
ret = (/\A"(.*)"\Z/ =~ str) ? $1 : str.dup
|
||||
ret.gsub!(/\\(.)/, "\\1")
|
||||
ret
|
||||
end
|
||||
|
||||
def self.split_header_value(str)
|
||||
str.scan( /(\w+\=(?:"[^\"]+"|[^,]+))/n ).collect{ |v| v[0] }
|
||||
end
|
||||
|
||||
def initialize
|
||||
super
|
||||
|
||||
yield self if block_given?
|
||||
end
|
||||
|
||||
def [](k)
|
||||
super k.to_s
|
||||
end
|
||||
|
||||
def []=(k, v)
|
||||
super k.to_s, v.to_s
|
||||
end
|
||||
|
||||
UNQUOTED = ['qop', 'nc', 'stale']
|
||||
|
||||
def to_s
|
||||
inject([]) do |parts, (k, v)|
|
||||
parts << "#{k}=" + (UNQUOTED.include?(k) ? v.to_s : quote(v))
|
||||
parts
|
||||
end.join(', ')
|
||||
end
|
||||
|
||||
def quote(str) # From WEBrick::HTTPUtils
|
||||
'"' << str.gsub(/[\\\"]/o, "\\\1") << '"'
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
|
|
@ -0,0 +1,40 @@
|
|||
require 'rack/auth/abstract/request'
|
||||
require 'rack/auth/digest/params'
|
||||
require 'rack/auth/digest/nonce'
|
||||
|
||||
module Rack
|
||||
module Auth
|
||||
module Digest
|
||||
class Request < Auth::AbstractRequest
|
||||
|
||||
def method
|
||||
@env['rack.methodoverride.original_method'] || @env['REQUEST_METHOD']
|
||||
end
|
||||
|
||||
def digest?
|
||||
:digest == scheme
|
||||
end
|
||||
|
||||
def correct_uri?
|
||||
(@env['SCRIPT_NAME'].to_s + @env['PATH_INFO'].to_s) == uri
|
||||
end
|
||||
|
||||
def nonce
|
||||
@nonce ||= Nonce.parse(params['nonce'])
|
||||
end
|
||||
|
||||
def params
|
||||
@params ||= Params.parse(parts.last)
|
||||
end
|
||||
|
||||
def method_missing(sym)
|
||||
if params.has_key? key = sym.to_s
|
||||
return params[key]
|
||||
end
|
||||
super
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,480 @@
|
|||
# AUTHOR: blink <blinketje@gmail.com>; blink#ruby-lang@irc.freenode.net
|
||||
|
||||
gem 'ruby-openid', '~> 2' if defined? Gem
|
||||
require 'rack/request'
|
||||
require 'rack/utils'
|
||||
require 'rack/auth/abstract/handler'
|
||||
require 'uri'
|
||||
require 'openid' #gem
|
||||
require 'openid/extension' #gem
|
||||
require 'openid/store/memory' #gem
|
||||
|
||||
module Rack
|
||||
class Request
|
||||
def openid_request
|
||||
@env['rack.auth.openid.request']
|
||||
end
|
||||
|
||||
def openid_response
|
||||
@env['rack.auth.openid.response']
|
||||
end
|
||||
end
|
||||
|
||||
module Auth
|
||||
|
||||
# Rack::Auth::OpenID provides a simple method for setting up an OpenID
|
||||
# Consumer. It requires the ruby-openid library from janrain to operate,
|
||||
# as well as a rack method of session management.
|
||||
#
|
||||
# The ruby-openid home page is at http://openidenabled.com/ruby-openid/.
|
||||
#
|
||||
# The OpenID specifications can be found at
|
||||
# http://openid.net/specs/openid-authentication-1_1.html
|
||||
# and
|
||||
# http://openid.net/specs/openid-authentication-2_0.html. Documentation
|
||||
# for published OpenID extensions and related topics can be found at
|
||||
# http://openid.net/developers/specs/.
|
||||
#
|
||||
# It is recommended to read through the OpenID spec, as well as
|
||||
# ruby-openid's documentation, to understand what exactly goes on. However
|
||||
# a setup as simple as the presented examples is enough to provide
|
||||
# Consumer functionality.
|
||||
#
|
||||
# This library strongly intends to utilize the OpenID 2.0 features of the
|
||||
# ruby-openid library, which provides OpenID 1.0 compatiblity.
|
||||
#
|
||||
# NOTE: Due to the amount of data that this library stores in the
|
||||
# session, Rack::Session::Cookie may fault.
|
||||
|
||||
class OpenID
|
||||
|
||||
class NoSession < RuntimeError; end
|
||||
class BadExtension < RuntimeError; end
|
||||
# Required for ruby-openid
|
||||
ValidStatus = [:success, :setup_needed, :cancel, :failure]
|
||||
|
||||
# = Arguments
|
||||
#
|
||||
# The first argument is the realm, identifying the site they are trusting
|
||||
# with their identity. This is required, also treated as the trust_root
|
||||
# in OpenID 1.x exchanges.
|
||||
#
|
||||
# The optional second argument is a hash of options.
|
||||
#
|
||||
# == Options
|
||||
#
|
||||
# <tt>:return_to</tt> defines the url to return to after the client
|
||||
# authenticates with the openid service provider. This url should point
|
||||
# to where Rack::Auth::OpenID is mounted. If <tt>:return_to</tt> is not
|
||||
# provided, return_to will be the current url which allows flexibility
|
||||
# with caveats.
|
||||
#
|
||||
# <tt>:session_key</tt> defines the key to the session hash in the env.
|
||||
# It defaults to 'rack.session'.
|
||||
#
|
||||
# <tt>:openid_param</tt> defines at what key in the request parameters to
|
||||
# find the identifier to resolve. As per the 2.0 spec, the default is
|
||||
# 'openid_identifier'.
|
||||
#
|
||||
# <tt>:store</tt> defined what OpenID Store to use for persistant
|
||||
# information. By default a Store::Memory will be used.
|
||||
#
|
||||
# <tt>:immediate</tt> as true will make initial requests to be of an
|
||||
# immediate type. This is false by default. See OpenID specification
|
||||
# documentation.
|
||||
#
|
||||
# <tt>:extensions</tt> should be a hash of openid extension
|
||||
# implementations. The key should be the extension main module, the value
|
||||
# should be an array of arguments for extension::Request.new.
|
||||
# The hash is iterated over and passed to #add_extension for processing.
|
||||
# Please see #add_extension for further documentation.
|
||||
#
|
||||
# == Examples
|
||||
#
|
||||
# simple_oid = OpenID.new('http://mysite.com/')
|
||||
#
|
||||
# return_oid = OpenID.new('http://mysite.com/', {
|
||||
# :return_to => 'http://mysite.com/openid'
|
||||
# })
|
||||
#
|
||||
# complex_oid = OpenID.new('http://mysite.com/',
|
||||
# :immediate => true,
|
||||
# :extensions => {
|
||||
# ::OpenID::SReg => [['email'],['nickname']]
|
||||
# }
|
||||
# )
|
||||
#
|
||||
# = Advanced
|
||||
#
|
||||
# Most of the functionality of this library is encapsulated such that
|
||||
# expansion and overriding functions isn't difficult nor tricky.
|
||||
# Alternately, to avoid opening up singleton objects or subclassing, a
|
||||
# wrapper rack middleware can be composed to act upon Auth::OpenID's
|
||||
# responses. See #check and #finish for locations of pertinent data.
|
||||
#
|
||||
# == Responses
|
||||
#
|
||||
# To change the responses that Auth::OpenID returns, override the methods
|
||||
# #redirect, #bad_request, #unauthorized, #access_denied, and
|
||||
# #foreign_server_failure.
|
||||
#
|
||||
# Additionally #confirm_post_params is used when the URI would exceed
|
||||
# length limits on a GET request when doing the initial verification
|
||||
# request.
|
||||
#
|
||||
# == Processing
|
||||
#
|
||||
# To change methods of processing completed transactions, override the
|
||||
# methods #success, #setup_needed, #cancel, and #failure. Please ensure
|
||||
# the returned object is a rack compatible response.
|
||||
#
|
||||
# The first argument is an OpenID::Response, the second is a
|
||||
# Rack::Request of the current request, the last is the hash used in
|
||||
# ruby-openid handling, which can be found manually at
|
||||
# env['rack.session'][:openid].
|
||||
#
|
||||
# This is useful if you wanted to expand the processing done, such as
|
||||
# setting up user accounts.
|
||||
#
|
||||
# oid_app = Rack::Auth::OpenID.new realm, :return_to => return_to
|
||||
# def oid_app.success oid, request, session
|
||||
# user = Models::User[oid.identity_url]
|
||||
# user ||= Models::User.create_from_openid oid
|
||||
# request['rack.session'][:user] = user.id
|
||||
# redirect MyApp.site_home
|
||||
# end
|
||||
#
|
||||
# site_map['/openid'] = oid_app
|
||||
# map = Rack::URLMap.new site_map
|
||||
# ...
|
||||
|
||||
def initialize(realm, options={})
|
||||
realm = URI(realm)
|
||||
raise ArgumentError, "Invalid realm: #{realm}" \
|
||||
unless realm.absolute? \
|
||||
and realm.fragment.nil? \
|
||||
and realm.scheme =~ /^https?$/ \
|
||||
and realm.host =~ /^(\*\.)?#{URI::REGEXP::PATTERN::URIC_NO_SLASH}+/
|
||||
realm.path = '/' if realm.path.empty?
|
||||
@realm = realm.to_s
|
||||
|
||||
if ruri = options[:return_to]
|
||||
ruri = URI(ruri)
|
||||
raise ArgumentError, "Invalid return_to: #{ruri}" \
|
||||
unless ruri.absolute? \
|
||||
and ruri.scheme =~ /^https?$/ \
|
||||
and ruri.fragment.nil?
|
||||
raise ArgumentError, "return_to #{ruri} not within realm #{realm}" \
|
||||
unless self.within_realm?(ruri)
|
||||
@return_to = ruri.to_s
|
||||
end
|
||||
|
||||
@session_key = options[:session_key] || 'rack.session'
|
||||
@openid_param = options[:openid_param] || 'openid_identifier'
|
||||
@store = options[:store] || ::OpenID::Store::Memory.new
|
||||
@immediate = !!options[:immediate]
|
||||
|
||||
@extensions = {}
|
||||
if extensions = options.delete(:extensions)
|
||||
extensions.each do |ext, args|
|
||||
add_extension ext, *args
|
||||
end
|
||||
end
|
||||
|
||||
# Undocumented, semi-experimental
|
||||
@anonymous = !!options[:anonymous]
|
||||
end
|
||||
|
||||
attr_reader :realm, :return_to, :session_key, :openid_param, :store,
|
||||
:immediate, :extensions
|
||||
|
||||
# Sets up and uses session data at <tt>:openid</tt> within the session.
|
||||
# Errors in this setup will raise a NoSession exception.
|
||||
#
|
||||
# If the parameter 'openid.mode' is set, which implies a followup from
|
||||
# the openid server, processing is passed to #finish and the result is
|
||||
# returned. However, if there is no appropriate openid information in the
|
||||
# session, a 400 error is returned.
|
||||
#
|
||||
# If the parameter specified by <tt>options[:openid_param]</tt> is
|
||||
# present, processing is passed to #check and the result is returned.
|
||||
#
|
||||
# If neither of these conditions are met, #unauthorized is called.
|
||||
|
||||
def call(env)
|
||||
env['rack.auth.openid'] = self
|
||||
env_session = env[@session_key]
|
||||
unless env_session and env_session.is_a?(Hash)
|
||||
raise NoSession, 'No compatible session'
|
||||
end
|
||||
# let us work in our own namespace...
|
||||
session = (env_session[:openid] ||= {})
|
||||
unless session and session.is_a?(Hash)
|
||||
raise NoSession, 'Incompatible openid session'
|
||||
end
|
||||
|
||||
request = Rack::Request.new(env)
|
||||
consumer = ::OpenID::Consumer.new(session, @store)
|
||||
|
||||
if mode = request.GET['openid.mode']
|
||||
if session.key?(:openid_param)
|
||||
finish(consumer, session, request)
|
||||
else
|
||||
bad_request
|
||||
end
|
||||
elsif request.GET[@openid_param]
|
||||
check(consumer, session, request)
|
||||
else
|
||||
unauthorized
|
||||
end
|
||||
end
|
||||
|
||||
# As the first part of OpenID consumer action, #check retrieves the data
|
||||
# required for completion.
|
||||
#
|
||||
# If all parameters fit within the max length of a URI, a 303 redirect
|
||||
# will be returned. Otherwise #confirm_post_params will be called.
|
||||
#
|
||||
# Any messages from OpenID's request are logged to env['rack.errors']
|
||||
#
|
||||
# <tt>env['rack.auth.openid.request']</tt> is the openid checkid request
|
||||
# instance.
|
||||
#
|
||||
# <tt>session[:openid_param]</tt> is set to the openid identifier
|
||||
# provided by the user.
|
||||
#
|
||||
# <tt>session[:return_to]</tt> is set to the return_to uri given to the
|
||||
# identity provider.
|
||||
|
||||
def check(consumer, session, req)
|
||||
oid = consumer.begin(req.GET[@openid_param], @anonymous)
|
||||
req.env['rack.auth.openid.request'] = oid
|
||||
req.env['rack.errors'].puts(oid.message)
|
||||
p oid if $DEBUG
|
||||
|
||||
## Extension support
|
||||
extensions.each do |ext,args|
|
||||
oid.add_extension(ext::Request.new(*args))
|
||||
end
|
||||
|
||||
session[:openid_param] = req.GET[openid_param]
|
||||
return_to_uri = return_to ? return_to : req.url
|
||||
session[:return_to] = return_to_uri
|
||||
immediate = session.key?(:setup_needed) ? false : immediate
|
||||
|
||||
if oid.send_redirect?(realm, return_to_uri, immediate)
|
||||
uri = oid.redirect_url(realm, return_to_uri, immediate)
|
||||
redirect(uri)
|
||||
else
|
||||
confirm_post_params(oid, realm, return_to_uri, immediate)
|
||||
end
|
||||
rescue ::OpenID::DiscoveryFailure => e
|
||||
# thrown from inside OpenID::Consumer#begin by yadis stuff
|
||||
req.env['rack.errors'].puts([e.message, *e.backtrace]*"\n")
|
||||
return foreign_server_failure
|
||||
end
|
||||
|
||||
# This is the final portion of authentication.
|
||||
# If successful, a redirect to the realm is be returned.
|
||||
# Data gathered from extensions are stored in session[:openid] with the
|
||||
# extension's namespace uri as the key.
|
||||
#
|
||||
# Any messages from OpenID's response are logged to env['rack.errors']
|
||||
#
|
||||
# <tt>env['rack.auth.openid.response']</tt> will contain the openid
|
||||
# response.
|
||||
|
||||
def finish(consumer, session, req)
|
||||
oid = consumer.complete(req.GET, req.url)
|
||||
req.env['rack.auth.openid.response'] = oid
|
||||
req.env['rack.errors'].puts(oid.message)
|
||||
p oid if $DEBUG
|
||||
|
||||
raise unless ValidStatus.include?(oid.status)
|
||||
__send__(oid.status, oid, req, session)
|
||||
end
|
||||
|
||||
# The first argument should be the main extension module.
|
||||
# The extension module should contain the constants:
|
||||
# * class Request, should have OpenID::Extension as an ancestor
|
||||
# * class Response, should have OpenID::Extension as an ancestor
|
||||
# * string NS_URI, which defining the namespace of the extension
|
||||
#
|
||||
# All trailing arguments will be passed to extension::Request.new in
|
||||
# #check.
|
||||
# The openid response will be passed to
|
||||
# extension::Response#from_success_response, #get_extension_args will be
|
||||
# called on the result to attain the gathered data.
|
||||
#
|
||||
# This method returns the key at which the response data will be found in
|
||||
# the session, which is the namespace uri by default.
|
||||
|
||||
def add_extension(ext, *args)
|
||||
raise BadExtension unless valid_extension?(ext)
|
||||
extensions[ext] = args
|
||||
return ext::NS_URI
|
||||
end
|
||||
|
||||
# Checks the validitity, in the context of usage, of a submitted
|
||||
# extension.
|
||||
|
||||
def valid_extension?(ext)
|
||||
if not %w[NS_URI Request Response].all?{|c| ext.const_defined?(c) }
|
||||
raise ArgumentError, 'Extension is missing constants.'
|
||||
elsif not ext::Response.respond_to?(:from_success_response)
|
||||
raise ArgumentError, 'Response is missing required method.'
|
||||
end
|
||||
return true
|
||||
rescue
|
||||
return false
|
||||
end
|
||||
|
||||
# Checks the provided uri to ensure it'd be considered within the realm.
|
||||
# is currently not compatible with wildcard realms.
|
||||
|
||||
def within_realm? uri
|
||||
uri = URI.parse(uri.to_s)
|
||||
realm = URI.parse(self.realm)
|
||||
return false unless uri.absolute?
|
||||
return false unless uri.path[0, realm.path.size] == realm.path
|
||||
return false unless uri.host == realm.host or realm.host[/^\*\./]
|
||||
# for wildcard support, is awkward with URI limitations
|
||||
realm_match = Regexp.escape(realm.host).
|
||||
sub(/^\*\./,"^#{URI::REGEXP::PATTERN::URIC_NO_SLASH}+.")+'$'
|
||||
return false unless uri.host.match(realm_match)
|
||||
return true
|
||||
end
|
||||
alias_method :include?, :within_realm?
|
||||
|
||||
protected
|
||||
|
||||
### These methods define some of the boilerplate responses.
|
||||
|
||||
# Returns an html form page for posting to an Identity Provider if the
|
||||
# GET request would exceed the upper URI length limit.
|
||||
|
||||
def confirm_post_params(oid, realm, return_to, immediate)
|
||||
Rack::Response.new.finish do |r|
|
||||
r.write '<html><head><title>Confirm...</title></head><body>'
|
||||
r.write oid.form_markup(realm, return_to, immediate)
|
||||
r.write '</body></html>'
|
||||
end
|
||||
end
|
||||
|
||||
# Returns a 303 redirect with the destination of that provided by the
|
||||
# argument.
|
||||
|
||||
def redirect(uri)
|
||||
[ 303, {'Content-Length'=>'0', 'Content-Type'=>'text/plain',
|
||||
'Location' => uri},
|
||||
[] ]
|
||||
end
|
||||
|
||||
# Returns an empty 400 response.
|
||||
|
||||
def bad_request
|
||||
[ 400, {'Content-Type'=>'text/plain', 'Content-Length'=>'0'},
|
||||
[''] ]
|
||||
end
|
||||
|
||||
# Returns a basic unauthorized 401 response.
|
||||
|
||||
def unauthorized
|
||||
[ 401, {'Content-Type' => 'text/plain', 'Content-Length' => '13'},
|
||||
['Unauthorized.'] ]
|
||||
end
|
||||
|
||||
# Returns a basic access denied 403 response.
|
||||
|
||||
def access_denied
|
||||
[ 403, {'Content-Type' => 'text/plain', 'Content-Length' => '14'},
|
||||
['Access denied.'] ]
|
||||
end
|
||||
|
||||
# Returns a 503 response to be used if communication with the remote
|
||||
# OpenID server fails.
|
||||
|
||||
def foreign_server_failure
|
||||
[ 503, {'Content-Type'=>'text/plain', 'Content-Length' => '23'},
|
||||
['Foreign server failure.'] ]
|
||||
end
|
||||
|
||||
private
|
||||
|
||||
### These methods are called after a transaction is completed, depending
|
||||
# on its outcome. These should all return a rack compatible response.
|
||||
# You'd want to override these to provide additional functionality.
|
||||
|
||||
# Called to complete processing on a successful transaction.
|
||||
# Within the openid session, :openid_identity and :openid_identifier are
|
||||
# set to the user friendly and the standard representation of the
|
||||
# validated identity. All other data in the openid session is cleared.
|
||||
|
||||
def success(oid, request, session)
|
||||
session.clear
|
||||
session[:openid_identity] = oid.display_identifier
|
||||
session[:openid_identifier] = oid.identity_url
|
||||
extensions.keys.each do |ext|
|
||||
label = ext.name[/[^:]+$/].downcase
|
||||
response = ext::Response.from_success_response(oid)
|
||||
session[label] = response.data
|
||||
end
|
||||
redirect(realm)
|
||||
end
|
||||
|
||||
# Called if the Identity Provider indicates further setup by the user is
|
||||
# required.
|
||||
# The identifier is retrived from the openid session at :openid_param.
|
||||
# And :setup_needed is set to true to prevent looping.
|
||||
|
||||
def setup_needed(oid, request, session)
|
||||
identifier = session[:openid_param]
|
||||
session[:setup_needed] = true
|
||||
redirect req.script_name + '?' + openid_param + '=' + identifier
|
||||
end
|
||||
|
||||
# Called if the user indicates they wish to cancel identification.
|
||||
# Data within openid session is cleared.
|
||||
|
||||
def cancel(oid, request, session)
|
||||
session.clear
|
||||
access_denied
|
||||
end
|
||||
|
||||
# Called if the Identity Provider indicates the user is unable to confirm
|
||||
# their identity. Data within the openid session is left alone, in case
|
||||
# of swarm auth attacks.
|
||||
|
||||
def failure(oid, request, session)
|
||||
unauthorized
|
||||
end
|
||||
end
|
||||
|
||||
# A class developed out of the request to use OpenID as an authentication
|
||||
# middleware. The request will be sent to the OpenID instance unless the
|
||||
# block evaluates to true. For example in rackup, you can use it as such:
|
||||
#
|
||||
# use Rack::Session::Pool
|
||||
# use Rack::Auth::OpenIDAuth, realm, openid_options do |env|
|
||||
# env['rack.session'][:authkey] == a_string
|
||||
# end
|
||||
# run RackApp
|
||||
#
|
||||
# Or simply:
|
||||
#
|
||||
# app = Rack::Auth::OpenIDAuth.new app, realm, openid_options, &auth
|
||||
|
||||
class OpenIDAuth < Rack::Auth::AbstractHandler
|
||||
attr_reader :oid
|
||||
def initialize(app, realm, options={}, &auth)
|
||||
@oid = OpenID.new(realm, options)
|
||||
super(app, &auth)
|
||||
end
|
||||
|
||||
def call(env)
|
||||
to = auth.call(env) ? @app : @oid
|
||||
to.call env
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,63 @@
|
|||
module Rack
|
||||
# Rack::Builder implements a small DSL to iteratively construct Rack
|
||||
# applications.
|
||||
#
|
||||
# Example:
|
||||
#
|
||||
# app = Rack::Builder.new {
|
||||
# use Rack::CommonLogger
|
||||
# use Rack::ShowExceptions
|
||||
# map "/lobster" do
|
||||
# use Rack::Lint
|
||||
# run Rack::Lobster.new
|
||||
# end
|
||||
# }
|
||||
#
|
||||
# Or
|
||||
#
|
||||
# app = Rack::Builder.app do
|
||||
# use Rack::CommonLogger
|
||||
# lambda { |env| [200, {'Content-Type' => 'text/plain'}, 'OK'] }
|
||||
# end
|
||||
#
|
||||
# +use+ adds a middleware to the stack, +run+ dispatches to an application.
|
||||
# You can use +map+ to construct a Rack::URLMap in a convenient way.
|
||||
|
||||
class Builder
|
||||
def initialize(&block)
|
||||
@ins = []
|
||||
instance_eval(&block) if block_given?
|
||||
end
|
||||
|
||||
def self.app(&block)
|
||||
self.new(&block).to_app
|
||||
end
|
||||
|
||||
def use(middleware, *args, &block)
|
||||
@ins << lambda { |app| middleware.new(app, *args, &block) }
|
||||
end
|
||||
|
||||
def run(app)
|
||||
@ins << app #lambda { |nothing| app }
|
||||
end
|
||||
|
||||
def map(path, &block)
|
||||
if @ins.last.kind_of? Hash
|
||||
@ins.last[path] = self.class.new(&block).to_app
|
||||
else
|
||||
@ins << {}
|
||||
map(path, &block)
|
||||
end
|
||||
end
|
||||
|
||||
def to_app
|
||||
@ins[-1] = Rack::URLMap.new(@ins.last) if Hash === @ins.last
|
||||
inner_app = @ins.last
|
||||
@ins[0...-1].reverse.inject(inner_app) { |a, e| e.call(a) }
|
||||
end
|
||||
|
||||
def call(env)
|
||||
to_app.call(env)
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,36 @@
|
|||
module Rack
|
||||
# Rack::Cascade tries an request on several apps, and returns the
|
||||
# first response that is not 404 (or in a list of configurable
|
||||
# status codes).
|
||||
|
||||
class Cascade
|
||||
attr_reader :apps
|
||||
|
||||
def initialize(apps, catch=404)
|
||||
@apps = apps
|
||||
@catch = [*catch]
|
||||
end
|
||||
|
||||
def call(env)
|
||||
status = headers = body = nil
|
||||
raise ArgumentError, "empty cascade" if @apps.empty?
|
||||
@apps.each { |app|
|
||||
begin
|
||||
status, headers, body = app.call(env)
|
||||
break unless @catch.include?(status.to_i)
|
||||
end
|
||||
}
|
||||
[status, headers, body]
|
||||
end
|
||||
|
||||
def add app
|
||||
@apps << app
|
||||
end
|
||||
|
||||
def include? app
|
||||
@apps.include? app
|
||||
end
|
||||
|
||||
alias_method :<<, :add
|
||||
end
|
||||
end
|
|
@ -0,0 +1,49 @@
|
|||
require 'rack/utils'
|
||||
|
||||
module Rack
|
||||
|
||||
# Middleware that applies chunked transfer encoding to response bodies
|
||||
# when the response does not include a Content-Length header.
|
||||
class Chunked
|
||||
include Rack::Utils
|
||||
|
||||
def initialize(app)
|
||||
@app = app
|
||||
end
|
||||
|
||||
def call(env)
|
||||
status, headers, body = @app.call(env)
|
||||
headers = HeaderHash.new(headers)
|
||||
|
||||
if env['HTTP_VERSION'] == 'HTTP/1.0' ||
|
||||
STATUS_WITH_NO_ENTITY_BODY.include?(status) ||
|
||||
headers['Content-Length'] ||
|
||||
headers['Transfer-Encoding']
|
||||
[status, headers.to_hash, body]
|
||||
else
|
||||
dup.chunk(status, headers, body)
|
||||
end
|
||||
end
|
||||
|
||||
def chunk(status, headers, body)
|
||||
@body = body
|
||||
headers.delete('Content-Length')
|
||||
headers['Transfer-Encoding'] = 'chunked'
|
||||
[status, headers.to_hash, self]
|
||||
end
|
||||
|
||||
def each
|
||||
term = "\r\n"
|
||||
@body.each do |chunk|
|
||||
size = bytesize(chunk)
|
||||
next if size == 0
|
||||
yield [size.to_s(16), term, chunk, term].join
|
||||
end
|
||||
yield ["0", term, "", term].join
|
||||
end
|
||||
|
||||
def close
|
||||
@body.close if @body.respond_to?(:close)
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,61 @@
|
|||
module Rack
|
||||
# Rack::CommonLogger forwards every request to an +app+ given, and
|
||||
# logs a line in the Apache common log format to the +logger+, or
|
||||
# rack.errors by default.
|
||||
|
||||
class CommonLogger
|
||||
def initialize(app, logger=nil)
|
||||
@app = app
|
||||
@logger = logger
|
||||
end
|
||||
|
||||
def call(env)
|
||||
dup._call(env)
|
||||
end
|
||||
|
||||
def _call(env)
|
||||
@env = env
|
||||
@logger ||= self
|
||||
@time = Time.now
|
||||
@status, @header, @body = @app.call(env)
|
||||
[@status, @header, self]
|
||||
end
|
||||
|
||||
def close
|
||||
@body.close if @body.respond_to? :close
|
||||
end
|
||||
|
||||
# By default, log to rack.errors.
|
||||
def <<(str)
|
||||
@env["rack.errors"].write(str)
|
||||
@env["rack.errors"].flush
|
||||
end
|
||||
|
||||
def each
|
||||
length = 0
|
||||
@body.each { |part|
|
||||
length += part.size
|
||||
yield part
|
||||
}
|
||||
|
||||
@now = Time.now
|
||||
|
||||
# Common Log Format: http://httpd.apache.org/docs/1.3/logs.html#common
|
||||
# lilith.local - - [07/Aug/2006 23:58:02] "GET / HTTP/1.1" 500 -
|
||||
# %{%s - %s [%s] "%s %s%s %s" %d %s\n} %
|
||||
@logger << %{%s - %s [%s] "%s %s%s %s" %d %s %0.4f\n} %
|
||||
[
|
||||
@env['HTTP_X_FORWARDED_FOR'] || @env["REMOTE_ADDR"] || "-",
|
||||
@env["REMOTE_USER"] || "-",
|
||||
@now.strftime("%d/%b/%Y %H:%M:%S"),
|
||||
@env["REQUEST_METHOD"],
|
||||
@env["PATH_INFO"],
|
||||
@env["QUERY_STRING"].empty? ? "" : "?"+@env["QUERY_STRING"],
|
||||
@env["HTTP_VERSION"],
|
||||
@status.to_s[0..3],
|
||||
(length.zero? ? "-" : length.to_s),
|
||||
@now - @time
|
||||
]
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,47 @@
|
|||
require 'rack/utils'
|
||||
|
||||
module Rack
|
||||
|
||||
# Middleware that enables conditional GET using If-None-Match and
|
||||
# If-Modified-Since. The application should set either or both of the
|
||||
# Last-Modified or Etag response headers according to RFC 2616. When
|
||||
# either of the conditions is met, the response body is set to be zero
|
||||
# length and the response status is set to 304 Not Modified.
|
||||
#
|
||||
# Applications that defer response body generation until the body's each
|
||||
# message is received will avoid response body generation completely when
|
||||
# a conditional GET matches.
|
||||
#
|
||||
# Adapted from Michael Klishin's Merb implementation:
|
||||
# http://github.com/wycats/merb-core/tree/master/lib/merb-core/rack/middleware/conditional_get.rb
|
||||
class ConditionalGet
|
||||
def initialize(app)
|
||||
@app = app
|
||||
end
|
||||
|
||||
def call(env)
|
||||
return @app.call(env) unless %w[GET HEAD].include?(env['REQUEST_METHOD'])
|
||||
|
||||
status, headers, body = @app.call(env)
|
||||
headers = Utils::HeaderHash.new(headers)
|
||||
if etag_matches?(env, headers) || modified_since?(env, headers)
|
||||
status = 304
|
||||
headers.delete('Content-Type')
|
||||
headers.delete('Content-Length')
|
||||
body = []
|
||||
end
|
||||
[status, headers, body]
|
||||
end
|
||||
|
||||
private
|
||||
def etag_matches?(env, headers)
|
||||
etag = headers['Etag'] and etag == env['HTTP_IF_NONE_MATCH']
|
||||
end
|
||||
|
||||
def modified_since?(env, headers)
|
||||
last_modified = headers['Last-Modified'] and
|
||||
last_modified == env['HTTP_IF_MODIFIED_SINCE']
|
||||
end
|
||||
end
|
||||
|
||||
end
|
|
@ -0,0 +1,29 @@
|
|||
require 'rack/utils'
|
||||
|
||||
module Rack
|
||||
# Sets the Content-Length header on responses with fixed-length bodies.
|
||||
class ContentLength
|
||||
include Rack::Utils
|
||||
|
||||
def initialize(app)
|
||||
@app = app
|
||||
end
|
||||
|
||||
def call(env)
|
||||
status, headers, body = @app.call(env)
|
||||
headers = HeaderHash.new(headers)
|
||||
|
||||
if !STATUS_WITH_NO_ENTITY_BODY.include?(status) &&
|
||||
!headers['Content-Length'] &&
|
||||
!headers['Transfer-Encoding'] &&
|
||||
(body.respond_to?(:to_ary) || body.respond_to?(:to_str))
|
||||
|
||||
body = [body] if body.respond_to?(:to_str) # rack 0.4 compat
|
||||
length = body.to_ary.inject(0) { |len, part| len + bytesize(part) }
|
||||
headers['Content-Length'] = length.to_s
|
||||
end
|
||||
|
||||
[status, headers, body]
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,23 @@
|
|||
require 'rack/utils'
|
||||
|
||||
module Rack
|
||||
|
||||
# Sets the Content-Type header on responses which don't have one.
|
||||
#
|
||||
# Builder Usage:
|
||||
# use Rack::ContentType, "text/plain"
|
||||
#
|
||||
# When no content type argument is provided, "text/html" is assumed.
|
||||
class ContentType
|
||||
def initialize(app, content_type = "text/html")
|
||||
@app, @content_type = app, content_type
|
||||
end
|
||||
|
||||
def call(env)
|
||||
status, headers, body = @app.call(env)
|
||||
headers = Utils::HeaderHash.new(headers)
|
||||
headers['Content-Type'] ||= @content_type
|
||||
[status, headers.to_hash, body]
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,96 @@
|
|||
require "zlib"
|
||||
require "stringio"
|
||||
require "time" # for Time.httpdate
|
||||
require 'rack/utils'
|
||||
|
||||
module Rack
|
||||
class Deflater
|
||||
def initialize(app)
|
||||
@app = app
|
||||
end
|
||||
|
||||
def call(env)
|
||||
status, headers, body = @app.call(env)
|
||||
headers = Utils::HeaderHash.new(headers)
|
||||
|
||||
# Skip compressing empty entity body responses and responses with
|
||||
# no-transform set.
|
||||
if Utils::STATUS_WITH_NO_ENTITY_BODY.include?(status) ||
|
||||
headers['Cache-Control'].to_s =~ /\bno-transform\b/
|
||||
return [status, headers, body]
|
||||
end
|
||||
|
||||
request = Request.new(env)
|
||||
|
||||
encoding = Utils.select_best_encoding(%w(gzip deflate identity),
|
||||
request.accept_encoding)
|
||||
|
||||
# Set the Vary HTTP header.
|
||||
vary = headers["Vary"].to_s.split(",").map { |v| v.strip }
|
||||
unless vary.include?("*") || vary.include?("Accept-Encoding")
|
||||
headers["Vary"] = vary.push("Accept-Encoding").join(",")
|
||||
end
|
||||
|
||||
case encoding
|
||||
when "gzip"
|
||||
headers['Content-Encoding'] = "gzip"
|
||||
headers.delete('Content-Length')
|
||||
mtime = headers.key?("Last-Modified") ?
|
||||
Time.httpdate(headers["Last-Modified"]) : Time.now
|
||||
[status, headers, GzipStream.new(body, mtime)]
|
||||
when "deflate"
|
||||
headers['Content-Encoding'] = "deflate"
|
||||
headers.delete('Content-Length')
|
||||
[status, headers, DeflateStream.new(body)]
|
||||
when "identity"
|
||||
[status, headers, body]
|
||||
when nil
|
||||
message = "An acceptable encoding for the requested resource #{request.fullpath} could not be found."
|
||||
[406, {"Content-Type" => "text/plain", "Content-Length" => message.length.to_s}, [message]]
|
||||
end
|
||||
end
|
||||
|
||||
class GzipStream
|
||||
def initialize(body, mtime)
|
||||
@body = body
|
||||
@mtime = mtime
|
||||
end
|
||||
|
||||
def each(&block)
|
||||
@writer = block
|
||||
gzip =::Zlib::GzipWriter.new(self)
|
||||
gzip.mtime = @mtime
|
||||
@body.each { |part| gzip.write(part) }
|
||||
@body.close if @body.respond_to?(:close)
|
||||
gzip.close
|
||||
@writer = nil
|
||||
end
|
||||
|
||||
def write(data)
|
||||
@writer.call(data)
|
||||
end
|
||||
end
|
||||
|
||||
class DeflateStream
|
||||
DEFLATE_ARGS = [
|
||||
Zlib::DEFAULT_COMPRESSION,
|
||||
# drop the zlib header which causes both Safari and IE to choke
|
||||
-Zlib::MAX_WBITS,
|
||||
Zlib::DEF_MEM_LEVEL,
|
||||
Zlib::DEFAULT_STRATEGY
|
||||
]
|
||||
|
||||
def initialize(body)
|
||||
@body = body
|
||||
end
|
||||
|
||||
def each
|
||||
deflater = ::Zlib::Deflate.new(*DEFLATE_ARGS)
|
||||
@body.each { |part| yield deflater.deflate(part) }
|
||||
@body.close if @body.respond_to?(:close)
|
||||
yield deflater.finish
|
||||
nil
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,153 @@
|
|||
require 'time'
|
||||
require 'rack/utils'
|
||||
require 'rack/mime'
|
||||
|
||||
module Rack
|
||||
# Rack::Directory serves entries below the +root+ given, according to the
|
||||
# path info of the Rack request. If a directory is found, the file's contents
|
||||
# will be presented in an html based index. If a file is found, the env will
|
||||
# be passed to the specified +app+.
|
||||
#
|
||||
# If +app+ is not specified, a Rack::File of the same +root+ will be used.
|
||||
|
||||
class Directory
|
||||
DIR_FILE = "<tr><td class='name'><a href='%s'>%s</a></td><td class='size'>%s</td><td class='type'>%s</td><td class='mtime'>%s</td></tr>"
|
||||
DIR_PAGE = <<-PAGE
|
||||
<html><head>
|
||||
<title>%s</title>
|
||||
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
||||
<style type='text/css'>
|
||||
table { width:100%%; }
|
||||
.name { text-align:left; }
|
||||
.size, .mtime { text-align:right; }
|
||||
.type { width:11em; }
|
||||
.mtime { width:15em; }
|
||||
</style>
|
||||
</head><body>
|
||||
<h1>%s</h1>
|
||||
<hr />
|
||||
<table>
|
||||
<tr>
|
||||
<th class='name'>Name</th>
|
||||
<th class='size'>Size</th>
|
||||
<th class='type'>Type</th>
|
||||
<th class='mtime'>Last Modified</th>
|
||||
</tr>
|
||||
%s
|
||||
</table>
|
||||
<hr />
|
||||
</body></html>
|
||||
PAGE
|
||||
|
||||
attr_reader :files
|
||||
attr_accessor :root, :path
|
||||
|
||||
def initialize(root, app=nil)
|
||||
@root = F.expand_path(root)
|
||||
@app = app || Rack::File.new(@root)
|
||||
end
|
||||
|
||||
def call(env)
|
||||
dup._call(env)
|
||||
end
|
||||
|
||||
F = ::File
|
||||
|
||||
def _call(env)
|
||||
@env = env
|
||||
@script_name = env['SCRIPT_NAME']
|
||||
@path_info = Utils.unescape(env['PATH_INFO'])
|
||||
|
||||
if forbidden = check_forbidden
|
||||
forbidden
|
||||
else
|
||||
@path = F.join(@root, @path_info)
|
||||
list_path
|
||||
end
|
||||
end
|
||||
|
||||
def check_forbidden
|
||||
return unless @path_info.include? ".."
|
||||
|
||||
body = "Forbidden\n"
|
||||
size = Rack::Utils.bytesize(body)
|
||||
return [403, {"Content-Type" => "text/plain","Content-Length" => size.to_s}, [body]]
|
||||
end
|
||||
|
||||
def list_directory
|
||||
@files = [['../','Parent Directory','','','']]
|
||||
glob = F.join(@path, '*')
|
||||
|
||||
Dir[glob].sort.each do |node|
|
||||
stat = stat(node)
|
||||
next unless stat
|
||||
basename = F.basename(node)
|
||||
ext = F.extname(node)
|
||||
|
||||
url = F.join(@script_name, @path_info, basename)
|
||||
size = stat.size
|
||||
type = stat.directory? ? 'directory' : Mime.mime_type(ext)
|
||||
size = stat.directory? ? '-' : filesize_format(size)
|
||||
mtime = stat.mtime.httpdate
|
||||
url << '/' if stat.directory?
|
||||
basename << '/' if stat.directory?
|
||||
|
||||
@files << [ url, basename, size, type, mtime ]
|
||||
end
|
||||
|
||||
return [ 200, {'Content-Type'=>'text/html; charset=utf-8'}, self ]
|
||||
end
|
||||
|
||||
def stat(node, max = 10)
|
||||
F.stat(node)
|
||||
rescue Errno::ENOENT, Errno::ELOOP
|
||||
return nil
|
||||
end
|
||||
|
||||
# TODO: add correct response if not readable, not sure if 404 is the best
|
||||
# option
|
||||
def list_path
|
||||
@stat = F.stat(@path)
|
||||
|
||||
if @stat.readable?
|
||||
return @app.call(@env) if @stat.file?
|
||||
return list_directory if @stat.directory?
|
||||
else
|
||||
raise Errno::ENOENT, 'No such file or directory'
|
||||
end
|
||||
|
||||
rescue Errno::ENOENT, Errno::ELOOP
|
||||
return entity_not_found
|
||||
end
|
||||
|
||||
def entity_not_found
|
||||
body = "Entity not found: #{@path_info}\n"
|
||||
size = Rack::Utils.bytesize(body)
|
||||
return [404, {"Content-Type" => "text/plain", "Content-Length" => size.to_s}, [body]]
|
||||
end
|
||||
|
||||
def each
|
||||
show_path = @path.sub(/^#{@root}/,'')
|
||||
files = @files.map{|f| DIR_FILE % f }*"\n"
|
||||
page = DIR_PAGE % [ show_path, show_path , files ]
|
||||
page.each_line{|l| yield l }
|
||||
end
|
||||
|
||||
# Stolen from Ramaze
|
||||
|
||||
FILESIZE_FORMAT = [
|
||||
['%.1fT', 1 << 40],
|
||||
['%.1fG', 1 << 30],
|
||||
['%.1fM', 1 << 20],
|
||||
['%.1fK', 1 << 10],
|
||||
]
|
||||
|
||||
def filesize_format(int)
|
||||
FILESIZE_FORMAT.each do |format, size|
|
||||
return format % (int.to_f / size) if int >= size
|
||||
end
|
||||
|
||||
int.to_s + 'B'
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,88 @@
|
|||
require 'time'
|
||||
require 'rack/utils'
|
||||
require 'rack/mime'
|
||||
|
||||
module Rack
|
||||
# Rack::File serves files below the +root+ given, according to the
|
||||
# path info of the Rack request.
|
||||
#
|
||||
# Handlers can detect if bodies are a Rack::File, and use mechanisms
|
||||
# like sendfile on the +path+.
|
||||
|
||||
class File
|
||||
attr_accessor :root
|
||||
attr_accessor :path
|
||||
|
||||
alias :to_path :path
|
||||
|
||||
def initialize(root)
|
||||
@root = root
|
||||
end
|
||||
|
||||
def call(env)
|
||||
dup._call(env)
|
||||
end
|
||||
|
||||
F = ::File
|
||||
|
||||
def _call(env)
|
||||
@path_info = Utils.unescape(env["PATH_INFO"])
|
||||
return forbidden if @path_info.include? ".."
|
||||
|
||||
@path = F.join(@root, @path_info)
|
||||
|
||||
begin
|
||||
if F.file?(@path) && F.readable?(@path)
|
||||
serving
|
||||
else
|
||||
raise Errno::EPERM
|
||||
end
|
||||
rescue SystemCallError
|
||||
not_found
|
||||
end
|
||||
end
|
||||
|
||||
def forbidden
|
||||
body = "Forbidden\n"
|
||||
[403, {"Content-Type" => "text/plain",
|
||||
"Content-Length" => body.size.to_s},
|
||||
[body]]
|
||||
end
|
||||
|
||||
# NOTE:
|
||||
# We check via File::size? whether this file provides size info
|
||||
# via stat (e.g. /proc files often don't), otherwise we have to
|
||||
# figure it out by reading the whole file into memory. And while
|
||||
# we're at it we also use this as body then.
|
||||
|
||||
def serving
|
||||
if size = F.size?(@path)
|
||||
body = self
|
||||
else
|
||||
body = [F.read(@path)]
|
||||
size = Utils.bytesize(body.first)
|
||||
end
|
||||
|
||||
[200, {
|
||||
"Last-Modified" => F.mtime(@path).httpdate,
|
||||
"Content-Type" => Mime.mime_type(F.extname(@path), 'text/plain'),
|
||||
"Content-Length" => size.to_s
|
||||
}, body]
|
||||
end
|
||||
|
||||
def not_found
|
||||
body = "File not found: #{@path_info}\n"
|
||||
[404, {"Content-Type" => "text/plain",
|
||||
"Content-Length" => body.size.to_s},
|
||||
[body]]
|
||||
end
|
||||
|
||||
def each
|
||||
F.open(@path, "rb") { |file|
|
||||
while part = file.read(8192)
|
||||
yield part
|
||||
end
|
||||
}
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,69 @@
|
|||
module Rack
|
||||
# *Handlers* connect web servers with Rack.
|
||||
#
|
||||
# Rack includes Handlers for Mongrel, WEBrick, FastCGI, CGI, SCGI
|
||||
# and LiteSpeed.
|
||||
#
|
||||
# Handlers usually are activated by calling <tt>MyHandler.run(myapp)</tt>.
|
||||
# A second optional hash can be passed to include server-specific
|
||||
# configuration.
|
||||
module Handler
|
||||
def self.get(server)
|
||||
return unless server
|
||||
server = server.to_s
|
||||
|
||||
if klass = @handlers[server]
|
||||
obj = Object
|
||||
klass.split("::").each { |x| obj = obj.const_get(x) }
|
||||
obj
|
||||
else
|
||||
try_require('rack/handler', server)
|
||||
const_get(server)
|
||||
end
|
||||
end
|
||||
|
||||
# Transforms server-name constants to their canonical form as filenames,
|
||||
# then tries to require them but silences the LoadError if not found
|
||||
#
|
||||
# Naming convention:
|
||||
#
|
||||
# Foo # => 'foo'
|
||||
# FooBar # => 'foo_bar.rb'
|
||||
# FooBAR # => 'foobar.rb'
|
||||
# FOObar # => 'foobar.rb'
|
||||
# FOOBAR # => 'foobar.rb'
|
||||
# FooBarBaz # => 'foo_bar_baz.rb'
|
||||
def self.try_require(prefix, const_name)
|
||||
file = const_name.gsub(/^[A-Z]+/) { |pre| pre.downcase }.
|
||||
gsub(/[A-Z]+[^A-Z]/, '_\&').downcase
|
||||
|
||||
require(::File.join(prefix, file))
|
||||
rescue LoadError
|
||||
end
|
||||
|
||||
def self.register(server, klass)
|
||||
@handlers ||= {}
|
||||
@handlers[server] = klass
|
||||
end
|
||||
|
||||
autoload :CGI, "rack/handler/cgi"
|
||||
autoload :FastCGI, "rack/handler/fastcgi"
|
||||
autoload :Mongrel, "rack/handler/mongrel"
|
||||
autoload :EventedMongrel, "rack/handler/evented_mongrel"
|
||||
autoload :SwiftipliedMongrel, "rack/handler/swiftiplied_mongrel"
|
||||
autoload :WEBrick, "rack/handler/webrick"
|
||||
autoload :LSWS, "rack/handler/lsws"
|
||||
autoload :SCGI, "rack/handler/scgi"
|
||||
autoload :Thin, "rack/handler/thin"
|
||||
|
||||
register 'cgi', 'Rack::Handler::CGI'
|
||||
register 'fastcgi', 'Rack::Handler::FastCGI'
|
||||
register 'mongrel', 'Rack::Handler::Mongrel'
|
||||
register 'emongrel', 'Rack::Handler::EventedMongrel'
|
||||
register 'smongrel', 'Rack::Handler::SwiftipliedMongrel'
|
||||
register 'webrick', 'Rack::Handler::WEBrick'
|
||||
register 'lsws', 'Rack::Handler::LSWS'
|
||||
register 'scgi', 'Rack::Handler::SCGI'
|
||||
register 'thin', 'Rack::Handler::Thin'
|
||||
end
|
||||
end
|
|
@ -0,0 +1,61 @@
|
|||
require 'rack/content_length'
|
||||
|
||||
module Rack
|
||||
module Handler
|
||||
class CGI
|
||||
def self.run(app, options=nil)
|
||||
serve app
|
||||
end
|
||||
|
||||
def self.serve(app)
|
||||
app = ContentLength.new(app)
|
||||
|
||||
env = ENV.to_hash
|
||||
env.delete "HTTP_CONTENT_LENGTH"
|
||||
|
||||
env["SCRIPT_NAME"] = "" if env["SCRIPT_NAME"] == "/"
|
||||
|
||||
env.update({"rack.version" => [1,0],
|
||||
"rack.input" => $stdin,
|
||||
"rack.errors" => $stderr,
|
||||
|
||||
"rack.multithread" => false,
|
||||
"rack.multiprocess" => true,
|
||||
"rack.run_once" => true,
|
||||
|
||||
"rack.url_scheme" => ["yes", "on", "1"].include?(ENV["HTTPS"]) ? "https" : "http"
|
||||
})
|
||||
|
||||
env["QUERY_STRING"] ||= ""
|
||||
env["HTTP_VERSION"] ||= env["SERVER_PROTOCOL"]
|
||||
env["REQUEST_PATH"] ||= "/"
|
||||
|
||||
status, headers, body = app.call(env)
|
||||
begin
|
||||
send_headers status, headers
|
||||
send_body body
|
||||
ensure
|
||||
body.close if body.respond_to? :close
|
||||
end
|
||||
end
|
||||
|
||||
def self.send_headers(status, headers)
|
||||
STDOUT.print "Status: #{status}\r\n"
|
||||
headers.each { |k, vs|
|
||||
vs.split("\n").each { |v|
|
||||
STDOUT.print "#{k}: #{v}\r\n"
|
||||
}
|
||||
}
|
||||
STDOUT.print "\r\n"
|
||||
STDOUT.flush
|
||||
end
|
||||
|
||||
def self.send_body(body)
|
||||
body.each { |part|
|
||||
STDOUT.print part
|
||||
STDOUT.flush
|
||||
}
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,8 @@
|
|||
require 'swiftcore/evented_mongrel'
|
||||
|
||||
module Rack
|
||||
module Handler
|
||||
class EventedMongrel < Handler::Mongrel
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,90 @@
|
|||
require 'fcgi'
|
||||
require 'socket'
|
||||
require 'rack/content_length'
|
||||
require 'rack/rewindable_input'
|
||||
|
||||
if defined? FCGI::Stream
|
||||
class FCGI::Stream
|
||||
alias _rack_read_without_buffer read
|
||||
|
||||
def read(n, buffer=nil)
|
||||
buf = _rack_read_without_buffer n
|
||||
buffer.replace(buf.to_s) if buffer
|
||||
buf
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
module Rack
|
||||
module Handler
|
||||
class FastCGI
|
||||
def self.run(app, options={})
|
||||
file = options[:File] and STDIN.reopen(UNIXServer.new(file))
|
||||
port = options[:Port] and STDIN.reopen(TCPServer.new(port))
|
||||
FCGI.each { |request|
|
||||
serve request, app
|
||||
}
|
||||
end
|
||||
|
||||
def self.serve(request, app)
|
||||
app = Rack::ContentLength.new(app)
|
||||
|
||||
env = request.env
|
||||
env.delete "HTTP_CONTENT_LENGTH"
|
||||
|
||||
env["SCRIPT_NAME"] = "" if env["SCRIPT_NAME"] == "/"
|
||||
|
||||
rack_input = RewindableInput.new(request.in)
|
||||
|
||||
env.update({"rack.version" => [1,0],
|
||||
"rack.input" => rack_input,
|
||||
"rack.errors" => request.err,
|
||||
|
||||
"rack.multithread" => false,
|
||||
"rack.multiprocess" => true,
|
||||
"rack.run_once" => false,
|
||||
|
||||
"rack.url_scheme" => ["yes", "on", "1"].include?(env["HTTPS"]) ? "https" : "http"
|
||||
})
|
||||
|
||||
env["QUERY_STRING"] ||= ""
|
||||
env["HTTP_VERSION"] ||= env["SERVER_PROTOCOL"]
|
||||
env["REQUEST_PATH"] ||= "/"
|
||||
env.delete "PATH_INFO" if env["PATH_INFO"] == ""
|
||||
env.delete "CONTENT_TYPE" if env["CONTENT_TYPE"] == ""
|
||||
env.delete "CONTENT_LENGTH" if env["CONTENT_LENGTH"] == ""
|
||||
|
||||
begin
|
||||
status, headers, body = app.call(env)
|
||||
begin
|
||||
send_headers request.out, status, headers
|
||||
send_body request.out, body
|
||||
ensure
|
||||
body.close if body.respond_to? :close
|
||||
end
|
||||
ensure
|
||||
rack_input.close
|
||||
request.finish
|
||||
end
|
||||
end
|
||||
|
||||
def self.send_headers(out, status, headers)
|
||||
out.print "Status: #{status}\r\n"
|
||||
headers.each { |k, vs|
|
||||
vs.split("\n").each { |v|
|
||||
out.print "#{k}: #{v}\r\n"
|
||||
}
|
||||
}
|
||||
out.print "\r\n"
|
||||
out.flush
|
||||
end
|
||||
|
||||
def self.send_body(out, body)
|
||||
body.each { |part|
|
||||
out.print part
|
||||
out.flush
|
||||
}
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,60 @@
|
|||
require 'lsapi'
|
||||
require 'rack/content_length'
|
||||
|
||||
module Rack
|
||||
module Handler
|
||||
class LSWS
|
||||
def self.run(app, options=nil)
|
||||
while LSAPI.accept != nil
|
||||
serve app
|
||||
end
|
||||
end
|
||||
def self.serve(app)
|
||||
app = Rack::ContentLength.new(app)
|
||||
|
||||
env = ENV.to_hash
|
||||
env.delete "HTTP_CONTENT_LENGTH"
|
||||
env["SCRIPT_NAME"] = "" if env["SCRIPT_NAME"] == "/"
|
||||
|
||||
rack_input = RewindableInput.new($stdin.read.to_s)
|
||||
|
||||
env.update(
|
||||
"rack.version" => [1,0],
|
||||
"rack.input" => rack_input,
|
||||
"rack.errors" => $stderr,
|
||||
"rack.multithread" => false,
|
||||
"rack.multiprocess" => true,
|
||||
"rack.run_once" => false,
|
||||
"rack.url_scheme" => ["yes", "on", "1"].include?(ENV["HTTPS"]) ? "https" : "http"
|
||||
)
|
||||
|
||||
env["QUERY_STRING"] ||= ""
|
||||
env["HTTP_VERSION"] ||= env["SERVER_PROTOCOL"]
|
||||
env["REQUEST_PATH"] ||= "/"
|
||||
status, headers, body = app.call(env)
|
||||
begin
|
||||
send_headers status, headers
|
||||
send_body body
|
||||
ensure
|
||||
body.close if body.respond_to? :close
|
||||
end
|
||||
end
|
||||
def self.send_headers(status, headers)
|
||||
print "Status: #{status}\r\n"
|
||||
headers.each { |k, vs|
|
||||
vs.split("\n").each { |v|
|
||||
print "#{k}: #{v}\r\n"
|
||||
}
|
||||
}
|
||||
print "\r\n"
|
||||
STDOUT.flush
|
||||
end
|
||||
def self.send_body(body)
|
||||
body.each { |part|
|
||||
print part
|
||||
STDOUT.flush
|
||||
}
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,87 @@
|
|||
require 'mongrel'
|
||||
require 'stringio'
|
||||
require 'rack/content_length'
|
||||
require 'rack/chunked'
|
||||
|
||||
module Rack
|
||||
module Handler
|
||||
class Mongrel < ::Mongrel::HttpHandler
|
||||
def self.run(app, options={})
|
||||
server = ::Mongrel::HttpServer.new(options[:Host] || '0.0.0.0',
|
||||
options[:Port] || 8080)
|
||||
# Acts like Rack::URLMap, utilizing Mongrel's own path finding methods.
|
||||
# Use is similar to #run, replacing the app argument with a hash of
|
||||
# { path=>app, ... } or an instance of Rack::URLMap.
|
||||
if options[:map]
|
||||
if app.is_a? Hash
|
||||
app.each do |path, appl|
|
||||
path = '/'+path unless path[0] == ?/
|
||||
server.register(path, Rack::Handler::Mongrel.new(appl))
|
||||
end
|
||||
elsif app.is_a? URLMap
|
||||
app.instance_variable_get(:@mapping).each do |(host, path, appl)|
|
||||
next if !host.nil? && !options[:Host].nil? && options[:Host] != host
|
||||
path = '/'+path unless path[0] == ?/
|
||||
server.register(path, Rack::Handler::Mongrel.new(appl))
|
||||
end
|
||||
else
|
||||
raise ArgumentError, "first argument should be a Hash or URLMap"
|
||||
end
|
||||
else
|
||||
server.register('/', Rack::Handler::Mongrel.new(app))
|
||||
end
|
||||
yield server if block_given?
|
||||
server.run.join
|
||||
end
|
||||
|
||||
def initialize(app)
|
||||
@app = Rack::Chunked.new(Rack::ContentLength.new(app))
|
||||
end
|
||||
|
||||
def process(request, response)
|
||||
env = {}.replace(request.params)
|
||||
env.delete "HTTP_CONTENT_TYPE"
|
||||
env.delete "HTTP_CONTENT_LENGTH"
|
||||
|
||||
env["SCRIPT_NAME"] = "" if env["SCRIPT_NAME"] == "/"
|
||||
|
||||
rack_input = request.body || StringIO.new('')
|
||||
rack_input.set_encoding(Encoding::BINARY) if rack_input.respond_to?(:set_encoding)
|
||||
|
||||
env.update({"rack.version" => [1,0],
|
||||
"rack.input" => rack_input,
|
||||
"rack.errors" => $stderr,
|
||||
|
||||
"rack.multithread" => true,
|
||||
"rack.multiprocess" => false, # ???
|
||||
"rack.run_once" => false,
|
||||
|
||||
"rack.url_scheme" => "http",
|
||||
})
|
||||
env["QUERY_STRING"] ||= ""
|
||||
env.delete "PATH_INFO" if env["PATH_INFO"] == ""
|
||||
|
||||
status, headers, body = @app.call(env)
|
||||
|
||||
begin
|
||||
response.status = status.to_i
|
||||
response.send_status(nil)
|
||||
|
||||
headers.each { |k, vs|
|
||||
vs.split("\n").each { |v|
|
||||
response.header[k] = v
|
||||
}
|
||||
}
|
||||
response.send_header
|
||||
|
||||
body.each { |part|
|
||||
response.write part
|
||||
response.socket.flush
|
||||
}
|
||||
ensure
|
||||
body.close if body.respond_to? :close
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,62 @@
|
|||
require 'scgi'
|
||||
require 'stringio'
|
||||
require 'rack/content_length'
|
||||
require 'rack/chunked'
|
||||
|
||||
module Rack
|
||||
module Handler
|
||||
class SCGI < ::SCGI::Processor
|
||||
attr_accessor :app
|
||||
|
||||
def self.run(app, options=nil)
|
||||
new(options.merge(:app=>app,
|
||||
:host=>options[:Host],
|
||||
:port=>options[:Port],
|
||||
:socket=>options[:Socket])).listen
|
||||
end
|
||||
|
||||
def initialize(settings = {})
|
||||
@app = Rack::Chunked.new(Rack::ContentLength.new(settings[:app]))
|
||||
@log = Object.new
|
||||
def @log.info(*args); end
|
||||
def @log.error(*args); end
|
||||
super(settings)
|
||||
end
|
||||
|
||||
def process_request(request, input_body, socket)
|
||||
env = {}.replace(request)
|
||||
env.delete "HTTP_CONTENT_TYPE"
|
||||
env.delete "HTTP_CONTENT_LENGTH"
|
||||
env["REQUEST_PATH"], env["QUERY_STRING"] = env["REQUEST_URI"].split('?', 2)
|
||||
env["HTTP_VERSION"] ||= env["SERVER_PROTOCOL"]
|
||||
env["PATH_INFO"] = env["REQUEST_PATH"]
|
||||
env["QUERY_STRING"] ||= ""
|
||||
env["SCRIPT_NAME"] = ""
|
||||
|
||||
rack_input = StringIO.new(input_body)
|
||||
rack_input.set_encoding(Encoding::BINARY) if rack_input.respond_to?(:set_encoding)
|
||||
|
||||
env.update({"rack.version" => [1,0],
|
||||
"rack.input" => rack_input,
|
||||
"rack.errors" => $stderr,
|
||||
"rack.multithread" => true,
|
||||
"rack.multiprocess" => true,
|
||||
"rack.run_once" => false,
|
||||
|
||||
"rack.url_scheme" => ["yes", "on", "1"].include?(env["HTTPS"]) ? "https" : "http"
|
||||
})
|
||||
status, headers, body = app.call(env)
|
||||
begin
|
||||
socket.write("Status: #{status}\r\n")
|
||||
headers.each do |k, vs|
|
||||
vs.split("\n").each { |v| socket.write("#{k}: #{v}\r\n")}
|
||||
end
|
||||
socket.write("\r\n")
|
||||
body.each {|s| socket.write(s)}
|
||||
ensure
|
||||
body.close if body.respond_to? :close
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,8 @@
|
|||
require 'swiftcore/swiftiplied_mongrel'
|
||||
|
||||
module Rack
|
||||
module Handler
|
||||
class SwiftipliedMongrel < Handler::Mongrel
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,18 @@
|
|||
require "thin"
|
||||
require "rack/content_length"
|
||||
require "rack/chunked"
|
||||
|
||||
module Rack
|
||||
module Handler
|
||||
class Thin
|
||||
def self.run(app, options={})
|
||||
app = Rack::Chunked.new(Rack::ContentLength.new(app))
|
||||
server = ::Thin::Server.new(options[:Host] || '0.0.0.0',
|
||||
options[:Port] || 8080,
|
||||
app)
|
||||
yield server if block_given?
|
||||
server.start
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,71 @@
|
|||
require 'webrick'
|
||||
require 'stringio'
|
||||
require 'rack/content_length'
|
||||
|
||||
module Rack
|
||||
module Handler
|
||||
class WEBrick < ::WEBrick::HTTPServlet::AbstractServlet
|
||||
def self.run(app, options={})
|
||||
options[:BindAddress] = options.delete(:Host) if options[:Host]
|
||||
server = ::WEBrick::HTTPServer.new(options)
|
||||
server.mount "/", Rack::Handler::WEBrick, app
|
||||
trap(:INT) { server.shutdown }
|
||||
yield server if block_given?
|
||||
server.start
|
||||
end
|
||||
|
||||
def initialize(server, app)
|
||||
super server
|
||||
@app = Rack::ContentLength.new(app)
|
||||
end
|
||||
|
||||
def service(req, res)
|
||||
env = req.meta_vars
|
||||
env.delete_if { |k, v| v.nil? }
|
||||
|
||||
rack_input = StringIO.new(req.body.to_s)
|
||||
rack_input.set_encoding(Encoding::BINARY) if rack_input.respond_to?(:set_encoding)
|
||||
|
||||
env.update({"rack.version" => [1,0],
|
||||
"rack.input" => rack_input,
|
||||
"rack.errors" => $stderr,
|
||||
|
||||
"rack.multithread" => true,
|
||||
"rack.multiprocess" => false,
|
||||
"rack.run_once" => false,
|
||||
|
||||
"rack.url_scheme" => ["yes", "on", "1"].include?(ENV["HTTPS"]) ? "https" : "http"
|
||||
})
|
||||
|
||||
env["HTTP_VERSION"] ||= env["SERVER_PROTOCOL"]
|
||||
env["QUERY_STRING"] ||= ""
|
||||
env["REQUEST_PATH"] ||= "/"
|
||||
if env["PATH_INFO"] == ""
|
||||
env.delete "PATH_INFO"
|
||||
else
|
||||
path, n = req.request_uri.path, env["SCRIPT_NAME"].length
|
||||
env["PATH_INFO"] = path[n, path.length-n]
|
||||
end
|
||||
|
||||
status, headers, body = @app.call(env)
|
||||
begin
|
||||
res.status = status.to_i
|
||||
headers.each { |k, vs|
|
||||
if k.downcase == "set-cookie"
|
||||
res.cookies.concat vs.split("\n")
|
||||
else
|
||||
vs.split("\n").each { |v|
|
||||
res[k] = v
|
||||
}
|
||||
end
|
||||
}
|
||||
body.each { |part|
|
||||
res.body << part
|
||||
}
|
||||
ensure
|
||||
body.close if body.respond_to? :close
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,19 @@
|
|||
module Rack
|
||||
|
||||
class Head
|
||||
def initialize(app)
|
||||
@app = app
|
||||
end
|
||||
|
||||
def call(env)
|
||||
status, headers, body = @app.call(env)
|
||||
|
||||
if env["REQUEST_METHOD"] == "HEAD"
|
||||
[status, headers, []]
|
||||
else
|
||||
[status, headers, body]
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
end
|
|
@ -0,0 +1,546 @@
|
|||
require 'rack/utils'
|
||||
|
||||
module Rack
|
||||
# Rack::Lint validates your application and the requests and
|
||||
# responses according to the Rack spec.
|
||||
|
||||
class Lint
|
||||
def initialize(app)
|
||||
@app = app
|
||||
end
|
||||
|
||||
# :stopdoc:
|
||||
|
||||
class LintError < RuntimeError; end
|
||||
module Assertion
|
||||
def assert(message, &block)
|
||||
unless block.call
|
||||
raise LintError, message
|
||||
end
|
||||
end
|
||||
end
|
||||
include Assertion
|
||||
|
||||
## This specification aims to formalize the Rack protocol. You
|
||||
## can (and should) use Rack::Lint to enforce it.
|
||||
##
|
||||
## When you develop middleware, be sure to add a Lint before and
|
||||
## after to catch all mistakes.
|
||||
|
||||
## = Rack applications
|
||||
|
||||
## A Rack application is an Ruby object (not a class) that
|
||||
## responds to +call+.
|
||||
def call(env=nil)
|
||||
dup._call(env)
|
||||
end
|
||||
|
||||
def _call(env)
|
||||
## It takes exactly one argument, the *environment*
|
||||
assert("No env given") { env }
|
||||
check_env env
|
||||
|
||||
env['rack.input'] = InputWrapper.new(env['rack.input'])
|
||||
env['rack.errors'] = ErrorWrapper.new(env['rack.errors'])
|
||||
|
||||
## and returns an Array of exactly three values:
|
||||
status, headers, @body = @app.call(env)
|
||||
## The *status*,
|
||||
check_status status
|
||||
## the *headers*,
|
||||
check_headers headers
|
||||
## and the *body*.
|
||||
check_content_type status, headers
|
||||
check_content_length status, headers, env
|
||||
[status, headers, self]
|
||||
end
|
||||
|
||||
## == The Environment
|
||||
def check_env(env)
|
||||
## The environment must be an true instance of Hash (no
|
||||
## subclassing allowed) that includes CGI-like headers.
|
||||
## The application is free to modify the environment.
|
||||
assert("env #{env.inspect} is not a Hash, but #{env.class}") {
|
||||
env.instance_of? Hash
|
||||
}
|
||||
|
||||
##
|
||||
## The environment is required to include these variables
|
||||
## (adopted from PEP333), except when they'd be empty, but see
|
||||
## below.
|
||||
|
||||
## <tt>REQUEST_METHOD</tt>:: The HTTP request method, such as
|
||||
## "GET" or "POST". This cannot ever
|
||||
## be an empty string, and so is
|
||||
## always required.
|
||||
|
||||
## <tt>SCRIPT_NAME</tt>:: The initial portion of the request
|
||||
## URL's "path" that corresponds to the
|
||||
## application object, so that the
|
||||
## application knows its virtual
|
||||
## "location". This may be an empty
|
||||
## string, if the application corresponds
|
||||
## to the "root" of the server.
|
||||
|
||||
## <tt>PATH_INFO</tt>:: The remainder of the request URL's
|
||||
## "path", designating the virtual
|
||||
## "location" of the request's target
|
||||
## within the application. This may be an
|
||||
## empty string, if the request URL targets
|
||||
## the application root and does not have a
|
||||
## trailing slash. This value may be
|
||||
## percent-encoded when I originating from
|
||||
## a URL.
|
||||
|
||||
## <tt>QUERY_STRING</tt>:: The portion of the request URL that
|
||||
## follows the <tt>?</tt>, if any. May be
|
||||
## empty, but is always required!
|
||||
|
||||
## <tt>SERVER_NAME</tt>, <tt>SERVER_PORT</tt>:: When combined with <tt>SCRIPT_NAME</tt> and <tt>PATH_INFO</tt>, these variables can be used to complete the URL. Note, however, that <tt>HTTP_HOST</tt>, if present, should be used in preference to <tt>SERVER_NAME</tt> for reconstructing the request URL. <tt>SERVER_NAME</tt> and <tt>SERVER_PORT</tt> can never be empty strings, and so are always required.
|
||||
|
||||
## <tt>HTTP_</tt> Variables:: Variables corresponding to the
|
||||
## client-supplied HTTP request
|
||||
## headers (i.e., variables whose
|
||||
## names begin with <tt>HTTP_</tt>). The
|
||||
## presence or absence of these
|
||||
## variables should correspond with
|
||||
## the presence or absence of the
|
||||
## appropriate HTTP header in the
|
||||
## request.
|
||||
|
||||
## In addition to this, the Rack environment must include these
|
||||
## Rack-specific variables:
|
||||
|
||||
## <tt>rack.version</tt>:: The Array [1,0], representing this version of Rack.
|
||||
## <tt>rack.url_scheme</tt>:: +http+ or +https+, depending on the request URL.
|
||||
## <tt>rack.input</tt>:: See below, the input stream.
|
||||
## <tt>rack.errors</tt>:: See below, the error stream.
|
||||
## <tt>rack.multithread</tt>:: true if the application object may be simultaneously invoked by another thread in the same process, false otherwise.
|
||||
## <tt>rack.multiprocess</tt>:: true if an equivalent application object may be simultaneously invoked by another process, false otherwise.
|
||||
## <tt>rack.run_once</tt>:: true if the server expects (but does not guarantee!) that the application will only be invoked this one time during the life of its containing process. Normally, this will only be true for a server based on CGI (or something similar).
|
||||
##
|
||||
|
||||
## Additional environment specifications have approved to
|
||||
## standardized middleware APIs. None of these are required to
|
||||
## be implemented by the server.
|
||||
|
||||
## <tt>rack.session</tt>:: A hash like interface for storing request session data.
|
||||
## The store must implement:
|
||||
if session = env['rack.session']
|
||||
## store(key, value) (aliased as []=);
|
||||
assert("session #{session.inspect} must respond to store and []=") {
|
||||
session.respond_to?(:store) && session.respond_to?(:[]=)
|
||||
}
|
||||
|
||||
## fetch(key, default = nil) (aliased as []);
|
||||
assert("session #{session.inspect} must respond to fetch and []") {
|
||||
session.respond_to?(:fetch) && session.respond_to?(:[])
|
||||
}
|
||||
|
||||
## delete(key);
|
||||
assert("session #{session.inspect} must respond to delete") {
|
||||
session.respond_to?(:delete)
|
||||
}
|
||||
|
||||
## clear;
|
||||
assert("session #{session.inspect} must respond to clear") {
|
||||
session.respond_to?(:clear)
|
||||
}
|
||||
end
|
||||
|
||||
## The server or the application can store their own data in the
|
||||
## environment, too. The keys must contain at least one dot,
|
||||
## and should be prefixed uniquely. The prefix <tt>rack.</tt>
|
||||
## is reserved for use with the Rack core distribution and other
|
||||
## accepted specifications and must not be used otherwise.
|
||||
##
|
||||
|
||||
%w[REQUEST_METHOD SERVER_NAME SERVER_PORT
|
||||
QUERY_STRING
|
||||
rack.version rack.input rack.errors
|
||||
rack.multithread rack.multiprocess rack.run_once].each { |header|
|
||||
assert("env missing required key #{header}") { env.include? header }
|
||||
}
|
||||
|
||||
## The environment must not contain the keys
|
||||
## <tt>HTTP_CONTENT_TYPE</tt> or <tt>HTTP_CONTENT_LENGTH</tt>
|
||||
## (use the versions without <tt>HTTP_</tt>).
|
||||
%w[HTTP_CONTENT_TYPE HTTP_CONTENT_LENGTH].each { |header|
|
||||
assert("env contains #{header}, must use #{header[5,-1]}") {
|
||||
not env.include? header
|
||||
}
|
||||
}
|
||||
|
||||
## The CGI keys (named without a period) must have String values.
|
||||
env.each { |key, value|
|
||||
next if key.include? "." # Skip extensions
|
||||
assert("env variable #{key} has non-string value #{value.inspect}") {
|
||||
value.instance_of? String
|
||||
}
|
||||
}
|
||||
|
||||
##
|
||||
## There are the following restrictions:
|
||||
|
||||
## * <tt>rack.version</tt> must be an array of Integers.
|
||||
assert("rack.version must be an Array, was #{env["rack.version"].class}") {
|
||||
env["rack.version"].instance_of? Array
|
||||
}
|
||||
## * <tt>rack.url_scheme</tt> must either be +http+ or +https+.
|
||||
assert("rack.url_scheme unknown: #{env["rack.url_scheme"].inspect}") {
|
||||
%w[http https].include? env["rack.url_scheme"]
|
||||
}
|
||||
|
||||
## * There must be a valid input stream in <tt>rack.input</tt>.
|
||||
check_input env["rack.input"]
|
||||
## * There must be a valid error stream in <tt>rack.errors</tt>.
|
||||
check_error env["rack.errors"]
|
||||
|
||||
## * The <tt>REQUEST_METHOD</tt> must be a valid token.
|
||||
assert("REQUEST_METHOD unknown: #{env["REQUEST_METHOD"]}") {
|
||||
env["REQUEST_METHOD"] =~ /\A[0-9A-Za-z!\#$%&'*+.^_`|~-]+\z/
|
||||
}
|
||||
|
||||
## * The <tt>SCRIPT_NAME</tt>, if non-empty, must start with <tt>/</tt>
|
||||
assert("SCRIPT_NAME must start with /") {
|
||||
!env.include?("SCRIPT_NAME") ||
|
||||
env["SCRIPT_NAME"] == "" ||
|
||||
env["SCRIPT_NAME"] =~ /\A\//
|
||||
}
|
||||
## * The <tt>PATH_INFO</tt>, if non-empty, must start with <tt>/</tt>
|
||||
assert("PATH_INFO must start with /") {
|
||||
!env.include?("PATH_INFO") ||
|
||||
env["PATH_INFO"] == "" ||
|
||||
env["PATH_INFO"] =~ /\A\//
|
||||
}
|
||||
## * The <tt>CONTENT_LENGTH</tt>, if given, must consist of digits only.
|
||||
assert("Invalid CONTENT_LENGTH: #{env["CONTENT_LENGTH"]}") {
|
||||
!env.include?("CONTENT_LENGTH") || env["CONTENT_LENGTH"] =~ /\A\d+\z/
|
||||
}
|
||||
|
||||
## * One of <tt>SCRIPT_NAME</tt> or <tt>PATH_INFO</tt> must be
|
||||
## set. <tt>PATH_INFO</tt> should be <tt>/</tt> if
|
||||
## <tt>SCRIPT_NAME</tt> is empty.
|
||||
assert("One of SCRIPT_NAME or PATH_INFO must be set (make PATH_INFO '/' if SCRIPT_NAME is empty)") {
|
||||
env["SCRIPT_NAME"] || env["PATH_INFO"]
|
||||
}
|
||||
## <tt>SCRIPT_NAME</tt> never should be <tt>/</tt>, but instead be empty.
|
||||
assert("SCRIPT_NAME cannot be '/', make it '' and PATH_INFO '/'") {
|
||||
env["SCRIPT_NAME"] != "/"
|
||||
}
|
||||
end
|
||||
|
||||
## === The Input Stream
|
||||
##
|
||||
## The input stream is an IO-like object which contains the raw HTTP
|
||||
## POST data.
|
||||
def check_input(input)
|
||||
## When applicable, its external encoding must be "ASCII-8BIT" and it
|
||||
## must be opened in binary mode, for Ruby 1.9 compatibility.
|
||||
assert("rack.input #{input} does not have ASCII-8BIT as its external encoding") {
|
||||
input.external_encoding.name == "ASCII-8BIT"
|
||||
} if input.respond_to?(:external_encoding)
|
||||
assert("rack.input #{input} is not opened in binary mode") {
|
||||
input.binmode?
|
||||
} if input.respond_to?(:binmode?)
|
||||
|
||||
## The input stream must respond to +gets+, +each+, +read+ and +rewind+.
|
||||
[:gets, :each, :read, :rewind].each { |method|
|
||||
assert("rack.input #{input} does not respond to ##{method}") {
|
||||
input.respond_to? method
|
||||
}
|
||||
}
|
||||
end
|
||||
|
||||
class InputWrapper
|
||||
include Assertion
|
||||
|
||||
def initialize(input)
|
||||
@input = input
|
||||
end
|
||||
|
||||
def size
|
||||
@input.size
|
||||
end
|
||||
|
||||
## * +gets+ must be called without arguments and return a string,
|
||||
## or +nil+ on EOF.
|
||||
def gets(*args)
|
||||
assert("rack.input#gets called with arguments") { args.size == 0 }
|
||||
v = @input.gets
|
||||
assert("rack.input#gets didn't return a String") {
|
||||
v.nil? or v.instance_of? String
|
||||
}
|
||||
v
|
||||
end
|
||||
|
||||
## * +read+ behaves like IO#read. Its signature is <tt>read([length, [buffer]])</tt>.
|
||||
## If given, +length+ must be an non-negative Integer (>= 0) or +nil+, and +buffer+ must
|
||||
## be a String and may not be nil. If +length+ is given and not nil, then this method
|
||||
## reads at most +length+ bytes from the input stream. If +length+ is not given or nil,
|
||||
## then this method reads all data until EOF.
|
||||
## When EOF is reached, this method returns nil if +length+ is given and not nil, or ""
|
||||
## if +length+ is not given or is nil.
|
||||
## If +buffer+ is given, then the read data will be placed into +buffer+ instead of a
|
||||
## newly created String object.
|
||||
def read(*args)
|
||||
assert("rack.input#read called with too many arguments") {
|
||||
args.size <= 2
|
||||
}
|
||||
if args.size >= 1
|
||||
assert("rack.input#read called with non-integer and non-nil length") {
|
||||
args.first.kind_of?(Integer) || args.first.nil?
|
||||
}
|
||||
assert("rack.input#read called with a negative length") {
|
||||
args.first.nil? || args.first >= 0
|
||||
}
|
||||
end
|
||||
if args.size >= 2
|
||||
assert("rack.input#read called with non-String buffer") {
|
||||
args[1].kind_of?(String)
|
||||
}
|
||||
end
|
||||
|
||||
v = @input.read(*args)
|
||||
|
||||
assert("rack.input#read didn't return nil or a String") {
|
||||
v.nil? or v.instance_of? String
|
||||
}
|
||||
if args[0].nil?
|
||||
assert("rack.input#read(nil) returned nil on EOF") {
|
||||
!v.nil?
|
||||
}
|
||||
end
|
||||
|
||||
v
|
||||
end
|
||||
|
||||
## * +each+ must be called without arguments and only yield Strings.
|
||||
def each(*args)
|
||||
assert("rack.input#each called with arguments") { args.size == 0 }
|
||||
@input.each { |line|
|
||||
assert("rack.input#each didn't yield a String") {
|
||||
line.instance_of? String
|
||||
}
|
||||
yield line
|
||||
}
|
||||
end
|
||||
|
||||
## * +rewind+ must be called without arguments. It rewinds the input
|
||||
## stream back to the beginning. It must not raise Errno::ESPIPE:
|
||||
## that is, it may not be a pipe or a socket. Therefore, handler
|
||||
## developers must buffer the input data into some rewindable object
|
||||
## if the underlying input stream is not rewindable.
|
||||
def rewind(*args)
|
||||
assert("rack.input#rewind called with arguments") { args.size == 0 }
|
||||
assert("rack.input#rewind raised Errno::ESPIPE") {
|
||||
begin
|
||||
@input.rewind
|
||||
true
|
||||
rescue Errno::ESPIPE
|
||||
false
|
||||
end
|
||||
}
|
||||
end
|
||||
|
||||
## * +close+ must never be called on the input stream.
|
||||
def close(*args)
|
||||
assert("rack.input#close must not be called") { false }
|
||||
end
|
||||
end
|
||||
|
||||
## === The Error Stream
|
||||
def check_error(error)
|
||||
## The error stream must respond to +puts+, +write+ and +flush+.
|
||||
[:puts, :write, :flush].each { |method|
|
||||
assert("rack.error #{error} does not respond to ##{method}") {
|
||||
error.respond_to? method
|
||||
}
|
||||
}
|
||||
end
|
||||
|
||||
class ErrorWrapper
|
||||
include Assertion
|
||||
|
||||
def initialize(error)
|
||||
@error = error
|
||||
end
|
||||
|
||||
## * +puts+ must be called with a single argument that responds to +to_s+.
|
||||
def puts(str)
|
||||
@error.puts str
|
||||
end
|
||||
|
||||
## * +write+ must be called with a single argument that is a String.
|
||||
def write(str)
|
||||
assert("rack.errors#write not called with a String") { str.instance_of? String }
|
||||
@error.write str
|
||||
end
|
||||
|
||||
## * +flush+ must be called without arguments and must be called
|
||||
## in order to make the error appear for sure.
|
||||
def flush
|
||||
@error.flush
|
||||
end
|
||||
|
||||
## * +close+ must never be called on the error stream.
|
||||
def close(*args)
|
||||
assert("rack.errors#close must not be called") { false }
|
||||
end
|
||||
end
|
||||
|
||||
## == The Response
|
||||
|
||||
## === The Status
|
||||
def check_status(status)
|
||||
## This is an HTTP status. When parsed as integer (+to_i+), it must be
|
||||
## greater than or equal to 100.
|
||||
assert("Status must be >=100 seen as integer") { status.to_i >= 100 }
|
||||
end
|
||||
|
||||
## === The Headers
|
||||
def check_headers(header)
|
||||
## The header must respond to +each+, and yield values of key and value.
|
||||
assert("headers object should respond to #each, but doesn't (got #{header.class} as headers)") {
|
||||
header.respond_to? :each
|
||||
}
|
||||
header.each { |key, value|
|
||||
## The header keys must be Strings.
|
||||
assert("header key must be a string, was #{key.class}") {
|
||||
key.instance_of? String
|
||||
}
|
||||
## The header must not contain a +Status+ key,
|
||||
assert("header must not contain Status") { key.downcase != "status" }
|
||||
## contain keys with <tt>:</tt> or newlines in their name,
|
||||
assert("header names must not contain : or \\n") { key !~ /[:\n]/ }
|
||||
## contain keys names that end in <tt>-</tt> or <tt>_</tt>,
|
||||
assert("header names must not end in - or _") { key !~ /[-_]\z/ }
|
||||
## but only contain keys that consist of
|
||||
## letters, digits, <tt>_</tt> or <tt>-</tt> and start with a letter.
|
||||
assert("invalid header name: #{key}") { key =~ /\A[a-zA-Z][a-zA-Z0-9_-]*\z/ }
|
||||
|
||||
## The values of the header must be Strings,
|
||||
assert("a header value must be a String, but the value of " +
|
||||
"'#{key}' is a #{value.class}") { value.kind_of? String }
|
||||
## consisting of lines (for multiple header values, e.g. multiple
|
||||
## <tt>Set-Cookie</tt> values) seperated by "\n".
|
||||
value.split("\n").each { |item|
|
||||
## The lines must not contain characters below 037.
|
||||
assert("invalid header value #{key}: #{item.inspect}") {
|
||||
item !~ /[\000-\037]/
|
||||
}
|
||||
}
|
||||
}
|
||||
end
|
||||
|
||||
## === The Content-Type
|
||||
def check_content_type(status, headers)
|
||||
headers.each { |key, value|
|
||||
## There must be a <tt>Content-Type</tt>, except when the
|
||||
## +Status+ is 1xx, 204 or 304, in which case there must be none
|
||||
## given.
|
||||
if key.downcase == "content-type"
|
||||
assert("Content-Type header found in #{status} response, not allowed") {
|
||||
not Rack::Utils::STATUS_WITH_NO_ENTITY_BODY.include? status.to_i
|
||||
}
|
||||
return
|
||||
end
|
||||
}
|
||||
assert("No Content-Type header found") {
|
||||
Rack::Utils::STATUS_WITH_NO_ENTITY_BODY.include? status.to_i
|
||||
}
|
||||
end
|
||||
|
||||
## === The Content-Length
|
||||
def check_content_length(status, headers, env)
|
||||
headers.each { |key, value|
|
||||
if key.downcase == 'content-length'
|
||||
## There must not be a <tt>Content-Length</tt> header when the
|
||||
## +Status+ is 1xx, 204 or 304.
|
||||
assert("Content-Length header found in #{status} response, not allowed") {
|
||||
not Rack::Utils::STATUS_WITH_NO_ENTITY_BODY.include? status.to_i
|
||||
}
|
||||
|
||||
bytes = 0
|
||||
string_body = true
|
||||
|
||||
if @body.respond_to?(:to_ary)
|
||||
@body.each { |part|
|
||||
unless part.kind_of?(String)
|
||||
string_body = false
|
||||
break
|
||||
end
|
||||
|
||||
bytes += Rack::Utils.bytesize(part)
|
||||
}
|
||||
|
||||
if env["REQUEST_METHOD"] == "HEAD"
|
||||
assert("Response body was given for HEAD request, but should be empty") {
|
||||
bytes == 0
|
||||
}
|
||||
else
|
||||
if string_body
|
||||
assert("Content-Length header was #{value}, but should be #{bytes}") {
|
||||
value == bytes.to_s
|
||||
}
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
return
|
||||
end
|
||||
}
|
||||
end
|
||||
|
||||
## === The Body
|
||||
def each
|
||||
@closed = false
|
||||
## The Body must respond to +each+
|
||||
@body.each { |part|
|
||||
## and must only yield String values.
|
||||
assert("Body yielded non-string value #{part.inspect}") {
|
||||
part.instance_of? String
|
||||
}
|
||||
yield part
|
||||
}
|
||||
##
|
||||
## The Body itself should not be an instance of String, as this will
|
||||
## break in Ruby 1.9.
|
||||
##
|
||||
## If the Body responds to +close+, it will be called after iteration.
|
||||
# XXX howto: assert("Body has not been closed") { @closed }
|
||||
|
||||
|
||||
##
|
||||
## If the Body responds to +to_path+, it must return a String
|
||||
## identifying the location of a file whose contents are identical
|
||||
## to that produced by calling +each+; this may be used by the
|
||||
## server as an alternative, possibly more efficient way to
|
||||
## transport the response.
|
||||
|
||||
if @body.respond_to?(:to_path)
|
||||
assert("The file identified by body.to_path does not exist") {
|
||||
::File.exist? @body.to_path
|
||||
}
|
||||
end
|
||||
|
||||
##
|
||||
## The Body commonly is an Array of Strings, the application
|
||||
## instance itself, or a File-like object.
|
||||
end
|
||||
|
||||
def close
|
||||
@closed = true
|
||||
@body.close if @body.respond_to?(:close)
|
||||
end
|
||||
|
||||
# :startdoc:
|
||||
|
||||
end
|
||||
end
|
||||
|
||||
## == Thanks
|
||||
## Some parts of this specification are adopted from PEP333: Python
|
||||
## Web Server Gateway Interface
|
||||
## v1.0 (http://www.python.org/dev/peps/pep-0333/). I'd like to thank
|
||||
## everyone involved in that effort.
|
|
@ -0,0 +1,65 @@
|
|||
require 'zlib'
|
||||
|
||||
require 'rack/request'
|
||||
require 'rack/response'
|
||||
|
||||
module Rack
|
||||
# Paste has a Pony, Rack has a Lobster!
|
||||
class Lobster
|
||||
LobsterString = Zlib::Inflate.inflate("eJx9kEEOwyAMBO99xd7MAcytUhPlJyj2
|
||||
P6jy9i4k9EQyGAnBarEXeCBqSkntNXsi/ZCvC48zGQoZKikGrFMZvgS5ZHd+aGWVuWwhVF0
|
||||
t1drVmiR42HcWNz5w3QanT+2gIvTVCiE1lm1Y0eU4JGmIIbaKwextKn8rvW+p5PIwFl8ZWJ
|
||||
I8jyiTlhTcYXkekJAzTyYN6E08A+dk8voBkAVTJQ==".delete("\n ").unpack("m*")[0])
|
||||
|
||||
LambdaLobster = lambda { |env|
|
||||
if env["QUERY_STRING"].include?("flip")
|
||||
lobster = LobsterString.split("\n").
|
||||
map { |line| line.ljust(42).reverse }.
|
||||
join("\n")
|
||||
href = "?"
|
||||
else
|
||||
lobster = LobsterString
|
||||
href = "?flip"
|
||||
end
|
||||
|
||||
content = ["<title>Lobstericious!</title>",
|
||||
"<pre>", lobster, "</pre>",
|
||||
"<a href='#{href}'>flip!</a>"]
|
||||
length = content.inject(0) { |a,e| a+e.size }.to_s
|
||||
[200, {"Content-Type" => "text/html", "Content-Length" => length}, content]
|
||||
}
|
||||
|
||||
def call(env)
|
||||
req = Request.new(env)
|
||||
if req.GET["flip"] == "left"
|
||||
lobster = LobsterString.split("\n").
|
||||
map { |line| line.ljust(42).reverse }.
|
||||
join("\n")
|
||||
href = "?flip=right"
|
||||
elsif req.GET["flip"] == "crash"
|
||||
raise "Lobster crashed"
|
||||
else
|
||||
lobster = LobsterString
|
||||
href = "?flip=left"
|
||||
end
|
||||
|
||||
res = Response.new
|
||||
res.write "<title>Lobstericious!</title>"
|
||||
res.write "<pre>"
|
||||
res.write lobster
|
||||
res.write "</pre>"
|
||||
res.write "<p><a href='#{href}'>flip!</a></p>"
|
||||
res.write "<p><a href='?flip=crash'>crash!</a></p>"
|
||||
res.finish
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
|
||||
if $0 == __FILE__
|
||||
require 'rack'
|
||||
require 'rack/showexceptions'
|
||||
Rack::Handler::WEBrick.run \
|
||||
Rack::ShowExceptions.new(Rack::Lint.new(Rack::Lobster.new)),
|
||||
:Port => 9292
|
||||
end
|
|
@ -0,0 +1,16 @@
|
|||
module Rack
|
||||
class Lock
|
||||
FLAG = 'rack.multithread'.freeze
|
||||
|
||||
def initialize(app, lock = Mutex.new)
|
||||
@app, @lock = app, lock
|
||||
end
|
||||
|
||||
def call(env)
|
||||
old, env[FLAG] = env[FLAG], false
|
||||
@lock.synchronize { @app.call(env) }
|
||||
ensure
|
||||
env[FLAG] = old
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,27 @@
|
|||
module Rack
|
||||
class MethodOverride
|
||||
HTTP_METHODS = %w(GET HEAD PUT POST DELETE OPTIONS)
|
||||
|
||||
METHOD_OVERRIDE_PARAM_KEY = "_method".freeze
|
||||
HTTP_METHOD_OVERRIDE_HEADER = "HTTP_X_HTTP_METHOD_OVERRIDE".freeze
|
||||
|
||||
def initialize(app)
|
||||
@app = app
|
||||
end
|
||||
|
||||
def call(env)
|
||||
if env["REQUEST_METHOD"] == "POST"
|
||||
req = Request.new(env)
|
||||
method = req.POST[METHOD_OVERRIDE_PARAM_KEY] ||
|
||||
env[HTTP_METHOD_OVERRIDE_HEADER]
|
||||
method = method.to_s.upcase
|
||||
if HTTP_METHODS.include?(method)
|
||||
env["rack.methodoverride.original_method"] = env["REQUEST_METHOD"]
|
||||
env["REQUEST_METHOD"] = method
|
||||
end
|
||||
end
|
||||
|
||||
@app.call(env)
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,204 @@
|
|||
module Rack
|
||||
module Mime
|
||||
# Returns String with mime type if found, otherwise use +fallback+.
|
||||
# +ext+ should be filename extension in the '.ext' format that
|
||||
# File.extname(file) returns.
|
||||
# +fallback+ may be any object
|
||||
#
|
||||
# Also see the documentation for MIME_TYPES
|
||||
#
|
||||
# Usage:
|
||||
# Rack::Mime.mime_type('.foo')
|
||||
#
|
||||
# This is a shortcut for:
|
||||
# Rack::Mime::MIME_TYPES.fetch('.foo', 'application/octet-stream')
|
||||
|
||||
def mime_type(ext, fallback='application/octet-stream')
|
||||
MIME_TYPES.fetch(ext, fallback)
|
||||
end
|
||||
module_function :mime_type
|
||||
|
||||
# List of most common mime-types, selected various sources
|
||||
# according to their usefulness in a webserving scope for Ruby
|
||||
# users.
|
||||
#
|
||||
# To amend this list with your local mime.types list you can use:
|
||||
#
|
||||
# require 'webrick/httputils'
|
||||
# list = WEBrick::HTTPUtils.load_mime_types('/etc/mime.types')
|
||||
# Rack::Mime::MIME_TYPES.merge!(list)
|
||||
#
|
||||
# To add the list mongrel provides, use:
|
||||
#
|
||||
# require 'mongrel/handlers'
|
||||
# Rack::Mime::MIME_TYPES.merge!(Mongrel::DirHandler::MIME_TYPES)
|
||||
|
||||
MIME_TYPES = {
|
||||
".3gp" => "video/3gpp",
|
||||
".a" => "application/octet-stream",
|
||||
".ai" => "application/postscript",
|
||||
".aif" => "audio/x-aiff",
|
||||
".aiff" => "audio/x-aiff",
|
||||
".asc" => "application/pgp-signature",
|
||||
".asf" => "video/x-ms-asf",
|
||||
".asm" => "text/x-asm",
|
||||
".asx" => "video/x-ms-asf",
|
||||
".atom" => "application/atom+xml",
|
||||
".au" => "audio/basic",
|
||||
".avi" => "video/x-msvideo",
|
||||
".bat" => "application/x-msdownload",
|
||||
".bin" => "application/octet-stream",
|
||||
".bmp" => "image/bmp",
|
||||
".bz2" => "application/x-bzip2",
|
||||
".c" => "text/x-c",
|
||||
".cab" => "application/vnd.ms-cab-compressed",
|
||||
".cc" => "text/x-c",
|
||||
".chm" => "application/vnd.ms-htmlhelp",
|
||||
".class" => "application/octet-stream",
|
||||
".com" => "application/x-msdownload",
|
||||
".conf" => "text/plain",
|
||||
".cpp" => "text/x-c",
|
||||
".crt" => "application/x-x509-ca-cert",
|
||||
".css" => "text/css",
|
||||
".csv" => "text/csv",
|
||||
".cxx" => "text/x-c",
|
||||
".deb" => "application/x-debian-package",
|
||||
".der" => "application/x-x509-ca-cert",
|
||||
".diff" => "text/x-diff",
|
||||
".djv" => "image/vnd.djvu",
|
||||
".djvu" => "image/vnd.djvu",
|
||||
".dll" => "application/x-msdownload",
|
||||
".dmg" => "application/octet-stream",
|
||||
".doc" => "application/msword",
|
||||
".dot" => "application/msword",
|
||||
".dtd" => "application/xml-dtd",
|
||||
".dvi" => "application/x-dvi",
|
||||
".ear" => "application/java-archive",
|
||||
".eml" => "message/rfc822",
|
||||
".eps" => "application/postscript",
|
||||
".exe" => "application/x-msdownload",
|
||||
".f" => "text/x-fortran",
|
||||
".f77" => "text/x-fortran",
|
||||
".f90" => "text/x-fortran",
|
||||
".flv" => "video/x-flv",
|
||||
".for" => "text/x-fortran",
|
||||
".gem" => "application/octet-stream",
|
||||
".gemspec" => "text/x-script.ruby",
|
||||
".gif" => "image/gif",
|
||||
".gz" => "application/x-gzip",
|
||||
".h" => "text/x-c",
|
||||
".hh" => "text/x-c",
|
||||
".htm" => "text/html",
|
||||
".html" => "text/html",
|
||||
".ico" => "image/vnd.microsoft.icon",
|
||||
".ics" => "text/calendar",
|
||||
".ifb" => "text/calendar",
|
||||
".iso" => "application/octet-stream",
|
||||
".jar" => "application/java-archive",
|
||||
".java" => "text/x-java-source",
|
||||
".jnlp" => "application/x-java-jnlp-file",
|
||||
".jpeg" => "image/jpeg",
|
||||
".jpg" => "image/jpeg",
|
||||
".js" => "application/javascript",
|
||||
".json" => "application/json",
|
||||
".log" => "text/plain",
|
||||
".m3u" => "audio/x-mpegurl",
|
||||
".m4v" => "video/mp4",
|
||||
".man" => "text/troff",
|
||||
".mathml" => "application/mathml+xml",
|
||||
".mbox" => "application/mbox",
|
||||
".mdoc" => "text/troff",
|
||||
".me" => "text/troff",
|
||||
".mid" => "audio/midi",
|
||||
".midi" => "audio/midi",
|
||||
".mime" => "message/rfc822",
|
||||
".mml" => "application/mathml+xml",
|
||||
".mng" => "video/x-mng",
|
||||
".mov" => "video/quicktime",
|
||||
".mp3" => "audio/mpeg",
|
||||
".mp4" => "video/mp4",
|
||||
".mp4v" => "video/mp4",
|
||||
".mpeg" => "video/mpeg",
|
||||
".mpg" => "video/mpeg",
|
||||
".ms" => "text/troff",
|
||||
".msi" => "application/x-msdownload",
|
||||
".odp" => "application/vnd.oasis.opendocument.presentation",
|
||||
".ods" => "application/vnd.oasis.opendocument.spreadsheet",
|
||||
".odt" => "application/vnd.oasis.opendocument.text",
|
||||
".ogg" => "application/ogg",
|
||||
".p" => "text/x-pascal",
|
||||
".pas" => "text/x-pascal",
|
||||
".pbm" => "image/x-portable-bitmap",
|
||||
".pdf" => "application/pdf",
|
||||
".pem" => "application/x-x509-ca-cert",
|
||||
".pgm" => "image/x-portable-graymap",
|
||||
".pgp" => "application/pgp-encrypted",
|
||||
".pkg" => "application/octet-stream",
|
||||
".pl" => "text/x-script.perl",
|
||||
".pm" => "text/x-script.perl-module",
|
||||
".png" => "image/png",
|
||||
".pnm" => "image/x-portable-anymap",
|
||||
".ppm" => "image/x-portable-pixmap",
|
||||
".pps" => "application/vnd.ms-powerpoint",
|
||||
".ppt" => "application/vnd.ms-powerpoint",
|
||||
".ps" => "application/postscript",
|
||||
".psd" => "image/vnd.adobe.photoshop",
|
||||
".py" => "text/x-script.python",
|
||||
".qt" => "video/quicktime",
|
||||
".ra" => "audio/x-pn-realaudio",
|
||||
".rake" => "text/x-script.ruby",
|
||||
".ram" => "audio/x-pn-realaudio",
|
||||
".rar" => "application/x-rar-compressed",
|
||||
".rb" => "text/x-script.ruby",
|
||||
".rdf" => "application/rdf+xml",
|
||||
".roff" => "text/troff",
|
||||
".rpm" => "application/x-redhat-package-manager",
|
||||
".rss" => "application/rss+xml",
|
||||
".rtf" => "application/rtf",
|
||||
".ru" => "text/x-script.ruby",
|
||||
".s" => "text/x-asm",
|
||||
".sgm" => "text/sgml",
|
||||
".sgml" => "text/sgml",
|
||||
".sh" => "application/x-sh",
|
||||
".sig" => "application/pgp-signature",
|
||||
".snd" => "audio/basic",
|
||||
".so" => "application/octet-stream",
|
||||
".svg" => "image/svg+xml",
|
||||
".svgz" => "image/svg+xml",
|
||||
".swf" => "application/x-shockwave-flash",
|
||||
".t" => "text/troff",
|
||||
".tar" => "application/x-tar",
|
||||
".tbz" => "application/x-bzip-compressed-tar",
|
||||
".tcl" => "application/x-tcl",
|
||||
".tex" => "application/x-tex",
|
||||
".texi" => "application/x-texinfo",
|
||||
".texinfo" => "application/x-texinfo",
|
||||
".text" => "text/plain",
|
||||
".tif" => "image/tiff",
|
||||
".tiff" => "image/tiff",
|
||||
".torrent" => "application/x-bittorrent",
|
||||
".tr" => "text/troff",
|
||||
".txt" => "text/plain",
|
||||
".vcf" => "text/x-vcard",
|
||||
".vcs" => "text/x-vcalendar",
|
||||
".vrml" => "model/vrml",
|
||||
".war" => "application/java-archive",
|
||||
".wav" => "audio/x-wav",
|
||||
".wma" => "audio/x-ms-wma",
|
||||
".wmv" => "video/x-ms-wmv",
|
||||
".wmx" => "video/x-ms-wmx",
|
||||
".wrl" => "model/vrml",
|
||||
".wsdl" => "application/wsdl+xml",
|
||||
".xbm" => "image/x-xbitmap",
|
||||
".xhtml" => "application/xhtml+xml",
|
||||
".xls" => "application/vnd.ms-excel",
|
||||
".xml" => "application/xml",
|
||||
".xpm" => "image/x-xpixmap",
|
||||
".xsl" => "application/xml",
|
||||
".xslt" => "application/xslt+xml",
|
||||
".yaml" => "text/yaml",
|
||||
".yml" => "text/yaml",
|
||||
".zip" => "application/zip",
|
||||
}
|
||||
end
|
||||
end
|
|
@ -0,0 +1,163 @@
|
|||
require 'uri'
|
||||
require 'stringio'
|
||||
require 'rack/lint'
|
||||
require 'rack/utils'
|
||||
require 'rack/response'
|
||||
|
||||
module Rack
|
||||
# Rack::MockRequest helps testing your Rack application without
|
||||
# actually using HTTP.
|
||||
#
|
||||
# After performing a request on a URL with get/post/put/delete, it
|
||||
# returns a MockResponse with useful helper methods for effective
|
||||
# testing.
|
||||
#
|
||||
# You can pass a hash with additional configuration to the
|
||||
# get/post/put/delete.
|
||||
# <tt>:input</tt>:: A String or IO-like to be used as rack.input.
|
||||
# <tt>:fatal</tt>:: Raise a FatalWarning if the app writes to rack.errors.
|
||||
# <tt>:lint</tt>:: If true, wrap the application in a Rack::Lint.
|
||||
|
||||
class MockRequest
|
||||
class FatalWarning < RuntimeError
|
||||
end
|
||||
|
||||
class FatalWarner
|
||||
def puts(warning)
|
||||
raise FatalWarning, warning
|
||||
end
|
||||
|
||||
def write(warning)
|
||||
raise FatalWarning, warning
|
||||
end
|
||||
|
||||
def flush
|
||||
end
|
||||
|
||||
def string
|
||||
""
|
||||
end
|
||||
end
|
||||
|
||||
DEFAULT_ENV = {
|
||||
"rack.version" => [1,0],
|
||||
"rack.input" => StringIO.new,
|
||||
"rack.errors" => StringIO.new,
|
||||
"rack.multithread" => true,
|
||||
"rack.multiprocess" => true,
|
||||
"rack.run_once" => false,
|
||||
}
|
||||
|
||||
def initialize(app)
|
||||
@app = app
|
||||
end
|
||||
|
||||
def get(uri, opts={}) request("GET", uri, opts) end
|
||||
def post(uri, opts={}) request("POST", uri, opts) end
|
||||
def put(uri, opts={}) request("PUT", uri, opts) end
|
||||
def delete(uri, opts={}) request("DELETE", uri, opts) end
|
||||
|
||||
def request(method="GET", uri="", opts={})
|
||||
env = self.class.env_for(uri, opts.merge(:method => method))
|
||||
|
||||
if opts[:lint]
|
||||
app = Rack::Lint.new(@app)
|
||||
else
|
||||
app = @app
|
||||
end
|
||||
|
||||
errors = env["rack.errors"]
|
||||
MockResponse.new(*(app.call(env) + [errors]))
|
||||
end
|
||||
|
||||
# Return the Rack environment used for a request to +uri+.
|
||||
def self.env_for(uri="", opts={})
|
||||
uri = URI(uri)
|
||||
env = DEFAULT_ENV.dup
|
||||
|
||||
env["REQUEST_METHOD"] = opts[:method] || "GET"
|
||||
env["SERVER_NAME"] = uri.host || "example.org"
|
||||
env["SERVER_PORT"] = uri.port ? uri.port.to_s : "80"
|
||||
env["QUERY_STRING"] = uri.query.to_s
|
||||
env["PATH_INFO"] = (!uri.path || uri.path.empty?) ? "/" : uri.path
|
||||
env["rack.url_scheme"] = uri.scheme || "http"
|
||||
|
||||
env["SCRIPT_NAME"] = opts[:script_name] || ""
|
||||
|
||||
if opts[:fatal]
|
||||
env["rack.errors"] = FatalWarner.new
|
||||
else
|
||||
env["rack.errors"] = StringIO.new
|
||||
end
|
||||
|
||||
opts[:input] ||= ""
|
||||
if String === opts[:input]
|
||||
rack_input = StringIO.new(opts[:input])
|
||||
else
|
||||
rack_input = opts[:input]
|
||||
end
|
||||
|
||||
rack_input.set_encoding(Encoding::BINARY) if rack_input.respond_to?(:set_encoding)
|
||||
env['rack.input'] = rack_input
|
||||
|
||||
env["CONTENT_LENGTH"] ||= env["rack.input"].length.to_s
|
||||
|
||||
opts.each { |field, value|
|
||||
env[field] = value if String === field
|
||||
}
|
||||
|
||||
env
|
||||
end
|
||||
end
|
||||
|
||||
# Rack::MockResponse provides useful helpers for testing your apps.
|
||||
# Usually, you don't create the MockResponse on your own, but use
|
||||
# MockRequest.
|
||||
|
||||
class MockResponse
|
||||
def initialize(status, headers, body, errors=StringIO.new(""))
|
||||
@status = status.to_i
|
||||
|
||||
@original_headers = headers
|
||||
@headers = Rack::Utils::HeaderHash.new
|
||||
headers.each { |field, values|
|
||||
@headers[field] = values
|
||||
@headers[field] = "" if values.empty?
|
||||
}
|
||||
|
||||
@body = ""
|
||||
body.each { |part| @body << part }
|
||||
|
||||
@errors = errors.string
|
||||
end
|
||||
|
||||
# Status
|
||||
attr_reader :status
|
||||
|
||||
# Headers
|
||||
attr_reader :headers, :original_headers
|
||||
|
||||
def [](field)
|
||||
headers[field]
|
||||
end
|
||||
|
||||
|
||||
# Body
|
||||
attr_reader :body
|
||||
|
||||
def =~(other)
|
||||
@body =~ other
|
||||
end
|
||||
|
||||
def match(other)
|
||||
@body.match other
|
||||
end
|
||||
|
||||
|
||||
# Errors
|
||||
attr_accessor :errors
|
||||
|
||||
|
||||
include Response::Helpers
|
||||
end
|
||||
end
|
|
@ -0,0 +1,57 @@
|
|||
require 'uri'
|
||||
|
||||
module Rack
|
||||
# Rack::ForwardRequest gets caught by Rack::Recursive and redirects
|
||||
# the current request to the app at +url+.
|
||||
#
|
||||
# raise ForwardRequest.new("/not-found")
|
||||
#
|
||||
|
||||
class ForwardRequest < Exception
|
||||
attr_reader :url, :env
|
||||
|
||||
def initialize(url, env={})
|
||||
@url = URI(url)
|
||||
@env = env
|
||||
|
||||
@env["PATH_INFO"] = @url.path
|
||||
@env["QUERY_STRING"] = @url.query if @url.query
|
||||
@env["HTTP_HOST"] = @url.host if @url.host
|
||||
@env["HTTP_PORT"] = @url.port if @url.port
|
||||
@env["rack.url_scheme"] = @url.scheme if @url.scheme
|
||||
|
||||
super "forwarding to #{url}"
|
||||
end
|
||||
end
|
||||
|
||||
# Rack::Recursive allows applications called down the chain to
|
||||
# include data from other applications (by using
|
||||
# <tt>rack['rack.recursive.include'][...]</tt> or raise a
|
||||
# ForwardRequest to redirect internally.
|
||||
|
||||
class Recursive
|
||||
def initialize(app)
|
||||
@app = app
|
||||
end
|
||||
|
||||
def call(env)
|
||||
@script_name = env["SCRIPT_NAME"]
|
||||
@app.call(env.merge('rack.recursive.include' => method(:include)))
|
||||
rescue ForwardRequest => req
|
||||
call(env.merge(req.env))
|
||||
end
|
||||
|
||||
def include(env, path)
|
||||
unless path.index(@script_name) == 0 && (path[@script_name.size] == ?/ ||
|
||||
path[@script_name.size].nil?)
|
||||
raise ArgumentError, "can only include below #{@script_name}, not #{path}"
|
||||
end
|
||||
|
||||
env = env.merge("PATH_INFO" => path, "SCRIPT_NAME" => @script_name,
|
||||
"REQUEST_METHOD" => "GET",
|
||||
"CONTENT_LENGTH" => "0", "CONTENT_TYPE" => "",
|
||||
"rack.input" => StringIO.new(""))
|
||||
@app.call(env)
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,106 @@
|
|||
# Copyright (c) 2009 Michael Fellinger m.fellinger@gmail.com
|
||||
# All files in this distribution are subject to the terms of the Ruby license.
|
||||
|
||||
require 'pathname'
|
||||
|
||||
module Rack
|
||||
|
||||
# High performant source reloader
|
||||
#
|
||||
# This class acts as Rack middleware.
|
||||
#
|
||||
# What makes it especially suited for use in a production environment is that
|
||||
# any file will only be checked once and there will only be made one system
|
||||
# call stat(2).
|
||||
#
|
||||
# Please note that this will not reload files in the background, it does so
|
||||
# only when actively called.
|
||||
#
|
||||
# It is performing a check/reload cycle at the start of every request, but
|
||||
# also respects a cool down time, during which nothing will be done.
|
||||
class Reloader
|
||||
def initialize(app, cooldown = 10, backend = Stat)
|
||||
@app = app
|
||||
@cooldown = cooldown
|
||||
@last = (Time.now - cooldown)
|
||||
@cache = {}
|
||||
@mtimes = {}
|
||||
|
||||
extend backend
|
||||
end
|
||||
|
||||
def call(env)
|
||||
if @cooldown and Time.now > @last + @cooldown
|
||||
if Thread.list.size > 1
|
||||
Thread.exclusive{ reload! }
|
||||
else
|
||||
reload!
|
||||
end
|
||||
|
||||
@last = Time.now
|
||||
end
|
||||
|
||||
@app.call(env)
|
||||
end
|
||||
|
||||
def reload!(stderr = $stderr)
|
||||
rotation do |file, mtime|
|
||||
previous_mtime = @mtimes[file] ||= mtime
|
||||
safe_load(file, mtime, stderr) if mtime > previous_mtime
|
||||
end
|
||||
end
|
||||
|
||||
# A safe Kernel::load, issuing the hooks depending on the results
|
||||
def safe_load(file, mtime, stderr = $stderr)
|
||||
load(file)
|
||||
stderr.puts "#{self.class}: reloaded `#{file}'"
|
||||
file
|
||||
rescue LoadError, SyntaxError => ex
|
||||
stderr.puts ex
|
||||
ensure
|
||||
@mtimes[file] = mtime
|
||||
end
|
||||
|
||||
module Stat
|
||||
def rotation
|
||||
files = [$0, *$LOADED_FEATURES].uniq
|
||||
paths = ['./', *$LOAD_PATH].uniq
|
||||
|
||||
files.map{|file|
|
||||
next if file =~ /\.(so|bundle)$/ # cannot reload compiled files
|
||||
|
||||
found, stat = figure_path(file, paths)
|
||||
next unless found && stat && mtime = stat.mtime
|
||||
|
||||
@cache[file] = found
|
||||
|
||||
yield(found, mtime)
|
||||
}.compact
|
||||
end
|
||||
|
||||
# Takes a relative or absolute +file+ name, a couple possible +paths+ that
|
||||
# the +file+ might reside in. Returns the full path and File::Stat for the
|
||||
# path.
|
||||
def figure_path(file, paths)
|
||||
found = @cache[file]
|
||||
found = file if !found and Pathname.new(file).absolute?
|
||||
found, stat = safe_stat(found)
|
||||
return found, stat if found
|
||||
|
||||
paths.find do |possible_path|
|
||||
path = ::File.join(possible_path, file)
|
||||
found, stat = safe_stat(path)
|
||||
return ::File.expand_path(found), stat if found
|
||||
end
|
||||
end
|
||||
|
||||
def safe_stat(file)
|
||||
return unless file
|
||||
stat = ::File.stat(file)
|
||||
return file, stat if stat.file?
|
||||
rescue Errno::ENOENT, Errno::ENOTDIR
|
||||
@cache.delete(file) and false
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,246 @@
|
|||
require 'rack/utils'
|
||||
|
||||
module Rack
|
||||
# Rack::Request provides a convenient interface to a Rack
|
||||
# environment. It is stateless, the environment +env+ passed to the
|
||||
# constructor will be directly modified.
|
||||
#
|
||||
# req = Rack::Request.new(env)
|
||||
# req.post?
|
||||
# req.params["data"]
|
||||
#
|
||||
# The environment hash passed will store a reference to the Request object
|
||||
# instantiated so that it will only instantiate if an instance of the Request
|
||||
# object doesn't already exist.
|
||||
|
||||
class Request
|
||||
# The environment of the request.
|
||||
attr_reader :env
|
||||
|
||||
def initialize(env)
|
||||
@env = env
|
||||
end
|
||||
|
||||
def body; @env["rack.input"] end
|
||||
def scheme; @env["rack.url_scheme"] end
|
||||
def script_name; @env["SCRIPT_NAME"].to_s end
|
||||
def path_info; @env["PATH_INFO"].to_s end
|
||||
def port; @env["SERVER_PORT"].to_i end
|
||||
def request_method; @env["REQUEST_METHOD"] end
|
||||
def query_string; @env["QUERY_STRING"].to_s end
|
||||
def content_length; @env['CONTENT_LENGTH'] end
|
||||
def content_type; @env['CONTENT_TYPE'] end
|
||||
def session; @env['rack.session'] ||= {} end
|
||||
def session_options; @env['rack.session.options'] ||= {} end
|
||||
|
||||
# The media type (type/subtype) portion of the CONTENT_TYPE header
|
||||
# without any media type parameters. e.g., when CONTENT_TYPE is
|
||||
# "text/plain;charset=utf-8", the media-type is "text/plain".
|
||||
#
|
||||
# For more information on the use of media types in HTTP, see:
|
||||
# http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.7
|
||||
def media_type
|
||||
content_type && content_type.split(/\s*[;,]\s*/, 2).first.downcase
|
||||
end
|
||||
|
||||
# The media type parameters provided in CONTENT_TYPE as a Hash, or
|
||||
# an empty Hash if no CONTENT_TYPE or media-type parameters were
|
||||
# provided. e.g., when the CONTENT_TYPE is "text/plain;charset=utf-8",
|
||||
# this method responds with the following Hash:
|
||||
# { 'charset' => 'utf-8' }
|
||||
def media_type_params
|
||||
return {} if content_type.nil?
|
||||
content_type.split(/\s*[;,]\s*/)[1..-1].
|
||||
collect { |s| s.split('=', 2) }.
|
||||
inject({}) { |hash,(k,v)| hash[k.downcase] = v ; hash }
|
||||
end
|
||||
|
||||
# The character set of the request body if a "charset" media type
|
||||
# parameter was given, or nil if no "charset" was specified. Note
|
||||
# that, per RFC2616, text/* media types that specify no explicit
|
||||
# charset are to be considered ISO-8859-1.
|
||||
def content_charset
|
||||
media_type_params['charset']
|
||||
end
|
||||
|
||||
def host
|
||||
# Remove port number.
|
||||
(@env["HTTP_HOST"] || @env["SERVER_NAME"]).to_s.gsub(/:\d+\z/, '')
|
||||
end
|
||||
|
||||
def script_name=(s); @env["SCRIPT_NAME"] = s.to_s end
|
||||
def path_info=(s); @env["PATH_INFO"] = s.to_s end
|
||||
|
||||
def get?; request_method == "GET" end
|
||||
def post?; request_method == "POST" end
|
||||
def put?; request_method == "PUT" end
|
||||
def delete?; request_method == "DELETE" end
|
||||
def head?; request_method == "HEAD" end
|
||||
|
||||
# The set of form-data media-types. Requests that do not indicate
|
||||
# one of the media types presents in this list will not be eligible
|
||||
# for form-data / param parsing.
|
||||
FORM_DATA_MEDIA_TYPES = [
|
||||
nil,
|
||||
'application/x-www-form-urlencoded',
|
||||
'multipart/form-data'
|
||||
]
|
||||
|
||||
# The set of media-types. Requests that do not indicate
|
||||
# one of the media types presents in this list will not be eligible
|
||||
# for param parsing like soap attachments or generic multiparts
|
||||
PARSEABLE_DATA_MEDIA_TYPES = [
|
||||
'multipart/related',
|
||||
'multipart/mixed'
|
||||
]
|
||||
|
||||
# Determine whether the request body contains form-data by checking
|
||||
# the request media_type against registered form-data media-types:
|
||||
# "application/x-www-form-urlencoded" and "multipart/form-data". The
|
||||
# list of form-data media types can be modified through the
|
||||
# +FORM_DATA_MEDIA_TYPES+ array.
|
||||
def form_data?
|
||||
FORM_DATA_MEDIA_TYPES.include?(media_type)
|
||||
end
|
||||
|
||||
# Determine whether the request body contains data by checking
|
||||
# the request media_type against registered parse-data media-types
|
||||
def parseable_data?
|
||||
PARSEABLE_DATA_MEDIA_TYPES.include?(media_type)
|
||||
end
|
||||
|
||||
# Returns the data recieved in the query string.
|
||||
def GET
|
||||
if @env["rack.request.query_string"] == query_string
|
||||
@env["rack.request.query_hash"]
|
||||
else
|
||||
@env["rack.request.query_string"] = query_string
|
||||
@env["rack.request.query_hash"] =
|
||||
Utils.parse_nested_query(query_string)
|
||||
end
|
||||
end
|
||||
|
||||
# Returns the data recieved in the request body.
|
||||
#
|
||||
# This method support both application/x-www-form-urlencoded and
|
||||
# multipart/form-data.
|
||||
def POST
|
||||
if @env["rack.request.form_input"].eql? @env["rack.input"]
|
||||
@env["rack.request.form_hash"]
|
||||
elsif form_data? || parseable_data?
|
||||
@env["rack.request.form_input"] = @env["rack.input"]
|
||||
unless @env["rack.request.form_hash"] =
|
||||
Utils::Multipart.parse_multipart(env)
|
||||
form_vars = @env["rack.input"].read
|
||||
|
||||
# Fix for Safari Ajax postings that always append \0
|
||||
form_vars.sub!(/\0\z/, '')
|
||||
|
||||
@env["rack.request.form_vars"] = form_vars
|
||||
@env["rack.request.form_hash"] = Utils.parse_nested_query(form_vars)
|
||||
|
||||
@env["rack.input"].rewind
|
||||
end
|
||||
@env["rack.request.form_hash"]
|
||||
else
|
||||
{}
|
||||
end
|
||||
end
|
||||
|
||||
# The union of GET and POST data.
|
||||
def params
|
||||
self.put? ? self.GET : self.GET.update(self.POST)
|
||||
rescue EOFError => e
|
||||
self.GET
|
||||
end
|
||||
|
||||
# shortcut for request.params[key]
|
||||
def [](key)
|
||||
params[key.to_s]
|
||||
end
|
||||
|
||||
# shortcut for request.params[key] = value
|
||||
def []=(key, value)
|
||||
params[key.to_s] = value
|
||||
end
|
||||
|
||||
# like Hash#values_at
|
||||
def values_at(*keys)
|
||||
keys.map{|key| params[key] }
|
||||
end
|
||||
|
||||
# the referer of the client or '/'
|
||||
def referer
|
||||
@env['HTTP_REFERER'] || '/'
|
||||
end
|
||||
alias referrer referer
|
||||
|
||||
|
||||
def cookies
|
||||
return {} unless @env["HTTP_COOKIE"]
|
||||
|
||||
if @env["rack.request.cookie_string"] == @env["HTTP_COOKIE"]
|
||||
@env["rack.request.cookie_hash"]
|
||||
else
|
||||
@env["rack.request.cookie_string"] = @env["HTTP_COOKIE"]
|
||||
# According to RFC 2109:
|
||||
# If multiple cookies satisfy the criteria above, they are ordered in
|
||||
# the Cookie header such that those with more specific Path attributes
|
||||
# precede those with less specific. Ordering with respect to other
|
||||
# attributes (e.g., Domain) is unspecified.
|
||||
@env["rack.request.cookie_hash"] =
|
||||
Utils.parse_query(@env["rack.request.cookie_string"], ';,').inject({}) {|h,(k,v)|
|
||||
h[k] = Array === v ? v.first : v
|
||||
h
|
||||
}
|
||||
end
|
||||
end
|
||||
|
||||
def xhr?
|
||||
@env["HTTP_X_REQUESTED_WITH"] == "XMLHttpRequest"
|
||||
end
|
||||
|
||||
# Tries to return a remake of the original request URL as a string.
|
||||
def url
|
||||
url = scheme + "://"
|
||||
url << host
|
||||
|
||||
if scheme == "https" && port != 443 ||
|
||||
scheme == "http" && port != 80
|
||||
url << ":#{port}"
|
||||
end
|
||||
|
||||
url << fullpath
|
||||
|
||||
url
|
||||
end
|
||||
|
||||
def path
|
||||
script_name + path_info
|
||||
end
|
||||
|
||||
def fullpath
|
||||
query_string.empty? ? path : "#{path}?#{query_string}"
|
||||
end
|
||||
|
||||
def accept_encoding
|
||||
@env["HTTP_ACCEPT_ENCODING"].to_s.split(/,\s*/).map do |part|
|
||||
m = /^([^\s,]+?)(?:;\s*q=(\d+(?:\.\d+)?))?$/.match(part) # From WEBrick
|
||||
|
||||
if m
|
||||
[m[1], (m[2] || 1.0).to_f]
|
||||
else
|
||||
raise "Invalid value for Accept-Encoding: #{part.inspect}"
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
def ip
|
||||
if addr = @env['HTTP_X_FORWARDED_FOR']
|
||||
addr.split(',').last.strip
|
||||
else
|
||||
@env['REMOTE_ADDR']
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,183 @@
|
|||
require 'rack/request'
|
||||
require 'rack/utils'
|
||||
|
||||
module Rack
|
||||
# Rack::Response provides a convenient interface to create a Rack
|
||||
# response.
|
||||
#
|
||||
# It allows setting of headers and cookies, and provides useful
|
||||
# defaults (a OK response containing HTML).
|
||||
#
|
||||
# You can use Response#write to iteratively generate your response,
|
||||
# but note that this is buffered by Rack::Response until you call
|
||||
# +finish+. +finish+ however can take a block inside which calls to
|
||||
# +write+ are syncronous with the Rack response.
|
||||
#
|
||||
# Your application's +call+ should end returning Response#finish.
|
||||
|
||||
class Response
|
||||
attr_accessor :length
|
||||
|
||||
def initialize(body=[], status=200, header={}, &block)
|
||||
@status = status
|
||||
@header = Utils::HeaderHash.new({"Content-Type" => "text/html"}.
|
||||
merge(header))
|
||||
|
||||
@writer = lambda { |x| @body << x }
|
||||
@block = nil
|
||||
@length = 0
|
||||
|
||||
@body = []
|
||||
|
||||
if body.respond_to? :to_str
|
||||
write body.to_str
|
||||
elsif body.respond_to?(:each)
|
||||
body.each { |part|
|
||||
write part.to_s
|
||||
}
|
||||
else
|
||||
raise TypeError, "stringable or iterable required"
|
||||
end
|
||||
|
||||
yield self if block_given?
|
||||
end
|
||||
|
||||
attr_reader :header
|
||||
attr_accessor :status, :body
|
||||
|
||||
def [](key)
|
||||
header[key]
|
||||
end
|
||||
|
||||
def []=(key, value)
|
||||
header[key] = value
|
||||
end
|
||||
|
||||
def set_cookie(key, value)
|
||||
case value
|
||||
when Hash
|
||||
domain = "; domain=" + value[:domain] if value[:domain]
|
||||
path = "; path=" + value[:path] if value[:path]
|
||||
# According to RFC 2109, we need dashes here.
|
||||
# N.B.: cgi.rb uses spaces...
|
||||
expires = "; expires=" + value[:expires].clone.gmtime.
|
||||
strftime("%a, %d-%b-%Y %H:%M:%S GMT") if value[:expires]
|
||||
secure = "; secure" if value[:secure]
|
||||
httponly = "; HttpOnly" if value[:httponly]
|
||||
value = value[:value]
|
||||
end
|
||||
value = [value] unless Array === value
|
||||
cookie = Utils.escape(key) + "=" +
|
||||
value.map { |v| Utils.escape v }.join("&") +
|
||||
"#{domain}#{path}#{expires}#{secure}#{httponly}"
|
||||
|
||||
case self["Set-Cookie"]
|
||||
when Array
|
||||
self["Set-Cookie"] << cookie
|
||||
when String
|
||||
self["Set-Cookie"] = [self["Set-Cookie"], cookie]
|
||||
when nil
|
||||
self["Set-Cookie"] = cookie
|
||||
end
|
||||
end
|
||||
|
||||
def delete_cookie(key, value={})
|
||||
unless Array === self["Set-Cookie"]
|
||||
self["Set-Cookie"] = [self["Set-Cookie"]].compact
|
||||
end
|
||||
|
||||
self["Set-Cookie"].reject! { |cookie|
|
||||
cookie =~ /\A#{Utils.escape(key)}=/
|
||||
}
|
||||
|
||||
set_cookie(key,
|
||||
{:value => '', :path => nil, :domain => nil,
|
||||
:expires => Time.at(0) }.merge(value))
|
||||
end
|
||||
|
||||
def redirect(target, status=302)
|
||||
self.status = status
|
||||
self["Location"] = target
|
||||
end
|
||||
|
||||
def finish(&block)
|
||||
@block = block
|
||||
|
||||
if [204, 304].include?(status.to_i)
|
||||
header.delete "Content-Type"
|
||||
[status.to_i, header.to_hash, []]
|
||||
else
|
||||
[status.to_i, header.to_hash, self]
|
||||
end
|
||||
end
|
||||
alias to_a finish # For *response
|
||||
|
||||
def each(&callback)
|
||||
@body.each(&callback)
|
||||
@writer = callback
|
||||
@block.call(self) if @block
|
||||
end
|
||||
|
||||
# Append to body and update Content-Length.
|
||||
#
|
||||
# NOTE: Do not mix #write and direct #body access!
|
||||
#
|
||||
def write(str)
|
||||
s = str.to_s
|
||||
@length += Rack::Utils.bytesize(s)
|
||||
@writer.call s
|
||||
|
||||
header["Content-Length"] = @length.to_s
|
||||
str
|
||||
end
|
||||
|
||||
def close
|
||||
body.close if body.respond_to?(:close)
|
||||
end
|
||||
|
||||
def empty?
|
||||
@block == nil && @body.empty?
|
||||
end
|
||||
|
||||
alias headers header
|
||||
|
||||
module Helpers
|
||||
def invalid?; @status < 100 || @status >= 600; end
|
||||
|
||||
def informational?; @status >= 100 && @status < 200; end
|
||||
def successful?; @status >= 200 && @status < 300; end
|
||||
def redirection?; @status >= 300 && @status < 400; end
|
||||
def client_error?; @status >= 400 && @status < 500; end
|
||||
def server_error?; @status >= 500 && @status < 600; end
|
||||
|
||||
def ok?; @status == 200; end
|
||||
def forbidden?; @status == 403; end
|
||||
def not_found?; @status == 404; end
|
||||
|
||||
def redirect?; [301, 302, 303, 307].include? @status; end
|
||||
def empty?; [201, 204, 304].include? @status; end
|
||||
|
||||
# Headers
|
||||
attr_reader :headers, :original_headers
|
||||
|
||||
def include?(header)
|
||||
!!headers[header]
|
||||
end
|
||||
|
||||
def content_type
|
||||
headers["Content-Type"]
|
||||
end
|
||||
|
||||
def content_length
|
||||
cl = headers["Content-Length"]
|
||||
cl ? cl.to_i : cl
|
||||
end
|
||||
|
||||
def location
|
||||
headers["Location"]
|
||||
end
|
||||
end
|
||||
|
||||
include Helpers
|
||||
end
|
||||
end
|
|
@ -0,0 +1,100 @@
|
|||
require 'tempfile'
|
||||
|
||||
module Rack
|
||||
# Class which can make any IO object rewindable, including non-rewindable ones. It does
|
||||
# this by buffering the data into a tempfile, which is rewindable.
|
||||
#
|
||||
# rack.input is required to be rewindable, so if your input stream IO is non-rewindable
|
||||
# by nature (e.g. a pipe or a socket) then you can wrap it in an object of this class
|
||||
# to easily make it rewindable.
|
||||
#
|
||||
# Don't forget to call #close when you're done. This frees up temporary resources that
|
||||
# RewindableInput uses, though it does *not* close the original IO object.
|
||||
class RewindableInput
|
||||
def initialize(io)
|
||||
@io = io
|
||||
@rewindable_io = nil
|
||||
@unlinked = false
|
||||
end
|
||||
|
||||
def gets
|
||||
make_rewindable unless @rewindable_io
|
||||
@rewindable_io.gets
|
||||
end
|
||||
|
||||
def read(*args)
|
||||
make_rewindable unless @rewindable_io
|
||||
@rewindable_io.read(*args)
|
||||
end
|
||||
|
||||
def each(&block)
|
||||
make_rewindable unless @rewindable_io
|
||||
@rewindable_io.each(&block)
|
||||
end
|
||||
|
||||
def rewind
|
||||
make_rewindable unless @rewindable_io
|
||||
@rewindable_io.rewind
|
||||
end
|
||||
|
||||
# Closes this RewindableInput object without closing the originally
|
||||
# wrapped IO oject. Cleans up any temporary resources that this RewindableInput
|
||||
# has created.
|
||||
#
|
||||
# This method may be called multiple times. It does nothing on subsequent calls.
|
||||
def close
|
||||
if @rewindable_io
|
||||
if @unlinked
|
||||
@rewindable_io.close
|
||||
else
|
||||
@rewindable_io.close!
|
||||
end
|
||||
@rewindable_io = nil
|
||||
end
|
||||
end
|
||||
|
||||
private
|
||||
|
||||
# Ruby's Tempfile class has a bug. Subclass it and fix it.
|
||||
class Tempfile < ::Tempfile
|
||||
def _close
|
||||
@tmpfile.close if @tmpfile
|
||||
@data[1] = nil if @data
|
||||
@tmpfile = nil
|
||||
end
|
||||
end
|
||||
|
||||
def make_rewindable
|
||||
# Buffer all data into a tempfile. Since this tempfile is private to this
|
||||
# RewindableInput object, we chmod it so that nobody else can read or write
|
||||
# it. On POSIX filesystems we also unlink the file so that it doesn't
|
||||
# even have a file entry on the filesystem anymore, though we can still
|
||||
# access it because we have the file handle open.
|
||||
@rewindable_io = Tempfile.new('RackRewindableInput')
|
||||
@rewindable_io.chmod(0000)
|
||||
@rewindable_io.set_encoding(Encoding::BINARY) if @rewindable_io.respond_to?(:set_encoding)
|
||||
@rewindable_io.binmode
|
||||
if filesystem_has_posix_semantics?
|
||||
@rewindable_io.unlink
|
||||
@unlinked = true
|
||||
end
|
||||
|
||||
buffer = ""
|
||||
while @io.read(1024 * 4, buffer)
|
||||
entire_buffer_written_out = false
|
||||
while !entire_buffer_written_out
|
||||
written = @rewindable_io.write(buffer)
|
||||
entire_buffer_written_out = written == buffer.size
|
||||
if !entire_buffer_written_out
|
||||
buffer.slice!(0 .. written - 1)
|
||||
end
|
||||
end
|
||||
end
|
||||
@rewindable_io.rewind
|
||||
end
|
||||
|
||||
def filesystem_has_posix_semantics?
|
||||
RUBY_PLATFORM !~ /(mswin|mingw|cygwin|java)/
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,142 @@
|
|||
# AUTHOR: blink <blinketje@gmail.com>; blink#ruby-lang@irc.freenode.net
|
||||
# bugrep: Andreas Zehnder
|
||||
|
||||
require 'time'
|
||||
require 'rack/request'
|
||||
require 'rack/response'
|
||||
|
||||
module Rack
|
||||
|
||||
module Session
|
||||
|
||||
module Abstract
|
||||
|
||||
# ID sets up a basic framework for implementing an id based sessioning
|
||||
# service. Cookies sent to the client for maintaining sessions will only
|
||||
# contain an id reference. Only #get_session and #set_session are
|
||||
# required to be overwritten.
|
||||
#
|
||||
# All parameters are optional.
|
||||
# * :key determines the name of the cookie, by default it is
|
||||
# 'rack.session'
|
||||
# * :path, :domain, :expire_after, :secure, and :httponly set the related
|
||||
# cookie options as by Rack::Response#add_cookie
|
||||
# * :defer will not set a cookie in the response.
|
||||
# * :renew (implementation dependent) will prompt the generation of a new
|
||||
# session id, and migration of data to be referenced at the new id. If
|
||||
# :defer is set, it will be overridden and the cookie will be set.
|
||||
# * :sidbits sets the number of bits in length that a generated session
|
||||
# id will be.
|
||||
#
|
||||
# These options can be set on a per request basis, at the location of
|
||||
# env['rack.session.options']. Additionally the id of the session can be
|
||||
# found within the options hash at the key :id. It is highly not
|
||||
# recommended to change its value.
|
||||
#
|
||||
# Is Rack::Utils::Context compatible.
|
||||
|
||||
class ID
|
||||
DEFAULT_OPTIONS = {
|
||||
:path => '/',
|
||||
:domain => nil,
|
||||
:expire_after => nil,
|
||||
:secure => false,
|
||||
:httponly => true,
|
||||
:defer => false,
|
||||
:renew => false,
|
||||
:sidbits => 128
|
||||
}
|
||||
|
||||
attr_reader :key, :default_options
|
||||
def initialize(app, options={})
|
||||
@app = app
|
||||
@key = options[:key] || "rack.session"
|
||||
@default_options = self.class::DEFAULT_OPTIONS.merge(options)
|
||||
end
|
||||
|
||||
def call(env)
|
||||
context(env)
|
||||
end
|
||||
|
||||
def context(env, app=@app)
|
||||
load_session(env)
|
||||
status, headers, body = app.call(env)
|
||||
commit_session(env, status, headers, body)
|
||||
end
|
||||
|
||||
private
|
||||
|
||||
# Generate a new session id using Ruby #rand. The size of the
|
||||
# session id is controlled by the :sidbits option.
|
||||
# Monkey patch this to use custom methods for session id generation.
|
||||
|
||||
def generate_sid
|
||||
"%0#{@default_options[:sidbits] / 4}x" %
|
||||
rand(2**@default_options[:sidbits] - 1)
|
||||
end
|
||||
|
||||
# Extracts the session id from provided cookies and passes it and the
|
||||
# environment to #get_session. It then sets the resulting session into
|
||||
# 'rack.session', and places options and session metadata into
|
||||
# 'rack.session.options'.
|
||||
|
||||
def load_session(env)
|
||||
request = Rack::Request.new(env)
|
||||
session_id = request.cookies[@key]
|
||||
|
||||
begin
|
||||
session_id, session = get_session(env, session_id)
|
||||
env['rack.session'] = session
|
||||
rescue
|
||||
env['rack.session'] = Hash.new
|
||||
end
|
||||
|
||||
env['rack.session.options'] = @default_options.
|
||||
merge(:id => session_id)
|
||||
end
|
||||
|
||||
# Acquires the session from the environment and the session id from
|
||||
# the session options and passes them to #set_session. If successful
|
||||
# and the :defer option is not true, a cookie will be added to the
|
||||
# response with the session's id.
|
||||
|
||||
def commit_session(env, status, headers, body)
|
||||
session = env['rack.session']
|
||||
options = env['rack.session.options']
|
||||
session_id = options[:id]
|
||||
|
||||
if not session_id = set_session(env, session_id, session, options)
|
||||
env["rack.errors"].puts("Warning! #{self.class.name} failed to save session. Content dropped.")
|
||||
[status, headers, body]
|
||||
elsif options[:defer] and not options[:renew]
|
||||
env["rack.errors"].puts("Defering cookie for #{session_id}") if $VERBOSE
|
||||
[status, headers, body]
|
||||
else
|
||||
cookie = Hash.new
|
||||
cookie[:value] = session_id
|
||||
cookie[:expires] = Time.now + options[:expire_after] unless options[:expire_after].nil?
|
||||
response = Rack::Response.new(body, status, headers)
|
||||
response.set_cookie(@key, cookie.merge(options))
|
||||
response.to_a
|
||||
end
|
||||
end
|
||||
|
||||
# All thread safety and session retrival proceedures should occur here.
|
||||
# Should return [session_id, session].
|
||||
# If nil is provided as the session id, generation of a new valid id
|
||||
# should occur within.
|
||||
|
||||
def get_session(env, sid)
|
||||
raise '#get_session not implemented.'
|
||||
end
|
||||
|
||||
# All thread safety and session storage proceedures should occur here.
|
||||
# Should return true or false dependant on whether or not the session
|
||||
# was saved or not.
|
||||
def set_session(env, sid, session, options)
|
||||
raise '#set_session not implemented.'
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,91 @@
|
|||
require 'openssl'
|
||||
require 'rack/request'
|
||||
require 'rack/response'
|
||||
|
||||
module Rack
|
||||
|
||||
module Session
|
||||
|
||||
# Rack::Session::Cookie provides simple cookie based session management.
|
||||
# The session is a Ruby Hash stored as base64 encoded marshalled data
|
||||
# set to :key (default: rack.session).
|
||||
# When the secret key is set, cookie data is checked for data integrity.
|
||||
#
|
||||
# Example:
|
||||
#
|
||||
# use Rack::Session::Cookie, :key => 'rack.session',
|
||||
# :domain => 'foo.com',
|
||||
# :path => '/',
|
||||
# :expire_after => 2592000,
|
||||
# :secret => 'change_me'
|
||||
#
|
||||
# All parameters are optional.
|
||||
|
||||
class Cookie
|
||||
|
||||
def initialize(app, options={})
|
||||
@app = app
|
||||
@key = options[:key] || "rack.session"
|
||||
@secret = options[:secret]
|
||||
@default_options = {:domain => nil,
|
||||
:path => "/",
|
||||
:expire_after => nil}.merge(options)
|
||||
end
|
||||
|
||||
def call(env)
|
||||
load_session(env)
|
||||
status, headers, body = @app.call(env)
|
||||
commit_session(env, status, headers, body)
|
||||
end
|
||||
|
||||
private
|
||||
|
||||
def load_session(env)
|
||||
request = Rack::Request.new(env)
|
||||
session_data = request.cookies[@key]
|
||||
|
||||
if @secret && session_data
|
||||
session_data, digest = session_data.split("--")
|
||||
session_data = nil unless digest == generate_hmac(session_data)
|
||||
end
|
||||
|
||||
begin
|
||||
session_data = session_data.unpack("m*").first
|
||||
session_data = Marshal.load(session_data)
|
||||
env["rack.session"] = session_data
|
||||
rescue
|
||||
env["rack.session"] = Hash.new
|
||||
end
|
||||
|
||||
env["rack.session.options"] = @default_options.dup
|
||||
end
|
||||
|
||||
def commit_session(env, status, headers, body)
|
||||
session_data = Marshal.dump(env["rack.session"])
|
||||
session_data = [session_data].pack("m*")
|
||||
|
||||
if @secret
|
||||
session_data = "#{session_data}--#{generate_hmac(session_data)}"
|
||||
end
|
||||
|
||||
if session_data.size > (4096 - @key.size)
|
||||
env["rack.errors"].puts("Warning! Rack::Session::Cookie data size exceeds 4K. Content dropped.")
|
||||
[status, headers, body]
|
||||
else
|
||||
options = env["rack.session.options"]
|
||||
cookie = Hash.new
|
||||
cookie[:value] = session_data
|
||||
cookie[:expires] = Time.now + options[:expire_after] unless options[:expire_after].nil?
|
||||
response = Rack::Response.new(body, status, headers)
|
||||
response.set_cookie(@key, cookie.merge(options))
|
||||
response.to_a
|
||||
end
|
||||
end
|
||||
|
||||
def generate_hmac(data)
|
||||
OpenSSL::HMAC.hexdigest(OpenSSL::Digest::SHA1.new, @secret, data)
|
||||
end
|
||||
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,109 @@
|
|||
# AUTHOR: blink <blinketje@gmail.com>; blink#ruby-lang@irc.freenode.net
|
||||
|
||||
require 'rack/session/abstract/id'
|
||||
require 'memcache'
|
||||
|
||||
module Rack
|
||||
module Session
|
||||
# Rack::Session::Memcache provides simple cookie based session management.
|
||||
# Session data is stored in memcached. The corresponding session key is
|
||||
# maintained in the cookie.
|
||||
# You may treat Session::Memcache as you would Session::Pool with the
|
||||
# following caveats.
|
||||
#
|
||||
# * Setting :expire_after to 0 would note to the Memcache server to hang
|
||||
# onto the session data until it would drop it according to it's own
|
||||
# specifications. However, the cookie sent to the client would expire
|
||||
# immediately.
|
||||
#
|
||||
# Note that memcache does drop data before it may be listed to expire. For
|
||||
# a full description of behaviour, please see memcache's documentation.
|
||||
|
||||
class Memcache < Abstract::ID
|
||||
attr_reader :mutex, :pool
|
||||
DEFAULT_OPTIONS = Abstract::ID::DEFAULT_OPTIONS.merge \
|
||||
:namespace => 'rack:session',
|
||||
:memcache_server => 'localhost:11211'
|
||||
|
||||
def initialize(app, options={})
|
||||
super
|
||||
|
||||
@mutex = Mutex.new
|
||||
@pool = MemCache.
|
||||
new @default_options[:memcache_server], @default_options
|
||||
raise 'No memcache servers' unless @pool.servers.any?{|s|s.alive?}
|
||||
end
|
||||
|
||||
def generate_sid
|
||||
loop do
|
||||
sid = super
|
||||
break sid unless @pool.get(sid, true)
|
||||
end
|
||||
end
|
||||
|
||||
def get_session(env, sid)
|
||||
session = @pool.get(sid) if sid
|
||||
@mutex.lock if env['rack.multithread']
|
||||
unless sid and session
|
||||
env['rack.errors'].puts("Session '#{sid.inspect}' not found, initializing...") if $VERBOSE and not sid.nil?
|
||||
session = {}
|
||||
sid = generate_sid
|
||||
ret = @pool.add sid, session
|
||||
raise "Session collision on '#{sid.inspect}'" unless /^STORED/ =~ ret
|
||||
end
|
||||
session.instance_variable_set('@old', {}.merge(session))
|
||||
return [sid, session]
|
||||
rescue MemCache::MemCacheError, Errno::ECONNREFUSED # MemCache server cannot be contacted
|
||||
warn "#{self} is unable to find server."
|
||||
warn $!.inspect
|
||||
return [ nil, {} ]
|
||||
ensure
|
||||
@mutex.unlock if env['rack.multithread']
|
||||
end
|
||||
|
||||
def set_session(env, session_id, new_session, options)
|
||||
expiry = options[:expire_after]
|
||||
expiry = expiry.nil? ? 0 : expiry + 1
|
||||
|
||||
@mutex.lock if env['rack.multithread']
|
||||
session = @pool.get(session_id) || {}
|
||||
if options[:renew] or options[:drop]
|
||||
@pool.delete session_id
|
||||
return false if options[:drop]
|
||||
session_id = generate_sid
|
||||
@pool.add session_id, 0 # so we don't worry about cache miss on #set
|
||||
end
|
||||
old_session = new_session.instance_variable_get('@old') || {}
|
||||
session = merge_sessions session_id, old_session, new_session, session
|
||||
@pool.set session_id, session, expiry
|
||||
return session_id
|
||||
rescue MemCache::MemCacheError, Errno::ECONNREFUSED # MemCache server cannot be contacted
|
||||
warn "#{self} is unable to find server."
|
||||
warn $!.inspect
|
||||
return false
|
||||
ensure
|
||||
@mutex.unlock if env['rack.multithread']
|
||||
end
|
||||
|
||||
private
|
||||
|
||||
def merge_sessions sid, old, new, cur=nil
|
||||
cur ||= {}
|
||||
unless Hash === old and Hash === new
|
||||
warn 'Bad old or new sessions provided.'
|
||||
return cur
|
||||
end
|
||||
|
||||
delete = old.keys - new.keys
|
||||
warn "//@#{sid}: delete #{delete*','}" if $VERBOSE and not delete.empty?
|
||||
delete.each{|k| cur.delete k }
|
||||
|
||||
update = new.keys.select{|k| new[k] != old[k] }
|
||||
warn "//@#{sid}: update #{update*','}" if $VERBOSE and not update.empty?
|
||||
update.each{|k| cur[k] = new[k] }
|
||||
|
||||
cur
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,100 @@
|
|||
# AUTHOR: blink <blinketje@gmail.com>; blink#ruby-lang@irc.freenode.net
|
||||
# THANKS:
|
||||
# apeiros, for session id generation, expiry setup, and threadiness
|
||||
# sergio, threadiness and bugreps
|
||||
|
||||
require 'rack/session/abstract/id'
|
||||
require 'thread'
|
||||
|
||||
module Rack
|
||||
module Session
|
||||
# Rack::Session::Pool provides simple cookie based session management.
|
||||
# Session data is stored in a hash held by @pool.
|
||||
# In the context of a multithreaded environment, sessions being
|
||||
# committed to the pool is done in a merging manner.
|
||||
#
|
||||
# The :drop option is available in rack.session.options if you with to
|
||||
# explicitly remove the session from the session cache.
|
||||
#
|
||||
# Example:
|
||||
# myapp = MyRackApp.new
|
||||
# sessioned = Rack::Session::Pool.new(myapp,
|
||||
# :domain => 'foo.com',
|
||||
# :expire_after => 2592000
|
||||
# )
|
||||
# Rack::Handler::WEBrick.run sessioned
|
||||
|
||||
class Pool < Abstract::ID
|
||||
attr_reader :mutex, :pool
|
||||
DEFAULT_OPTIONS = Abstract::ID::DEFAULT_OPTIONS.merge :drop => false
|
||||
|
||||
def initialize(app, options={})
|
||||
super
|
||||
@pool = Hash.new
|
||||
@mutex = Mutex.new
|
||||
end
|
||||
|
||||
def generate_sid
|
||||
loop do
|
||||
sid = super
|
||||
break sid unless @pool.key? sid
|
||||
end
|
||||
end
|
||||
|
||||
def get_session(env, sid)
|
||||
session = @pool[sid] if sid
|
||||
@mutex.lock if env['rack.multithread']
|
||||
unless sid and session
|
||||
env['rack.errors'].puts("Session '#{sid.inspect}' not found, initializing...") if $VERBOSE and not sid.nil?
|
||||
session = {}
|
||||
sid = generate_sid
|
||||
@pool.store sid, session
|
||||
end
|
||||
session.instance_variable_set('@old', {}.merge(session))
|
||||
return [sid, session]
|
||||
ensure
|
||||
@mutex.unlock if env['rack.multithread']
|
||||
end
|
||||
|
||||
def set_session(env, session_id, new_session, options)
|
||||
@mutex.lock if env['rack.multithread']
|
||||
session = @pool[session_id]
|
||||
if options[:renew] or options[:drop]
|
||||
@pool.delete session_id
|
||||
return false if options[:drop]
|
||||
session_id = generate_sid
|
||||
@pool.store session_id, 0
|
||||
end
|
||||
old_session = new_session.instance_variable_get('@old') || {}
|
||||
session = merge_sessions session_id, old_session, new_session, session
|
||||
@pool.store session_id, session
|
||||
return session_id
|
||||
rescue
|
||||
warn "#{new_session.inspect} has been lost."
|
||||
warn $!.inspect
|
||||
ensure
|
||||
@mutex.unlock if env['rack.multithread']
|
||||
end
|
||||
|
||||
private
|
||||
|
||||
def merge_sessions sid, old, new, cur=nil
|
||||
cur ||= {}
|
||||
unless Hash === old and Hash === new
|
||||
warn 'Bad old or new sessions provided.'
|
||||
return cur
|
||||
end
|
||||
|
||||
delete = old.keys - new.keys
|
||||
warn "//@#{sid}: dropping #{delete*','}" if $DEBUG and not delete.empty?
|
||||
delete.each{|k| cur.delete k }
|
||||
|
||||
update = new.keys.select{|k| new[k] != old[k] }
|
||||
warn "//@#{sid}: updating #{update*','}" if $DEBUG and not update.empty?
|
||||
update.each{|k| cur[k] = new[k] }
|
||||
|
||||
cur
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,349 @@
|
|||
require 'ostruct'
|
||||
require 'erb'
|
||||
require 'rack/request'
|
||||
require 'rack/utils'
|
||||
|
||||
module Rack
|
||||
# Rack::ShowExceptions catches all exceptions raised from the app it
|
||||
# wraps. It shows a useful backtrace with the sourcefile and
|
||||
# clickable context, the whole Rack environment and the request
|
||||
# data.
|
||||
#
|
||||
# Be careful when you use this on public-facing sites as it could
|
||||
# reveal information helpful to attackers.
|
||||
|
||||
class ShowExceptions
|
||||
CONTEXT = 7
|
||||
|
||||
def initialize(app)
|
||||
@app = app
|
||||
@template = ERB.new(TEMPLATE)
|
||||
end
|
||||
|
||||
def call(env)
|
||||
@app.call(env)
|
||||
rescue StandardError, LoadError, SyntaxError => e
|
||||
backtrace = pretty(env, e)
|
||||
[500,
|
||||
{"Content-Type" => "text/html",
|
||||
"Content-Length" => backtrace.join.size.to_s},
|
||||
backtrace]
|
||||
end
|
||||
|
||||
def pretty(env, exception)
|
||||
req = Rack::Request.new(env)
|
||||
path = (req.script_name + req.path_info).squeeze("/")
|
||||
|
||||
frames = exception.backtrace.map { |line|
|
||||
frame = OpenStruct.new
|
||||
if line =~ /(.*?):(\d+)(:in `(.*)')?/
|
||||
frame.filename = $1
|
||||
frame.lineno = $2.to_i
|
||||
frame.function = $4
|
||||
|
||||
begin
|
||||
lineno = frame.lineno-1
|
||||
lines = ::File.readlines(frame.filename)
|
||||
frame.pre_context_lineno = [lineno-CONTEXT, 0].max
|
||||
frame.pre_context = lines[frame.pre_context_lineno...lineno]
|
||||
frame.context_line = lines[lineno].chomp
|
||||
frame.post_context_lineno = [lineno+CONTEXT, lines.size].min
|
||||
frame.post_context = lines[lineno+1..frame.post_context_lineno]
|
||||
rescue
|
||||
end
|
||||
|
||||
frame
|
||||
else
|
||||
nil
|
||||
end
|
||||
}.compact
|
||||
|
||||
env["rack.errors"].puts "#{exception.class}: #{exception.message}"
|
||||
env["rack.errors"].puts exception.backtrace.map { |l| "\t" + l }
|
||||
env["rack.errors"].flush
|
||||
|
||||
[@template.result(binding)]
|
||||
end
|
||||
|
||||
def h(obj) # :nodoc:
|
||||
case obj
|
||||
when String
|
||||
Utils.escape_html(obj)
|
||||
else
|
||||
Utils.escape_html(obj.inspect)
|
||||
end
|
||||
end
|
||||
|
||||
# :stopdoc:
|
||||
|
||||
# adapted from Django <djangoproject.com>
|
||||
# Copyright (c) 2005, the Lawrence Journal-World
|
||||
# Used under the modified BSD license:
|
||||
# http://www.xfree86.org/3.3.6/COPYRIGHT2.html#5
|
||||
TEMPLATE = <<'HTML'
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
||||
<meta name="robots" content="NONE,NOARCHIVE" />
|
||||
<title><%=h exception.class %> at <%=h path %></title>
|
||||
<style type="text/css">
|
||||
html * { padding:0; margin:0; }
|
||||
body * { padding:10px 20px; }
|
||||
body * * { padding:0; }
|
||||
body { font:small sans-serif; }
|
||||
body>div { border-bottom:1px solid #ddd; }
|
||||
h1 { font-weight:normal; }
|
||||
h2 { margin-bottom:.8em; }
|
||||
h2 span { font-size:80%; color:#666; font-weight:normal; }
|
||||
h3 { margin:1em 0 .5em 0; }
|
||||
h4 { margin:0 0 .5em 0; font-weight: normal; }
|
||||
table {
|
||||
border:1px solid #ccc; border-collapse: collapse; background:white; }
|
||||
tbody td, tbody th { vertical-align:top; padding:2px 3px; }
|
||||
thead th {
|
||||
padding:1px 6px 1px 3px; background:#fefefe; text-align:left;
|
||||
font-weight:normal; font-size:11px; border:1px solid #ddd; }
|
||||
tbody th { text-align:right; color:#666; padding-right:.5em; }
|
||||
table.vars { margin:5px 0 2px 40px; }
|
||||
table.vars td, table.req td { font-family:monospace; }
|
||||
table td.code { width:100%;}
|
||||
table td.code div { overflow:hidden; }
|
||||
table.source th { color:#666; }
|
||||
table.source td {
|
||||
font-family:monospace; white-space:pre; border-bottom:1px solid #eee; }
|
||||
ul.traceback { list-style-type:none; }
|
||||
ul.traceback li.frame { margin-bottom:1em; }
|
||||
div.context { margin: 10px 0; }
|
||||
div.context ol {
|
||||
padding-left:30px; margin:0 10px; list-style-position: inside; }
|
||||
div.context ol li {
|
||||
font-family:monospace; white-space:pre; color:#666; cursor:pointer; }
|
||||
div.context ol.context-line li { color:black; background-color:#ccc; }
|
||||
div.context ol.context-line li span { float: right; }
|
||||
div.commands { margin-left: 40px; }
|
||||
div.commands a { color:black; text-decoration:none; }
|
||||
#summary { background: #ffc; }
|
||||
#summary h2 { font-weight: normal; color: #666; }
|
||||
#summary ul#quicklinks { list-style-type: none; margin-bottom: 2em; }
|
||||
#summary ul#quicklinks li { float: left; padding: 0 1em; }
|
||||
#summary ul#quicklinks>li+li { border-left: 1px #666 solid; }
|
||||
#explanation { background:#eee; }
|
||||
#template, #template-not-exist { background:#f6f6f6; }
|
||||
#template-not-exist ul { margin: 0 0 0 20px; }
|
||||
#traceback { background:#eee; }
|
||||
#requestinfo { background:#f6f6f6; padding-left:120px; }
|
||||
#summary table { border:none; background:transparent; }
|
||||
#requestinfo h2, #requestinfo h3 { position:relative; margin-left:-100px; }
|
||||
#requestinfo h3 { margin-bottom:-1em; }
|
||||
.error { background: #ffc; }
|
||||
.specific { color:#cc3300; font-weight:bold; }
|
||||
</style>
|
||||
<script type="text/javascript">
|
||||
//<!--
|
||||
function getElementsByClassName(oElm, strTagName, strClassName){
|
||||
// Written by Jonathan Snook, http://www.snook.ca/jon;
|
||||
// Add-ons by Robert Nyman, http://www.robertnyman.com
|
||||
var arrElements = (strTagName == "*" && document.all)? document.all :
|
||||
oElm.getElementsByTagName(strTagName);
|
||||
var arrReturnElements = new Array();
|
||||
strClassName = strClassName.replace(/\-/g, "\\-");
|
||||
var oRegExp = new RegExp("(^|\\s)" + strClassName + "(\\s|$$)");
|
||||
var oElement;
|
||||
for(var i=0; i<arrElements.length; i++){
|
||||
oElement = arrElements[i];
|
||||
if(oRegExp.test(oElement.className)){
|
||||
arrReturnElements.push(oElement);
|
||||
}
|
||||
}
|
||||
return (arrReturnElements)
|
||||
}
|
||||
function hideAll(elems) {
|
||||
for (var e = 0; e < elems.length; e++) {
|
||||
elems[e].style.display = 'none';
|
||||
}
|
||||
}
|
||||
window.onload = function() {
|
||||
hideAll(getElementsByClassName(document, 'table', 'vars'));
|
||||
hideAll(getElementsByClassName(document, 'ol', 'pre-context'));
|
||||
hideAll(getElementsByClassName(document, 'ol', 'post-context'));
|
||||
}
|
||||
function toggle() {
|
||||
for (var i = 0; i < arguments.length; i++) {
|
||||
var e = document.getElementById(arguments[i]);
|
||||
if (e) {
|
||||
e.style.display = e.style.display == 'none' ? 'block' : 'none';
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
function varToggle(link, id) {
|
||||
toggle('v' + id);
|
||||
var s = link.getElementsByTagName('span')[0];
|
||||
var uarr = String.fromCharCode(0x25b6);
|
||||
var darr = String.fromCharCode(0x25bc);
|
||||
s.innerHTML = s.innerHTML == uarr ? darr : uarr;
|
||||
return false;
|
||||
}
|
||||
//-->
|
||||
</script>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div id="summary">
|
||||
<h1><%=h exception.class %> at <%=h path %></h1>
|
||||
<h2><%=h exception.message %></h2>
|
||||
<table><tr>
|
||||
<th>Ruby</th>
|
||||
<td><code><%=h frames.first.filename %></code>: in <code><%=h frames.first.function %></code>, line <%=h frames.first.lineno %></td>
|
||||
</tr><tr>
|
||||
<th>Web</th>
|
||||
<td><code><%=h req.request_method %> <%=h(req.host + path)%></code></td>
|
||||
</tr></table>
|
||||
|
||||
<h3>Jump to:</h3>
|
||||
<ul id="quicklinks">
|
||||
<li><a href="#get-info">GET</a></li>
|
||||
<li><a href="#post-info">POST</a></li>
|
||||
<li><a href="#cookie-info">Cookies</a></li>
|
||||
<li><a href="#env-info">ENV</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<div id="traceback">
|
||||
<h2>Traceback <span>(innermost first)</span></h2>
|
||||
<ul class="traceback">
|
||||
<% frames.each { |frame| %>
|
||||
<li class="frame">
|
||||
<code><%=h frame.filename %></code>: in <code><%=h frame.function %></code>
|
||||
|
||||
<% if frame.context_line %>
|
||||
<div class="context" id="c<%=h frame.object_id %>">
|
||||
<% if frame.pre_context %>
|
||||
<ol start="<%=h frame.pre_context_lineno+1 %>" class="pre-context" id="pre<%=h frame.object_id %>">
|
||||
<% frame.pre_context.each { |line| %>
|
||||
<li onclick="toggle('pre<%=h frame.object_id %>', 'post<%=h frame.object_id %>')"><%=h line %></li>
|
||||
<% } %>
|
||||
</ol>
|
||||
<% end %>
|
||||
|
||||
<ol start="<%=h frame.lineno %>" class="context-line">
|
||||
<li onclick="toggle('pre<%=h frame.object_id %>', 'post<%=h frame.object_id %>')"><%=h frame.context_line %><span>...</span></li></ol>
|
||||
|
||||
<% if frame.post_context %>
|
||||
<ol start='<%=h frame.lineno+1 %>' class="post-context" id="post<%=h frame.object_id %>">
|
||||
<% frame.post_context.each { |line| %>
|
||||
<li onclick="toggle('pre<%=h frame.object_id %>', 'post<%=h frame.object_id %>')"><%=h line %></li>
|
||||
<% } %>
|
||||
</ol>
|
||||
<% end %>
|
||||
</div>
|
||||
<% end %>
|
||||
</li>
|
||||
<% } %>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<div id="requestinfo">
|
||||
<h2>Request information</h2>
|
||||
|
||||
<h3 id="get-info">GET</h3>
|
||||
<% unless req.GET.empty? %>
|
||||
<table class="req">
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Variable</th>
|
||||
<th>Value</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<% req.GET.sort_by { |k, v| k.to_s }.each { |key, val| %>
|
||||
<tr>
|
||||
<td><%=h key %></td>
|
||||
<td class="code"><div><%=h val.inspect %></div></td>
|
||||
</tr>
|
||||
<% } %>
|
||||
</tbody>
|
||||
</table>
|
||||
<% else %>
|
||||
<p>No GET data.</p>
|
||||
<% end %>
|
||||
|
||||
<h3 id="post-info">POST</h3>
|
||||
<% unless req.POST.empty? %>
|
||||
<table class="req">
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Variable</th>
|
||||
<th>Value</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<% req.POST.sort_by { |k, v| k.to_s }.each { |key, val| %>
|
||||
<tr>
|
||||
<td><%=h key %></td>
|
||||
<td class="code"><div><%=h val.inspect %></div></td>
|
||||
</tr>
|
||||
<% } %>
|
||||
</tbody>
|
||||
</table>
|
||||
<% else %>
|
||||
<p>No POST data.</p>
|
||||
<% end %>
|
||||
|
||||
|
||||
<h3 id="cookie-info">COOKIES</h3>
|
||||
<% unless req.cookies.empty? %>
|
||||
<table class="req">
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Variable</th>
|
||||
<th>Value</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<% req.cookies.each { |key, val| %>
|
||||
<tr>
|
||||
<td><%=h key %></td>
|
||||
<td class="code"><div><%=h val.inspect %></div></td>
|
||||
</tr>
|
||||
<% } %>
|
||||
</tbody>
|
||||
</table>
|
||||
<% else %>
|
||||
<p>No cookie data.</p>
|
||||
<% end %>
|
||||
|
||||
<h3 id="env-info">Rack ENV</h3>
|
||||
<table class="req">
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Variable</th>
|
||||
<th>Value</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<% env.sort_by { |k, v| k.to_s }.each { |key, val| %>
|
||||
<tr>
|
||||
<td><%=h key %></td>
|
||||
<td class="code"><div><%=h val %></div></td>
|
||||
</tr>
|
||||
<% } %>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
</div>
|
||||
|
||||
<div id="explanation">
|
||||
<p>
|
||||
You're seeing this error because you use <code>Rack::ShowExceptions</code>.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
HTML
|
||||
|
||||
# :startdoc:
|
||||
end
|
||||
end
|
|
@ -0,0 +1,106 @@
|
|||
require 'erb'
|
||||
require 'rack/request'
|
||||
require 'rack/utils'
|
||||
|
||||
module Rack
|
||||
# Rack::ShowStatus catches all empty responses the app it wraps and
|
||||
# replaces them with a site explaining the error.
|
||||
#
|
||||
# Additional details can be put into <tt>rack.showstatus.detail</tt>
|
||||
# and will be shown as HTML. If such details exist, the error page
|
||||
# is always rendered, even if the reply was not empty.
|
||||
|
||||
class ShowStatus
|
||||
def initialize(app)
|
||||
@app = app
|
||||
@template = ERB.new(TEMPLATE)
|
||||
end
|
||||
|
||||
def call(env)
|
||||
status, headers, body = @app.call(env)
|
||||
headers = Utils::HeaderHash.new(headers)
|
||||
empty = headers['Content-Length'].to_i <= 0
|
||||
|
||||
# client or server error, or explicit message
|
||||
if (status.to_i >= 400 && empty) || env["rack.showstatus.detail"]
|
||||
req = Rack::Request.new(env)
|
||||
message = Rack::Utils::HTTP_STATUS_CODES[status.to_i] || status.to_s
|
||||
detail = env["rack.showstatus.detail"] || message
|
||||
body = @template.result(binding)
|
||||
size = Rack::Utils.bytesize(body)
|
||||
[status, headers.merge("Content-Type" => "text/html", "Content-Length" => size.to_s), [body]]
|
||||
else
|
||||
[status, headers, body]
|
||||
end
|
||||
end
|
||||
|
||||
def h(obj) # :nodoc:
|
||||
case obj
|
||||
when String
|
||||
Utils.escape_html(obj)
|
||||
else
|
||||
Utils.escape_html(obj.inspect)
|
||||
end
|
||||
end
|
||||
|
||||
# :stopdoc:
|
||||
|
||||
# adapted from Django <djangoproject.com>
|
||||
# Copyright (c) 2005, the Lawrence Journal-World
|
||||
# Used under the modified BSD license:
|
||||
# http://www.xfree86.org/3.3.6/COPYRIGHT2.html#5
|
||||
TEMPLATE = <<'HTML'
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
||||
<title><%=h message %> at <%=h req.script_name + req.path_info %></title>
|
||||
<meta name="robots" content="NONE,NOARCHIVE" />
|
||||
<style type="text/css">
|
||||
html * { padding:0; margin:0; }
|
||||
body * { padding:10px 20px; }
|
||||
body * * { padding:0; }
|
||||
body { font:small sans-serif; background:#eee; }
|
||||
body>div { border-bottom:1px solid #ddd; }
|
||||
h1 { font-weight:normal; margin-bottom:.4em; }
|
||||
h1 span { font-size:60%; color:#666; font-weight:normal; }
|
||||
table { border:none; border-collapse: collapse; width:100%; }
|
||||
td, th { vertical-align:top; padding:2px 3px; }
|
||||
th { width:12em; text-align:right; color:#666; padding-right:.5em; }
|
||||
#info { background:#f6f6f6; }
|
||||
#info ol { margin: 0.5em 4em; }
|
||||
#info ol li { font-family: monospace; }
|
||||
#summary { background: #ffc; }
|
||||
#explanation { background:#eee; border-bottom: 0px none; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div id="summary">
|
||||
<h1><%=h message %> <span>(<%= status.to_i %>)</span></h1>
|
||||
<table class="meta">
|
||||
<tr>
|
||||
<th>Request Method:</th>
|
||||
<td><%=h req.request_method %></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th>Request URL:</th>
|
||||
<td><%=h req.url %></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
<div id="info">
|
||||
<p><%= detail %></p>
|
||||
</div>
|
||||
|
||||
<div id="explanation">
|
||||
<p>
|
||||
You're seeing this error because you use <code>Rack::ShowStatus</code>.
|
||||
</p>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
HTML
|
||||
|
||||
# :startdoc:
|
||||
end
|
||||
end
|
|
@ -0,0 +1,38 @@
|
|||
module Rack
|
||||
|
||||
# The Rack::Static middleware intercepts requests for static files
|
||||
# (javascript files, images, stylesheets, etc) based on the url prefixes
|
||||
# passed in the options, and serves them using a Rack::File object. This
|
||||
# allows a Rack stack to serve both static and dynamic content.
|
||||
#
|
||||
# Examples:
|
||||
# use Rack::Static, :urls => ["/media"]
|
||||
# will serve all requests beginning with /media from the "media" folder
|
||||
# located in the current directory (ie media/*).
|
||||
#
|
||||
# use Rack::Static, :urls => ["/css", "/images"], :root => "public"
|
||||
# will serve all requests beginning with /css or /images from the folder
|
||||
# "public" in the current directory (ie public/css/* and public/images/*)
|
||||
|
||||
class Static
|
||||
|
||||
def initialize(app, options={})
|
||||
@app = app
|
||||
@urls = options[:urls] || ["/favicon.ico"]
|
||||
root = options[:root] || Dir.pwd
|
||||
@file_server = Rack::File.new(root)
|
||||
end
|
||||
|
||||
def call(env)
|
||||
path = env["PATH_INFO"]
|
||||
can_serve = @urls.any? { |url| path.index(url) == 0 }
|
||||
|
||||
if can_serve
|
||||
@file_server.call(env)
|
||||
else
|
||||
@app.call(env)
|
||||
end
|
||||
end
|
||||
|
||||
end
|
||||
end
|
|
@ -0,0 +1,55 @@
|
|||
module Rack
|
||||
# Rack::URLMap takes a hash mapping urls or paths to apps, and
|
||||
# dispatches accordingly. Support for HTTP/1.1 host names exists if
|
||||
# the URLs start with <tt>http://</tt> or <tt>https://</tt>.
|
||||
#
|
||||
# URLMap modifies the SCRIPT_NAME and PATH_INFO such that the part
|
||||
# relevant for dispatch is in the SCRIPT_NAME, and the rest in the
|
||||
# PATH_INFO. This should be taken care of when you need to
|
||||
# reconstruct the URL in order to create links.
|
||||
#
|
||||
# URLMap dispatches in such a way that the longest paths are tried
|
||||
# first, since they are most specific.
|
||||
|
||||
class URLMap
|
||||
def initialize(map = {})
|
||||
remap(map)
|
||||
end
|
||||
|
||||
def remap(map)
|
||||
@mapping = map.map { |location, app|
|
||||
if location =~ %r{\Ahttps?://(.*?)(/.*)}
|
||||
host, location = $1, $2
|
||||
else
|
||||
host = nil
|
||||
end
|
||||
|
||||
unless location[0] == ?/
|
||||
raise ArgumentError, "paths need to start with /"
|
||||
end
|
||||
location = location.chomp('/')
|
||||
|
||||
[host, location, app]
|
||||
}.sort_by { |(h, l, a)| [h ? -h.size : (-1.0 / 0.0), -l.size] } # Longest path first
|
||||
end
|
||||
|
||||
def call(env)
|
||||
path = env["PATH_INFO"].to_s.squeeze("/")
|
||||
script_name = env['SCRIPT_NAME']
|
||||
hHost, sName, sPort = env.values_at('HTTP_HOST','SERVER_NAME','SERVER_PORT')
|
||||
@mapping.each { |host, location, app|
|
||||
next unless (hHost == host || sName == host \
|
||||
|| (host.nil? && (hHost == sName || hHost == sName+':'+sPort)))
|
||||
next unless location == path[0, location.size]
|
||||
next unless path[location.size] == nil || path[location.size] == ?/
|
||||
|
||||
return app.call(
|
||||
env.merge(
|
||||
'SCRIPT_NAME' => (script_name + location),
|
||||
'PATH_INFO' => path[location.size..-1]))
|
||||
}
|
||||
[404, {"Content-Type" => "text/plain"}, ["Not Found: #{path}"]]
|
||||
end
|
||||
end
|
||||
end
|
||||
|
|
@ -0,0 +1,401 @@
|
|||
# -*- encoding: binary -*-
|
||||
|
||||
require 'set'
|
||||
require 'tempfile'
|
||||
|
||||
module Rack
|
||||
# Rack::Utils contains a grab-bag of useful methods for writing web
|
||||
# applications adopted from all kinds of Ruby libraries.
|
||||
|
||||
module Utils
|
||||
# Performs URI escaping so that you can construct proper
|
||||
# query strings faster. Use this rather than the cgi.rb
|
||||
# version since it's faster. (Stolen from Camping).
|
||||
def escape(s)
|
||||
s.to_s.gsub(/([^ a-zA-Z0-9_.-]+)/n) {
|
||||
'%'+$1.unpack('H2'*bytesize($1)).join('%').upcase
|
||||
}.tr(' ', '+')
|
||||
end
|
||||
module_function :escape
|
||||
|
||||
# Unescapes a URI escaped string. (Stolen from Camping).
|
||||
def unescape(s)
|
||||
s.tr('+', ' ').gsub(/((?:%[0-9a-fA-F]{2})+)/n){
|
||||
[$1.delete('%')].pack('H*')
|
||||
}
|
||||
end
|
||||
module_function :unescape
|
||||
|
||||
DEFAULT_SEP = /[&;] */n
|
||||
|
||||
# Stolen from Mongrel, with some small modifications:
|
||||
# Parses a query string by breaking it up at the '&'
|
||||
# and ';' characters. You can also use this to parse
|
||||
# cookies by changing the characters used in the second
|
||||
# parameter (which defaults to '&;').
|
||||
def parse_query(qs, d = nil)
|
||||
params = {}
|
||||
|
||||
(qs || '').split(d ? /[#{d}] */n : DEFAULT_SEP).each do |p|
|
||||
k, v = p.split('=', 2).map { |x| unescape(x) }
|
||||
|
||||
if cur = params[k]
|
||||
if cur.class == Array
|
||||
params[k] << v
|
||||
else
|
||||
params[k] = [cur, v]
|
||||
end
|
||||
else
|
||||
params[k] = v
|
||||
end
|
||||
end
|
||||
|
||||
return params
|
||||
end
|
||||
module_function :parse_query
|
||||
|
||||
def parse_nested_query(qs, d = nil)
|
||||
params = {}
|
||||
|
||||
(qs || '').split(d ? /[#{d}] */n : DEFAULT_SEP).each do |p|
|
||||
k, v = unescape(p).split('=', 2)
|
||||
normalize_params(params, k, v)
|
||||
end
|
||||
|
||||
return params
|
||||
end
|
||||
module_function :parse_nested_query
|
||||
|
||||
def normalize_params(params, name, v = nil)
|
||||
name =~ %r(\A[\[\]]*([^\[\]]+)\]*)
|
||||
k = $1 || ''
|
||||
after = $' || ''
|
||||
|
||||
return if k.empty?
|
||||
|
||||
if after == ""
|
||||
params[k] = v
|
||||
elsif after == "[]"
|
||||
params[k] ||= []
|
||||
raise TypeError, "expected Array (got #{params[k].class.name}) for param `#{k}'" unless params[k].is_a?(Array)
|
||||
params[k] << v
|
||||
elsif after =~ %r(^\[\]\[([^\[\]]+)\]$) || after =~ %r(^\[\](.+)$)
|
||||
child_key = $1
|
||||
params[k] ||= []
|
||||
raise TypeError, "expected Array (got #{params[k].class.name}) for param `#{k}'" unless params[k].is_a?(Array)
|
||||
if params[k].last.is_a?(Hash) && !params[k].last.key?(child_key)
|
||||
normalize_params(params[k].last, child_key, v)
|
||||
else
|
||||
params[k] << normalize_params({}, child_key, v)
|
||||
end
|
||||
else
|
||||
params[k] ||= {}
|
||||
raise TypeError, "expected Hash (got #{params[k].class.name}) for param `#{k}'" unless params[k].is_a?(Hash)
|
||||
params[k] = normalize_params(params[k], after, v)
|
||||
end
|
||||
|
||||
return params
|
||||
end
|
||||
module_function :normalize_params
|
||||
|
||||
def build_query(params)
|
||||
params.map { |k, v|
|
||||
if v.class == Array
|
||||
build_query(v.map { |x| [k, x] })
|
||||
else
|
||||
"#{escape(k)}=#{escape(v)}"
|
||||
end
|
||||
}.join("&")
|
||||
end
|
||||
module_function :build_query
|
||||
|
||||
# Escape ampersands, brackets and quotes to their HTML/XML entities.
|
||||
def escape_html(string)
|
||||
string.to_s.gsub("&", "&").
|
||||
gsub("<", "<").
|
||||
gsub(">", ">").
|
||||
gsub("'", "'").
|
||||
gsub('"', """)
|
||||
end
|
||||
module_function :escape_html
|
||||
|
||||
def select_best_encoding(available_encodings, accept_encoding)
|
||||
# http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html
|
||||
|
||||
expanded_accept_encoding =
|
||||
accept_encoding.map { |m, q|
|
||||
if m == "*"
|
||||
(available_encodings - accept_encoding.map { |m2, _| m2 }).map { |m2| [m2, q] }
|
||||
else
|
||||
[[m, q]]
|
||||
end
|
||||
}.inject([]) { |mem, list|
|
||||
mem + list
|
||||
}
|
||||
|
||||
encoding_candidates = expanded_accept_encoding.sort_by { |_, q| -q }.map { |m, _| m }
|
||||
|
||||
unless encoding_candidates.include?("identity")
|
||||
encoding_candidates.push("identity")
|
||||
end
|
||||
|
||||
expanded_accept_encoding.find_all { |m, q|
|
||||
q == 0.0
|
||||
}.each { |m, _|
|
||||
encoding_candidates.delete(m)
|
||||
}
|
||||
|
||||
return (encoding_candidates & available_encodings)[0]
|
||||
end
|
||||
module_function :select_best_encoding
|
||||
|
||||
# Return the bytesize of String; uses String#length under Ruby 1.8 and
|
||||
# String#bytesize under 1.9.
|
||||
if ''.respond_to?(:bytesize)
|
||||
def bytesize(string)
|
||||
string.bytesize
|
||||
end
|
||||
else
|
||||
def bytesize(string)
|
||||
string.size
|
||||
end
|
||||
end
|
||||
module_function :bytesize
|
||||
|
||||
# Context allows the use of a compatible middleware at different points
|
||||
# in a request handling stack. A compatible middleware must define
|
||||
# #context which should take the arguments env and app. The first of which
|
||||
# would be the request environment. The second of which would be the rack
|
||||
# application that the request would be forwarded to.
|
||||
class Context
|
||||
attr_reader :for, :app
|
||||
|
||||
def initialize(app_f, app_r)
|
||||
raise 'running context does not respond to #context' unless app_f.respond_to? :context
|
||||
@for, @app = app_f, app_r
|
||||
end
|
||||
|
||||
def call(env)
|
||||
@for.context(env, @app)
|
||||
end
|
||||
|
||||
def recontext(app)
|
||||
self.class.new(@for, app)
|
||||
end
|
||||
|
||||
def context(env, app=@app)
|
||||
recontext(app).call(env)
|
||||
end
|
||||
end
|
||||
|
||||
# A case-insensitive Hash that preserves the original case of a
|
||||
# header when set.
|
||||
class HeaderHash < Hash
|
||||
def initialize(hash={})
|
||||
@names = {}
|
||||
hash.each { |k, v| self[k] = v }
|
||||
end
|
||||
|
||||
def to_hash
|
||||
inject({}) do |hash, (k,v)|
|
||||
if v.respond_to? :to_ary
|
||||
hash[k] = v.to_ary.join("\n")
|
||||
else
|
||||
hash[k] = v
|
||||
end
|
||||
hash
|
||||
end
|
||||
end
|
||||
|
||||
def [](k)
|
||||
super @names[k.downcase]
|
||||
end
|
||||
|
||||
def []=(k, v)
|
||||
delete k
|
||||
@names[k.downcase] = k
|
||||
super k, v
|
||||
end
|
||||
|
||||
def delete(k)
|
||||
super @names.delete(k.downcase)
|
||||
end
|
||||
|
||||
def include?(k)
|
||||
@names.has_key? k.downcase
|
||||
end
|
||||
|
||||
alias_method :has_key?, :include?
|
||||
alias_method :member?, :include?
|
||||
alias_method :key?, :include?
|
||||
|
||||
def merge!(other)
|
||||
other.each { |k, v| self[k] = v }
|
||||
self
|
||||
end
|
||||
|
||||
def merge(other)
|
||||
hash = dup
|
||||
hash.merge! other
|
||||
end
|
||||
end
|
||||
|
||||
# Every standard HTTP code mapped to the appropriate message.
|
||||
# Stolen from Mongrel.
|
||||
HTTP_STATUS_CODES = {
|
||||
100 => 'Continue',
|
||||
101 => 'Switching Protocols',
|
||||
200 => 'OK',
|
||||
201 => 'Created',
|
||||
202 => 'Accepted',
|
||||
203 => 'Non-Authoritative Information',
|
||||
204 => 'No Content',
|
||||
205 => 'Reset Content',
|
||||
206 => 'Partial Content',
|
||||
300 => 'Multiple Choices',
|
||||
301 => 'Moved Permanently',
|
||||
302 => 'Found',
|
||||
303 => 'See Other',
|
||||
304 => 'Not Modified',
|
||||
305 => 'Use Proxy',
|
||||
307 => 'Temporary Redirect',
|
||||
400 => 'Bad Request',
|
||||
401 => 'Unauthorized',
|
||||
402 => 'Payment Required',
|
||||
403 => 'Forbidden',
|
||||
404 => 'Not Found',
|
||||
405 => 'Method Not Allowed',
|
||||
406 => 'Not Acceptable',
|
||||
407 => 'Proxy Authentication Required',
|
||||
408 => 'Request Timeout',
|
||||
409 => 'Conflict',
|
||||
410 => 'Gone',
|
||||
411 => 'Length Required',
|
||||
412 => 'Precondition Failed',
|
||||
413 => 'Request Entity Too Large',
|
||||
414 => 'Request-URI Too Large',
|
||||
415 => 'Unsupported Media Type',
|
||||
416 => 'Requested Range Not Satisfiable',
|
||||
417 => 'Expectation Failed',
|
||||
500 => 'Internal Server Error',
|
||||
501 => 'Not Implemented',
|
||||
502 => 'Bad Gateway',
|
||||
503 => 'Service Unavailable',
|
||||
504 => 'Gateway Timeout',
|
||||
505 => 'HTTP Version Not Supported'
|
||||
}
|
||||
|
||||
# Responses with HTTP status codes that should not have an entity body
|
||||
STATUS_WITH_NO_ENTITY_BODY = Set.new((100..199).to_a << 204 << 304)
|
||||
|
||||
# A multipart form data parser, adapted from IOWA.
|
||||
#
|
||||
# Usually, Rack::Request#POST takes care of calling this.
|
||||
|
||||
module Multipart
|
||||
EOL = "\r\n"
|
||||
|
||||
def self.parse_multipart(env)
|
||||
unless env['CONTENT_TYPE'] =~
|
||||
%r|\Amultipart/.*boundary=\"?([^\";,]+)\"?|n
|
||||
nil
|
||||
else
|
||||
boundary = "--#{$1}"
|
||||
|
||||
params = {}
|
||||
buf = ""
|
||||
content_length = env['CONTENT_LENGTH'].to_i
|
||||
input = env['rack.input']
|
||||
input.rewind
|
||||
|
||||
boundary_size = Utils.bytesize(boundary) + EOL.size
|
||||
bufsize = 16384
|
||||
|
||||
content_length -= boundary_size
|
||||
|
||||
read_buffer = ''
|
||||
|
||||
status = input.read(boundary_size, read_buffer)
|
||||
raise EOFError, "bad content body" unless status == boundary + EOL
|
||||
|
||||
rx = /(?:#{EOL})?#{Regexp.quote boundary}(#{EOL}|--)/n
|
||||
|
||||
loop {
|
||||
head = nil
|
||||
body = ''
|
||||
filename = content_type = name = nil
|
||||
|
||||
until head && buf =~ rx
|
||||
if !head && i = buf.index(EOL+EOL)
|
||||
head = buf.slice!(0, i+2) # First \r\n
|
||||
buf.slice!(0, 2) # Second \r\n
|
||||
|
||||
filename = head[/Content-Disposition:.* filename=(?:"((?:\\.|[^\"])*)"|([^;\s]*))/ni, 1]
|
||||
content_type = head[/Content-Type: (.*)#{EOL}/ni, 1]
|
||||
name = head[/Content-Disposition:.*\s+name="?([^\";]*)"?/ni, 1] || head[/Content-ID:\s*([^#{EOL}]*)/ni, 1]
|
||||
|
||||
if content_type || filename
|
||||
body = Tempfile.new("RackMultipart")
|
||||
body.binmode if body.respond_to?(:binmode)
|
||||
end
|
||||
|
||||
next
|
||||
end
|
||||
|
||||
# Save the read body part.
|
||||
if head && (boundary_size+4 < buf.size)
|
||||
body << buf.slice!(0, buf.size - (boundary_size+4))
|
||||
end
|
||||
|
||||
c = input.read(bufsize < content_length ? bufsize : content_length, read_buffer)
|
||||
raise EOFError, "bad content body" if c.nil? || c.empty?
|
||||
buf << c
|
||||
content_length -= c.size
|
||||
end
|
||||
|
||||
# Save the rest.
|
||||
if i = buf.index(rx)
|
||||
body << buf.slice!(0, i)
|
||||
buf.slice!(0, boundary_size+2)
|
||||
|
||||
content_length = -1 if $1 == "--"
|
||||
end
|
||||
|
||||
if filename == ""
|
||||
# filename is blank which means no file has been selected
|
||||
data = nil
|
||||
elsif filename
|
||||
body.rewind
|
||||
|
||||
# Take the basename of the upload's original filename.
|
||||
# This handles the full Windows paths given by Internet Explorer
|
||||
# (and perhaps other broken user agents) without affecting
|
||||
# those which give the lone filename.
|
||||
filename =~ /^(?:.*[:\\\/])?(.*)/m
|
||||
filename = $1
|
||||
|
||||
data = {:filename => filename, :type => content_type,
|
||||
:name => name, :tempfile => body, :head => head}
|
||||
elsif !filename && content_type
|
||||
body.rewind
|
||||
|
||||
# Generic multipart cases, not coming from a form
|
||||
data = {:type => content_type,
|
||||
:name => name, :tempfile => body, :head => head}
|
||||
else
|
||||
data = body
|
||||
end
|
||||
|
||||
Utils.normalize_params(params, name, data) unless data.nil?
|
||||
|
||||
break if buf.empty? || content_length == -1
|
||||
}
|
||||
|
||||
input.rewind
|
||||
|
||||
params
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
|
@ -0,0 +1,54 @@
|
|||
# -*- encoding: utf-8 -*-
|
||||
|
||||
Gem::Specification.new do |s|
|
||||
s.name = %q{rack}
|
||||
s.version = "1.0.1"
|
||||
|
||||
s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
|
||||
s.authors = ["Christian Neukirchen"]
|
||||
s.date = %q{2009-10-18}
|
||||
s.default_executable = %q{rackup}
|
||||
s.description = %q{Rack provides minimal, modular and adaptable interface for developing web applications in Ruby. By wrapping HTTP requests and responses in the simplest way possible, it unifies and distills the API for web servers, web frameworks, and software in between (the so-called middleware) into a single method call. Also see http://rack.rubyforge.org.}
|
||||
s.email = %q{chneukirchen@gmail.com}
|
||||
s.executables = ["rackup"]
|
||||
s.extra_rdoc_files = ["README", "SPEC", "RDOX", "KNOWN-ISSUES"]
|
||||
s.files = ["COPYING", "KNOWN-ISSUES", "README", "Rakefile", "bin/rackup", "contrib/rack_logo.svg", "example/lobster.ru", "example/protectedlobster.rb", "example/protectedlobster.ru", "lib/rack.rb", "lib/rack/adapter/camping.rb", "lib/rack/auth/abstract/handler.rb", "lib/rack/auth/abstract/request.rb", "lib/rack/auth/basic.rb", "lib/rack/auth/digest/md5.rb", "lib/rack/auth/digest/nonce.rb", "lib/rack/auth/digest/params.rb", "lib/rack/auth/digest/request.rb", "lib/rack/auth/openid.rb", "lib/rack/builder.rb", "lib/rack/cascade.rb", "lib/rack/chunked.rb", "lib/rack/commonlogger.rb", "lib/rack/conditionalget.rb", "lib/rack/content_length.rb", "lib/rack/content_type.rb", "lib/rack/deflater.rb", "lib/rack/directory.rb", "lib/rack/file.rb", "lib/rack/handler.rb", "lib/rack/handler/cgi.rb", "lib/rack/handler/evented_mongrel.rb", "lib/rack/handler/fastcgi.rb", "lib/rack/handler/lsws.rb", "lib/rack/handler/mongrel.rb", "lib/rack/handler/scgi.rb", "lib/rack/handler/swiftiplied_mongrel.rb", "lib/rack/handler/thin.rb", "lib/rack/handler/webrick.rb", "lib/rack/head.rb", "lib/rack/lint.rb", "lib/rack/lobster.rb", "lib/rack/lock.rb", "lib/rack/methodoverride.rb", "lib/rack/mime.rb", "lib/rack/mock.rb", "lib/rack/recursive.rb", "lib/rack/reloader.rb", "lib/rack/request.rb", "lib/rack/response.rb", "lib/rack/rewindable_input.rb", "lib/rack/session/abstract/id.rb", "lib/rack/session/cookie.rb", "lib/rack/session/memcache.rb", "lib/rack/session/pool.rb", "lib/rack/showexceptions.rb", "lib/rack/showstatus.rb", "lib/rack/static.rb", "lib/rack/urlmap.rb", "lib/rack/utils.rb", "test/cgi/lighttpd.conf", "test/cgi/test", "test/cgi/test.fcgi", "test/cgi/test.ru", "test/multipart/binary", "test/multipart/empty", "test/multipart/ie", "test/multipart/nested", "test/multipart/none", "test/multipart/semicolon", "test/multipart/text", "test/spec_rack_auth_basic.rb", "test/spec_rack_auth_digest.rb", "test/spec_rack_auth_openid.rb", "test/spec_rack_builder.rb", "test/spec_rack_camping.rb", "test/spec_rack_cascade.rb", "test/spec_rack_cgi.rb", "test/spec_rack_chunked.rb", "test/spec_rack_commonlogger.rb", "test/spec_rack_conditionalget.rb", "test/spec_rack_content_length.rb", "test/spec_rack_content_type.rb", "test/spec_rack_deflater.rb", "test/spec_rack_directory.rb", "test/spec_rack_fastcgi.rb", "test/spec_rack_file.rb", "test/spec_rack_handler.rb", "test/spec_rack_head.rb", "test/spec_rack_lint.rb", "test/spec_rack_lobster.rb", "test/spec_rack_lock.rb", "test/spec_rack_methodoverride.rb", "test/spec_rack_mock.rb", "test/spec_rack_mongrel.rb", "test/spec_rack_recursive.rb", "test/spec_rack_request.rb", "test/spec_rack_response.rb", "test/spec_rack_rewindable_input.rb", "test/spec_rack_session_cookie.rb", "test/spec_rack_session_memcache.rb", "test/spec_rack_session_pool.rb", "test/spec_rack_showexceptions.rb", "test/spec_rack_showstatus.rb", "test/spec_rack_static.rb", "test/spec_rack_thin.rb", "test/spec_rack_urlmap.rb", "test/spec_rack_utils.rb", "test/spec_rack_webrick.rb", "test/testrequest.rb", "test/unregistered_handler/rack/handler/unregistered.rb", "test/unregistered_handler/rack/handler/unregistered_long_one.rb", "SPEC", "RDOX", "rack.gemspec"]
|
||||
s.has_rdoc = true
|
||||
s.homepage = %q{http://rack.rubyforge.org}
|
||||
s.require_paths = ["lib"]
|
||||
s.rubyforge_project = %q{rack}
|
||||
s.rubygems_version = %q{1.3.1}
|
||||
s.summary = %q{a modular Ruby webserver interface}
|
||||
s.test_files = ["test/spec_rack_auth_basic.rb", "test/spec_rack_auth_digest.rb", "test/spec_rack_auth_openid.rb", "test/spec_rack_builder.rb", "test/spec_rack_camping.rb", "test/spec_rack_cascade.rb", "test/spec_rack_cgi.rb", "test/spec_rack_chunked.rb", "test/spec_rack_commonlogger.rb", "test/spec_rack_conditionalget.rb", "test/spec_rack_content_length.rb", "test/spec_rack_content_type.rb", "test/spec_rack_deflater.rb", "test/spec_rack_directory.rb", "test/spec_rack_fastcgi.rb", "test/spec_rack_file.rb", "test/spec_rack_handler.rb", "test/spec_rack_head.rb", "test/spec_rack_lint.rb", "test/spec_rack_lobster.rb", "test/spec_rack_lock.rb", "test/spec_rack_methodoverride.rb", "test/spec_rack_mock.rb", "test/spec_rack_mongrel.rb", "test/spec_rack_recursive.rb", "test/spec_rack_request.rb", "test/spec_rack_response.rb", "test/spec_rack_rewindable_input.rb", "test/spec_rack_session_cookie.rb", "test/spec_rack_session_memcache.rb", "test/spec_rack_session_pool.rb", "test/spec_rack_showexceptions.rb", "test/spec_rack_showstatus.rb", "test/spec_rack_static.rb", "test/spec_rack_thin.rb", "test/spec_rack_urlmap.rb", "test/spec_rack_utils.rb", "test/spec_rack_webrick.rb"]
|
||||
|
||||
if s.respond_to? :specification_version then
|
||||
current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
|
||||
s.specification_version = 2
|
||||
|
||||
if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
|
||||
s.add_development_dependency(%q<test-spec>, [">= 0"])
|
||||
s.add_development_dependency(%q<camping>, [">= 0"])
|
||||
s.add_development_dependency(%q<fcgi>, [">= 0"])
|
||||
s.add_development_dependency(%q<memcache-client>, [">= 0"])
|
||||
s.add_development_dependency(%q<mongrel>, [">= 0"])
|
||||
s.add_development_dependency(%q<ruby-openid>, ["~> 2.0.0"])
|
||||
s.add_development_dependency(%q<thin>, [">= 0"])
|
||||
else
|
||||
s.add_dependency(%q<test-spec>, [">= 0"])
|
||||
s.add_dependency(%q<camping>, [">= 0"])
|
||||
s.add_dependency(%q<fcgi>, [">= 0"])
|
||||
s.add_dependency(%q<memcache-client>, [">= 0"])
|
||||
s.add_dependency(%q<mongrel>, [">= 0"])
|
||||
s.add_dependency(%q<ruby-openid>, ["~> 2.0.0"])
|
||||
s.add_dependency(%q<thin>, [">= 0"])
|
||||
end
|
||||
else
|
||||
s.add_dependency(%q<test-spec>, [">= 0"])
|
||||
s.add_dependency(%q<camping>, [">= 0"])
|
||||
s.add_dependency(%q<fcgi>, [">= 0"])
|
||||
s.add_dependency(%q<memcache-client>, [">= 0"])
|
||||
s.add_dependency(%q<mongrel>, [">= 0"])
|
||||
s.add_dependency(%q<ruby-openid>, ["~> 2.0.0"])
|
||||
s.add_dependency(%q<thin>, [">= 0"])
|
||||
end
|
||||
end
|
Loading…
Reference in New Issue