?
| Path : /lib64/python3.8/http/__pycache__/ |
| Current File : //lib64/python3.8/http/__pycache__/client.cpython-38.pyc |
U
e5d @ sf d Z ddlZddlZddlZddlZddlZddlZddlZ ddl
mZ dddddd d
ddd
ddddddddgZdZ
dZdZdZdZdZe ejj dd ejj D ZdZdZed jZed!jZed"Z ed#Z!d$d%d&hZ"dBd(d)Z#G d*d+ d+ej$j%Z&d,d- Z'e&fd.d/Z(G d0d dej)Z*G d1d dZ+zddl,Z,W n e-k
r` Y nX G d2d3 d3e+Z.e/d3 G d4d de0Z1G d5d de1Z2G d6d de1Z3G d7d de1Z4G d8d d e1Z5G d9d
d
e1Z6G d:d de1Z7G d;d
d
e1Z8G d<d de8Z9G d=d de8Z:G d>d de8Z;G d?d de1Z<G d@d de1Z=G dAd de>e<Z?e1Z@dS )Ca
HTTP/1.1 client library
<intro stuff goes here>
<other stuff, too>
HTTPConnection goes through a number of "states", which define when a client
may legally make another request or fetch the response for a particular
request. This diagram details these state transitions:
(null)
|
| HTTPConnection()
v
Idle
|
| putrequest()
v
Request-started
|
| ( putheader() )* endheaders()
v
Request-sent
|\_____________________________
| | getresponse() raises
| response = getresponse() | ConnectionError
v v
Unread-response Idle
[Response-headers-read]
|\____________________
| |
| response.read() | putrequest()
v v
Idle Req-started-unread-response
______/|
/ |
response.read() | | ( putheader() )* endheaders()
v v
Request-started Req-sent-unread-response
|
| response.read()
v
Request-sent
This diagram presents the following rules:
-- a second request may not be started until {response-headers-read}
-- a response [object] cannot be retrieved until {request-sent}
-- there is no differentiation between an unread response body and a
partially read response body
Note: this enforcement is applied by the HTTPConnection class. The
HTTPResponse class does not enforce this state machine, which
implies sophisticated clients may accelerate the request/response
pipeline. Caution should be taken, though: accelerating the states
beyond the above pattern may imply knowledge of the server's
connection-close behavior for certain requests. For example, it
is impossible to tell whether the server will close the connection
UNTIL the response headers have been read; this means that further
requests cannot be placed into the pipeline until it is known that
the server will NOT be closing the connection.
Logical State __state __response
------------- ------- ----------
Idle _CS_IDLE None
Request-started _CS_REQ_STARTED None
Request-sent _CS_REQ_SENT None
Unread-response _CS_IDLE <response_class>
Req-started-unread-response _CS_REQ_STARTED <response_class>
Req-sent-unread-response _CS_REQ_SENT <response_class>
N)urlsplitHTTPResponseHTTPConnection
HTTPExceptionNotConnectedUnknownProtocolUnknownTransferEncodingUnimplementedFileModeIncompleteRead
InvalidURLImproperConnectionStateCannotSendRequestCannotSendHeaderResponseNotReady
BadStatusLineLineTooLongRemoteDisconnectederror responsesP i ZUNKNOWNZIdlezRequest-startedzRequest-sentc C s i | ]}||j qS )phrase).0vr r #/usr/lib64/python3.8/http/client.py
<dictcomp>j s r i d s [^:\s][^:\r\n]*s \n(?![ \t])|\r(?![ \t\n])z[ - ]z[ -]ZPATCHZPOSTZPUTdatac
C sh z| dW S tk
rb } z8t|j|j|j|jd| | |j|j |f dW 5 d}~X Y nX dS )z<Call data.encode("latin-1") but show a better error message.latin-1z`%s (%.20r) is not valid Latin-1. Use %s.encode('utf-8') if you want to send it encoded in UTF-8.N)encodeUnicodeEncodeErrorencodingobjectstartendtitle)r nameerrr r r _encode s r( c @ s e Zd Zdd ZdS )HTTPMessagec C sj | d }t|}g }d}| D ]@}|d| |krBd}n|dd sVd}|r$|| q$|S )a Find all header lines matching a given header name.
Look through the list of headers and find all lines matching a given
header name (and their continuation lines). A list of the lines is
returned, without interpretation. If the header does not occur, an
empty list is returned. If the header occurs multiple times, all
occurrences are returned. Case is not important in the header name.
:r N )lowerlenkeysisspaceappend)selfr&