U
|
ß=®d¤n ã @ sj U d dl Z d dlZd dlZd dlZd dlZd dlmZ ddlm Z ddlm
|
Z
|
ddl m Z ddl m Z ddlmZ dd lmZ dd
|
lmZ dd lmZ dd lmZ dd lmZ ejrÀddlmZ e d¡Ze Z ej e ge f e d< dddddddddddd d d d d d!d"Z!d#Z"e e d$d%d&Z#d`e e e$ej%ej& e$ej%e e d)d*d+Z'ej&ej&d,d-d.Z(dae ej%ej& e$ej)e$e f ej%ej)eej&f ej%ej e gej&f e e$e$e$ej&d0 d1d2Z*dbe ej%e$ e$e e$e$e$d3d4d5Z+dcej)ej,e ej g ej,e f e f ej%e$ dd6d7d8Z-ddej%ej,e ej%e. ej%e e$ej%e$ e$ej%ej ej%e gej%e f e e e e e.ej%ej/ ej%e$ e.d=d>d?d@Z0ddAdBdCZ1deej)e.ej2e.e.e.f e f e.e dDdEdFZ3dfej&ej%ej)e.ej2e.e.e.f e f ej%ej)e.ej2e.e.e.f e f ej%e$ ej%e$ ej%e$ ej%e$ ej%e$ ej%e$ ej%e$ ej%e$ e$e dG dHdIZ4e e dJdKdLZ5dgej%ej& ej%ej6ej7 e$e$ej%e$ ej&ddMdNdOZ8dhej%ej7 ej%e ej%ej9e e f e$e ej%e ej%ej7 dQdRdSZ:die e$e$e.dTdUdVZ;da<ej%ej e$ge f e dW< dje$e dXdYdZZ=ej>e. dAd[d\Z?dkej%e e$dd]d^d_Z@dS )lé N)Úgettexté )Úisatty©Ú
|
strip_ansi)ÚAbort)Ú
|
UsageError)Úresolve_color_default)ÚChoice)Ú convert_type)Ú ParamType)Úecho)ÚLazyFile©Ú ProgressBarÚVÚvisible_prompt_funcé é é é! é" é# é$ é% é' éZ é[ é\ é] é^ é_ é` éa )ZblackÚredÚgreenZyellowÚblueZmagentaZcyanZwhiteÚresetZ bright_blackZ
|
bright_redZ bright_greenZ bright_yellowZ bright_blueZbright_magentaZ bright_cyanZ bright_whitez[0m)ÚpromptÚreturnc C s dd l }| | ¡S )Nr )Úgetpass)r( r* © r+ úCd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\click/termui.pyÚhidden_prompt_func2 s r- FT)ÚtextÚsuffixÚ show_defaultÚdefaultÚ show_choicesÚtyper) c C sd | }|d k r8|r8t |tr8|dd tt|j¡ d7 }|d k rX|rX| dt| d}| | S )Nz (z, ú)z [ú])Ú
|
isinstancer
|
ÚjoinÚmapÚstrÚchoicesÚ_format_default)r. r/ r0 r1 r2 r3 r( r+ r+ r, Ú _build_prompt8 s r< )r1 r) c C s$ t | tjtfr t| dr | jS | S )NÚname)r6 ÚioÚIOBaser Úhasattrr= )r1 r+ r+ r, r; H s r; ú: ) r. r1 Ú
|
hide_inputÚconfirmation_promptr3 Ú
|
value_procÚ prompt_suffixr0 Úerrr2 r) c
|
|
s. t t d fdd }
|
|dkr(t||}t| |||| |} |rX|dkrNtd}t||}|
|
| } | rhqxqX|dk rX|} qxqXz || } W nX tk
|
rÜ } z:r¬ttd d nttd j|d
|
d W Y ¢qXW 5 d}~X Y nX |sæ| S |
|
|}| oø| }|s
|
|ræq
|
qæ| |kr| S ttd d qXdS ) 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 an 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. r) c s` rt nt}z t| d¡d d |dW S ttfk
|
rZ rNtd d t d Y nX d S )Nú F©ÚnlrF ©rF )r- r r ÚrstripÚKeyboardInterruptÚEOFErrorr )r. Úf©rF rB r+ r, Ú prompt_func s
|
zprompt.<locals>.prompt_funcNTzRepeat for confirmationz)Error: The value you entered was invalid.rK zError: {e.message})Úez+Error: The two entered values do not match.)r9 r r< Ú_r r Úformat)r. r1 rB rC r3 rD rE r0 rF r2 rQ r( ÚvalueÚresultrR Zvalue2Zis_emptyr+ rP r, r( O sJ 5
|
ÿ
|
|
|
r( )r. r1 ÚabortrE r0 rF r) c C sÆ t | |||dkrdn
|
|r dnd}z(t| d¡d|d td ¡ ¡ }W n ttfk
|
rj t dY nX |dkrzd }q´|d
|
krd}q´|dk r|d kr|}q´tt d |d q"q´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/NrH FrI )ÚyÚyesT)ÚnÚnoÚ zError: invalid inputrK )
|
r< r rL r ÚlowerÚstriprM rN r rS ) r. r1 rW rE r0 rF r( rU Úrvr+ r+ r, Úconfirm¾ s. ür` )Útext_or_generatorÚcolorr) c C s t |}t | ¡r2t tjg tjt f | ¡ }n(t| trD| g}nt 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 |tr|nt|V qd S )N)r6 r9 )Ú.0Úelr+ r+ r, Ú <genexpr> s z!echo_via_pager.<locals>.<genexpr>r )ÚpagerÚ
|
)r ÚinspectÚisgeneratorfunctionÚtÚcastÚCallableÚIterabler9 r6 ÚiterÚ _termui_implrf Ú itertoolsÚchain)ra rb ÚiZtext_generatorrf r+ r+ r, Úecho_via_pagerû s
|
|
rs ú#ú-ú %(label)s [%(bar)s] %(info)sú zProgressBar[V])ÚiterableÚlengthÚlabelÚshow_etaÚ show_percentÚshow_posÚitem_show_funcÚ fill_charÚ
|
empty_charÚ bar_templateÚinfo_sepÚwidthÚfilerb Úupdate_min_stepsr) c C s: ddl m} t| } || |||||||| |
|
| || | |dS )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 )rx ry r{ r| r} r~ r r r r r rz r rb r
)ro r r )rx ry rz r{ r| r} r~ r r r r r r rb r
r r+ r+ r, Ú progressbar s( ñr )r) c C s t tjsdS tddd 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
|
Nz
|
[2J[1;1HF)rJ )r ÚsysÚstdoutr r+ r+ r+ r, Úclear³ s
|
r )rb Úoffsetr) c C sj t | tr d| d| dS t | ttfrZ| \}}}d| d|dd|dd|dS tt| | S )Né& z;5;Údz;2;ú;)r6 ÚintÚtupleÚlistr9 Ú _ansi_colors)rb r ÚrÚgÚbr+ r+ r, Ú_interpret_colorÁ s
|
|
$r ) r. ÚfgÚbgÚboldÚdimÚ underlineÚoverlineÚitalicÚblinkÚreverseÚ strikethroughr' r) c C sê t | tst| } g } |rZz| dt| d¡ W n$ tk
|
rX td|dY nX |r z | dt|d d¡ W n$ tk
|
r td|dY nX |dk rÂ| d|r¶dnd d¡ |dk rä| d|rØdnd d¡ |dk r| d|rüd nd
|
d¡ |dk r.| d|r"d nd d¡ |dk rT| d|rHd nd d¡ |dk rz| d|rndnd d¡ | dk r | d| rdnd d¡ |
|
dk rÆ| 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 é é é é é5 é7 é é é é é é é é r\ )r6 r9 Úappendr ÚKeyErrorÚ TypeErrorÚ_ansi_reset_allr7 ) r. r r r r r r r r r r r' Úbitsr+ r+ r, ÚstyleÎ sB Z
|
|
|
|
|
|
|
|
|
rµ rG 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. r+ r+ r, ÚunstyleO s r¶ )Úmessager rJ rF rb Ústylesr) c K s4 | dk r"t | ttfs"t| f|} t| ||||dS )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 rJ rF rb )r6 ÚbytesÚ bytearrayrµ r )r· r rJ rF rb r¸ r+ r+ r, Úsecho[ s r» ú.txt)r. ÚeditorÚenvÚ require_saveÚ extensionÚfilenamer) c C s< ddl m} |||||d}|dkr.| | ¡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)ro r ÚeditZ edit_file)r. r½ r¾ r¿ rÀ rÁ r Zedr+ r+ r, rà } s #
|
|
rà )ÚurlÚwaitÚlocater) c C s ddl m} || ||dS )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Æ )ro rÇ )rÄ rÅ rÆ rÇ r+ r+ r, Úlaunch« s rÈ Ú_getchar)r r) c C s t dkrddlm} |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É ro rÊ )r rO r+ r+ r, rÊ Í s rÊ c C s ddl m} | S )Nr )Ú raw_terminal)ro rË )rO r+ r+ r, rË ë s rË )ÚinforF r) c C sx t tjrt tjsdS | dkr(td} z:| r<t| d|d z
|
t W n ttfk
|
r^ Y nX W 5 | rrt|d X dS )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...rK FrI ) r r Ústdinr rS r rÊ rM rN )rÌ rF r+ r+ r, Úpauseñ s
|
|
rÎ )FNTN) NFFNNrA TFT)FFrA TF)N)NNNTNFNrt ru rv rw r NNr )r ) NNNNNNNNNNT)NNTFN)NNNTr¼ N)FF)F)NF)Arh r> rp r Útypingrj r rS Ú_compatr r Ú
|
exceptionsr r Úglobalsr Útypesr
|
r r Úutilsr r Ú TYPE_CHECKINGro r ÚTypeVarr Úinputr rl r9 Ú__annotations__r r³ r- ÚboolÚOptionalÚAnyr< r; ÚUnionr( r` rm rs r ÚTextIOr r ÚTupler rµ r¶ ÚIOÚAnyStrr» ÚMappingrà rÈ rÉ rÊ ÚContextManagerrË rÎ r+ r+ r+ r, Ú<module> s
|
ï ú
|
ù ö
|
õ q úù ? þ$ý ! ñ
|
ð ÿ þ ô ó û
|
ù # ú
|
|
ù .
|
