diff doc/installation.txt @ 3736:a2d22d0de0bc

WSGI support via roundup.cgi.wsgi_handler
author Richard Jones <richard@users.sourceforge.net>
date Thu, 09 Nov 2006 00:36:21 +0000
parents e6ef9abfe403
children 9f4dd27ae843
line wrap: on
line diff
--- a/doc/installation.txt	Fri Nov 03 05:43:00 2006 +0000
+++ b/doc/installation.txt	Thu Nov 09 00:36:21 2006 +0000
@@ -318,6 +318,7 @@
 2. `stand-alone web server`_
 3. `Zope product - ZRoundup`_
 4. `Apache HTTP Server with mod_python`_
+5. `WSGI handler`_
 
 You may need to give the web server user permission to access the tracker home
 - see the `UNIX environment steps`_ for information. You may also need to
@@ -347,7 +348,7 @@
 
    http://support.microsoft.com/default.aspx?scid=kb%3Ben-us%3B276494
 
-Copy the ``cgi-bin/roundup.cgi`` file to your web server's ``cgi-bin``
+Copy the ``frontends/roundup.cgi`` file to your web server's ``cgi-bin``
 directory. You will need to configure it to tell it where your tracker home
 is. You can do this either:
 
@@ -507,6 +508,25 @@
       PythonOption TrackerHome /var/db/roundup/devel
     </Directory>
 
+WSGI Handler
+~~~~~~~~~~~~
+
+The WSGI handler is quite simple. The following sample code shows how
+to use it::
+
+    from wsgiref.simple_server import make_server
+
+    # obtain the WSGI request dispatcher
+    from roundup.cgi.wsgi_handler import RequestDispatcher
+    tracker_home = 'demo'
+    app = RequestDispatcher(tracker_home)
+
+    httpd = make_server('', 8917, app)
+    httpd.serve_forever()
+
+To test the above you should create a demo tracker with ``python demo.py``.
+Edit the ``config.ini`` to change the web URL to "http://localhost:8917/".
+
 
 Configure an Email Interface
 ----------------------------

Roundup Issue Tracker: http://roundup-tracker.org/