Commit 59a27f1d authored by Andrew M. Kuchling's avatar Andrew M. Kuchling

Various minor edits

parent 4cbe95cd
...@@ -8,19 +8,18 @@ ...@@ -8,19 +8,18 @@
The \module{SimpleHTTPServer} module defines a request-handler class, The \module{SimpleHTTPServer} module defines a request-handler class,
interface compatible with \class{BaseHTTPServer.BaseHTTPRequestHandler} interface-compatible with \class{BaseHTTPServer.BaseHTTPRequestHandler},
which serves files only from a base directory. that serves files only from a base directory.
The \module{SimpleHTTPServer} module defines the following class: The \module{SimpleHTTPServer} module defines the following class:
\begin{classdesc}{SimpleHTTPRequestHandler}{request, client_address, server} \begin{classdesc}{SimpleHTTPRequestHandler}{request, client_address, server}
This class is used, to serve files from current directory and below, This class is used to serve files from the current directory and below,
directly mapping the directory structure to HTTP requests. directly mapping the directory structure to HTTP requests.
A lot of the work is done by the base class A lot of the work, such as parsing the request, is done by the base
\class{BaseHTTPServer.BaseHTTPRequestHandler}, such as parsing the class \class{BaseHTTPServer.BaseHTTPRequestHandler}. This class
request. This class implements the \function{do_GET()} and implements the \function{do_GET()} and \function{do_HEAD()} functions.
\function{do_HEAD()} functions.
\end{classdesc} \end{classdesc}
The \class{SimpleHTTPRequestHandler} defines the following member The \class{SimpleHTTPRequestHandler} defines the following member
...@@ -32,7 +31,7 @@ is defined in the module. ...@@ -32,7 +31,7 @@ is defined in the module.
\end{memberdesc} \end{memberdesc}
\begin{memberdesc}{extensions_map} \begin{memberdesc}{extensions_map}
A dictionary mapping suffixes into MIME types. Default is signified A dictionary mapping suffixes into MIME types. The default is signified
by an empty string, and is considered to be \code{application/octet-stream}. by an empty string, and is considered to be \code{application/octet-stream}.
The mapping is used case-insensitively, and so should contain only The mapping is used case-insensitively, and so should contain only
lower-cased keys. lower-cased keys.
...@@ -43,7 +42,7 @@ The \class{SimpleHTTPRequestHandler} defines the following methods: ...@@ -43,7 +42,7 @@ The \class{SimpleHTTPRequestHandler} defines the following methods:
\begin{methoddesc}{do_HEAD}{} \begin{methoddesc}{do_HEAD}{}
This method serves the \code{'HEAD'} request type: it sends the This method serves the \code{'HEAD'} request type: it sends the
headers it would send for the equivalent \code{GET} request. See the headers it would send for the equivalent \code{GET} request. See the
\method{do_GET()} method for more complete explanation of the possible \method{do_GET()} method for a more complete explanation of the possible
headers. headers.
\end{methoddesc} \end{methoddesc}
...@@ -61,13 +60,15 @@ returns a \code{404} error response if the \function{listdir()} fails. ...@@ -61,13 +60,15 @@ returns a \code{404} error response if the \function{listdir()} fails.
If the request was mapped to a file, it is opened and the contents are If the request was mapped to a file, it is opened and the contents are
returned. Any \exception{IOError} exception in opening the requested returned. Any \exception{IOError} exception in opening the requested
file is mapped to a \code{404}, \code{'File not found'} file is mapped to a \code{404}, \code{'File not found'}
error. Otherwise, the content type is guessed using the error. Otherwise, the content type is guessed by calling the
\method{guess_type()} method, which in turn uses the
\var{extensions_map} variable. \var{extensions_map} variable.
A \code{'Content-type:'} with the guessed content type is output, and A \code{'Content-type:'} header with the guessed content type is
then a blank line, signifying end of headers, and then the contents of output, followed by a blank line signifying the end of the headers,
the file. If the file's MIME type starts with \code{text/} the file is and then the contents of the file are output. If the file's MIME type
opened in text mode; otherwise binary mode is used. starts with \code{text/} the file is opened in text mode; otherwise
binary mode is used.
For example usage, see the implementation of the \function{test()} For example usage, see the implementation of the \function{test()}
function. function.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment