summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorR David Murray <rdmurray@bitdance.com>2014-02-24 22:21:42 (GMT)
committerR David Murray <rdmurray@bitdance.com>2014-02-24 22:21:42 (GMT)
commit8920e915fab355f73ee0e73e3e1b3c1b7a6768fd (patch)
tree4b98408a125416bcc40ed9ac3bb4f0f0fda32e90 /Doc/library
parent56f3c306c213ecf5f8f64b3b2291fe2c066f7112 (diff)
downloadcpython-8920e915fab355f73ee0e73e3e1b3c1b7a6768fd.zip
cpython-8920e915fab355f73ee0e73e3e1b3c1b7a6768fd.tar.gz
cpython-8920e915fab355f73ee0e73e3e1b3c1b7a6768fd.tar.bz2
whatsnew: http.server --bind cli option.
Also some fixups in the docs.
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/http.server.rst14
1 files changed, 8 insertions, 6 deletions
diff --git a/Doc/library/http.server.rst b/Doc/library/http.server.rst
index 0f7c8b3..dd19fb4 100644
--- a/Doc/library/http.server.rst
+++ b/Doc/library/http.server.rst
@@ -351,7 +351,7 @@ of which this module provides three different variants:
The :class:`SimpleHTTPRequestHandler` class can be used in the following
manner in order to create a very basic webserver serving files relative to
-the current directory. ::
+the current directory::
import http.server
import socketserver
@@ -365,15 +365,17 @@ the current directory. ::
print("serving at port", PORT)
httpd.serve_forever()
+.. _http-server-cli:
+
:mod:`http.server` can also be invoked directly using the :option:`-m`
switch of the interpreter with a ``port number`` argument. Similar to
-the previous example, this serves files relative to the current directory. ::
+the previous example, this serves files relative to the current directory::
python -m http.server 8000
-By default, server binds itself to all interfaces. To restrict it to bind to a
-particular interface only, ``--bind ADDRESS`` argument can be used. For e.g, to
-restrict the server to bind only to localhost. ::
+By default, server binds itself to all interfaces. The option ``-b/--bind``
+specifies a specific address to which it should bind. For example, the
+following command causes the server to bind to localhost only::
python -m http.server 8000 --bind 127.0.0.1
@@ -422,7 +424,7 @@ restrict the server to bind only to localhost. ::
reasons. Problems with the CGI script will be translated to error 403.
:class:`CGIHTTPRequestHandler` can be enabled in the command line by passing
-the ``--cgi`` option.::
+the ``--cgi`` option::
python -m http.server --cgi 8000