From 5dae7b51580abd5edf61e30cc10d2474e3e4a10e Mon Sep 17 00:00:00 2001
From: lkcl <lkcl@teenymac.(none)>
Date: Wed, 14 Jul 2010 20:35:20 +0100
Subject: [PATCH] document proxyapp

---
 proxyapp.py | 37 +++++++++++++++++++++++++++++++------
 1 file changed, 31 insertions(+), 6 deletions(-)

diff --git a/proxyapp.py b/proxyapp.py
index 5d89461..0e6226c 100644
--- a/proxyapp.py
+++ b/proxyapp.py
@@ -1,18 +1,43 @@
+""" This is a proxy server which converts incoming requests into
+    HTTP/1.1 with Keep-Alive set.  It maintains a continuous
+    HTTP connection to the server it is proxying for, so that
+    as long as that remote server keeps a process or thread
+    running to serve the continuous stream of requests, that
+    process or thread can keep state information in memory.
+
+    For example, a connection object to a database can be kept
+    around; large complex data structures that are too big to
+    serialise or pass across inter-process boundaries and so on.
+
+    The target proxy HTTP Server *must* support HTTP keep-alives
+    (header "Connection: keep-alive").
+
+    The client (browser, usually) *does not* have to support
+    HTTP keep-alives, or maintain a continuous connection: that
+    action is performed by the proxy.
+
+    However, the only requirements is that the client (browser)
+    *must* support and accept cookies, as the cookie named "session"
+    is used by multitaskhttpd to identify and route the incoming
+    connections through to the correct persistent proxy connection.
+"""
+
 import multitask
 import httpd
 from ProxyServer import ProxyServerRequestHandler
 from httpd import HTTPServer, App, BaseApp
 
-class MyApp(ProxyServerRequestHandler, BaseApp):
+class ProxyApp(ProxyServerRequestHandler, BaseApp):
 
     def __init__(self):
         BaseApp.__init__(self)
         ProxyServerRequestHandler.__init__(self)
         self.proxies = {}
 
-httpd.set_debug(True)
-agent = HTTPServer()   
-agent.apps = dict({'/test': MyApp, '*': MyApp})
-agent.start()
-multitask.run() 
+if __name__ == '__main__':
+    httpd.set_debug(True)
+    agent = HTTPServer()   
+    agent.apps = dict({'*': ProxyApp})
+    agent.start()
+    multitask.run() 
 
-- 
2.30.2