[ANN] Rack 1.0, a modular Ruby webserver interface
Christian Neukirchen
Today we are proud to release Rack 1.0, which was close to almost be
codenamed MiddleWarem4Ever.
= 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.
Use Rack::Lint to find out in which ways this possibly broke your
applications and middleware.
== Changes
* April 25th, 2009: Seventh public release 1.0.0.
* SPEC changes, see above.
* 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.
== Where can I get it?
You can download Rack 1.0 at
http://chneukirchen.org/releases/rack-1.0.0.tar.gz
http://rubyforge.org/projects/rack
Alternatively, you can checkout from the development repository with:
git clone git://github.com/rack/rack.git
cd rack && git checkout rack-1.0 # for this release
== 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
== 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
== 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/
== Contact
Please mail bugs, suggestions and patches to
<mailto:rack-...@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>
Rack is freely distributable under the terms of an MIT-style license.
== 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>
Happy hacking and have a nice day,
Christian Neukirchen
on behalf of the Rack Core Team.
571dc1d6a74a2a4cb0082a59612ff8b2f80f8752 rack-1.0.0.gem
53609db88608fb846a0a62df803ae2bb33372cfe rack-1.0.0.tar.gz
Christian Neukirchen
Roger Rohrbach
it's arrived at v1.
Sinatra 0.9.1.1 depends on [rack (>= 0.9.1, < 1.0)]. I assume the
release of a Rack 1.0-compatible version of Sinatra is imminent?
Harry Vangberg
gem install sinatra-sinatra -s http://gems.github.com
2009/4/26 Roger Rohrbach <ro...@ecstatic.com>:
Roger Rohrbach
Hongli Lai
front page doesn't link to the latest version of the spec.
Christian Neukirchen
> Could you update the rdoc on the website? It specification link on the
> front page doesn't link to the latest version of the spec.
The SPEC is now at http://rack.rubyforge.org/doc/SPEC.html
Mail complaints to the RDoc maintainers, which didn't care for
preserving URLs with the last update.
--
Christian Neukirchen <chneuk...@gmail.com> http://chneukirchen.org
Hongli Lai
wrote:
> > Could you update the rdoc on the website? It specification link on the
> > front page doesn't link to the latest version of the spec.
>
> Mail complaints to the RDoc maintainers, which didn't care for
> preserving URLs with the last update.
mention that rack.input#read must behave like IO#read, but I don't see
that in the HTML.
Christian Neukirchen
> This is not the latest spec. For example the latest spec should
> mention that rack.input#read must behave like IO#read, but I don't see
> that in the HTML.
Fixed.