Pump is a dead simple abstraction of HTTP for Python.
The Pump specification consists of headers, requests, responses, apps, and middleware. Below are examples of each.
Pump requests.
{"server_port": "80",
"server_name": "127.0.0.1",
"remote_addr": "127.0.0.1",
"uri": "/",
"scheme": "http",
"method": "get",
"headers":
{"accept_charset": "ISO-8859-1,utf-8;q=0.7,*;q=0.3",
"connection": "keep-alive",
"host": "localhost:8000",
...}}
Pump responses.
{"status": 200,
"headers": {"content_type": "text/plain"},
"body": "Hello!"}
Pump apps.
def app(req):
if req["uri"] == "/favicon.ico":
return {"status": 404, headers: {}, body: "Not Found"}
return {"status": 200,
"headers": {"content_type": "text/html"},
"body": "<h1>Hello!</h1>"}
Pump middleware.
def wrap_with_logger(app):
def wrapped(req):
response = app(req)
print "%s %s\n => %s" % (req["method"],
req["uri"],
response)
return response
return wrapped
For the detailed specification, see SPEC.md.
To install, type
$ pip install pump
or grab the code from Github:
$ git clone git://github.com/adeel/pump.git
$ cd pump
$ python setup.py install
Pump comes with an adapter for the Paste WSGI server. If you don't have that installed, do
$ pip install Paste
and then to run your app:
import pump
pump.adapters.serve_with_paste(app, {"port": 3000})
Soon, Pump will come with adapters for other popular WSGI servers.
Pump was heavily inspired by Clojure's Ring. Thanks, Mark McGranaghan!
Copyright (c) 2011 Adeel Ahmad Khan [email protected].
MIT license.