codekingpro/portable-devtools
114k
1�
2 ��j1* � �� � S SK Jr S SKrS SKrS SKr\R \\4 r \R \ \3\\ 4 \4\\ \4 4 r S5 S S jjr S S jr
S S jrS S jrS S jr " S S 5 rg)
� )� annotationsNc �X � U ( a" [ R " U 5 S =( d U$ U$ )z�6Guess the "Content-Type" of a file.7 8:param filename:9 The filename to guess the "Content-Type" of using :mod:`mimetypes`.10:param default:11 If no "Content-Type" can be guessed, default to `default`.12r )� mimetypes�13guess_type)�filename�defaults �TD:\code\apps\devtools\python\user_packages\Python313\site-packages\urllib3/fields.py�guess_content_typer14 s' � � ��#�#�H�-�a�0�;�G�;� �N� c �l ^� SSK nUR S[ SS9 [ T[ 5 ( a TR S5 m[
U4S jS 5 5 ( d U S T S153n UR S 5 U$ [ R R TS5 mU S T 3mT$ ! [ [ 4 a N;f = f)
av 16Helper function to format and quote a single header parameter using the17strategy defined in RFC 2231.18 19Particularly useful for header parameters which might contain20non-ASCII values, like file names. This follows21`RFC 2388 Section 4.4 <https://tools.ietf.org/html/rfc2388#section-4.4>`_.22 23:param name:24 The name of the parameter, a string expected to be ASCII only.25:param value:26 The value of the parameter, provided as ``bytes`` or `str``.27:returns:28 An RFC-2231-formatted unicode string.29 30.. deprecated:: 2.0.031 Will be removed in urllib3 v3.0. This is not valid for32 ``multipart/form-data`` header parameters.33r Nz�'format_header_param_rfc2231' is insecure, deprecated and will be removed in urllib3 v3.0. This is not valid for multipart/form-data header parameters.� ��34stacklevel�utf-8c 3 �, ># � U H oT; v � M g 7f�N� )�.0�ch�values �r � <genexpr>�.format_header_param_rfc2231.<locals>.<genexpr>@ s �� � �/�Y�r�U�{�Y�s �z"\
35�="�"�asciiz*=)
�warnings�warn�
FutureWarning�36isinstance�bytes�decode�any�encode�UnicodeEncodeError�UnicodeDecodeError�email�utils�encode_rfc2231)�namer r �results ` r �format_header_param_rfc2231r+ s� �� �( � �M�M� 1� �� � � �%�� � �� � �W�%�� �/�Y�/� /� /��6��E�7�!�$�� � �M�M�'� "� �M� �K�K� &� &�u�g� 6�E��f�B�u�g� �E� �L�� #�$6�7� � � �s �$B � B3�2B3c � � [ U[ 5 ( a UR S5 nUR SSSS.5 nU SU S3$ )a� 37Format and quote a single multipart header parameter.38 39This follows the `WHATWG HTML Standard`_ as of 2021/06/10, matching40the behavior of current browser and curl versions. Values are41assumed to be UTF-8. The ``\n``, ``\r``, and ``"`` characters are42percent encoded.43 44.. _WHATWG HTML Standard:45 https://html.spec.whatwg.org/multipage/46 form-control-infrastructure.html#multipart-form-data47 48:param name:49 The name of the parameter, an ASCII-only ``str``.50:param value:51 The value of the parameter, a ``str`` or UTF-8 encoded52 ``bytes``.53:returns:54 A string ``name="value"`` with the escaped value.55 56.. versionchanged:: 2.0.057 Matches the WHATWG HTML Standard as of 2021/06/10. Control58 characters are no longer percent encoded.59 60.. versionchanged:: 2.0.061 Renamed from ``format_header_param_html5`` and62 ``format_header_param``. The old names will be removed in63 urllib3 v3.0.64r z%0Az%0Dz%22)�65 �
�" r r )r r r! � translate)r) r s r � format_multipart_header_paramr1 O sI � �< �%�� � �� � �W�%��
�O�O��E�u� =� >�E��V�2�e�W�A� � r c �J � SSK nUR S[ SS9 [ X5 $ )�r66.. deprecated:: 2.0.067 Renamed to :func:`format_multipart_header_param`. Will be68 removed in urllib3 v3.0.69r Nz~'format_header_param_html5' has been renamed to 'format_multipart_header_param'. The old name will be removed in urllib3 v3.0.r
r �r r r r1 �r) r r s r �format_header_param_html5r6 u �2 � � � �M�M� #� �� � � )�� 5�5r c �J � SSK nUR S[ SS9 [ X5 $ )r3 r Nzx'format_header_param' has been renamed to 'format_multipart_header_param'. The old name will be removed in urllib3 v3.0.r
r r4 r5 s r �format_header_paramr9 � r7 r c � � \ rS rSrSr S S S jjr\ S
SS jj5 rSS jr SS jr SS jr70 S SS jjr S71r g)� RequestField� a� 72A data container for request body parameters.73 74:param name:75 The name of this request field. Must be unicode.76:param data:77 The data/value body.78:param filename:79 An optional filename of the request field. Must be unicode.80:param headers:81 An optional dict-like object of headers to initially use for the field.82 83.. versionchanged:: 2.0.084 The ``header_formatter`` parameter is deprecated and will85 be removed in urllib3 v3.0.86Nc �� � Xl X0l X l 0 U l U( a [ U5 U l Ub SS KnUR
S[ SS9 XPl g [ U l g )Nr zSThe 'header_formatter' parameter is deprecated and will be removed in urllib3 v3.0.r
r )87�_name� _filename�data�headers�dictr r r �header_formatterr1 )�selfr) r@ r rA rC r s r �__init__�RequestField.__init__� s] � � �88�!��� �.0�� � � ��=�D�L� � '� � �M�M�3� � �
�
� %5� !�$A�D� !r c � � [ U[ 5 ( a% [ U5 S:X a Uu pEnOUu pE[ U5 nOSnSnUnU " XXCS9nUR US9 U$ )aS 89A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters.90 91Supports constructing :class:`~urllib3.fields.RequestField` from92parameter of key/value strings AND key/filetuple. A filetuple is a93(filename, data, MIME type) tuple where the MIME type is optional.94For example::95 96 'foo': 'bar',97 'fakefile': ('foofile.txt', 'contents of foofile'),98 'realfile': ('barfile.txt', open('realfile').read()),99 'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'),100 'nonamefile': 'contents of nonamefile field',101 102Field names and filenames must be unicode.103� N)r rC )� content_type)r �tuple�lenr104 �make_multipart)�cls� fieldnamer rC r r@ rI �
request_params r � from_tuples�RequestField.from_tuples� sn � �6 �e�U� #� #��5�z�Q��/4�,�� �!&��� 1�(� ;� ��H� �L��D�� �h�105�
� �$�$�,�$�?� � r c �$ � U R X5 $ )a; 106Override this method to change how each multipart header107parameter is formatted. By default, this calls108:func:`format_multipart_header_param`.109 110:param name:111 The name of the parameter, an ASCII-only ``str``.112:param value:113 The value of the parameter, a ``str`` or UTF-8 encoded114 ``bytes``.115 116:meta public:117)rC )rD r) r s r � _render_part�RequestField._render_part� s � � �$�$�T�1�1r c �� � / n[ U[ 5 ( a UR 5 nOUnU H* u pEUc M118 UR U R XE5 5 M, SR U5 $ )a 119Helper function to format and quote a single header.120 121Useful for single headers that are composed of multiple items. E.g.,122'Content-Disposition' fields.123 124:param header_parts:125 A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format126 as `k1="v1"; k2="v2"; ...`.127�; )r rB �items�appendrS �join)rD � header_parts�parts�iterabler) r s r �
_render_parts�RequestField._render_parts sc � �& �� �l�D� )� )�#�)�)�+�H�#�H�#�K�D�� �� � �T� .� .�t� ;�<� $� �y�y�� � r c � � / n/ SQnU HI nU R R US5 ( d M& UR U SU R U 35 MK U R R 5 H+ u pEXB; d M U( d M UR U SU 35 M- UR S5 SR U5 $ )z-128Renders the headers for this request field.129)�Content-Disposition� Content-Type�Content-LocationFz: z
130)rA �getrX rW rY )rD �lines� sort_keys�sort_key� header_name� header_values r �render_headers�RequestField.render_headers# s� � � ��O� �!�H��|�|� � ��%�0�0�� � ��z��D�L�L��,B�+C� D�E� "� *.� � �);�);�)=� %�K��+� �<��L�L�K�=��<�.�!A�B� *>�131 � � �V� ��{�{�5�!�!r c �� � U=( d SSR SU R SU R 4SU R 445 /5 - nXR S' X R S' X0R S' g )132a� 133Makes this request field into a multipart request field.134 135This method overrides "Content-Disposition", "Content-Type" and136"Content-Location" headers to the request parameter.137 138:param content_disposition:139 The 'Content-Disposition' of the request body. Defaults to 'form-data'140:param content_type:141 The 'Content-Type' of the request body.142:param content_location:143 The 'Content-Location' of the request body.144 145z form-datarV � r) r r` ra rb N)rY r] r> r? rA )rD �content_dispositionrI �content_locations r rL �RequestField.make_multipart6 sy � �( 3� A�k�T�Y�Y���"�"� �d�j�j�)�J����+G�H��
�F146� 147�� /B� � �*�+�'3� � �^�$�+;� � �'�(r )r? r> r@ rC rA )NNN)148r) �strr@ �_TYPE_FIELD_VALUEr �149str | NonerA z typing.Mapping[str, str] | NonerC �5typing.Callable[[str, _TYPE_FIELD_VALUE], str] | Noner )rN rp r �_TYPE_FIELD_VALUE_TUPLErC rs �returnr; �r) rp r rq ru rp )rZ z[dict[str, _TYPE_FIELD_VALUE | None] | typing.Sequence[tuple[str, _TYPE_FIELD_VALUE | None]]ru rp )ru rp )rm rr rI rr rn rr ru �None)
�__name__�150__module__� __qualname__�__firstlineno__�__doc__rE � classmethodrP rS r] ri rL �__static_attributes__r r r r; r; � s� � ��* $�37�RV�
B��B� �B� � B�151 1� B� P�
B�8 �152 SW� * ��* � '�* � P� * �153 154� * � �* �X2� �
D� � 155
�
�>"�* +/�#'�'+� <� '� <� !� <� %� <�156 157� <� <r r; )zapplication/octet-stream)r rr r rp ru rp rv )�158__future__r � email.utilsr& r �typing�Unionrp r rq rJ rt r159 r+ r1 r6 r9 r; r r r �<module>r� s� �� "� � �
��L�L��e��,� � �,�,�� �#� �160 �!� �#� �#�161%�&�(�� � *D�
��
�#&�
��
� -�`# �L6�$6�$|<� |<r