ur-mongrel.git  about / heads / tags
Rack-enabled Mongrel with an updated HTTP parser

$ git log --pretty=format:'%h %s (%cs)%d'
f1e493e tee_input: avoid IO#sync=true to workaround BSD stdio issue (2009-10-27)
	(HEAD -> master)
87254d3 more-compatible TeeInput#read for POSTs with Content-Length (2009-10-07)
4e6ab7b Remove unused Const::HTTP_STATUS_CODES hash (2009-09-12)
46ca4a1 Start using the new HTTP parser + TeeInput (2009-09-12)
c5a6352 Add new HTTP/{0.9,1.0,1.1} parser (2009-09-12)
8c1c7bd remove HeaderOut class (2009-09-12)
392ea08 http_response: drop old API compatibility (2009-09-12)
469a507 http_response: replace old API with simpler one (2009-09-12)
9f9a9d4 Merge branch 'master' of git@github.com:fauna/mongrel (2009-02-01)
	(fauna/master)
bddf65a Realistic defaults. (2009-02-01)
...

$ git cat-file blob HEAD:README
= Mongrel:  Simple Fast Mostly Ruby Web Server

Mongrel is a small library that provides a very fast HTTP 1.1 server for Ruby web applications.  It is not particular to any framework, and is intended to be just enough to get a web application running behind a more complete and robust web server.

What makes Mongrel so fast is the careful use of an Ragel extension to provide fast, accurate HTTP 1.1 protocol parsing. This makes the server scream without too many portability issues.

See http://mongrel.rubyforge.org for more information.

== License

Mongrel is copyright 2007 Zed A. Shaw and contributors. It is licensed under the Ruby license and the GPL2. See the include LICENSE file for details.

== Quick Start

The easiest way to get started with Mongrel is to install it via RubyGems and then run a Ruby on Rails application. You can do this easily:

 $ gem install mongrel

Now you should have the mongrel_rails command available in your PATH, so just do the following:

 $ cd myrailsapp
 $ mongrel_rails start

This will start it in the foreground so you can play with it.  It runs your application in production mode.  To get help do:

 $ mongrel_rails start -h 

Finally, you can then start in background mode:

 $ mongrel_rails start -d

And you can stop it whenever you like with:

 $ mongrel_rails stop

All of which should be done from your application's directory.  It writes the PID of the process you ran into log/mongrel.pid.

There are also many more new options for configuring the rails runner including changing to a different directory, adding more MIME types, and setting processor threads and timeouts.

== Install

It doesn't explicitly require Camping, but if you want to run the examples/camping/ examples then you'll need to install Camping 1.2 at least (and redcloth I think). These are all available from RubyGems.

The library consists of a C extension so you'll need a C compiler or at least a friend who can build it for you.

Finally, the source includes a setup.rb for those who hate RubyGems.

== Usage

The examples/simpletest.rb file has the following code as the simplest example:

 require 'mongrel'

 class SimpleHandler < Mongrel::HttpHandler
    def process(request, response)
      response.start(200) do |head,out|
        head["Content-Type"] = "text/plain"
        out.write("hello!\n")
      end
    end
 end

 h = Mongrel::HttpServer.new("0.0.0.0", "3000")
 h.register("/test", SimpleHandler.new)
 h.register("/files", Mongrel::DirHandler.new("."))
 h.run.join

If you run this and access port 3000 with a browser it will say "hello!".  If you access it with any url other than "/test" it will give a simple 404.  Check out the Mongrel::Error404Handler for a basic way to give a more complex 404 message.

This also shows the DirHandler with directory listings.  This is still rough but it should work for basic hosting.  *File extension to mime type mapping is missing though.*

== Contact

E-mail the Mongrel list at http://rubyforge.org/mailman/listinfo/mongrel-users and someone will help you. Comments about the API are welcome.

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
  http11-lws   strip trailing and leading linear whitespace in headers (2011-05-18)
* master       tee_input: avoid IO#sync=true to workaround BSD stdio issue (2009-10-27)
  fauna/spinoff Fix require for 1.9. (2009-07-07)
  fauna/master Merge branch 'master' of git@github.com:fauna/mongrel (2009-02-01)
  fauna/rack   Removed uri_classifier, now we just use racks (2008-12-04)
  fauna/cleanup Remove debug. (2008-11-22)
  fauna/trunk_from_svn Remove debug. (2008-11-22)
  fauna/logger moving toward using a logger instead of dumping to STDERR all over the place.. but.. will still dump there by default (2008-11-22)
  fauna/stable_1-1 Updated certificates locations. (2008-07-27)
  fauna/stable_1-2 Copy JRuby cast change from 1.1 to 1.2. (2008-05-24)
...

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
# no tags, yet...

git clone https://yhbt.net/ur-mongrel.git