rack 0.3.0 → 0.4.0

data/AUTHORS

@@ -2,6 +2,7 @@
 * HTTP authentication: Tim Fletcher <twoggle@gmail.com>
 * Cookie sessions, Static handler: Luc Heinrich <luc@honk-honk.com>
 * Pool sessions, OpenID authentication: blink <blinketje@gmail.com>
+* Rack::Deflater: Christoffer Sawicki <christoffer.sawicki@gmail.com>
 * LiteSpeed handler: Adrian Madrid
 * SCGI handler: Jeremy Evans
 * Official Logo: Armin Ronacher

data/RDOX

@@ -16,6 +16,15 @@
 * should return 400 Bad Request if incorrect uri given
 * should return 400 Bad Request if different auth scheme used
 
+== Rack::Auth::OpenID
+* realm uri should be absolute and have a path
+* uri options should be absolute
+* return_to should be absolute and be under the realm
+* extensions should be a module
+* extensions should have required constants defined
+* extensions should have Request and Response defined and inherit from OpenID::Extension
+* extensions should have NS_URI defined and be a string of an absolute http uri
+
 == Rack::Builder
 * chains apps by default
 * has implicit #to_app
@@ -29,6 +38,7 @@
 * 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)
@@ -45,6 +55,20 @@
 * should log to rack.errors by default
 * should log to anything with <<
 
+== 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 handle the lack of an acceptable encoding
+
+== 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
@@ -58,10 +82,16 @@
 
 == Rack::File
 * serves files
+* sets Last-Modified header
 * serves files with URL encoded filenames
 * does not allow directory traversal
 * 404s if it can't find the file
 
+== Rack::Handler
+* has registered default handlers
+* should get unregistered handler by name
+* should register custom handler
+
 == Rack::Lint
 * passes valid request
 * notices fatal errors
@@ -110,6 +140,9 @@
 * 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
 
 == Rack::Recursive
 * should allow for subrequests
@@ -121,6 +154,8 @@
 * 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
 * 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
@@ -133,10 +168,13 @@
 * 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
+* should work around buggy 1.8.* Tempfile equality
 * does conform to the Rack spec
+* should parse Accept-Encoding correctly
 
 == Rack::Response
 * has sensible default values
@@ -158,10 +196,22 @@
 * survives broken cookies
 * barks on too big cookies
 
+== Rack::Session::Memcache
+* startup (empty)
+* faults on no connection
+* creates a new cookie
+* determines session from a cookie
+* survives broken cookies
+* maintains freshness
+* multithread: should cleanly merge sessions
+* shutdown
+
 == Rack::Session::Pool
 * creates a new cookie
-* loads from a cookie
+* determines session from a cookie
 * survives broken cookies
+* maintains freshness
+* multithread: should merge sessions
 
 == Rack::ShowExceptions
 * catches exceptions
@@ -187,13 +237,21 @@
 == Rack::Utils
 * should escape correctly
 * should unescape correctly
-* should parse queries correctly
+* should parse query strings correctly
+* should build query strings correctly
+* should figure out which encodings are acceptable
 
 == Rack::Utils::HeaderHash
 * should capitalize on all accesses
 * should capitalize correctly
 * should be converted to real Hash
 
+== Rack::Utils::Context
+* should perform checks on both arguments
+* should set context correctly
+* should alter app on recontexting
+* should run different apps
+
 == Rack::Handler::WEBrick
 * should respond
 * should be a WEBrick
@@ -204,4 +262,4 @@
 * should set status
 * should provide a .run
 
-151 specifications, 2 empty (598 requirements), 0 failures
+197 specifications, 3 empty (886 requirements), 0 failures

data/README

@@ -9,11 +9,27 @@ middleware) into a single method call.
 The exact details of this are described in the Rack specification,
 which all Rack applications should conform to.
 
