codekingpro/portable-devtools
114k
1�
2 ��j 9 �
� � S r SSKrSSKrSSKrSSKrSSKJr SSKrSSKJ r J3r4J r J r J
r
Jr S\ \\4 S\4S jrS\ \\4 S\4S jrS\5S\4S jrS\ \\4 S\64S7 jrS\S\4S jrS+S\ \\4 S \S\4S
jjr\R0 S+S\ \\4 SSS \S\4S jj5 r\R0 S,S\ \\4 S\S \S\4S jj5 r S,S\ \\4 S\ \ S \S\ \\4 4S jjr S-S\ \\4 S\S\S\ \\
\ 4 4S jjr\\" S5 4r \R0 S\S\4S j5 r \R0 S\S\4S j5 r \R0 S.S j5 r S\ S\\4 S\ \ 4S jr \\" S5 4r \R0 S\S\4S j5 r \R0 S\S\4S j5 r \R0 S.S j5 r S\ S\\4 S\ \ 4S jr \ r \ r!\ r"S \8S\94S jr#\RH " \ " S!5 5 r%SS"SS#S$/4S%\ \\4 S&\S'\ \\\/\4 4 S(\S)\
\ S\4 S* jjr&g)/a� Escaping/unescaping methods for HTML, JSON, URLs, and others.10 11Also includes a few other miscellaneous string manipulation functions that12have crept in over time.13 14Many functions in this module have near-equivalents in the standard library15(the differences mainly relate to handling of bytes and unicode strings,16and were more relevant in Python 2). In new code, the standard library17functions are encouraged instead of this module where applicable. See the18docstrings on each function for details.19� N)� unicode_type)�Union�Any�Optional�Dict�List�Callable�value�returnc �@ � [ R " [ U 5 5 $ )a Escapes a string so it is valid within HTML or XML.20 21Escapes the characters ``<``, ``>``, ``"``, ``'``, and ``&``.22When used in attribute values the escaped strings must be enclosed23in quotes.24 25Equivalent to `html.escape` except that this function always returns26type `str` while `html.escape` returns `bytes` if its input is `bytes`.27 28.. versionchanged:: 3.229 30 Added the single quote to the list of escaped characters.31 32.. versionchanged:: 6.433 34 Now simply wraps `html.escape`. This is equivalent to the old behavior35 except that single quotes are now escaped as ``'`` instead of36 ``'`` and performance may be different.37)�html�escape�38to_unicode�r39 s �TD:\code\apps\devtools\python\user_packages\Python313\site-packages\tornado/escape.py� xhtml_escaper ' s � �( �;�;�z�%�(� )�)� c �@ � [ R " [ U 5 5 $ )a6 Un-escapes an XML-escaped string.40 41Equivalent to `html.unescape` except that this function always returns42type `str` while `html.unescape` returns `bytes` if its input is `bytes`.43 44.. versionchanged:: 6.445 46 Now simply wraps `html.unescape`. This changes behavior for some inputs47 as required by the HTML 5 specification48 https://html.spec.whatwg.org/multipage/parsing.html#numeric-character-reference-end-state49 50 Some invalid inputs such as surrogates now raise an error, and numeric51 references to certain ISO-8859-1 characters are now handled correctly.52)r
�unescaper r s r �xhtml_unescaper > s � � �=�=��E�*� +�+r c �N � [ R " U 5 R SS5 $ )z�JSON-encodes the given Python object.53 54Equivalent to `json.dumps` with the additional guarantee that the output55will never contain the character sequence ``</`` which can be problematic56when JSON is embedded in an HTML ``<script>`` tag.57z</z<\/)�json�dumps�replacer s r � json_encoder S s � � �:�:�e� � $� $�T�6� 2�2r c �. � [ R " U 5 $ )zvReturns Python objects for the given JSON string.58 59Supports both `str` and `bytes` inputs. Equvalent to `json.loads`.60)r �loadsr s r � json_decoder c s � �61 �:�:�e� � r c �N � [ R " SSU 5 R 5 $ )z>Replace all sequences of whitespace chars with a single space.z [\x00-\x20]+� )�re�sub�stripr s r �squeezer$ k s � �
�6�6�/�3�� .� 4� 4� 6�6r �plusc � � U( a [ R R O[ R R nU" U 5 $ )aU Returns a URL-encoded version of the given value.62 63Equivalent to either `urllib.parse.quote_plus` or `urllib.parse.quote` depending on the ``plus``64argument.65 66If ``plus`` is true (the default), spaces will be represented as ``+`` and slashes will be67represented as ``%2F``. This is appropriate for query strings. If ``plus`` is false, spaces68will be represented as ``%20`` and slashes are left as-is. This is appropriate for the path69component of a URL. Note that the default of ``plus=True`` is effectively the70reverse of Python's urllib module.71 72.. versionadded:: 3.173 The ``plus`` argument74)�urllib�parse�75quote_plus�quote)r76 r% r* s r �77url_escaper+ p s+ � � (,�F�L�L� #� #�� � �1C�1C�E� ��<�r �encodingc � � g �N� �r78 r, r% s r � url_unescaper1 � � � �r c � � g r. r/ r0 s r r1 r1 � s � � r c � � UcA U( a [ U 5 R SS5 n [ R R U 5 $ U( a [ R R79 O[ R R nU" [ U 5 US9$ )a Decodes the given value from a URL.80 81The argument may be either a byte or unicode string.82 83If encoding is None, the result will be a byte string and this function is equivalent to84`urllib.parse.unquote_to_bytes` if ``plus=False``. Otherwise, the result is a unicode string in85the specified encoding and this function is equivalent to either `urllib.parse.unquote_plus` or86`urllib.parse.unquote` except that this function also accepts `bytes` as input.87 88If ``plus`` is true (the default), plus signs will be interpreted as spaces (literal plus signs89must be represented as "%2B"). This is appropriate for query strings and form-encoded values90but not for the path component of a URL. Note that this default is the reverse of Python's91urllib module.92 93.. versionadded:: 3.194 The ``plus`` argument95�+r )r, )�
to_basestringr r' r( �unquote_to_bytes� unquote_plus�unquote)r96 r, r% r9 s r r1 r1 � sh � �( �� �!�%�(�0�0��c�:�E��|�|�,�,�U�3�3�/3�&�,�,�+�+�� � �9M�9M���}�U�+�h�?�?r F�qs�keep_blank_values�strict_parsingc � � [ U [ 5 ( a U R S5 n [ R R XUSSS9n0 nUR
5 H( u pVU Vs/ s H owR S5 PM snXE' M* U$ s snf )a Parses a query string like urlparse.parse_qs,97but takes bytes and returns the values as byte strings.98 99Keys still become type str (interpreted as latin1 in python3!)100because it's too painful to keep them as byte strings in101python3 and in practice they're nearly always ascii anyway.102�latin1�strict)r, �errors)�103isinstance�bytes�decoder' r( �parse_qs�items�encode)r: r; r< �result�encoded�k�v�is r �parse_qs_bytesrL � s� � � �"�e� � �
�Y�Y�x�
��
�\�\�
"�
"�104�~��� #� �F� �G�� � ����23�4�!�Q�h�h�x�(�!�4��105� � �N�� 5s �"Bc � � g r. r/ r s r �utf8rN � r2 r c � � g r. r/ r s r rN rN � r2 r c � � g r. r/ r s r rN rN � r2 r c � � [ U [ 5 ( a U $ [ U [ 5 ( d [ S[ U 5 - 5 eU R S5 $ )z�Converts a string argument to a byte string.106 107If the argument is already a byte string or None, it is returned unchanged.108Otherwise it must be a unicode string and is encoded as utf8.109�(Expected bytes, unicode, or None; got %r�utf-8)rA � _UTF8_TYPESr � TypeError�typerF r s r rN rN � sG � � �%��%�%�� � �e�\� *� *��B�T�%�[�P�Q�Q� �<�<�� � r c � � g r. r/ r s r r r � r2 r c � � g r. r/ r s r r r � r2 r c � � g r. r/ r s r r r � r2 r c � � [ U [ 5 ( a U $ [ U [ 5 ( d [ S[ U 5 - 5 eU R S5 $ )z�Converts a string argument to a unicode string.110 111If the argument is already a unicode string or None, it is returned112unchanged. Otherwise it must be a byte string and is decoded as utf8.113rR rS )rA �_TO_UNICODE_TYPESrB rU rV rC r s r r r � sH � � �%�*�+�+�� � �e�U� #� #��B�T�%�[�P�Q�Q� �<�<�� � r �objc � � [ U [ 5 ( a8 U R 5 VVs0 s H u p[ U5 [ U5 _M snn$ [ U [ 5 ( a [ S U 5 5 $ [ U [114 5 ( a [ S U 5 5 $ [ U [ 5 ( a [ U 5 $ U $ s snnf )znWalks a simple data structure, converting byte strings to unicode.115 116Supports lists, tuples, and dictionaries.117c 3 �8 # � U H n[ U5 v � M g 7fr. ��recursive_unicode��.0rK s r � <genexpr>�$recursive_unicode.<locals>.<genexpr> s � � �6�#�Q�%�a�(�(�#�� �c 3 �8 # � U H n[ U5 v � M g 7fr. r_ ra s r rc rd s � � �7�3�a�&�q�)�)�3�re )rA �dictrE r` �list�tuplerB r )r\ rI rJ s r r` r` s� � �118 �#�t� � �IL����U��v��!�!�$�&7��&:�:��U�U� �C�� � ��6�#�6�6�6� �C�� � ��7�3�7�7�7� �C�� � ��#�� ��119�� Vs �!B>z�\b((?:([\w-]+):(/{1,3})|www[.])(?:(?:(?:[^\s&()]|&|")*(?:[^!"#$%&'()*+,.:;<=>?@\[\]^`{|}~\s]))|(?:\((?:[^\s&()]|&|")*\)))+)� �http�https�text�shorten� extra_params�require_protocol�permitted_protocolsc �� ^^^^� T( a# [ T5 ( d STR 5 - mS[ R S[ 4UUUU4S jjn[ [
U 5 5 n [ R XP5 $ )a7 Converts plain text into HTML with links.120 121For example: ``linkify("Hello http://tornadoweb.org!")`` would return122``Hello <a href="http://tornadoweb.org">http://tornadoweb.org</a>!``123 124Parameters:125 126* ``shorten``: Long urls will be shortened for display.127 128* ``extra_params``: Extra text to include in the link tag, or a callable129 taking the link as an argument and returning the extra text130 e.g. ``linkify(text, extra_params='rel="nofollow" class="external"')``,131 or::132 133 def extra_params_cb(url):134 if url.startswith("http://example.com"):135 return 'class="internal"'136 else:137 return 'class="external" rel="nofollow"'138 linkify(text, extra_params=extra_params_cb)139 140* ``require_protocol``: Only linkify urls which include a protocol. If141 this is False, urls such as www.facebook.com will also be linkified.142 143* ``permitted_protocols``: List (or set) of protocols which should be144 linkified, e.g. ``linkify(text, permitted_protocols=["http", "ftp",145 "mailto"])``. It is very unsafe to include protocols such as146 ``javascript``.147r �mr c �\ >� U R S5 nU R S5 nT ( a U( d U$ U( a UT ; a U$ U R S5 nU( d SU- n[ T1485 ( a ST149" U5 R 5 - nOT150nSnT
( Ga [ U5 U:� a� UnU( a3 [ U5 S- [ U R S5 =( d S5 - nOSnXS R S 5 n[ U5 S:� a; US U US - S - US S S151 R S 5 S R S 5 S - n[ U5 US
- :� a US U nX:w aF UR S5 n X�S-152 :� a US U nUS-
n[ U5 [ U5 :� a UnOUSU- -
nSU SU SU S3$ )N� � zhttp://r � � rj r �/� �?�.g �?�&� z...z title="%s"z <a href="�"�>z</a>)�group�callabler# �len�split�rfind)rs �url�proto�href�params�max_len� before_clip� proto_len�parts�ampro rq rp rn s ����r � make_link�linkify.<locals>.make_linkR s� �� ��g�g�a�j������153�� �E��J� �U�"5�5��J��w�w�q�z��� �t�#�D� �L� !� !��<��-�3�3�5�5�F�!�F� �� �s�3�x�'�)� �K�� ��J��N�S������1A�r�-B� B� � � ��154�O�)�)�#�.�E��5�z�A�~� �155��O��A�h� ��� �A�h�r��l�(�(��-�a�0�6�6�s�;�A�>�?� � �3�x�'�C�-�'��(�7�m���!��i�i��n���1��$� �d�s�)�C��u� ���s�8�s�;� /�/�%�C� �m�d� 2�2�F��4�&��&���3�%�t�4�4r ) r� r# �typing�Match�str�_unicoder �_URL_REr" )rm rn ro rp rq r� s ```` r �linkifyr� + sc �� �H �H�\� 2� 2��\� /� /� 1�1� �95�V�\�\� 95�c� 95� 95�| �L��&� '�D� �;�;�y� '�'r )T)rS T)FF)r156 Nr N)'�__doc__r
r r! � urllib.parser' � tornado.utilr r� r r r r r r r� rB r r r r r$ �boolr+ �overloadr1 rL rV rT rN r[ r r� �157native_strr6 r` �compiler� r� r/ r r �<module>r� s� �� 158� � � � � %�
� =� =�*��c�5�j�)� *�c� *�.,�%��U�159�+� ,�� ,�*
3�s�
3�s�
3� �u�S�%�Z�(� �S� �7�3� 7�3� 7�160�e�C��J�'� �t� �s� �& � � � ��c�5�j�)� �T� �� �QV� � � � � � �DH� � ��e�� � �(+� �=A� �� � � � OS�@� ��e�� �@�(0��
�@�GK�@�161�3��:��@�> TY��
�c�5�j���.2��LP�� �#�t�E�{�162���. �d�4�j�!� � � � � �� �%� � � � � � � �� �� � � � � � � � � �163!��d�C��&�'� 164!�H�U�O� 165!� "�4��:�.� � � � � �c� �c� � � � � � � �e� �� � � � � � � � � �166!�e�D�#�u� ,�-� 167!�(�3�-� 168!� �� �169��
��3� �3� �0
�*�*�� ]�� �� �57� "�&,�g�%6� f(�170��U�171�172�f(�
�f(� ��X�s�e�S�j� 1�1�2�f(� � f(�173 �c�� f(� �
f(r