mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-10-03 21:55:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 12

Update http.client.rst (#24803)

Browse source 
* Update http.client.rst

* Apply suggestions from code review

Co-authored-by: Éric <merwok@netwok.org>

* Update http.client.rst

Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Senthil Kumaran <senthil@python.org>
This commit is contained in:
Géry Ogam 2022-10-04 01:18:36 +02:00 • committed by GitHub
parent 00b5a08c80
commit 0c91a12511
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 8 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

17
Doc/library/http.client.rst
View file

@ -61,7 +61,7 @@ The module provides the following classes:
.. versionchanged:: 3.4 .. versionchanged:: 3.4
The *strict* parameter was removed. HTTP 0.9-style "Simple Responses" are The *strict* parameter was removed. HTTP 0.9-style "Simple Responses" are
not longer supported. no longer supported.
.. versionchanged:: 3.7 .. versionchanged:: 3.7
*blocksize* parameter was added. *blocksize* parameter was added.
@ -474,7 +474,7 @@ statement.
Return the value of the header *name*, or *default* if there is no header Return the value of the header *name*, or *default* if there is no header
matching *name*. If there is more than one header with the name *name*, matching *name*. If there is more than one header with the name *name*,
return all of the values joined by ', '. If 'default' is any iterable other return all of the values joined by ', '. If *default* is any iterable other
than a single string, its elements are similarly returned joined by commas. than a single string, its elements are similarly returned joined by commas.
.. method:: HTTPResponse.getheaders() .. method:: HTTPResponse.getheaders()
@ -578,7 +578,7 @@ Here is an example session that uses the ``HEAD`` method. Note that the
>>> data == b'' >>> data == b''
True True
Here is an example session that shows how to ``POST`` requests:: Here is an example session that uses the ``POST`` method::
>>> import http.client, urllib.parse >>> import http.client, urllib.parse
>>> params = urllib.parse.urlencode({'@number': 12524, '@type': 'issue', '@action': 'show'}) >>> params = urllib.parse.urlencode({'@number': 12524, '@type': 'issue', '@action': 'show'})
@ -594,14 +594,13 @@ Here is an example session that shows how to ``POST`` requests::
b'Redirecting to <a href="https://bugs.python.org/issue12524">https://bugs.python.org/issue12524</a>' b'Redirecting to <a href="https://bugs.python.org/issue12524">https://bugs.python.org/issue12524</a>'
>>> conn.close() >>> conn.close()
Client side ``HTTP PUT`` requests are very similar to ``POST`` requests. The Client side HTTP ``PUT`` requests are very similar to ``POST`` requests. The
difference lies only the server side where HTTP server will allow resources to difference lies only on the server side where HTTP servers will allow resources to
be created via ``PUT`` request. It should be noted that custom HTTP methods be created via ``PUT`` requests. It should be noted that custom HTTP methods
are also handled in :class:`urllib.request.Request` by setting the appropriate are also handled in :class:`urllib.request.Request` by setting the appropriate
method attribute. Here is an example session that shows how to send a ``PUT`` method attribute. Here is an example session that uses the ``PUT`` method::
request using http.client::
>>> # This creates an HTTP message >>> # This creates an HTTP request
>>> # with the content of BODY as the enclosed representation >>> # with the content of BODY as the enclosed representation
>>> # for the resource http://localhost:8080/file >>> # for the resource http://localhost:8080/file
... ...