+== Future specification changes
+
+PLEASE NOTE: In versions of Rack LATER than 0.4, the following
+changes will be commited to the Rack specification:
+
+* 1xx, 204 and 304 status codes MUST not contain a Content-Type.
+* A valid Content-Length header MUST be provided for non 1xx, 204 and 304
+  responses with a Transfer-Encoding of "identity" (default).
+  The Content-Length MUST be the same as the sum of the byte-sizes of
+  the chunks.
+* The REQUEST_METHOD may be any HTTP token.
+
+Internal Rack modules have been updated to follow this behavior, but
+the Rack 0.4 Lint does NOT check it yet for compatibility reasons.
+Please update your libraries accordingly.
+
 == Supported web servers
 
 The included *handlers* connect all kinds of web servers to Rack:
 * Mongrel
-* Mongrel/Swiftcore (require it before requiring rack)
+* EventedMongrel
 * WEBrick
 * FCGI
 * CGI
@@ -23,6 +39,7 @@ The included *handlers* connect all kinds of web servers to Rack:
 These web servers include Rack handlers in their distributions:
 * Ebb
 * Fuzed
+* Phusion Passenger (which is mod_rack for Apache)
 * Thin
 
 Any valid Rack app will run the same on all these handlers, without
@@ -36,12 +53,14 @@ The included *adapters* connect Rack with existing Ruby web frameworks:
 These frameworks include Rack adapters in their distributions:
 * Coset
 * Halcyon
+* Mack
 * Maveric
 * Merb
 * Racktools::SimpleApplication
 * Ramaze
 * Sinatra
 * Vintage
+* Waves
 
 Ruby on Rails can be run with the adapter included with Thin, which
 will be merged into a later Rack version.
@@ -61,8 +80,8 @@ applications needs using middleware, for example:
 * ...many others!
 
 All these components use the same interface, which is described in
-detail in the Rack specification.  You can choose to use them exactly
-in the way you want.
+detail in the Rack specification.  These optional components can be
+used in any way you wish.
 
 == Convenience
 
@@ -112,6 +131,53 @@ 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
+  * mongrel
+  * fcgi
+  * ruby-openid
+  * memcache-client
+
+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.
@@ -138,27 +204,45 @@ at my site:
   * HTTP status 201 can contain a Content-Type and a body now.
   * Many bugfixes, especially related to Cookie handling.
 
+* August 21th, 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.
+
 == Contact
 
 Please mail bugs, suggestions and patches to
-<mailto:chneukirchen@gmail.com>.
+<mailto:rack-devel@googlegroups.com>.
+
+Mailing list archives are available at
+<http://groups.google.com/group/rack-devel>
 
-Darcs repository ("darcs send" is welcome for patches):
-http://chneukirchen.org/repos/rack
+Git repository (branches rebased on master are most welcome):
+* http://github.com/chneukirchen/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 to
 
+* blink for the Pool sessions, Memcache sessions, OpenID support, many
+  tweaks, patches and bugreports.
 * Michael Fellinger, for the helpful discussion, bugfixes and a better
   Rack::Request interface.
 * Adrian Madrid, for the LiteSpeed handler.
-* Christoffer Sawicki, for the Rails adapter.
+* 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.
-* blink for the Pool sessions, OpenID support, various tweaks, and bugreports.
 * Armin Ronacher, for the logo and racktools.
 * Aredridel, for bug fixing.
+* 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.
@@ -166,6 +250,7 @@ You are also welcome to join the #rack channel on irc.freenode.net.
 * 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
 
@@ -192,11 +277,11 @@ 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>
+rack-devel mailing list:: <http://groups.google.com/group/rack-devel>
 
 Camping:: <http://camping.rubyforge.org/>
 Ramaze:: <http://ramaze.rubyforge.org/>
 Maveric:: <http://maveric.rubyforge.org/>
-racktools:: <http://lucumr.pocoo.org/trac/repos/racktools/>
 
 Christian Neukirchen:: <http://chneukirchen.org/>
 

