|
Server : LiteSpeed System : Linux host 5.15.0-161-generic #171-Ubuntu SMP Sat Oct 11 08:17:01 UTC 2025 x86_64 User : idnco5810 ( 1093) PHP Version : 8.2.29 Disable Function : NONE Directory : /lib/python3/dist-packages/click/__pycache__/ |
Upload File : |
o
�+caNq � ! @ s� U d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlmZ ddl m
Z
ddl m Z ddl m Z ddl
mZ ddl
mZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZ ejrnddlmZ e� d�Z e Z ej e!ge!f e"d< i dd�dd�dd�dd�dd�d d �d d �d d!�d"d#�d$d%�d&d'�d(d)�d*d+�d,d-�d.d/�d0d1�d2d3�Z#d4Z$d5e!d6e!fd7d8�Z% 9 : d�d;e!d<e!d=e&d>ej'ej( d?e&d@ej'e d6e!fdAdB�Z)d>ej(d6ej(fdCdD�Z* 9 9 E : 9 :d�d;e!d>ej'ej( dFe&dGej+e&e!f d@ej'ej+eej(f dHej'ej e!gej(f dIe!d=e&dJe&d?e&d6ej(fdKd5�Z, 9 9 E : 9d�d;e!d>ej'e& dLe&dIe!d=e&dJe&d6e&fdMdN�Z-d6ej.fdOdP�Z/ d�dQej+ej0e! ej g ej0e! f e!f dRej'e& d6dfdSdT�Z1 : 9 U V W X d�dYej'ej0e dZej'e2 d[ej'e! d\e&d]ej'e& d^e&d_ej'ej ej'e gej'e! f d`e!dae!dbe!dce!dde2deej'ej3 dRej'e& dfe2d6dgf dhdi�Z4d�djdk�Z5 d�dRej+e2ej6e2e2e2f e!f dle2d6e!fdmdn�Z7 :d�d;ej(doej'ej+e2ej6e2e2e2f e!f dpej'ej+e2ej6e2e2e2f e!f dqej'e& drej'e& dsej'e& dtej'e& duej'e& dvej'e& dwej'e& dxej'e& d"e&d6e!fdydz�Z8d;e!d6e!fd{d|�Z9 : 9 d�d}ej'ej( deej'ej: d~e&dJe&dRej'e& dej(d6dfd�d��Z; : � d�d;ej'ej< d�ej'e! d�ej'ej=e!e!f d�e&d�e!d�ej'e! d6ej'ej< fd�d��Z>d�d�e!d�e&d�e&d6e2fd�d��Z?da@ej'ej e&ge!f e"d�< d�d�e&d6e!fd�d��ZAd6ejBe2 fd�d��ZCd�d�ej'e! dJe&d6dfd�d��ZDdS )�� N)�gettext� )�isatty��
strip_ansi)�WIN)�Abort)�
UsageError)�resolve_color_default)�Choice)� convert_type)� ParamType)�echo)�LazyFile�� ProgressBar�V�visible_prompt_func�black� �red� �green� �yellow�! �blue�" �magenta�# �cyan�$ �white�% �reset�' � bright_black�Z �
bright_red�[ � bright_green�\ �
bright_yellow�] � bright_blue�^ �bright_magenta�_ � bright_cyan�` � bright_white�a z[0m�prompt�returnc C s dd l }|� | �S )Nr )�getpass)r6 r8 � r9 �./usr/lib/python3/dist-packages/click/termui.py�hidden_prompt_func5 s
r; FT�text�suffix� show_default�default� show_choices�typec C sd | }|d ur |r t |t�r |dd�tt|j��� d�7 }|d ur,|r,|� dt|�� d�}|� |� �S )Nz (z, �)z [�])�
isinstancer �join�map�str�choices�_format_default)r< r= r> r? r@ rA r6 r9 r9 r: �
_build_prompt; s rJ c C s$ t | tjtf�rt| d�r| jS | S )N�name)rD �io�IOBaser �hasattrrK )r? r9 r9 r: rI K s rI �: �
hide_input�confirmation_prompt�
value_proc�
prompt_suffix�errc
s, dt dt f� �fdd� }
|du rt||�}t| |||| |�} |r3|du r(td�}t�t |�}t||�} |
| �} | r<n|durC|} nq5z|| �}
W n) tys } z �r]ttd�� d � n ttd
�j|d �� d � W Y d}~q3d}~ww |sx|
S t�t |�}|
|�}|r�nqy| |kr�|
S ttd �� d � q4)
a Prompts a user for input. This is a convenience function that can
be used to prompt a user for input later.
If the user aborts the input by sending a interrupt signal, this
function will catch it and raise a :exc:`Abort` exception.
:param text: the text to show for the prompt.
:param default: the default value to use if no input happens. If this
is not given it will prompt until it's aborted.
:param hide_input: if this is set to true then the input value will
be hidden.
:param confirmation_prompt: Prompt a second time to confirm the
value. Can be set to a string instead of ``True`` to customize
the message.
:param type: the type to use to check the value against.
:param value_proc: if this parameter is provided it's a function that
is invoked instead of the type conversion to
convert a value.
:param prompt_suffix: a suffix that should be added to the prompt.
:param show_default: shows or hides the default value in the prompt.
:param err: if set to true the file defaults to ``stderr`` instead of
``stdout``, the same as with echo.
:param show_choices: Show or hide choices if the passed type is a Choice.
For example if type is a Choice of either day or week,
show_choices is true and text is "Group by" then the
prompt will be "Group by (day, week): ".
.. versionadded:: 8.0
``confirmation_prompt`` can be a custom string.
.. versionadded:: 7.0
Added the ``show_choices`` parameter.
.. versionadded:: 6.0
Added unicode support for cmd.exe on Windows.
.. versionadded:: 4.0
Added the `err` parameter.
r< r7 c sV �rt nt}zt| �d�d� d� |d�W S ttfy* �r&td � d� t� d �w )N� F��nlrT �rT )r; r r �rstrip�KeyboardInterrupt�EOFErrorr )r< �f�rT rP r9 r: � prompt_func� s
�zprompt.<locals>.prompt_funcNTzRepeat for confirmationz)Error: The value you entered was invalid.rX zError: {e.message})�ez+Error: The two entered values do not match.) rG r rJ �_�t�castr r �format)r< r? rP rQ rA rR rS r> rT r@ r^ r6 �value�resultr_ �value2r9 r] r: r6 R sR 5
�
� �� ���abortc C s� t | |||du r
dn|rdnd�} zt|�d�d|d� td��� �� }W n
ttfy3 t� d�w |d v r;d}n|d
v rBd}n|durM|d krM|}n tt d �|d
� q |r^|s^t� �|S )ay Prompts for confirmation (yes/no question).
If the user aborts the input by sending a interrupt signal this
function will catch it and raise a :exc:`Abort` exception.
:param text: the question to ask.
:param default: The default value to use when no input is given. If
``None``, repeat until input is given.
:param abort: if this is set to `True` a negative answer aborts the
exception by raising :exc:`Abort`.
:param prompt_suffix: a suffix that should be added to the prompt.
:param show_default: shows or hides the default value in the prompt.
:param err: if set to true the file defaults to ``stderr`` instead of
``stdout``, the same as with echo.
.. versionchanged:: 8.0
Repeat until input is given if ``default`` is ``None``.
.. versionadded:: 4.0
Added the ``err`` parameter.
Nzy/nzY/nzy/NTrU FrV )�y�yes)�n�no� zError: invalid inputrX )
rJ r rY r �lower�striprZ r[ r r` ) r< r? rg rS r> rT r6 rd �rvr9 r9 r: �confirm� s2 ��rp c C s( ddl } ddl}|jdtdd� | �� S )z�Returns the current size of the terminal as tuple in the form
``(width, height)`` in columns and rows.
.. deprecated:: 8.0
Will be removed in Click 8.1. Use
:func:`shutil.get_terminal_size` instead.
r Nzu'click.get_terminal_size()' is deprecated and will be removed in Click 8.1. Use 'shutil.get_terminal_size()' instead.� )�
stacklevel)�shutil�warnings�warn�DeprecationWarning�get_terminal_size)rs rt r9 r9 r: rw � s �rw �text_or_generator�colorc C s� t |�}t�| �rt�tjg tjt f | �� }nt| t�r"| g}n t t�tjt | ��}dd� |D �}ddl
m } |t �
|d�|�S )a� This function takes a text and shows it via an environment specific
pager on stdout.
.. versionchanged:: 3.0
Added the `color` flag.
:param text_or_generator: the text to page, or alternatively, a
generator emitting the text to page.
:param color: controls if the pager supports ANSI colors or not. The
default is autodetection.
c s s& � | ]}t |t�r |nt|�V qd S �N)rD rG )�.0�elr9 r9 r: � <genexpr>, s �$ z!echo_via_pager.<locals>.<genexpr>r )�pager�
)r
�inspect�isgeneratorfunctionra rb �Callable�IterablerG rD �iter� _termui_implr~ � itertools�chain)rx ry �i�text_generatorr~ r9 r9 r: �echo_via_pager s
r� �#�-� %(label)s [%(bar)s] %(info)s� �iterable�length�label�show_eta� show_percent�show_pos�item_show_func� fill_char�
empty_char� bar_template�info_sep�width�file�update_min_stepszProgressBar[V]c C s: ddl m} t|
�}
|| |||||||| |
| || |
|d�S )aQ This function creates an iterable context manager that can be used
to iterate over something while showing a progress bar. It will
either iterate over the `iterable` or `length` items (that are counted
up). While iteration happens, this function will print a rendered
progress bar to the given `file` (defaults to stdout) and will attempt
to calculate remaining time and more. By default, this progress bar
will not be rendered if the file is not a terminal.
The context manager creates the progress bar. When the context
manager is entered the progress bar is already created. With every
iteration over the progress bar, the iterable passed to the bar is
advanced and the bar is updated. When the context manager exits,
a newline is printed and the progress bar is finalized on screen.
Note: The progress bar is currently designed for use cases where the
total progress can be expected to take at least several seconds.
Because of this, the ProgressBar class object won't display
progress that is considered too fast, and progress where the time
between steps is less than a second.
No printing must happen or the progress bar will be unintentionally
destroyed.
Example usage::
with progressbar(items) as bar:
for item in bar:
do_something_with(item)
Alternatively, if no iterable is specified, one can manually update the
progress bar through the `update()` method instead of directly
iterating over the progress bar. The update method accepts the number
of steps to increment the bar with::
with progressbar(length=chunks.total_bytes) as bar:
for chunk in chunks:
process_chunk(chunk)
bar.update(chunks.bytes)
The ``update()`` method also takes an optional value specifying the
``current_item`` at the new position. This is useful when used
together with ``item_show_func`` to customize the output for each
manual step::
with click.progressbar(
length=total_size,
label='Unzipping archive',
item_show_func=lambda a: a.filename
) as bar:
for archive in zip_file:
archive.extract()
bar.update(archive.size, archive)
:param iterable: an iterable to iterate over. If not provided the length
is required.
:param length: the number of items to iterate over. By default the
progressbar will attempt to ask the iterator about its
length, which might or might not work. If an iterable is
also provided this parameter can be used to override the
length. If an iterable is not provided the progress bar
will iterate over a range of that length.
:param label: the label to show next to the progress bar.
:param show_eta: enables or disables the estimated time display. This is
automatically disabled if the length cannot be
determined.
:param show_percent: enables or disables the percentage display. The
default is `True` if the iterable has a length or
`False` if not.
:param show_pos: enables or disables the absolute position display. The
default is `False`.
:param item_show_func: A function called with the current item which
can return a string to show next to the progress bar. If the
function returns ``None`` nothing is shown. The current item can
be ``None``, such as when entering and exiting the bar.
:param fill_char: the character to use to show the filled part of the
progress bar.
:param empty_char: the character to use to show the non-filled part of
the progress bar.
:param bar_template: the format string to use as template for the bar.
The parameters in it are ``label`` for the label,
``bar`` for the progress bar and ``info`` for the
info section.
:param info_sep: the separator between multiple info items (eta etc.)
:param width: the width of the progress bar in characters, 0 means full
terminal width
:param file: The file to write to. If this is not a terminal then
only the label is printed.
:param color: controls if the terminal supports ANSI colors or not. The
default is autodetection. This is only needed if ANSI
codes are included anywhere in the progress bar output
which is not the case by default.
:param update_min_steps: Render only when this many updates have
completed. This allows tuning for very fast iterators.
.. versionchanged:: 8.0
Output is shown even if execution time is less than 0.5 seconds.
.. versionchanged:: 8.0
``item_show_func`` shows the current item, not the previous one.
.. versionchanged:: 8.0
Labels are echoed if the output is not a TTY. Reverts a change
in 7.0 that removed all output.
.. versionadded:: 8.0
Added the ``update_min_steps`` parameter.
.. versionchanged:: 4.0
Added the ``color`` parameter. Added the ``update`` method to
the object.
.. versionadded:: 2.0
r r )r� r� r� r� r� r� r� r� r� r� r� r� r� ry r� )r� r r
)r� r� r� r� r� r� r� r� r� r� r� r� r� ry r� r r9 r9 r: � progressbar3 s( �r� c C s0 t tj�sdS trt�d� dS tj�d� dS )z�Clears the terminal screen. This will have the effect of clearing
the whole visible space of the terminal and moving the cursor to the
top left. This does not do anything if not connected to a terminal.
.. versionadded:: 2.0
N�clsz
[2J[1;1H)r �sys�stdoutr �os�system�writer9 r9 r9 r: �clear� s
r� �offsetc C sj t | t�rd| � d| d��S t | ttf�r-| \}}}d| � d|d�d|d�d|d��S tt| | �S )N�& z;5;�dz;2;�;)rD �int�tuple�listrG � _ansi_colors)ry r� �r�g�br9 r9 r: �_interpret_color� s
$r� �fg�bg�bold�dim� underline�overline�italic�blink�reverse�
strikethroughc
C s� t | t�s t| �} g } |r*z
| �dt|�� d�� W n ty) td|���d�w |rJz| �dt|d�� d�� W n tyI td|���d�w |dur[| �d|rUdnd� d�� |durl| �d|rfdnd� d�� |dur}| �d|rwd nd
� d�� |dur�| �d|r�d nd � d�� |dur�| �d|r�d
nd� d�� |dur�| �d|r�dnd� d�� | dur�| �d| r�dnd� d�� |
dur�| �d|
r�dnd� d�� | �| � | r�| �t� d�| �S )a! Styles a text with ANSI styles and returns the new string. By
default the styling is self contained which means that at the end
of the string a reset code is issued. This can be prevented by
passing ``reset=False``.
Examples::
click.echo(click.style('Hello World!', fg='green'))
click.echo(click.style('ATTENTION!', blink=True))
click.echo(click.style('Some things', reverse=True, fg='cyan'))
click.echo(click.style('More colors', fg=(255, 12, 128), bg=117))
Supported color names:
* ``black`` (might be a gray)
* ``red``
* ``green``
* ``yellow`` (might be an orange)
* ``blue``
* ``magenta``
* ``cyan``
* ``white`` (might be light gray)
* ``bright_black``
* ``bright_red``
* ``bright_green``
* ``bright_yellow``
* ``bright_blue``
* ``bright_magenta``
* ``bright_cyan``
* ``bright_white``
* ``reset`` (reset the color code only)
If the terminal supports it, color may also be specified as:
- An integer in the interval [0, 255]. The terminal must support
8-bit/256-color mode.
- An RGB tuple of three integers in [0, 255]. The terminal must
support 24-bit/true-color mode.
See https://en.wikipedia.org/wiki/ANSI_color and
https://gist.github.com/XVilka/8346728 for more information.
:param text: the string to style with ansi codes.
:param fg: if provided this will become the foreground color.
:param bg: if provided this will become the background color.
:param bold: if provided this will enable or disable bold mode.
:param dim: if provided this will enable or disable dim mode. This is
badly supported.
:param underline: if provided this will enable or disable underline.
:param overline: if provided this will enable or disable overline.
:param italic: if provided this will enable or disable italic.
:param blink: if provided this will enable or disable blinking.
:param reverse: if provided this will enable or disable inverse
rendering (foreground becomes background and the
other way round).
:param strikethrough: if provided this will enable or disable
striking through text.
:param reset: by default a reset-all code is added at the end of the
string which means that styles do not carry over. This
can be disabled to compose styles.
.. versionchanged:: 8.0
A non-string ``message`` is converted to a string.
.. versionchanged:: 8.0
Added support for 256 and RGB color codes.
.. versionchanged:: 8.0
Added the ``strikethrough``, ``italic``, and ``overline``
parameters.
.. versionchanged:: 7.0
Added support for bright colors.
.. versionadded:: 2.0
z[�mzUnknown color N�
r � rq � � �5 �7 � � � � � � � � rl )rD rG �appendr� �KeyError� TypeError�_ansi_reset_allrE )
r< r� r� r� r� r� r� r� r� r� r� r$ �bitsr9 r9 r: �style� sF
Z � �
r� c C s t | �S )a Removes ANSI styling information from a string. Usually it's not
necessary to use this function as Click's echo function will
automatically remove styling if necessary.
.. versionadded:: 2.0
:param text: the text to remove style information from.
r )r< r9 r9 r: �unstyleh s r� �messagerW �stylesc K s8 | durt | ttf�st| fi |��} t| ||||d�S )a� This function combines :func:`echo` and :func:`style` into one
call. As such the following two calls are the same::
click.secho('Hello World!', fg='green')
click.echo(click.style('Hello World!', fg='green'))
All keyword arguments are forwarded to the underlying functions
depending on which one they go with.
Non-string types will be converted to :class:`str`. However,
:class:`bytes` are passed directly to :meth:`echo` without applying
style. If you want to style bytes that represent text, call
:meth:`bytes.decode` first.
.. versionchanged:: 8.0
A non-string ``message`` is converted to a string. Bytes are
passed through without style applied.
.. versionadded:: 2.0
N)r� rW rT ry )rD �bytes� bytearrayr� r )r� r� rW rT ry r� r9 r9 r: �sechot s r� �.txt�editor�env� require_save� extension�filenamec C s< ddl m} |||||d�}|du r|�| �S |�|� dS )a� Edits the given text in the defined editor. If an editor is given
(should be the full path to the executable but the regular operating
system search path is used for finding the executable) it overrides
the detected editor. Optionally, some environment variables can be
used. If the editor is closed without changes, `None` is returned. In
case a file is edited directly the return value is always `None` and
`require_save` and `extension` are ignored.
If the editor cannot be opened a :exc:`UsageError` is raised.
Note for Windows: to simplify cross-platform usage, the newlines are
automatically converted from POSIX to Windows and vice versa. As such,
the message here will have ``\n`` as newline markers.
:param text: the text to edit.
:param editor: optionally the editor to use. Defaults to automatic
detection.
:param env: environment variables to forward to the editor.
:param require_save: if this is true, then not saving in the editor
will make the return value become `None`.
:param extension: the extension to tell the editor about. This defaults
to `.txt` but changing this might change syntax
highlighting.
:param filename: if provided it will edit this file instead of the
provided text contents. It will not use a temporary
file as an indirection in that case.
r )�Editor)r� r� r� r� N)r� r� �edit� edit_file)r< r� r� r� r� r� r� �edr9 r9 r: r� � s #
r� �url�wait�locatec C s ddl m} || ||d�S )a This function launches the given URL (or filename) in the default
viewer application for this file type. If this is an executable, it
might launch the executable in a new session. The return value is
the exit code of the launched application. Usually, ``0`` indicates
success.
Examples::
click.launch('https://click.palletsprojects.com/')
click.launch('/my/downloaded/file', locate=True)
.. versionadded:: 2.0
:param url: URL or filename of the thing to launch.
:param wait: Wait for the program to exit before returning. This
only works if the launched program blocks. In particular,
``xdg-open`` on Linux does not block.
:param locate: if this is set to `True` then instead of launching the
application associated with the URL it will attempt to
launch a file manager with the file located. This
might have weird effects if the URL does not point to
the filesystem.
r )�open_url)r� r� )r� r� )r� r� r� r� r9 r9 r: �launch� s r� �_getcharr c C s t du r ddlm} |a t | �S )a� Fetches a single character from the terminal and returns it. This
will always return a unicode character and under certain rare
circumstances this might return more than one character. The
situations which more than one character is returned is when for
whatever reason multiple characters end up in the terminal buffer or
standard input was not actually a terminal.
Note that this will always read from the terminal, even if something
is piped into the standard input.
Note for Windows: in rare cases when typing non-ASCII characters, this
function might wait for a second character and then return both at once.
This is because certain Unicode characters look like special-key markers.
.. versionadded:: 2.0
:param echo: if set to `True`, the character read will also show up on
the terminal. The default is to not show it.
Nr )�getchar)r� r� r� )r r\ r9 r9 r: r� � s r� c C s ddl m} | � S )Nr )� raw_terminal)r� r� )r\ r9 r9 r: r� s r� �infoc C s� t tj�r
t tj�s dS | du rtd�} z&| r t| d|d� zt� W n ttfy. Y nw W | r9t|d� dS dS | rCt|d� w w )a( This command stops execution and waits for the user to press any
key to continue. This is similar to the Windows batch "pause"
command. If the program is not run through a terminal, this command
will instead do nothing.
.. versionadded:: 2.0
.. versionadded:: 4.0
Added the `err` parameter.
:param info: The message to print before pausing. Defaults to
``"Press any key to continue..."``.
:param err: if set to message goes to ``stderr`` instead of
``stdout``, the same as with echo.
Nz Press any key to continue...FrV rX ) r r� �stdinr� r` r r� rZ r[ )r� rT r9 r9 r: �pause
s$
��� �r� )FNTN) NFFNNrO TFT)FFrO TFrz )NNNTNFNr� r� r� r� r! NNr )r7 N)r ) NNNNNNNNNNT)NNTFN)NNNTr� N)FF)F)NF)Er� rL r� r� r� �typingra r r` �_compatr r r �
exceptionsr r �globalsr
�typesr r r
�utilsr r �
TYPE_CHECKINGr� r �TypeVarr �inputr r� rG �__annotations__r� r� r; �bool�Optional�AnyrJ rI �Unionr6 rp �
terminal_sizerw r� r� r� �TextIOr� r� �Tupler� r� r� �IOr� �AnyStr�Mappingr� r� r� r� �ContextManagerr� r� r9 r9 r9 r: �<module> s:
�������� �
� � �
����� ����
���
� ��
�� ����� �
�
�r�������
�=�$��
�!������� �� �
� � �
���
�
���
��� � ������ �
� � �
�
�
�
�����
�#�
������
� . "