�
�Bfi � � � % S SK Jr S SKrS SKrS SKJr S SKJr SSKJ r SSK
J r \R ( a S S KJ
r
S
r\" / S Q5 rS r S SKr\S
-
r S SKr\S-
r " S S\5 r\R2 rS\S' \R8 \ \4 r 1 Skr S SS jjr S S jr!S S jr" " S S\RF 5 r$ S S jr%g! \ a S SKr N�f = f! \ a N�f = f! \ a N�f = f) � )� annotationsN)� b64encode)�Enum� )�UnrewindableBodyError� )�to_bytes)�Finalz@@@SKIP_HEADER@@@)�accept-encoding�host�
user-agentz gzip,deflatez,brz,zstdc � � \ rS rSrSrSrg)�_TYPE_FAILEDTELL�' r � N)�__name__�
__module__� __qualname__�__firstlineno__�token�__static_attributes__r � �6/usr/lib/python3/dist-packages/urllib3/util/request.pyr r ' s � �
�Er r zFinal[_TYPE_FAILEDTELL]� _FAILEDTELL> �GET�HEAD�TRACE�DELETE�CONNECT�OPTIONSc � � 0 nU( aG [ U[ 5 ( a O-[ U[ 5 ( a SR U5 nO[ nXS' U( a X&S' U ( a SUS' U( a. S[ UR
S5 5 R 5 3US' U( a. S[ UR
S5 5 R 5 3US ' U( a S
US ' U$ ) a�
Shortcuts for generating request headers.
:param keep_alive:
If ``True``, adds 'connection: keep-alive' header.
:param accept_encoding:
Can be a boolean, list, or string.
``True`` translates to 'gzip,deflate'. If the dependencies for
Brotli (either the ``brotli`` or ``brotlicffi`` package) and/or Zstandard
(the ``zstandard`` package) algorithms are installed, then their encodings are
included in the string ('br' and 'zstd', respectively).
List will get joined by comma.
String will be used as provided.
:param user_agent:
String representing the user-agent you want, such as
"python-urllib3/0.6"
:param basic_auth:
Colon-separated username:password string for 'authorization: basic ...'
auth header.
:param proxy_basic_auth:
Colon-separated username:password string for 'proxy-authorization: basic ...'
auth header.
:param disable_cache:
If ``True``, adds 'cache-control: no-cache' header.
Example:
.. code-block:: python
import urllib3
print(urllib3.util.make_headers(keep_alive=True, user_agent="Batman/1.0"))
# {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
print(urllib3.util.make_headers(accept_encoding=True))
# {'accept-encoding': 'gzip,deflate'}
�,r r
z
keep-alive�
connectionzBasic zlatin-1�
authorizationzproxy-authorizationzno-cachez
cache-control)�
isinstance�str�list�join�ACCEPT_ENCODINGr �encode�decode)�
keep_alive�accept_encoding�
user_agent�
basic_auth�proxy_basic_auth�
disable_cache�headerss r � make_headersr3 7 s� � �b !�G�� �o�s� +� +� �
���
.�
.� !�h�h�� 7�O� -�O�%4�!�"�� *� � �� ,�� � ���Y�z� 0� 0�� ;�<�C�C�E�F� G� �� � ��Y� /� 6� 6�y� A�B�I�I�K�L� M� �%�&� �#-��� � �Nr c � � Ub
[ X5 U$ [ U SS5 b U R 5 nU$ U$ ! [ a
[ n U$ f = f)zs
If a position is provided, move file to that point.
Otherwise, we'll attempt to record a position for future use.
N�tell)� rewind_body�getattrr5 �OSErrorr )�body�poss r �set_file_positionr; � sa � � ���D� � �J�
��v�t� $� 0� ��)�)�+�C� �J�3�J�� � � �C� �J� �s �4 �A�Ac �� � [ U SS5 nUb [ U[ 5 ( a
U" U5 gU[
L a [ S5 e[
S[ U5 S35 e! [ a n[ S5 UeSnAff = f)z�
Attempt to rewind body to a certain position.
Primarily used for request redirects and retries.
:param body:
File-like object that supports seek.
:param int pos:
Position to seek to in file.
�seekNzAAn error occurred when rewinding request body for redirect/retry.zRUnable to record file position for rewinding request body during a redirect/retry.z1body_pos must be of type integer, instead it was �.)r7 r% �intr8 r r �
ValueError�type)r9 �body_pos� body_seek�es r r6 r6 � s� � � ��f�d�+�I�� ��H�c�!:�!:� � �h� �
�[� �#�
4�
�
�
�?��X��?O�q� Q�
�
�� � �'�S���
�� �s �A �
A7�& A2�2A7c �* � \ rS rSr% S\S' S\S' Srg)�ChunksAndContentLength� z typing.Iterable[bytes] | None�chunksz
int | None�content_lengthr N)r r r r �__annotations__r r r r rF rF � s � � )�)� � r rF c � ^ ^� T c SnUR 5 [ ; a SnOxSnOu[ T [ [ 45 ( a [ T 5 4n[
US 5 nO?[ T S5 ( a SUU 4S jjnU" 5 nSnO [ T 5 nT 4nUR n[ X4S9$ ! [ a/ [ T 5 nSn N#! [ a [ ST < 35 Sef = ff = f)a: Takes the HTTP request method, body, and blocksize and
transforms them into an iterable of chunks to pass to
socket.sendall() and an optional 'Content-Length' header.
A 'Content-Length' of 'None' indicates the length of the body
can't be determined so should use 'Transfer-Encoding: chunked'
for framing instead.
Nr �readc 3 � ># � [ T[ R 5 n TR T5 nU( d g U ( a UR S5 nUv � M7 7f)Nzutf-8)r% �io�
TextIOBaserL r* )r* � datablock� blocksizer9 s ��r �chunk_readable�&body_to_chunks.<locals>.chunk_readable� sJ �� � � ��b�m�m�4�F�� �I�I�i� 0� � ��� )� 0� 0�� 9�I� ��
�s �AAzO'body' must be a bytes-like object, file-like object, or iterable. Instead was )rH rI )�returnztyping.Iterable[bytes])
�upper�_METHODS_NOT_EXPECTING_BODYr% r& �bytesr �len�hasattr�
memoryview�nbytes� TypeError�iterrF )r9 �methodrQ rH rI rR �mvs ` ` r �body_to_chunksr` � s� �� �$ �|��� �<�<�>�!<� <� �N� !�N�
�D�3��,� '� '��4�.�"�� �V�A�Y� ��
��v� � � � � �!�� �� '��D�!�B� �W�F� �Y�Y�N� !�� O�O�� � �
� �d���!%��� �
� �8�8<�x�A�� � �
�� �s � B$ �$
C �/
B>�>C�C )NNNNNN)r, � bool | Noner- z bool | list[str] | str | Noner. �
str | Noner/ rb r0 rb r1 ra rT zdict[str, str])r9 z
typing.Anyr: �_TYPE_BODY_POSITION | NonerT rc )r9 ztyping.IO[typing.AnyStr]rB �_TYPE_BODY_POSITIONrT �None)r9 ztyping.Any | Noner^ r& rQ r? rT rF )&�
__future__r rN �typing�base64r �enumr �
exceptionsr �utilr �
TYPE_CHECKINGr
� SKIP_HEADER� frozenset�SKIPPABLE_HEADERSr) �
brotlicffi�_unused_module_brotli� ImportError�brotli� zstandard�_unused_module_zstdr r r rJ �Unionr? rd rV r3 r; r6 �
NamedTuplerF r` r r r �<module>rx s� �� "� �
� � � .� � ��� � "� � � G�H� � �� �/�2� �u� �O� �+� �w� �O��t� � (8�'=�'=� �
$� =� �l�l�3�(8�#8�9� � W� � #�59� !� !�#'�!%�
N��N�2�N� �N� � N�
!� N� �
N� �N�b�
��5�� ��(
�< �V� .� .� �
CP�
�CP�%(�CP�58�CP��CP��M � /�.�/��� �� �� � �� �s< �C �C< �
C-�*C0 �,C-�-C0 �0C9�8C9�<D�D