add context parameter to HTTPHandler (closes #22788)

This commit is contained in:
Benjamin Peterson 2014-11-23 20:36:44 -06:00
parent f200498abe
commit 43052a14c1
4 changed files with 24 additions and 21 deletions

View file

@ -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