rack 0.1.0

data/AUTHORS

@@ -0,0 +1,3 @@
+* Christian Neukirchen <chneukirchen@gmail.com>
+* Rails adapter: Christoffer Sawicki <christoffer.sawicki@gmail.com>
+* Official Logo: Armin Ronacher

data/COPYING

@@ -0,0 +1,18 @@
+Copyright (c) 2007 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.

data/KNOWN-ISSUES

@@ -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 "/".

data/RDOX

@@ -0,0 +1,144 @@
+
+== 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
+
+== Rack::Handler::CGI
+* 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
+
+== Rack::CommonLogger
+* should log to rack.errors by default
+* should log to anything with <<
+
+== Rack::Handler::FastCGI
+* 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
+
+== Rack::File
+* serves files
+* does not allow directory traversal
+* 404s if it can't find the file
+
+== 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 body errors
+* notices input handling errors
+* notices error handling errors
+
+== 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::MockRequest
+* should return a MockResponse
+* should be able to only return the environment
+* should provide sensible defaults
+* should allow GET/POST/PUT/DELETE
+* 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
+
+== 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 cache, but invalidates the cache
+* can figure out if called via XHR
+* can parse cookies
+* provides setters
+* provides the original env
+* can restore the URL
+* can parse multipart form data
+* can parse big multipart form data
+* can detect invalid multipart form data
+
+== Rack::Response
+* has sensible default values
+* can be written to
+* can set and read headers
+* can set cookies
+* can delete cookies
+* has a useful constructor
+* has a constructor that can take a block
+* doesn't return invalid responses
+
+== Rack::ShowExceptions
+* catches exceptions
+
+== Rack::URLMap
+* dispatches paths correctly
+* dispatches hosts correctly
+* should be nestable
+* should route root apps correctly
+
+== Rack::Utils
+* should escape correctly
+* should unescape correctly
+* should parse queries correctly
+
+== Rack::Utils::HeaderHash
+* should capitalize on all accesses
+* should capitalize correctly
+* should be converted to real Hash
+
+== 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
+
+102 specifications (428 requirements), 0 failures

data/README

@@ -0,0 +1,154 @@
+= Rack, a modular Ruby webserver interface
+
+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.
+
+The exact details of this are described in the Rack specification,
+which all Rack applications should conform to.
+
+== Supported web servers
+
+The included *handlers* connect all kinds of web servers to Rack:
+* Mongrel
+* WEBrick
+* FCGI
+* CGI
+
+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
+* Rails (alpha)
+* more to come soon, ...
+
+These frameworks include Rack adapters in their distributions:
+* Ramaze
+* Maveric
+* Racktools::SimpleApplication
+
+== 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.
+* ...
+
+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.
+
+== 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.
+
+== 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
+
+== History
+
+* March 3rd, 2007: First public release 0.1.
+
+== Contact
+
+Please mail bugs, suggestions and patches to
+<mailto:chneukirchen@gmail.com>.
+
+Darcs repository ("darcs send" is welcome for patches):
+http://chneukirchen.org/repos/rack
+
+You are also welcome to join the #rack channel on irc.freenode.net.
+
+== Thanks to
+
+* Michael Fellinger, for the helpful discussion.
+* Christoffer Sawicki, for the Rails adapter.
+* Armin Ronacher, for the logo and racktools.
+* Alexander Kellett for testing the Gem and reviewing the announce.
+* 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.
+
+== Copyright
+
+Copyright (C) 2007  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>
+
+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

@@ -0,0 +1,174 @@
+# Rakefile for Rack.  -*-ruby-*-
+require 'rake/rdoctask'
+require 'rake/testtask'
+
+
+desc "Run all the tests"
+task :default => [:test]
+
+desc "Do predistribution stuff"
+task :predist => [:chmod, :changelog, :rdoc]
+
+
+desc "Make an archive as .tar.gz"
+task :dist => :fulltest do
+  system "export DARCS_REPO=#{File.expand_path "."}; " +
+         "darcs dist -d rack-#{get_darcs_tree_version}"
+end
+
+# Helper to retrieve the "revision number" of the darcs tree.
+def get_darcs_tree_version
+  unless File.directory? "_darcs"
+    require 'rack'
+    return Rack.version
+  end
+
+  changes = `darcs changes`
+  count = 0
+  tag = "0.0"
+
+  changes.each("\n\n") { |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
+  }
+
+  tag + "." + count.to_s
+end
+
+def manifest
+  `darcs query manifest`.split("\n").map { |f| f.gsub(/\A\.\//, '') }
+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
+  system "darcs changes --repo=#{ENV["DARCS_REPO"] || "."} >ChangeLog"
+end
+
+
+desc "Generate RDox"
+task "RDOX" do
+  system "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
+  system "specrb -Ilib:test -w #{ENV['TEST'] || '-a'} #{ENV['TESTOPTS'] || '-t "^(?!Rack::Handler|Rack::Adapter)"'}"
+end
+
+desc "Run all the tests"
+task :fulltest do
+  system "specrb -Ilib:test -w #{ENV['TEST'] || '-a'} #{ENV['TESTOPTS']}"
+end
+
+begin
+  $" << "sources"  if defined? FromSrc
+  require 'rubygems'
+
+  require 'rake'
+  require 'rake/clean'
+  require 'rake/packagetask'
+  require 'rake/gempackagetask'
+  require 'fileutils'
+rescue LoadError
+  # Too bad.
+else
+  spec = Gem::Specification.new do |s|
+    s.name            = "rack"
+    s.version         = get_darcs_tree_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)
+    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'
+  end
+
+  Rake::GemPackageTask.new(spec) do |p|
+    p.gem_spec = spec
+    p.need_tar = false
+    p.need_zip = false
+  end
+end
+
+desc "Generate RDoc documentation"
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.options << '--line-numbers' << '--inline-source' <<
+    '--main' << 'README' <<
+    '--title' << 'Rack Documentation' <<
+    '--charset' << 'utf-8'
+  rdoc.rdoc_dir = "doc"
+  rdoc.rdoc_files.include 'README'
+  rdoc.rdoc_files.include 'KNOWN-ISSUES'
+  rdoc.rdoc_files.include 'SPEC'
+  rdoc.rdoc_files.include 'RDOX'
+  rdoc.rdoc_files.include('lib/rack.rb')
+  rdoc.rdoc_files.include('lib/rack/*.rb')
+  rdoc.rdoc_files.include('lib/rack/*/*.rb')
+end
+task :rdoc => ["SPEC", "RDOX"]
+
+task :pushsite => [:rdoc] do
+  system "rsync -avz doc/ chneukirchen@rack.rubyforge.org:/var/www/gforge-projects/rack/doc/"
+  system "rsync -avz site/ chneukirchen@rack.rubyforge.org:/var/www/gforge-projects/rack/"
+end
+
+begin
+  require 'rcov/rcovtask'
+
+  Rcov::RcovTask.new do |t|
+    t.test_files = FileList['test/{spec,test}_*.rb']
+    t.verbose = true     # uncomment to see the executed command
+    t.rcov_opts = ["--text-report",
+                   "-Ilib:test",
+                   "--include-file", "^lib,^test",
+                   "--exclude-only", "^/usr,^/home/.*/src,active_"]
+  end
+rescue LoadError
+end