codekingpro/portable-devtools
114k
1�
2 ��ja? � �p � S r SSKrSSKrSSKJr SSKrSSKrSSKrSSKrSSKJ r J3r4J r J r J
r
JrJrJrJrJr \R& ( a SSKrSSKJr SSKJr SSKr\r\r \r \R< r " S S\ \\ 4 5 r " S S55 r S \S \ 4S
jr! S+S\ S\ \\ 4 S\6\7\ \\ 4 S S4S jjr"S\\8\# \9\$ \10S 4 S \RJ 4S jr&S\$S \11\' 4S jr(\)" S5 r*S\\ S \4S jr+\RX " S\RZ 5 r.S\S \4S jr/ " S S 5 r0 " S S 5 r1S! r2S"\S#\S \4S$ jr3\Rh Rk S%5 ( d \Rh Rk S&5 S':X a \3r6O SS(K7J8r6 S* r:g! \9 a% \Rh Rk S&5 S):X a e \3r6 N.f = f),a� Miscellaneous utility functions and classes.12 13This module is used internally by Tornado. It is not necessarily expected14that the functions and classes defined here will be useful to other15applications, but they are documented here in case they are.16 17The one public-facing part of this module is the `Configurable` class18and its `~Configurable.configure` method, which becomes a part of the19interface of its subclasses, including `.AsyncHTTPClient`, `.IOLoop`,20and `.Resolver`.21� N)�getfullargspec)22�Any�Optional�Dict�Mapping�List�Tuple�Match�Callable�Type�Sequence)�
TracebackType)�Unionc �@ � \ rS rSrSrS\S\4S jrS\S\SS4S jrS r g)23�24ObjectDict�7 zFMakes a dictionary behave like an object, with attribute-style access.�name�returnc �> � X $ ! [ a [ U5 ef = f�N)�KeyError�AttributeError)�selfr s �RD:\code\apps\devtools\python\user_packages\Python313\site-packages\tornado/util.py� __getattr__�ObjectDict.__getattr__: s) � � '��:� ��� '� ��&� &� '�s � � �valueNc � � X U' g r � )r r r s r � __setattr__�ObjectDict.__setattr__@ s � ��T�25� r )26�__name__�27__module__� __qualname__�__firstlineno__�__doc__�strr r r �__static_attributes__r r" r r r 7 s2 � �P�'�� '�� '� �� �C� �D� r" r c �b � \ rS rSrSrS S jrS
S\S\S\4S jjr\ S\4S j5 r28S\4S29 jr S r g)�GzipDecompressor�D z�Streaming gzip decompressor.30 31The interface is like that of `zlib.decompressobj` (without some of the32optional arguments, but it understands gzip headers and checksums.33r Nc �\ � [ R " S[ R - 5 U l g )N� )�zlib�
decompressobj� MAX_WBITS�r s r �__init__�GzipDecompressor.__init__K s � � "� /� /��T�^�^�0C� D��r" r �34max_lengthc �8 � U R R X5 $ )a} Decompress a chunk, returning newly-available data.35 36Some data may be buffered for later processing; `flush` must37be called when there is no more input data to ensure that38all data was processed.39 40If ``max_length`` is given, some input data may be left over41in ``unconsumed_tail``; you must retrieve this value and pass42it back to a future call to `decompress` if it is not empty.43)r0 �44decompress)r r r5 s r r7 �GzipDecompressor.decompressQ s � � �!�!�,�,�U�?�?r" c �. � U R R $ )z(Returns the unconsumed portion left over)r0 �unconsumed_tailr2 s r r: � GzipDecompressor.unconsumed_tail^ s � � �!�!�1�1�1r" c �6 � U R R 5 $ )z�Return any remaining buffered data not yet returned by decompress.45 46Also checks for errors such as truncated input.47No other methods may be called on this object after `flush`.48)r0 �flushr2 s r r= �GzipDecompressor.flushc s � � �!�!�'�'�)�)r" )r0 �r N)r )
r# r$ r% r& r' r3 �bytes�intr7 �propertyr: r= r) r r" r r+ r+ D sR � �� E� @�� @�3� @�u� @� �2�� 2� �2�*�u� *r" r+ r r c � � U R S5 S:X a [ U 5 $ U R S5 n[ SR USS 5 US /S9n [ X!S 5 $ ! [49 a [
SUS - 5 ef = f)a� Imports an object by name.50 51``import_object('x')`` is equivalent to ``import x``.52``import_object('x.y.z')`` is equivalent to ``from x.y import z``.53 54>>> import tornado.escape55>>> import_object('tornado.escape') is tornado.escape56True57>>> import_object('tornado.escape.utf8') is tornado.escape.utf858True59>>> import_object('tornado') is tornado60True61>>> import_object('tornado.missing_module')62Traceback (most recent call last):63 ...64ImportError: No module named missing_module65�.r N�����)�fromlistzNo module named %s)�count�66__import__�split�join�getattrr � ImportError)r �parts�objs r �
import_objectrO l s� � �$ �z�z�#��!���$� � � �J�J�s�O�E�67�S�X�X�e�C�R�j�)�U�2�Y�K�68@�C�<��s�"�I�&�&�� � <��.��r��:�;�;�<�s �
A! �! A=�code�glob�locc �^ � [ U [ 5 ( a [ U SSSS9n [ XU5 g )Nz<string>�execT)� dont_inherit)�69isinstancer( �compilerT )rP rQ rR s r �exec_inrX � s- � � �$�� � � �t�Z��d�C����S�r" �exc_infor c �b � U S b U S R U S 5 e[ S5 e! Sn f = f)N� � z'raise_exc_info called with no exception)NNN)�with_traceback� TypeError)rY s r �raise_exc_infor_ � s? � �&� �A�;� "��1�+�,�,�X�a�[�9� 9�� E�F� F�� &��s �(* �.�ec �~ � [ U S5 ( a U R $ U R ( a U R S $ g)a4 Provides the errno from an Exception object.70 71There are cases that the errno attribute was not set so we pull72the errno out of the args but if someone instantiates an Exception73without any args you will get a tuple error. So this function74abstracts all that behavior to give you a safe way to get the75errno.76�errnor N)�hasattrrb �args)r` s r �errno_from_exceptionre � s2 � � �q�'����w�w�� 77����v�v�a�y��r" �>abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789�matchc �d � U R S5 nUS [ ; a [ SUS - 5 eU$ )Nr[ r zcannot unescape '\\%s')�group� _alphanum�78ValueError)rg ri s r �_re_unescape_replacementrl � s5 � � �K�K��N�E� �Q�x�9� ��3�e�A�h�>�?�?� �Lr" z\\(.)�sc �6 � [ R [ U 5 $ )z�Unescape a string escaped by `re.escape`.79 80May raise ``ValueError`` for regular expressions which could not81have been produced by `re.escape` (for example, strings containing82``\d`` cannot be unescaped).83 84.. versionadded:: 4.485)�_re_unescape_pattern�subrl )rm s r � re_unescaperq � s � � � #� #�$<�a� @�@r" c � ^ � \ rS rSrSrSrSrS\S\S\4U 4S jjr\ S 5 r86\ S 5 r SS87 jr \ r
\ S 5 r\ S 5 r\ S
5 r\ S 5 rSrU =r$ )� Configurable�� a� Base class for configurable interfaces.88 89A configurable interface is an (abstract) class whose constructor90acts as a factory function for one of its implementation subclasses.91The implementation subclass as well as optional keyword arguments to92its initializer can be set globally at runtime with `configure`.93 94By using the constructor as the factory method, the interface95looks like a normal class, `isinstance` works as usual, etc. This96pattern is most useful when the choice of implementation is likely97to be a global decision (e.g. when `~select.epoll` is available,98always use it instead of `~select.select`), or when a99previously-monolithic class has been split into specialized100subclasses.101 102Configurable subclasses must define the class methods103`configurable_base` and `configurable_default`, and use the instance104method `initialize` instead of ``__init__``.105 106.. versionchanged:: 5.0107 108 It is now possible for configuration to be specified at109 multiple levels of a class hierarchy.110 111Nrd �kwargsr c �L >� U R 5 n0 nXL a= U R 5 nUR ( a UR UR 5 OU nUR U5 UR 5 ULa U" U0 UD6$ [ TU ] U5 nUR " U0 UD6 U$ r )�configurable_base�configured_class�_Configurable__impl_kwargs�update�super�__new__�112initialize)�clsrd ru �base� init_kwargs�impl�instance� __class__s �r r| �Configurable.__new__� s� �� ��$�$�&��� � �;��'�'�)�D��!�!��"�"�4�#5�#5�6���D����6�"� � !� !� #�4� /���-��-� -��7�?�4�(�� ���T�1�[�1��r" c � � [ 5 e)z�Returns the base class of a configurable hierarchy.113 114This will normally return the class in which it is defined.115(which is *not* necessarily the same as the ``cls`` classmethod116parameter).117 118��NotImplementedError�r~ s r rw � Configurable.configurable_base s
� � "�#�#r" c � � [ 5 e)zBReturns the implementation class to be used if none is configured.r� r� s r �configurable_default�!Configurable.configurable_default s
� � "�#�#r" c � � g r r r2 s r � _initialize�Configurable._initialize s � � r" c �� � U R 5 n[ U[ 5 ( a+ [ R " [119 [ [ U5 5 nUb [ X5 ( d [ SU - 5 eXl120 X#l g)z�Sets the class to use when the base class is instantiated.121 122Keyword arguments will be saved and added to the arguments passed123to the constructor. This can be used to set global defaults for124some parameters.125NzInvalid subclass of %s) rw rV r( �typing�castr rs rO �126issubclassrk �_Configurable__impl_classry )r~ r� ru r s r � configure�Configurable.configure$ sf � � �$�$�&�� �d�C� � ��;�;�t�L� 1�=��3F�G�D� � �J�t�$9�$9� � 5�� ;�<� <� �� #�r" c �� � U R 5 nUR R S5 c U R 5 Ul UR b UR $ [ S5 e)z'Returns the currently configured class.r� zconfigured class not found)rw �__dict__�getr� r� rk �r~ r s r rx � Configurable.configured_class5 sa � � �$�$�&�� �=�=� � � 8� 9� A� #� 8� 8� :�D� � � � � (��$�$� $� � 9�:� :r" c �R � U R 5 nUR UR 4$ r �rw r� ry r� s r �_save_configuration� Configurable._save_configurationE s) � � �$�$�&���!�!�4�#5�#5�6�6r" c �L � U R 5 nUS Ul US Ul g )Nr r[ r� )r~ �savedr s r �_restore_configuration�#Configurable._restore_configurationK s* � � �$�$�&�� !�!�H��� "�1�X��r" r r? )r# r$ r% r& r' r� ry r r| � classmethodrw r� r� r} r� rx r� r� r) �
__classcell__)r� s @r rs rs � s� �� ��D �L��M��C� �3� �3� �( � $� � $� �$� �$�127
� �J�� �$� �$� �
;� �
;� �7� �7�128 �&� �&r" rs c
� � \ rS rSrSrS\S\SS4S jrS\S\\ 4S jr SS \129\ S130\ \\ 4 S \ S\ 4S jjr
S
\ S \131\ S132\ \\ 4 S\\ \133\ \ \\ 4 4 4S jrSrg)� ArgReplaceriS z�Replaces one value in an ``args, kwargs`` pair.134 135Inspects the function signature to find an argument by name136whether it is passed by position or keyword. For use in decorators137and similar wrappers.138�funcr r Nc � � X l U R U5 R U5 U l g ! [ a139 S U l g f = fr )r � _getargnames�index�arg_posrk )r r� r s r r3 �ArgReplacer.__init__[ s? � �� � � �,�,�T�2�8�8��>�D�L��� � �D�L� �s �%. �A�Ac � � [ U5 R $ ! [ a: [ US5 ( a' UR nUR140 S UR s $ e f = f)N� func_code)r rd r^ rc r� � co_varnames� co_argcount)r r� rP s r r� �ArgReplacer._getargnamesc s\ � � �!�$�'�,�,� ,��� 141 ��t�[�)�)� �~�~���'�'�(:�$�*:�*:�;�;� �142 �s � �A A�Ard ru �defaultc � � U R b' [ U5 U R :� a XR $ UR U R U5 $ )zwReturns the old value of the named argument without replacing it.143 144Returns ``default`` if the argument is not present.145)r� �lenr� r )r rd ru r� s r �
get_old_value�ArgReplacer.get_old_valuer s? � � �<�<� #��D� �D�L�L�(@�� � �%� %��:�:�d�i�i��1� 1r" � new_valuec �� � U R bA [ U5 U R :� a( X R n[ U5 nXU R ' O)UR U R 5 nXU R ' XBU4$ )ad Replace the named argument in ``args, kwargs`` with ``new_value``.146 147Returns ``(old_value, args, kwargs)``. The returned ``args`` and148``kwargs`` objects may not be the same as the input objects, or149the input objects may be mutated.150 151If the named argument was not found, ``new_value`` will be added152to ``kwargs`` and None will be returned as ``old_value``.153)r� r� �listr� r )r r� rd ru � old_values r �replace�ArgReplacer.replace~ si � � �<�<� #��D� �D�L�L�(@� �\�\�*�I���:�D�!*�� � � � �154�155�4�9�9�-�I� )�4�9�9� ���&�&r" )r� r r )r# r$ r% r& r' r r( r3 r r� r
r r r� r r� r) r r" r r� r� S s� � �� �X� �S� �T� �
��
�d�3�i�
� KO�1562� �S�M�1572�+/��S��>�1582�DG�1592� �1602�'� �'�$,�S�M�'�;?��S��>�'� �s�H�S�M�4��S��>�1� 2�'r" r� c �" � U R 5 $ )z@Equivalent to ``td.total_seconds()`` (introduced in Python 2.7).)�
total_seconds)�tds r �timedelta_to_secondsr� � s � � � � � � r" �mask�datac �� � [ R " SU 5 n[ R " SU5 n[ [ U5 5 H nX4 X$S- - X4' M UR 5 $ )a= Websocket masking function.161 162`mask` is a `bytes` object of length 4; `data` is a `bytes` object of any length.163Returns a `bytes` object of the same length as `data` with the mask applied164as specified in section 5.3 of RFC 6455.165 166This pure-python implementation may be replaced by an optimized version when available.167�B� )�array�ranger� �tobytes)r� r� �mask_arr� unmasked_arr�is r �_websocket_mask_pythonr� � sZ � � �{�{�3��%�H��;�;�s�D�)�L�
�3�t�9�
��&�/�H��U�O�;� �� � � � � !�!r" �TORNADO_NO_EXTENSION�TORNADO_EXTENSION�0)�websocket_mask�1c �* � SS K n U R 5 $ )Nr )�doctest� DocTestSuite)r� s r �doctestsr� � s � �� � � � !�!r" r );r' r� �asyncio�inspectr �os�rer� r/ r r r r r r r168 r r r
�
TYPE_CHECKING�datetime�typesr r �unittestr@ �169bytes_typer( � unicode_type�basestring_type� TimeoutErrorr r+ rO rX �type�
BaseException�NoReturnr_ rA re � frozensetrj rl rW �DOTALLro rq rs r� r� r� �environr� �_websocket_mask�tornado.speedupsr� rL r� r r" r �<module>r� s# ��170�
� � "� � �
� � � � � 171��� �#� ��172 �173�� ���174 �#�#� �175��c�3�h� � 176�%*� %*�P<�� <�� <�< SW��177
���#�s�(�^��*2�8�G�C��H�<M�3N�*O�� �� &��H�T�N�H�]�$;�X�o�=V�V�W� &� �_�_� &� �M� �h�s�m� �$
�V� W� ��E�#�J� �3� � �z�z�(�B�I�I�6� � A�3� A�3� A�D&� D&�N@'� @'�F �
"��
"�e�
"��
"� �:�:�>�>�(�)�)�R�Z�Z�^�^�<O�-P�TW�-W� -�O�1�F�"��
� 1�
�:�:�>�>�-� .�#� 5� �0��1�s � F178 �179(F5�4F5