rack 1.0.1 → 1.1.0

data/COPYING

@@ -1,4 +1,4 @@
-Copyright (c) 2007, 2008, 2009 Christian Neukirchen <purl.org/net/chneukirchen>
+Copyright (c) 2007, 2008, 2009, 2010 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

data/KNOWN-ISSUES

@@ -16,3 +16,6 @@
     end
 
   Of course, use this only when your app runs at "/".
+
+  Since lighttpd 1.4.23, you also can use the "fix-root-scriptname" flag
+  in fastcgi.server.

data/RDOX

@@ -1,428 +0,0 @@
-
-== 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

data/README

@@ -11,21 +11,13 @@ 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.
+With Rack 1.1, the Rack specification (found in SPEC) changed in the
+following backward-incompatible ways.
+
+* Rack::VERSION has been pushed to [1,1].
+* rack.logger is now specified.
+* The SPEC now allows subclasses of the required types.
+* rack.input has to be opened in binary mode.
 
 == Supported web servers
 
@@ -43,8 +35,11 @@ The included *handlers* connect all kinds of web servers to Rack:
 These web servers include Rack handlers in their distributions:
 * Ebb
 * Fuzed
+* Glassfish v3
 * Phusion Passenger (which is mod_rack for Apache and for nginx)
+* Rainbows!
 * Unicorn
+* Zbatery
 
 Any valid Rack app will run the same on all these handlers, without
 changing anything.
@@ -70,6 +65,7 @@ These frameworks include Rack adapters in their distributions:
 * Vintage
 * Waves
 * Wee
+* ... and many others.
 
 Current links to these projects can be found at
 http://wiki.ramaze.net/Home#other-frameworks
@@ -130,13 +126,13 @@ Either with the embedded WEBrick starter:
 
 Or with rackup:
 
-    bin/rackup -Ilib example/lobster.ru 
+    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:
+A Gem of Rack is available at gemcutter.org.  You can install it with:
 
     gem install rack
 
@@ -165,7 +161,6 @@ To run the test suite completely, you need:
   * fcgi
   * memcache-client
   * mongrel
-  * ruby-openid
   * thin
 
 The full set of tests test FCGI access with lighttpd (on port
@@ -283,16 +278,49 @@ run on port 11211) and memcache-client installed.
   * Make sure WEBrick respects the :Host option
   * Many Ruby 1.9 fixes.
 
+* January 3rd, 2009: Ninth public release 1.1.0.
+  * Moved Auth::OpenID to rack-contrib.
+  * SPEC change that relaxes Lint slightly to allow subclasses of the
+    required types
+  * SPEC change to document rack.input binary mode in greator detail
+  * SPEC define optional rack.logger specification
+  * File servers support X-Cascade header
+  * Imported Config middleware
+  * Imported ETag middleware
+  * Imported Runtime middleware
+  * Imported Sendfile middleware
+  * New Logger and NullLogger middlewares
+  * Added mime type for .ogv and .manifest.
+  * Don't squeeze PATH_INFO slashes
+  * Use Content-Type to determine POST params parsing
+  * Update Rack::Utils::HTTP_STATUS_CODES hash
+  * Add status code lookup utility
+  * Response should call #to_i on the status
+  * Add Request#user_agent
+  * Request#host knows about forwared host
+  * Return an empty string for Request#host if HTTP_HOST and
+    SERVER_NAME are both missing
+  * Allow MockRequest to accept hash params
+  * Optimizations to HeaderHash
+  * Refactored rackup into Rack::Server
+  * Added Utils.build_nested_query to complement Utils.parse_nested_query
+  * Added Utils::Multipart.build_multipart to complement
+    Utils::Multipart.parse_multipart
+  * Extracted set and delete cookie helpers into Utils so they can be
+    used outside Response
+  * Extract parse_query and parse_multipart in Request so subclasses
+    can change their behavior
+  * Enforce binary encoding in RewindableInput
+  * Set correct external_encoding for handlers that don't use RewindableInput
+
 == Contact
 
-Please mail bugs, suggestions and patches to
-<mailto:rack-devel@googlegroups.com>.
+Please post bugs, suggestions and patches to
+the bug tracker at <http://rack.lighthouseapp.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
@@ -318,8 +346,14 @@ would like to thank:
 * 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.
+  Tom Robinson, Phil Hagelberg, S. Brent Faulkner, Bosko Milekic,
+  Daniel Rodríguez Troitiño, Genki Takiuchi, Geoffrey Grosenbach,
+  Julien Sanchez, Kamal Fariz Mahyuddin, Masayoshi Takahashi, Patrick
+  Aljordm, Mig, and Kazuhiro Nishiyama for bug fixing and other
+  improvements.
+* Eric Wong, Hongli Lai, Jeremy Kemper for their continuous support
+  and API improvements.
+* Yehuda Katz and Carl Lerche for refactoring rackup.
 * Brian Candler, for Rack::ContentType.
 * Graham Batty, for improved handler loading.
 * Stephen Bannasch, for bug reports and documentation.
@@ -334,7 +368,7 @@ would like to thank:
 
 == Copyright
 
-Copyright (C) 2007, 2008, 2009 Christian Neukirchen <http://purl.org/net/chneukirchen>
+Copyright (C) 2007, 2008, 2009, 2010 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
@@ -349,7 +383,7 @@ 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 
+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.
 
@@ -358,6 +392,7 @@ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 Rack:: <http://rack.rubyforge.org/>
 Rack's Rubyforge project:: <http://rubyforge.org/projects/rack>
 Official Rack repositories:: <http://github.com/rack>
+Rack Lighthouse Bug Tracking:: <http://rack.lighthouseapp.com/>
 rack-devel mailing list:: <http://groups.google.com/group/rack-devel>
 
 Christian Neukirchen:: <http://chneukirchen.org/>