puma--puma/README.md

# Puma: A Ruby Web Server Built For Concurrency

## Description

Puma is a small library that provides a very fast and concurrent HTTP 1.1 server for Ruby web applications.  It is designed for running rack apps only.

What makes Puma 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.

## License

Puma is copyright 2011 Evan Phoenix and contributors. It is licensed under the BSD license. See the include LICENSE file for details.

## Quick Start

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

    $ gem install puma

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

    $ puma app.ru

## Install

    $ gem install puma
Switch README to format hoe understands 2011-10-07 15:00:45 -04:00			`# Puma: A Ruby Web Server Built For Concurrency`
Redo README in Markdown and replace Mongrel with Puma 2011-10-01 16:23:20 -04:00
Switch README to format hoe understands 2011-10-07 15:00:45 -04:00			`## Description`
Redo README in Markdown and replace Mongrel with Puma 2011-10-01 16:23:20 -04:00
Prune the README.md 2011-10-04 22:56:03 -04:00			`Puma is a small library that provides a very fast and concurrent HTTP 1.1 server for Ruby web applications. It is designed for running rack apps only.`
Redo README in Markdown and replace Mongrel with Puma 2011-10-01 16:23:20 -04:00
			`What makes Puma 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.`

Switch README to format hoe understands 2011-10-07 15:00:45 -04:00			`## License`
Redo README in Markdown and replace Mongrel with Puma 2011-10-01 16:23:20 -04:00
Prune the README.md 2011-10-04 22:56:03 -04:00			`Puma is copyright 2011 Evan Phoenix and contributors. It is licensed under the BSD license. See the include LICENSE file for details.`
Redo README in Markdown and replace Mongrel with Puma 2011-10-01 16:23:20 -04:00
Switch README to format hoe understands 2011-10-07 15:00:45 -04:00			`## Quick Start`
Redo README in Markdown and replace Mongrel with Puma 2011-10-01 16:23:20 -04:00
			`The easiest way to get started with Puma is to install it via RubyGems and then run a Ruby on Rails application. You can do this easily:`

Indent examples at the level Markdown expects 2011-10-01 16:27:47 -04:00			`$ gem install puma`
Redo README in Markdown and replace Mongrel with Puma 2011-10-01 16:23:20 -04:00
Prune the README.md 2011-10-04 22:56:03 -04:00			`Now you should have the puma command available in your PATH, so just do the following:`
Redo README in Markdown and replace Mongrel with Puma 2011-10-01 16:23:20 -04:00
Prune the README.md 2011-10-04 22:56:03 -04:00			`$ puma app.ru`
Redo README in Markdown and replace Mongrel with Puma 2011-10-01 16:23:20 -04:00
Switch README to format hoe understands 2011-10-07 15:00:45 -04:00			`## Install`
Redo README in Markdown and replace Mongrel with Puma 2011-10-01 16:23:20 -04:00
Prune the README.md 2011-10-04 22:56:03 -04:00			`$ gem install puma`