Originally written by: Ryan Kelly https://github.com/rfk (2007) Updated by: Marcus Breese (2013)
This module implements a lightweight reverse proxy for HTTP, using non-blocking IO based on the eventlet module. It aims to do as little as possible while supporting simple request/response rewriting and being compatible with HTTP keep-alive.
Basic operation is via the 'serve' function, which will bind to the specified host and port and start accepting incoming HTTP requests:
proxylet.serve(host,port,mapper)
Here 'mapper' is a function taking a proxylet.streams.HTTPRequest object, and returning either None (for '404 Not Found') or a 3-tuple giving the destination host, destination port, and a rewriter object.
The rewriter can be any callable that takes request and response streams as arguments and returns wrapped versions of them, but it will most likely be a subclass of proxylet.relocate.Relocator. This class has the necessary logic to rewrite the request for proxying.
As an example of the available functionality, this mapping function will proxy requests to /svn to a private subversion server, requests to /files to a private fileserver, and return 404 for any other paths:
Example code to get this running...
def _demo_mapper(req):
"""Simple demonstration mapper function, also for testing purposes.
Proxies the following:
* /rfk/ : my personal website
* /g/ : google website
* /morph/ : morph SVN repo
"""
from relocate import DrupalRelocator, DAVRelocator, SVNRelocator, Relocator
rfk = Relocator("http://localhost:8080/rfk","http://www.rfk.id.au/")
goog = Relocator("http://localhost:8080/g","http://www.google.com/")
svn = SVNRelocator("http://localhost:8080/svn","http://sphericalmatrix.com/svn/morph")
if svn.matchesLocal(req.reqURI):
return svn.mapping
if rfk.matchesLocal(req.reqURI):
return rfk.mapping
if goog.matchesLocal(req.reqURI):
return goog.mapping
return None
def _demo():
serve('',8080,_demo_mapper)