codekingpro/portable-devtools
115k
1�
2 �j:O � � � S SK Jr S SKJr S SKrS SKrS SKrS SKr S SK3J r S SK J
r
S SK Jr SSKJr SSKJr SS KJr SS4KJr SS KJr SS KJr SS
KJr SSKJr SSKJr SSKJr SSKJr \ R8 ( a S SK r \ R> " S5 r \ RB " S5 r"S(S jr#S)S jr$S*S jr%S+S,S jjr& " S S5 r' " S S5 r( S- S.S jjr)S/S jr* S0 S1S jjr+ S2 S3S jjr, S4 S5S! jjr-S6S7S" jjr. " S# S$5 r/ S8 S9S% jjr0S S S S&. S:S' jjr1g);� )� annotationsN��update_wrapper)�5ModuleType)�
TracebackType� )�_default_text_stderr)�_default_text_stdout)�_find_binary_writer)�auto_wrap_for_ansi)�binary_streams)� open_stream)�should_strip_ansi)�6strip_ansi)� text_streams)�WIN)�resolve_color_default�P�Rc �\ � SR U R 5 5 R 5 $ )N�-)�join�split�lower)�names �QD:\code\apps\devtools\python\user_packages\Python313\site-packages\click/utils.py� _posixifyr s � � �8�8�D�J�J�L� !� '� '� )�)� c �, ^ � SU 4S jjn[ UT 5 $ )z0Wraps a function so that it swallows exceptions.c �6 >� T" U 0 UD6$ ! [ a g f = f�N)� Exception)�args�kwargs�funcs �r �wrapper�safecall.<locals>.wrapper' s- �� � ���(��(� (��� � �� �s � �7�)r# zP.argsr$ zP.kwargs�returnzR | Noner )r% r& s ` r �safecallr) $ s �� �� �'�4� (�(r c �� � [ U [ 5 ( a% U R [ R " 5 5 $ [
U 5 $ ! [8 a U R SS5 s $ f = f)z%Converts a value into a valid string.�utf-8�replace)�9isinstance�bytes�decode�sys�getfilesystemencoding� UnicodeError�str)�values r �make_strr5 1 sZ � ��%�� � � 4��<�<�� 9� 9� ;�<� <� �u�:��� � 4��<�<���3� 3� 4�s �#A � A%�$A%c �. � U R S5 nUS:w a U SU n U R 5 nU( d gUS S:X a USS nSn[ U5 S-10 n[ U5 HP u pgU[ U5 US:� - -
nXA:� a OEUS S:X a S R USUS- 5 s $ XA:X d MI Xe:w d MP O S R U5 $ U[ S115 -
nUS:� a) U[ X6 5 US:� - - nXA:: a O
US- nUS:� a M) S R USU 5 S12- $ ) z<Returns a condensed version of help string.13 14:meta private:15z16 17�����N� r �r �.� z...)�findr �len� enumerater )�help�18max_length�
paragraph_end�words� total_length�19last_index�i�words r �make_default_short_helprG ; s? � � �I�I�f�%�M�����N�]�#��
�J�J�L�E� ��
�Q�x�4���a�b� ���L��U��a� �J� �U�#�����D� �Q��U�+�+� � � $� � ��8�s�?��8�8�E�'�A��E�N�+� +� � %�!�/� � $� �x�x��� � �C��J� �L� �a�%���E�H�
��Q��/�/� � � %� � �Q���
�a�%� �8�8�E�"�1�I� �� &�&r c � � \ rS rSrSr S SS jjrSS jrSS jrSS jrSS jr SS jr20SS21 jr SS jr SS jr
S
rg)�LazyFile�p z�A lazy file works like a regular file but it does not fully open22the file but it does perform some basic checks early to see if the23filename parameter does make sense. This is useful for safely opening24files for writing.25Nc � � [ R " U5 U l X l X0l X@l XPl U U U R S:X a [ XX45 u U l U l g SU; a [ X5 R 5 S U l SU l g )Nr �rT) �os�fspathr �mode�encoding�errors�atomicr �_f� should_close�open�close)�self�filenamerO rP rQ rR s r �__init__�LazyFile.__init__w sy � � ���8�,�� �� � �
� � � � � � � �9�9�� �)4�X�X�)V� &�D�G�T�&��d�{� �X�$�*�*�,��D�G� $�D� r c �6 � [ U R 5 U5 $ r! )�getattrrU �rW r s r � __getattr__�LazyFile.__getattr__� s � ��t�y�y�{�D�)�)r c � � U R b [ U R 5 $ S[ U R 5 SU R S3$ )Nz<unopened file 'z' �>)rS �repr�format_filenamer rO �rW s r �__repr__�LazyFile.__repr__� s= � � �7�7� �����=� �!�/�$�)�)�"<�!=�R�� � �{�!�L�Lr c �: � U R b U R $ [ U R U R U R U R26 U R S9u ol Xl U$ ! [ a' nSSK J27n U" U R UR S9UeSnAff = f)z�Opens the file if it's not yet open. This call might fail with28a :exc:`FileError`. Not handling this error will produce an error29that Click shows.30N�rR r )� FileError)�hint) rS r r rO rP rQ rR rT �OSError�31exceptionsri �strerror)rW �rv�eri s r rU �
LazyFile.open� s� � �32 �7�7� ��7�7�N� ?�$/�� � �4�9�9�d�m�m�T�[�[����%� !�B�!� ��� �� � ?� -��D�I�I�A�J�J�7�Q� >�� ?�s �AA) �)33B�3"B�Bc �T � U R b U R R 5 gg)z+Closes the underlying file, no matter what.N)rS rV rd s r rV �LazyFile.close� s � � �7�7� � �G�G�M�M�O� r c �H � U R ( a U R 5 gg)zyThis function only closes the file if it was opened by the lazy34file wrapper. For instance this will never close stdin.35N)rT rV rd s r �close_intelligently� LazyFile.close_intelligently� s � � � � � �J�J�L� r c � � U $ r! � rd s r � __enter__�LazyFile.__enter__� � � �� r c �$ � U R 5 g r! )rt �rW �exc_type� exc_value�tbs r �__exit__�LazyFile.__exit__� s � �
� � �"r c �L � U R 5 [ U R 5 $ r! )rU �iterrS rd s r �__iter__�LazyFile.__iter__� s � � � � � ��D�G�G�}� r )rS rR rP rQ rO r rT )rL N�strictF)36rX �str | os.PathLike[str]rO r3 rP �37str | NonerQ r� rR �bool�r r3 r( �t.Any�r( r3 )r( � t.IO[t.Any]�r( �None)r( rI �r} ztype[BaseException] | Noner~ zBaseException | Noner zTracebackType | Noner( r� �r( zcabc.Iterator[t.AnyStr])�__name__�38__module__� __qualname__�__firstlineno__�__doc__rY r^ re rU rV rt rx r� r� �__static_attributes__rw r r rI rI p s� � �� � #� %� �
%�(�%� �%� � %�39 � %� �
%�6*�M�40�$ �41��#�,�#� (�#�
!� #�42 43� #� r rI c �` � \ rS rSrS44S jrS S jrS S jr S
S jrSS jrSS jr Sr45g )� KeepOpenFile�� c � � Xl g r! ��_file)rW �files r rY �KeepOpenFile.__init__� s � �"&�46r c �. � [ U R U5 $ r! )r\ r� r] s r r^ �KeepOpenFile.__getattr__� s � ��t�z�z�4�(�(r c � � U $ r! rw rd s r rx �KeepOpenFile.__enter__� rz r c � � g r! rw r| s r r� �KeepOpenFile.__exit__� s � �
r c �, � [ U R 5 $ r! )rb r� rd s r re �KeepOpenFile.__repr__� � � ��D�J�J� � r c �, � [ U R 5 $ r! )r� r� rd s r r� �KeepOpenFile.__iter__� r� r r� N)r� r� r( r� r� )r( r� r� r� r� ) r� r� r� r� rY r^ rx r� re r� r� rw r r r� r� � sF � �'�)��
�,�
� (�
�
!�
�47 48�
� � r r� Tc �� � Uc U( a [ 5 nO49[ 5 nUc gU b, [ U [ [ [50 45 ( d [ U 5 nOU nU( a+ U=( d Sn[ U[ 5 ( a US-
nOUS-
nU( d UR
5 g[ U[ [51 45 ( aA [ U5 nUb2 UR
5 UR U5 UR
5 gOW[ U5 n[ X5 ( a [ U5 nO0[ ( a% [ b [ X5 nOU( d [ U5 nUR U5 UR
5 g)a� Print a message and newline to stdout or a file. This should be52used instead of :func:`print` because it provides better support53for different data, files, and environments.54 55Compared to :func:`print`, this does the following:56 57- Ensures that the output encoding is not misconfigured on Linux.58- Supports Unicode in the Windows console.59- Supports writing to binary outputs, and supports writing bytes60 to text outputs.61- Supports colors and styles on Windows.62- Removes ANSI color and style codes if the output does not look63 like an interactive terminal.64- Always flushes the output.65 66:param message: The string or bytes to output. Other objects are67 converted to strings.68:param file: The file to write to. Defaults to ``stdout``.69:param err: Write to ``stderr`` instead of ``stdout``.70:param nl: Print a newline after the message. Enabled by default.71:param color: Force showing or hiding colors and other styles. By72 default Click will remove color if the output does not look like73 an interactive terminal.74 75.. versionchanged:: 6.076 Support Unicode output on the Windows console. Click does not77 modify ``sys.stdout``, so ``sys.stdout.write()`` and ``print()``78 will still not support Unicode.79 80.. versionchanged:: 4.081 Added the ``color`` parameter.82 83.. versionadded:: 3.084 Added the ``err`` parameter.85 86.. versionchanged:: 2.087 Support colors on Windows if colorama is installed.88Nr8 �89� 90)r r91 r- r3 r. � bytearray�flushr �writer r r r r )�messager� �nl�err�color�out� binary_files r �echor� � s. � �Z �|� �'�)�D�'�)�D� �<� � ��:�g��U�I�7N�#O�#O�.1�'�l���� ��i�R�� �c�3� � � �4�K�C� �5�L�C� � �92�93� �� �#��y�)�*�*�)�$�/� � � "� �J�J�L� � � �c� "� � � � � � #� &�e�,�� �T� )� )� �S�/�C�
�S�!�-�)�$�6��� ��o���J�J�s�O��J�J�Lr c �` � [ R " U 5 nUc [ SU S35 eU" 5 $ )z�Returns a system stream for byte processing.94 95:param name: the name of the stream to open. Valid names are ``'stdin'``,96 ``'stdout'`` and ``'stderr'``97�Unknown standard stream '�')r
�get� TypeError)r �openers r �get_binary_streamr� H s5 � � �
�
��
%�F�
�~��3�D�6��;�<�<� �8�Or c �b � [ R " U 5 nUc [ SU S35 eU" X5 $ )a� Returns a system stream for text processing. This usually returns98a wrapped stream around a binary stream returned from99:func:`get_binary_stream` but it also can take shortcuts for already100correctly configured streams.101 102:param name: the name of the stream to open. Valid names are ``'stdin'``,103 ``'stdout'`` and ``'stderr'``104:param encoding: overrides the detected default encoding.105:param errors: overrides the default error mode.106r� r� )r r� r� )r rP rQ r� s r �get_text_streamr� T s9 � � �
�
�d�
#�F�
�~��3�D�6��;�<�<� �(� #�#r c � � U( a [ R " S[ XX#US95 $ [ XX#US9u pgU( d [ R " S[ U5 5 nU$ )a Open a file, with extra behavior to handle ``'-'`` to indicate107a standard stream, lazy open on write, and atomic write. Similar to108the behavior of the :class:`~click.File` param type.109 110If ``'-'`` is given to open ``stdout`` or ``stdin``, the stream is111wrapped so that using it in a context manager will not close it.112This makes it possible to use the function without accidentally113closing a standard stream:114 115.. code-block:: python116 117 with open_file(filename) as f:118 ...119 120:param filename: The name or Path of the file to open, or ``'-'`` for121 ``stdin``/``stdout``.122:param mode: The mode in which to open the file.123:param encoding: The encoding to decode or encode a file opened in124 text mode.125:param errors: The error handling mode.126:param lazy: Wait to open the file until it is accessed. For read127 mode, the file is temporarily opened to raise access errors128 early, then closed until it is read again.129:param atomic: Write to a temporary file and replace the given file130 on close.131 132.. versionadded:: 3.0133r� rh )�t�castrI r r� )rX rO rP rQ �lazyrR �frT s r � open_filer� i sU � �H ��v�v� �8�H�H�V�T�134� 135� "�(�(�6�R�O�A� �
�F�F�=�,�q�/� 2�� �Hr c �< � U( a [ R R U 5 n O[ R " U 5 n [ U [136 5 ( a' U R
[ R " 5 S5 n U $ U R SS5 R
SS5 n U $ )uu Format a filename as a string for display. Ensures the filename can be137displayed by replacing any invalid bytes or surrogate escapes in the name138with the replacement character ``�``.139 140Invalid bytes or surrogate escapes will raise an error when written to a141stream with ``errors="strict"``. This will typically happen with ``stdout``142when the locale is something like ``en_GB.UTF-8``.143 144Many scenarios *are* safe to write surrogates though, due to PEP 538 and145PEP 540, including:146 147- Writing to ``stderr``, which uses ``errors="backslashreplace"``.148- The system has ``LANG=C.UTF-8``, ``C``, or ``POSIX``. Python opens149 stdout and stderr with ``errors="surrogateescape"``.150- None of ``LANG/LC_*`` are set. Python assumes ``LANG=C.UTF-8``.151- Python is started in UTF-8 mode with ``PYTHONUTF8=1`` or ``-X utf8``.152 Python opens stdout and stderr with ``errors="surrogateescape"``.153 154:param filename: formats a filename for UI display. This will also convert155 the filename into unicode without failing.156:param shorten: this optionally shortens the filename to strip of the157 path that leads up to it.158r, r+ �surrogateescape)159rM �path�basenamerN r- r. r/ r0 r1 �encode)rX �shortens r rc rc � s� � �6 ��7�7�#�#�H�-���9�9�X�&���(�E�"�"��?�?�3�#<�#<�#>� �J�� �O� �?�?�7�,=�>�E�E� �Y�160�� �Or c �� � [ ( ak U( a SOSn[ R R U5 nUc [ R R S5 n[ R R
X@5 $ U( aH [ R R
[ R R S[ U 5 35 5 $ [ R S:X a= [ R R
[ R R S5 U 5 $ [ R R
[ R R S[ R R S5 5 [ U 5 5 $ ) a" Returns the config folder for the application. The default behavior161is to return whatever is most appropriate for the operating system.162 163To give you an idea, for an app called ``"Foo Bar"``, something like164the following folders could be returned:165 166Mac OS X:167 ``~/Library/Application Support/Foo Bar``168Mac OS X (POSIX):169 ``~/.foo-bar``170Unix:171 ``~/.config/foo-bar``172Unix (POSIX):173 ``~/.foo-bar``174Windows (roaming):175 ``C:\Users\<user>\AppData\Roaming\Foo Bar``176Windows (not roaming):177 ``C:\Users\<user>\AppData\Local\Foo Bar``178 179.. versionadded:: 2.0180 181:param app_name: the application name. This should be properly capitalized182 and can contain whitespace.183:param roaming: controls if the folder should be roaming or not on Windows.184 Has no effect otherwise.185:param force_posix: if this is set to `True` then on any POSIX system the186 folder will be stored in the home folder with a leading187 dot instead of the XDG config home or darwin's188 application support folder.189�APPDATA� LOCALAPPDATA�~z~/.�darwinz ~/Library/Application Support�XDG_CONFIG_HOMEz ~/.config)190r rM �environr� r� �191expanduserr r r0 �platform)�app_name�roaming� force_posix�key�folders r � get_app_dirr� � s� � �> �s�"�i������ � ��$�� �>��W�W�'�'��,�F��w�w�|�|�F�-�-���w�w�|�|�B�G�G� .� .��Y�x�5H�4I�/J� K�L�L�192�|�|�x� ��w�w�|�|� �G�G� � � >� ?��193� 194� �7�7�<�<�195�196�197���(�"�'�'�*<�*<�[�*I�J��(�� � r c �6 � \ rS rSrSrSS jrS S jrS198S jrSrg) �PacifyFlushWrapperi� a� This wrapper is used to catch and suppress BrokenPipeErrors resulting199from ``.flush()`` being called on broken pipe during the shutdown/final-GC200of the Python interpreter. Notably ``.flush()`` is always called on201``sys.stdout`` and ``sys.stderr``. So as to have minimal impact on any202other cleanup code, and the case where the underlying file is not a broken203pipe, all calls and attributes are proxied.204c � � Xl g r! ��wrapped)rW r� s r rY �PacifyFlushWrapper.__init__� s � � � r c � � U R R 5 g ! [ a) nSS KnUR UR :w a e S nAg S nAff = f)Nr )r� r� rk �errno�EPIPE)rW ro r� s r r� �PacifyFlushWrapper.flush sB � � � �L�L� � � ��� � ��w�w�%�+�+�%�� &�� �s � �205A� A � Ac �. � [ U R U5 $ r! )r\ r� )rW �attrs r r^ � PacifyFlushWrapper.__getattr__206 s � ��t�|�|�T�*�*r r� N)r� r� r( r� r� )r� r3 r( r� ) r� r� r� r� r� rY r� r^ r� rw r r r� r� � s � �� ��+r r� c � � Uc [ R S nU ( d [ R S n [ USS5 S; do [ R207 S:X az UR S:X aj [ R R U 5 ( dF [ R R U S35 ( a [ R R U 5 $ [ R " [ UR 5 n[ R R [ R R U 5 5 S nUS:w a U S U 3nS208UR S 5 3$ ) a� Determine the command used to run the program, for use in help209text. If a file or entry point was executed, the file name is210returned. If ``python -m`` was used to execute a module or package,211``python -m name`` is returned.212 213This doesn't try to be too precise, the goal is to give a concise214name for help text. Files are only shown as their name without the215path. ``python`` is only shown for modules, and the full path to216``sys.executable`` is not shown.217 218:param path: The Python file being executed. Python puts this in219 ``sys.argv[0]``, which is used by default.220:param _main: The ``__main__`` module. This should only be passed221 during internal testing.222 223.. versionadded:: 8.0224 Based on command args detection in the Werkzeug reloader.225 226:meta private:227N�__main__r � __package__> Nr8 �ntr8 z.exer: z228python -m )r0 �modules�argvr\ rM r r� r� �existsr� r� r� r3 �splitext�lstrip)r� �_main� py_moduler s r �_detect_program_namer� s � �.
�}�� � �J�'�� ��x�x��{�� �u�m�T�*�j�8�229���4�� � � �� #������t�$�$� �G�G�N�N�d�V�4�=� )� )� �w�w� � ��%�%�230 ���s�E� -� -�.�I�
�7�7� � �B�G�G� ,� ,�T� 2� 3�A� 6�D� �z�� �k��4�&�)� �
� �(�(��-�.� /�/r )�user�env�glob_recursivec �\ � SSK J n / nU H� nU( a [ R R U5 nU( a [ R R U5 n U" XcS9nU( d UR U5 Mp UR U5 M� U$ ! [231 R a / n NIf = f)au Simulate Unix shell expansion with Python functions.232 233See :func:`glob.glob`, :func:`os.path.expanduser`, and234:func:`os.path.expandvars`.235 236This is intended for use on Windows, where the shell does not do any237expansion. It may not exactly match what a Unix shell would do.238 239:param args: List of command line arguments to expand.240:param user: Expand user home directory.241:param env: Expand environment variables.242:param glob_recursive: ``**`` matches directories recursively.243 244.. versionchanged:: 8.1245 Invalid glob patterns are treated as empty expansions rather246 than raising an error.247 248.. versionadded:: 8.0249 250:meta private:251r )�glob)� recursive) r� rM r� r� �252expandvars�re�error�append�extend)r# r� r� r� r� r� �arg�matchess r � _expand_argsr E s� � �8 �253 �C��� ��'�'�$�$�S�)�C� ��'�'�$�$�S�)�C� ��3�9�G� � �J�J�s�O� �J�J�w� � �" �J�� �x�x� ��G� �s �B�B+�*B+)r r3 r( r3 )r% zt.Callable[P, R]r( zt.Callable[P, R | None])r4 r� r( r3 )�- )r? r3 r@ �intr( r3 )NNTFN) r� z t.Any | Noner� zt.IO[t.Any] | Noner� r� r� r� r� z bool | Noner( r� )r �&t.Literal['stdin', 'stdout', 'stderr']r( z254t.BinaryIO)Nr� )r r rP r� rQ r� r( zt.TextIO)rL Nr� FF)rX r� rO r3 rP r� rQ r� r� r� rR r� r( r� )F)rX z3str | bytes | os.PathLike[str] | os.PathLike[bytes]r� r� r( r3 )TF)r� r3 r� r� r� r� r( r3 )NN)r� r� r� zModuleType | Noner( r3 )255r# zcabc.Iterable[str]r� r� r� r� r� r� r( z list[str])2�256__future__r �collections.abc�abc�cabcrM r� r0 �typingr� � functoolsr �typesr r �_compatr r257 r r r
r r r r r �globalsr �
TYPE_CHECKING�typing_extensions�te� ParamSpecr �TypeVarr r r) r5 rG rI r� r� r� r� r� rc r� r� r� r rw r r �<module>r s �� "� � � � 258� � $� � � )� )� (� '� #� � &� � !� � *��?�?�"�259� � �S��A��I�I�c�N��*�260)��2'�jU � U �p � �4 !� #��� � d�
�d�261 �d�
�d� 262� d�263 � d� 264�
d�N � �!�$�2650�$��$�
�$� � $�. � �!���
.
�$�.
�266
�.
� �.
�
� .
�267 � .
�
�
.
� �.
�f �'�A�'�
�'� �'�T.�b+� +�4 9=�40�268�40�$5�40��40�t �� � 1�269 �1� �1� 270� 1�271 � 1� �
1r