codekingpro/portable-devtools
114k
1�
2 ��j�T � � � S SK Jr S SKrS SKrS SKJr S SKJr SSKJ r SSKJ3r4 SSK J r
SS KJr \R ( a S S5KJr S S KJr S S jr S S S
jjr S S jr S S!S jjrS"S jr S# S$S jjrS%S jr " S S5 r S& S'S jjr " S S5 r " S S5 r " S S\R> 5 r g)(� )� annotationsN)�partial��update_wrapper� )�ClientDisconnected)�RequestEntityTooLarge)�utils)�host_is_trusted)�WSGIApplication)�WSGIEnvironmentc �$ ^ � [ U 4S jT 5 $ )z�Marks a function as responder. Decorate a function with it and it6will automatically call the return value as WSGI application.7 8Example::9 10 @responder11 def application(environ, start_response):12 return Response('Hello World!')13c � >� T" U 6 " U SS 6 $ )N������ )�a�fs ��SD:\code\apps\devtools\python\user_packages\Python313\site-packages\werkzeug/wsgi.py�<lambda>�responder.<locals>.<lambda> s �� �Q��U�A�b�c�F�^� r )r s `r � responderr s �� � �3�Q� 7�7r c � � U S [ X5 S.nU( d\ U R SS5 US' U( d@ U R SS5 US' U( d$ U R SS5 R S 5 US14' [ R " S 0 UD6$ ) a, Recreate the URL for a request from the parts in a WSGI15environment.16 17The URL is an IRI, not a URI, so it may contain Unicode characters.18Use :func:`~werkzeug.urls.iri_to_uri` to convert it to ASCII.19 20:param environ: The WSGI environment to get the URL parts from.21:param root_only: Only build the root path, don't include the22 remaining path or query string.23:param strip_querystring: Don't include the query string.24:param host_only: Only build the scheme and host.25:param trusted_hosts: A list of trusted host names to validate the26 host against.27�wsgi.url_scheme)�scheme�host� SCRIPT_NAME� � root_path� PATH_INFO�path� QUERY_STRING�latin1� query_stringr )�get_host�get�encode�
_sansio_utils�get_current_url)�environ� root_only�strip_querystring� host_only�
trusted_hosts�partss r r) r) s� � �, �+�,���0�
�E�28 � $�[�[� �� ;��k��� #�K�K� �R� 8�E�&�M�$�(/� � �N�B�(G�(N�(N�x�(X��n�%� � (� (� 1�5� 1�1r c � � U R S5 nUc g [ U R SS 5 5 nX4$ ! [ [ 4 a S n X4$ f = f)N� SERVER_NAME� SERVER_PORT)r& �int� TypeError�29ValueError)r* �name�ports r � _get_serverr8 E sa � � �;�;�}� %�D� �|��� �w�{�{�=�$� ?�@��30 �:���
�z� "� ��� �:�� �s �5 �A � A c �j � [ R " U S U R S5 [ U 5 U5 $ )a Get and validate a request's ``host:port`` based on the values in the31given WSGI environ.32 33The ``Host`` header sent by the client is preferred. Otherwise, the server's34configured address is used. If the server address is a Unix socket, it is35ignored. The port is omitted if it matches the standard HTTP or HTTPS ports.36 37The value is passed through :func:`host_is_trusted`. The host must be made38up of valid characters, but this does not check validity beyond that. If a39list of trusted domains is given, the domain must match one.40 41:param environ: The WSGI environ.42:param trusted_hosts: A list of trusted domains to match. These should43 already be IDNA encoded, but will be encoded if needed. The port is44 ignored for this check. If a name starts with a dot it will match as a45 suffix, accepting all subdomains. If empty or ``None``, all domains are46 allowed.47 48:return: Host, with port if necessary.49:raise .SecurityError: If the host is not trusted.50 51.. versionchanged:: 3.252 The characters of the host value are validated. The empty string is no53 longer allowed if no header value is available.54 55.. versionchanged:: 3.256 When using the server address, Unix sockets are ignored.57 58.. versionchanged:: 3.1.359 If ``SERVER_NAME`` is IPv6, it is wrapped in ``[]``.60r � HTTP_HOST)r( r% r& r8 )r* r. s r r% r% V s8 � �D � !� !��!�"�� � �K� ��G� �� � r c �h � [ R " U R S5 U R S5 S9$ )aP Return the ``Content-Length`` header value as an int. If the header is not given61or the ``Transfer-Encoding`` header is ``chunked``, ``None`` is returned to indicate62a streaming request. If the value is not an integer, or negative, 0 is returned.63 64:param environ: The WSGI environ to get the content length from.65 66.. versionadded:: 0.967�CONTENT_LENGTH�HTTP_TRANSFER_ENCODING)�http_content_length�http_transfer_encoding)r( �get_content_lengthr& )r* s r r@ r@ � s1 � � � +� +� #�K�K�(8� 9� &�{�{�+C� D� � r c �� � [ R " [ R [ U S 5 n[ U 5 nUb Ub XB:� a68 [ 5 eSU ; a9 Ub4 [ R " [ R [ [
X2SS95 $ U$ Uc U( a [ R " 5 $ U$ [ R " [ R [ [
X45 5 $ )aT Return the WSGI input stream, wrapped so that it may be read safely without going69past the ``Content-Length`` header value or ``max_content_length``.70 71If ``Content-Length`` exceeds ``max_content_length``, a72:exc:`RequestEntityTooLarge`` ``413 Content Too Large`` error is raised.73 74If the WSGI server sets ``environ["wsgi.input_terminated"]``, it indicates that the75server handles terminating the stream, so it is safe to read directly. For example,76a server that knows how to handle chunked requests safely would set this.77 78If ``max_content_length`` is set, it can be enforced on streams if79``wsgi.input_terminated`` is set. Otherwise, an empty stream is returned unless the80user explicitly disables this safe fallback.81 82If the limit is reached before the underlying stream is exhausted (such as a file83that is too large, or an infinite stream), the remaining contents of the stream84cannot be read safely. Depending on how the server handles this, clients may show a85"connection reset" failure instead of seeing the 413 response.86 87:param environ: The WSGI environ containing the stream.88:param safe_fallback: Return an empty stream when ``Content-Length`` is not set.89 Disabling this allows infinite streams, which can be a denial-of-service risk.90:param max_content_length: The maximum length that content-length or streaming91 requests may not exceed.92 93.. versionchanged:: 2.3.294 ``max_content_length`` is only applied to streaming requests if the server sets95 ``wsgi.input_terminated``.96 97.. versionchanged:: 2.398 Check ``max_content_length`` and raise an error if it is exceeded.99 100.. versionadded:: 0.9101z102wsgi.inputzwsgi.input_terminatedT)�is_max) �t�cast�IO�bytesr@ r �
LimitedStream�io�BytesIO)r* �
safe_fallback�max_content_length�stream�content_lengths r �get_input_streamrN � s� � �N �V�V�A�D�D��K�� �!6�
7�F�'��0�N��!�&8�&D� � .�'�)� )� �'�)� � )� �6�6����U� �]�6�d� S��
� �
�103 � � ,�r�z�z�|�8�&�8� �6�6�!�$�$�u�+�}�V� D� E�Er c �b � U R SS5 R S5 nUR SS9$ )z�Return ``PATH_INFO`` from the WSGI environment.104 105:param environ: WSGI environment to get the path from.106 107.. versionchanged:: 3.0108 The ``charset`` and ``errors`` parameters were removed.109 110.. versionadded:: 0.9111r r r# �replace)�errors)r& r' �decode)r* r! s r �
get_path_inforS � s0 � � �+�+�k�2�.�5�5�h�?�D� �;�;�i�;� (�(r c �P � \ rS rSrSr S S112S jjrS S jrS S jrS
S jrSr g)�ClosingIterator�� a The WSGI specification requires that all middlewares and gateways113respect the `close` callback of the iterable returned by the application.114Because it is useful to add another close action to a returned iterable115and adding a custom iterable is a boring task this class can be used for116that::117 118 return ClosingIterator(app(environ, start_response), [cleanup_session,119 cleanup_locals])120 121If there is just one close function it can be passed instead of the list.122 123A closing iterator is not needed if the application uses response objects124and finishes the processing if the response is started::125 126 try:127 return response(environ, start_response)128 finally:129 cleanup_session()130 cleanup_locals()131Nc �> � [ U5 n[ R " [ R / [ 4 [ [ U5 5 U l Uc / nO [ U5 ( a U/nO [ U5 n[ USS 5 nU( a UR SU5 X l g )N�closer )
�iterrC rD �CallablerF r �next�_next�callable�list�getattr�insert�132_callbacks)�self�iterable� callbacks�iterator�iterable_closes r �__init__�ClosingIterator.__init__� s � � ��>���V�V�A�J�J�r�5�y� 1�7�4��3J�K��133� � ��I�
�i�
�
�"� �I� �Y��I� ��7�D�9�� � � � �Q�� /�#�r c � � U $ �Nr �rb s r �__iter__�ClosingIterator.__iter__134 � � �� r c �" � U R 5 $ rj )r\ rk s r �__next__�ClosingIterator.__next__
s � ��z�z�|�r c �8 � U R H135 nU" 5 M g rj )ra )rb �callbacks r rX �ClosingIterator.close s � � ���H� �J� (r )ra r\ rj )rc �t.Iterable[bytes]rd z@None | (t.Callable[[], None] | t.Iterable[t.Callable[[], None]])�return�None)rv rU �rv rF �rv rw )136�__name__�137__module__� __qualname__�__firstlineno__�__doc__rg rl rp rX �__static_attributes__r r r rU rU � s? � ��2 GK� $�#�$�D�$�138 139� $�&� �r rU c �: � U R S[ 5 " X5 $ )ag Wraps a file. This uses the WSGI server's file wrapper if available140or otherwise the generic :class:`FileWrapper`.141 142.. versionadded:: 0.5143 144If the file wrapper from the WSGI server is used it's important to not145iterate over it from inside the application but to pass it through146unchanged. If you want to pass out a file wrapper inside a response147object you have to set :attr:`Response.direct_passthrough` to `True`.148 149More information about file wrappers are available in :pep:`333`.150 151:param file: a :class:`file`-like object with a :meth:`~file.read` method.152:param buffer_size: number of bytes for one iteration.153zwsgi.file_wrapper)r& � FileWrapper)r* �file� buffer_sizes r � wrap_filer� s � �$ �;�;�*�K� 8� � � r c �b � \ rS rSrSrS S
S jjrSS jrSS jrSS jrSS jr SS jr154SS jr S155r g )r� i, a0 This class can be used to convert a :class:`file`-like object into156an iterable. It yields `buffer_size` blocks until the file is fully157read.158 159You should not use this class directly but rather use the160:func:`wrap_file` function that uses the WSGI server's file wrapper161support if it's available.162 163.. versionadded:: 0.5164 165If you're using this object together with a :class:`Response` you have166to use the `direct_passthrough` mode.167 168:param file: a :class:`file`-like object with a :meth:`~file.read` method.169:param buffer_size: number of bytes for one iteration.170c � � Xl X l g rj )r� r� )rb r� r� s r rg �FileWrapper.__init__> s
� �� �&�r c �p � [ U R S5 ( a U R R 5 g g �NrX )�hasattrr� rX rk s r rX �FileWrapper.closeB s& � � �4�9�9�g� &� &� �I�I�O�O� � 'r c � � [ U R S5 ( a U R R 5 $ [ U R S5 ( a gg)N�seekable�seekTF)r� r� r� rk s r r� �FileWrapper.seekableF s= � � �4�9�9�j� )� )��9�9�%�%�'� '� �4�9�9�f� %� %��r c �n � [ U R S5 ( a U R R " U6 g g )Nr� )r� r� r� )rb �argss r r� �FileWrapper.seekM s( � � �4�9�9�f� %� %� �I�I�N�N�D� !� &r c �n � [ U R S5 ( a U R R 5 $ g )N�tell)r� r� r� rk s r r� �FileWrapper.tellQ s' � � �4�9�9�f� %� %��9�9�>�>�#� #�r c � � U $ rj r rk s r rl �FileWrapper.__iter__V rn r c �r � U R R U R 5 nU( a U$ [ 5 erj )r� �readr� �
StopIteration)rb �datas r rp �FileWrapper.__next__Y s* � ��y�y�~�~�d� .� .�/�� ��K��o� r )r� r� N�i )r� � t.IO[bytes]r� r3 rv rw ry �rv �bool)r� zt.Anyrv rw )rv �171int | None)rv r� rx )
rz r{ r| r} r~ rg rX r� r� r� rl rp r r r r r� r� , s* � ��"'� ��"��172� r r� c �p � \ rS rSrSr S S
S jjrSS jrSS jrSS jrSS jr SS jr173SS174 jr S r g)�
_RangeWrapperi` aK This class can be used to convert an iterable object into175an iterable that will only yield a piece of the underlying content.176It yields blocks until the underlying stream range is fully read.177The yielded blocks will have a size that can't exceed the original178iterator defined block size, but that can be smaller.179 180If you're using this object together with a :class:`Response` you have181to use the `direct_passthrough` mode.182 183:param iterable: an iterable object with a :meth:`__next__` method.184:param start_byte: byte from which read will start.185:param byte_range: how many bytes to read.186Nc �� � [ U5 U l X0l X l S U l Ub X#- U l SU l [
US5 =( a UR 5 U l SU l g )Nr r� F) rY rc �187byte_range�188start_byte�end_byte� read_lengthr� r� � end_reached)rb rc r� r� s r rg �_RangeWrapper.__init__q s\ � � �X���
�$��$�� ��
� � !� &� 3�D�M� ��� ��*�5�M�(�:K�:K�:M��
� ��r c � � U $ rj r rk s r rl �_RangeWrapper.__iter__� rn r c � � [ U R 5 nU =R [ U5 -
sl U$ ! [ a SU l e f = f�NT)r[ rc r� �lenr� r� �rb �chunks r � _next_chunk�_RangeWrapper._next_chunk� sI � � ��� � �'�E� � � ��E�189� *� ��L�� � � #�D� � � �s �47 �A190c � � S nU R ( aS U R R U R 5 U R R 5 U l U R191 nX4$ U R192 U R :: a, U R
5 nU R193 U R :: a M, Ub XR U R194 -195 S nU R nX4$ rj )r� rc r� r� r� r� r� �rb r� �contextual_read_lengths r �_first_iteration� _RangeWrapper._first_iteration� s� � ��� �=�=� �M�M� � �t��� /� #�}�}� 1� 1� 3�D� �%)�%5�%5� "� �,�,� �"�"�d�o�o�5� �(�(�*�� �"�"�d�o�o�5�� � �o�o��0@�0@� @� B�C��%)�_�_� "��,�,r c �B � U R ( a196 [ 5 eS nU R nU R S:X a U R 5 u pUc U R 5 nU R197 b3 U R U R198 :� a SU l US U R199 U-200 $ U$ )Nr T)r� r� r� r� r� r� r� s r r\ �_RangeWrapper._next� s� � � � � � �/� !���!%�!1�!1� � � � �q� �,0�,A�,A�,C� )�E� �=��$�$�&�E� �=�=� $��)9�)9�T�]�]�)J� #�D� ��A�4�=�=�+A�A�B� B�� r c �V � U R 5 nU( a U$ SU l [ 5 er� )r\ r� r� r� s r rp �_RangeWrapper.__next__� s% � ��201�202� �� ��L� ����o� r c �p � [ U R S5 ( a U R R 5 g g r� )r� rc rX rk s r rX �_RangeWrapper.close� s( � � �4�=�=�'� *� *� �M�M� � � !� +r )r� r� r� rc r� r� r� )r N)rc z t.Iterable[bytes] | t.IO[bytes]r� r3 r� r� )rv r� rx )rv ztuple[bytes | None, int]ry )
rz r{ r| r} r~ rg rl r� r� r\ rp rX r r r r r� r� ` sN � � �" �!%� !�1�!� �!� � !�$�� -� � �"r r� c � � \ rS rSrSrSSS jjr\SS j5 rSS jrSSS jjr SS jr203SS jr SS204 jr SS jr
SS jrS
rg)rG i� a� Wrap a stream so that it doesn't read more than a given limit. This is used to205limit ``wsgi.input`` to the ``Content-Length`` header value or206:attr:`.Request.max_content_length`.207 208When attempting to read after the limit has been reached, :meth:`on_exhausted` is209called. When the limit is a maximum, this raises :exc:`.RequestEntityTooLarge`.210 211If reading from the stream returns zero bytes or raises an error,212:meth:`on_disconnect` is called, which raises :exc:`.ClientDisconnected`. When the213limit is a maximum and zero bytes were read, no error is raised, since it may be the214end of the stream.215 216If the limit is reached before the underlying stream is exhausted (such as a file217that is too large, or an infinite stream), the remaining contents of the stream218cannot be read safely. Depending on how the server handles this, clients may show a219"connection reset" failure instead of seeing the 413 response.220 221:param stream: The stream to read from. Must be a readable binary IO object.222:param limit: The limit in bytes to not read past. Should be either the223 ``Content-Length`` header value or ``request.max_content_length``.224:param is_max: Whether the given ``limit`` is ``request.max_content_length`` instead225 of the ``Content-Length`` header value. This changes how exhausted and226 disconnect events are handled.227 228.. versionchanged:: 2.3229 Handle ``max_content_length`` differently than ``Content-Length``.230 231.. versionchanged:: 2.3232 Implements ``io.RawIOBase`` rather than ``io.IOBase``.233c �6 � Xl SU l X l X0l g )Nr )�_stream�_pos�limit�
_limit_is_max)rb rL r� rB s r rg �LimitedStream.__init__� s � � � ��� ��234� #�r c �4 � U R U R :� $ )z:Whether the current stream position has reached the limit.)r� r� rk s r � is_exhausted�LimitedStream.is_exhausted� s � � �y�y�D�J�J�&�&r c �: � U R ( a235 [ 5 eg)aR Called when attempting to read after the limit has been reached.236 237The default behavior is to do nothing, unless the limit is a maximum, in which238case it raises :exc:`.RequestEntityTooLarge`.239 240.. versionchanged:: 2.3241 Raises ``RequestEntityTooLarge`` if the limit is a maximum.242 243.. versionchanged:: 2.3244 Any return value is ignored.245N)r� r rk s r � on_exhausted�LimitedStream.on_exhausted� s � � � � �'�)� )� r Nc �@ � U R ( a Ub246 [ 5 eg)a� Called when an attempted read receives zero bytes before the limit was247reached. This indicates that the client disconnected before sending the full248request body.249 250The default behavior is to raise :exc:`.ClientDisconnected`, unless the limit is251a maximum and no error was raised.252 253.. versionchanged:: 2.3254 Added the ``error`` parameter. Do nothing if the limit is a maximum and no255 error was raised.256 257.. versionchanged:: 2.3258 Any return value is ignored.259N)r� r )rb �errors r �
on_disconnect�LimitedStream.on_disconnect� s � � �!�!�U�%6�$�&� &� &7r c �F � U R ( d U R 5 $ g)a Exhaust the stream by reading until the limit is reached or the client260disconnects, returning the remaining data.261 262.. versionchanged:: 2.3263 Return the remaining data.264 265.. versionchanged:: 2.2.3266 Handle case where wrapped stream returns fewer bytes than requested.267r )r� �readallrk s r �exhaust�LimitedStream.exhaust s � � � � ��<�<�>� !�r c �& � [ U5 nU R U R -268 nUS:: a U R 5 g[ U R269 S5 ( aU X#:: a U R270 R
U5 nOg[ U5 n U R271 R
U5 nU( a XaS U& O4 U R272 R [ X#5 5 n[ U5 nXqS U& U( d U R 5 gU =R U-
sl U$ ! [ [ 4 a nU R US9 S nAgS nAff = f! [ [ 4 a nU R US9 S nAgS nAff = f! [ [ 4 a nU R US9 S nAgS nAff = f)Nr �readinto)r� )
r� r� r� r� r� r� r� �OSErrorr5 r� � bytearrayr� �min)rb �b�size� remaining�out_size�e�temp_br� s r r� �LimitedStream.readinto sn � ��1�v���J�J����*� � ��>� � � � �� �4�<�<�� ,� ,�� � �+/�<�<�+@�+@��+C�H� #�9�-�� � #�|�|� 4� 4�V� <�H�273 �#)�i�x�L��
��|�|�(�(��T�)=�>��274 �4�y�H� �i�x�L�� � � � �� � � �X� � ����A ��,� ��&�&�Q�&�/� �� �� ��,� ��&�&�Q�&�/� �� �� �Z�(�
��"�"��"�+���
�sH � D �D; �-$E' �D8� D3�3D8�;E$� E � E$�'F�7F � Fc � � U R ( a U R 5 g[ 5 nU R ( d= U R S5 nU( d O$UR U5 U R ( d M= [ U5 $ )Nr i )r� r� r� r� �extendrF )rb �outr� s r r� �LimitedStream.readallF sh � � � � � � � � ���k�� �#�#��9�9�Y�'�D� �� �J�J�t� � �#�#�#� �S�z�r c � � U R $ )z;Return the current stream position.275 276.. versionadded:: 0.9277)r� rk s r r� �LimitedStream.tellY s � �278 �y�y�r c � � gr� r rk s r �readable�LimitedStream.readable` s � �r )r� r� r� r� )F)rL r� r� r3 rB r� rv rw r� ry rj )r� zException | Nonerv rw rx )r� r� rv r� )rv r3 )rz r{ r| r} r~ rg �propertyr� r� r� r� r� r� r� r� r r r r rG rG � sD � � �>$� �'� �'�
*� '�,
� .�`�&�r rG )r z t.Callable[..., WSGIApplication]rv r )FFFN) r* r
r+ r� r, r� r- r� r. �t.Collection[str] | Nonerv �str)r* r
rv z tuple[str, int | None] | Nonerj )r* r
r. r� rv r� )r* r
rv r� )TN)r* r
rJ r� rK r� rv r� )r* r
rv r� r� )r* r
r� r� r� r3 rv ru )!�279__future__r rH �typingrC � functoolsr r �280exceptionsr r �sansior281 r( � sansio.utilsr �
TYPE_CHECKING�_typeshed.wsgir r
r r) r8 r% r@ rN rS rU r� r� r� � RawIOBaserG r r r �<module>r� s_ �� "� � � � $� *� -� *� )��?�?�.�.�2828� � #��.2� #2�
�#2��#2� �#2� � #2�283 ,� #2� �
#2�L�
��"��$ IM�'�
�'�-E�'��'�T �" �%)�AF�
�AF��AF� #�AF� � AF�H )� 1� 1�j EI��
��$/��>A����.1 � 1 �hT"� T"�nj�B�L�L� jr