\section{\module{CGIHTTPServer} ---         CGI-capable HTTP request handler}  \declaremodule{standard}{CGIHTTPServer}\sectionauthor{Moshe Zadka}{moshez@zadka.site.co.il}\modulesynopsis{This module provides a request handler for HTTP servers                which can run CGI scripts.}  The \module{CGIHTTPServer} module defines a request-handler class,interface compatible with\class{BaseHTTPServer.BaseHTTPRequestHandler} and inherits behaviorfrom \class{SimpleHTTPServer.SimpleHTTPRequestHandler} but can alsorun CGI scripts. \note{This module can run CGI scripts on \UNIX{} and Windows systems;on Mac OS it will only be able to run Python scripts within the sameprocess as itself.} \note{CGI scripts run by the \class{CGIHTTPRequestHandler} class cannot executeredirects (HTTP code 302), because code 200 (script output follows)is sent prior to execution of the CGI script.  This pre-empts the statuscode.} The \module{CGIHTTPServer} module defines the following class: \begin{classdesc}{CGIHTTPRequestHandler}{request, client_address, server}This class is used to serve either files or output of CGI scripts from the current directory and below. Note that mapping HTTP hierarchicstructure to local directory structure is exactly as in\class{SimpleHTTPServer.SimpleHTTPRequestHandler}. The class will however, run the CGI script, instead of serving it as afile, if it guesses it to be a CGI script. Only directory-based CGIare used --- the other common server configuration is to treat specialextensions as denoting CGI scripts. The \function{do_GET()} and \function{do_HEAD()} functions aremodified to run CGI scripts and serve the output, instead of servingfiles, if the request leads to somewhere below the\code{cgi_directories} path.\end{classdesc} The \class{CGIHTTPRequestHandler} defines the following data member: \begin{memberdesc}{cgi_directories}This defaults to \code{['/cgi-bin', '/htbin']} and describesdirectories to treat as containing CGI scripts.\end{memberdesc} The \class{CGIHTTPRequestHandler} defines the following methods: \begin{methoddesc}{do_POST}{}This method serves the \code{'POST'} request type, only allowed forCGI scripts.  Error 501, "Can only POST to CGI scripts", is outputwhen trying to POST to a non-CGI url.\end{methoddesc} Note that CGI scripts will be run with UID of user nobody, for securityreasons. Problems with the CGI script will be translated to error 403. For example usage, see the implementation of the \function{test()}function.  \begin{seealso}  \seemodule{BaseHTTPServer}{Base class implementation for Web server                             and request handler.}\end{seealso}