data/Rakefile

@@ -11,43 +11,35 @@ task :predist => [:chmod, :changelog, :rdoc]
 
 
 desc "Make an archive as .tar.gz"
-task :dist => :fulltest do
-  sh "export DARCS_REPO=#{File.expand_path "."}; " +
-     "darcs dist -d rack-#{get_darcs_tree_version}"
+task :dist => [:fulltest, :predist] do
+  sh "git archive --format=tar --prefix=#{release}/ HEAD^{tree} >#{release}.tar"
+  sh "pax -waf #{release}.tar -s ':^:#{release}/:' RDOX SPEC ChangeLog doc"
+  sh "gzip -f -9 #{release}.tar"
 end
 
-# Helper to retrieve the "revision number" of the darcs tree.
-def get_darcs_tree_version
-  unless File.directory? "_darcs"
+# Helper to retrieve the "revision number" of the git tree.
+def git_tree_version
+  if File.directory?(".git")
+    @tree_version ||= `git describe`.strip.sub('-', '.')
+    @tree_version << ".0"  unless @tree_version.count('.') == 2
+  else
     $: << "lib"
     require 'rack'
-    return Rack.version
+    @tree_version = Rack.release
   end
+  @tree_version
+end
 
-  changes = `darcs changes`
-  count = 0
-  tag = "0.0"
-
-  changes.split("\n\n").each { |change|
-    head, title, desc = change.split("\n", 3)
-
-    if title =~ /^  \*/
-      # Normal change.
-      count += 1
-    elsif title =~ /tagged (.*)/
-      # Tag.  We look for these.
-      tag = $1
-      break
-    else
-      warn "Unparsable change: #{change}"
-    end
-  }
+def gem_version
+  git_tree_version.gsub(/-.*/, '')
+end
 
-  tag + "." + count.to_s
+def release
+  "rack-#{git_tree_version}"
 end
 
 def manifest
-  `darcs query manifest`.split("\n").map { |f| f.gsub(/\A\.\//, '') }
+  `git ls-files`.split("\n")
 end
 
 
@@ -59,7 +51,20 @@ end
 
 desc "Generate a ChangeLog"
 task :changelog do
-  sh "darcs changes --repo=#{ENV["DARCS_REPO"] || "."} >ChangeLog"
+  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
 
 
@@ -81,16 +86,15 @@ 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)"'}"
+  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 do
+task :fulltest => [:chmod] do
   sh "specrb -Ilib:test -w #{ENV['TEST'] || '-a'} #{ENV['TESTOPTS']}"
 end
 
 begin
-  $" << "sources"  if defined? FromSrc
   require 'rubygems'
 
   require 'rake'
@@ -103,7 +107,7 @@ rescue LoadError
 else
   spec = Gem::Specification.new do |s|
     s.name            = "rack"
-    s.version         = get_darcs_tree_version
+    s.version         = gem_version
     s.platform        = Gem::Platform::RUBY
     s.summary         = "a modular Ruby webserver interface"
 

data/SPEC

@@ -14,7 +14,6 @@ and the *body*.
 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.
@@ -63,12 +62,10 @@ 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 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+.
@@ -100,7 +97,7 @@ The error stream must respond to +puts+, +write+ and +flush+.
 * +close+ must never be called on the error stream.
 == The Response
 === The Status
-The status, if parsed as integer (+to_i+), must be bigger than 100.
+The status, if parsed as integer (+to_i+), 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.
@@ -109,7 +106,6 @@ 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 respond to #each.
 The values passed on #each must be Strings
 and not contain characters below 037.
@@ -120,9 +116,7 @@ given.
 === The Body
 The Body must respond to #each
 and must only yield String values.
-
 If the Body responds to #close, it will be called after iteration.
-
 The Body commonly is an Array of Strings, the application
 instance itself, or a File-like object.
 == Thanks