Current File : //snap/core22/current/usr/lib/python3.10/http/__pycache__/client.cpython-310.pyc |
o
E�h�� � @ sP d Z ddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Zddlm
Z
g d�ZdZdZdZdZd Zd
Ze� �ejj� dd� ejj�� D �Zd
ZdZe�d�jZe�d�j Z!e�d�Z"e�d�Z#h d�Z$d?dd�Z%G dd� dej&j'�Z(dd� Z)e(fdd�Z*G dd� dej+�Z,G dd � d �Z-zddl.Z.W n e/y� Y nw G d!d"� d"e-�Z0e�1d"� G d#d$� d$e2�Z3G d%d&� d&e3�Z4G d'd(� d(e3�Z5G d)d*� d*e3�Z6G d+d,� d,e3�Z7G d-d.� d.e3�Z8G d/d0� d0e3�Z9G d1d2� d2e3�Z:G d3d4� d4e:�Z;G d5d6� d6e:�Z<G d7d8� d8e:�Z=G d9d:� d:e3�Z>G d;d<� d<e3�Z?G d=d>� d>e@e>�ZAe3ZBdS )@a�
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)�urlsplit)�HTTPResponse�HTTPConnection�
HTTPException�NotConnected�UnknownProtocol�UnknownTransferEncoding�UnimplementedFileMode�IncompleteRead�
InvalidURL�ImproperConnectionState�CannotSendRequest�CannotSendHeader�ResponseNotReady�
BadStatusLine�LineTooLong�RemoteDisconnected�error� responses�P i� �UNKNOWN�IdlezRequest-startedzRequest-sentc C s i | ]}||j �qS � )�phrase)�.0�vr r �"/usr/lib/python3.10/http/client.py�
<dictcomp>l s r i �d s [^:\s][^:\r\n]*s \n(?![ \t])|\r(?![ \t\n])z[ - ]z[ -]> �PUT�POST�PATCH�datac
C sZ z| � d�W S ty, } zt|j|j|j|jd|�� | |j|j� |f �d�d}~ww )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)�encode�UnicodeEncodeError�encoding�object�start�end�title)r"