summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorBenjamin Peterson <benjamin@python.org>2014-11-24 02:36:44 (GMT)
committerBenjamin Peterson <benjamin@python.org>2014-11-24 02:36:44 (GMT)
commit43052a14c1412893ae76253f1323a41769d09b07 (patch)
tree1e7b9b2ecdfb9f54fb2830f17bf9dc902771ed2b /Doc
parentf200498abe02aaeb451f115d828e938f2f366891 (diff)
downloadcpython-43052a14c1412893ae76253f1323a41769d09b07.zip
cpython-43052a14c1412893ae76253f1323a41769d09b07.tar.gz
cpython-43052a14c1412893ae76253f1323a41769d09b07.tar.bz2
add context parameter to HTTPHandler (closes #22788)
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/logging.handlers.rst15
1 files changed, 10 insertions, 5 deletions
diff --git a/Doc/library/logging.handlers.rst b/Doc/library/logging.handlers.rst
index a2b14de..2c7bf50 100644
--- a/Doc/library/logging.handlers.rst
+++ b/Doc/library/logging.handlers.rst
@@ -839,17 +839,22 @@ supports sending logging messages to a Web server, using either ``GET`` or
``POST`` semantics.
-.. class:: HTTPHandler(host, url, method='GET', secure=False, credentials=None)
+.. class:: HTTPHandler(host, url, method='GET', secure=False, credentials=None, context=None)
Returns a new instance of the :class:`HTTPHandler` class. The *host* can be
- of the form ``host:port``, should you need to use a specific port number.
- If no *method* is specified, ``GET`` is used. If *secure* is true, an HTTPS
- connection will be used. If *credentials* is specified, it should be a
- 2-tuple consisting of userid and password, which will be placed in an HTTP
+ of the form ``host:port``, should you need to use a specific port number. If
+ no *method* is specified, ``GET`` is used. If *secure* is true, a HTTPS
+ connection will be used. The *context* parameter may be set to a
+ :class:`ssl.SSLContext` instance to configure the SSL settings used for the
+ HTTPS connection. If *credentials* is specified, it should be a 2-tuple
+ consisting of userid and password, which will be placed in a HTTP
'Authorization' header using Basic authentication. If you specify
credentials, you should also specify secure=True so that your userid and
password are not passed in cleartext across the wire.
+ .. versionchanged:: 3.4.3
+ The *context* parameter was added.
+
.. method:: mapLogRecord(record)
Provides a dictionary, based on ``record``, which is to be URL-encoded