U
|
ß=®d L ã @ s| U d dl Z d dlZd dlZd dlmZ d dlmZ ddlm Z ddlm
|
Z
|
ddlm Z ddlm Z dd lm Z dd
|
lmZ dd lmZ dd lmZ ejrªd dlZe d ¡Ze d¡Ze d¡Zejdej f Z ejegef Z de d< ejdej e e
|
f dZ!dddddZ"ddddd Z#dKej$e e%ejd gdf d d d!Z&dd"e'ej(e' d#d$d%d&Z)ejd'e
|
dZ*ej+e e
|
d(d)d*Z,ej+ej(e' ej$e* ej eje ge*f d+d,d*Z,ej+dLdej$e* ej eje ge*f d+d-d*Z,ej+dMej(e' dej eje ge
|
f d+d.d*Z,dNej ej(e' e f ej(ej$e* ej ej e
|
eje gej e
|
e*f f f d+d/d*Z,ejd0e dZ-ej+e e d(d1d2Z.ej+ej(e' ej$e- ej eje ge-f d+d3d2Z.ej+dOdej$e- ej eje ge-f d+d4d2Z.ej+dPej(e' dej eje ge f d+d5d2Z.dQej e'e df ej(ej$e- ej ej e eje gej e e-f f f d+d6d2Z.ejdej f edd7d8d9Z/dd:e'ej(ej$e ej e e! d;d<d=Z0dd:e'ej(ej$e ej e e! d;d>d?Z1e'ej e e! d@dAdBZ2e'ej e e! d@dCdDZ3dRddddEej(e' e'ej(e' ej(e' ej(e' ej e e! dFdGdHZ4e'ej e e! d@dIdJZ5dS )Sé N©Úupdate_wrapper)Úgettexté )ÚArgument)ÚCommand)ÚContext)ÚGroup)ÚOption)Ú Parameter©Úget_current_context)ÚechoÚPÚRÚT.z te.TypeAliasÚ
|
_DecoratorÚFC)Úboundz)t.Callable[te.Concatenate[Context, P], R]út.Callable[P, R]©ÚfÚreturnc s dddd fdd }t | S )z]Marks a callback as wanting to receive the current context
|
object as first argument.
|
úP.argsúP.kwargsr ©ÚargsÚkwargsr c s t f| |S ©Nr ©r r ©r © úGd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\click/decorators.pyÚnew_func! s z pass_context.<locals>.new_funcr ©r r# r! r r" Ú pass_context s r% ú't.Callable[te.Concatenate[t.Any, P], R]c s dddd fdd }t | S )z¼Similar to :func:`pass_context`, but only pass the object on the
|
context onwards (:attr:`Context.obj`). This is useful if that object
|
represents the state of a nested system.
|
r r r r c s t jf| |S r )r Úobjr r r! r" r# - s zpass_obj.<locals>.new_funcr r$ r! r r" Úpass_obj' s r( Fú#t.Callable[te.Concatenate[T, P], R])Ú object_typeÚensurer c s ddd fdd }|S )a. Given an object type this creates a decorator that will work
|
similar to :func:`pass_obj` but instead of passing the object of the
|
current context, it will find the innermost context of type
|
:func:`object_type`.
|
|
This generates a decorator that works roughly like this::
|
|
from functools import update_wrapper
|
|
def decorator(f):
|
@pass_context
|
def new_func(ctx, *args, **kwargs):
|
obj = ctx.find_object(object_type)
|
return ctx.invoke(f, obj, *args, **kwargs)
|
return update_wrapper(new_func, f)
|
return decorator
|
|
:param object_type: the type of the object to pass.
|
:param ensure: if set to `True`, a new object will be created and
|
remembered on the context if it's not there yet.
|
r) r r c s$ dddd fdd }t | S )Nr r r r c sN t } r| ¡}n
|
| ¡}|d kr:tdjd|j|f| |S )Nz<Managed to invoke callback without a context object of type z
|
existing.)r Z ensure_objectZ find_objectÚ RuntimeErrorÚ__name__Úinvoke©r r Úctxr' )r+ r r* r! r" r# M s
|
ÿz8make_pass_decorator.<locals>.decorator.<locals>.new_funcr r$ ©r+ r* r r" Ú decoratorL s z&make_pass_decorator.<locals>.decoratorr! )r* r+ r2 r! r1 r" Úmake_pass_decorator3 s r3 )Údoc_descriptionzGt.Callable[[t.Callable[te.Concatenate[t.Any, P], R]], t.Callable[P, R]])Úkeyr4 r c s: ddd fdd }|dkr(d d}d | d
|
|_ |S ) a{ Create a decorator that passes a key from
|
:attr:`click.Context.meta` as the first argument to the decorated
|
function.
|
|
:param key: Key in ``Context.meta`` to pass.
|
:param doc_description: Description of the object being passed,
|
inserted into the decorator's docstring. Defaults to "the 'key'
|
key from Context.meta".
|
|
.. versionadded:: 8.0
|
r& r r c s" ddt d fdd }t| S )Nr r r c s$ t }|j }|j |f| |S r )r Úmetar. r/ )r r5 r! r" r# t s
|
z2pass_meta_key.<locals>.decorator.<locals>.new_func)r r r$ ©r5 r r" r2 s s z pass_meta_key.<locals>.decoratorNzthe z$ key from :attr:`click.Context.meta`zDecorator that passes z1 as the first argument to the decorated function.)Ú__doc__)r5 r4 r2 r! r7 r" Ú pass_meta_keyd s
|
ÿr9 ÚCmdType)Únamer c C s d S r r! ©r; r! r! r" Úcommand s r= )r; ÚclsÚattrsr c K s d S r r! ©r; r> r? r! r! r" r= s c K s d S r r! r@ r! r! r" r= s c K s d S r r! r@ r! r! r" r= © s c sv d}t r0}ddks$td r0tddkrJt tjt t¡ttd fdd }|dk rr||S |S )a± Creates a new :class:`Command` and uses the decorated function as
|
callback. This will also automatically attach all decorated
|
:func:`option`\s and :func:`argument`\s as parameters to the command.
|
|
The name of the command defaults to the name of the function with
|
underscores replaced by dashes. If you want to change that, you can
|
pass the intended name as the first argument.
|
|
All keyword arguments are forwarded to the underlying command class.
|
For the ``params`` argument, any decorated params are appended to
|
the end of the list.
|
|
Once decorated the function turns into a :class:`Command` instance
|
that can be invoked as a command line utility or be attached to a
|
command :class:`Group`.
|
|
:param name: the name of the command. This defaults to the function
|
name with underscores replaced by dashes.
|
:param cls: the command class to instantiate. This defaults to
|
:class:`Command`.
|
|
.. versionchanged:: 8.1
|
This decorator can be applied without parentheses.
|
|
.. versionchanged:: 8.1
|
The ``params`` argument can be used. Decorated params are
|
appended to the end of the list.
|
Nz4Use 'command(cls=cls)(callable)' to specify a class.z7Use 'command(**kwargs)(callable)' to provide arguments.r c sÊ t | trtd dd ¡}|d k r*|ng }z
|
| j}W n tk
|
rL Y nX | `| t|¡ d¡d krx| j d< t
|
j rd k st t rt f p®| j ¡ dd¡| |d }| j |_ |S )Nz5Attempted to convert a callback into a command twice.ÚparamsÚhelpÚ_ú-)r; ÚcallbackrA )Ú
|
isinstancer Ú TypeErrorÚpopÚ__click_params__ÚAttributeErrorÚextendÚreversedÚgetr8 ÚtÚ TYPE_CHECKINGÚAssertionErrorÚcallabler- ÚlowerÚreplace)r Z attr_paramsrA Zdecorator_paramsÚcmd©r? r> r; r! r" r2 Ý s0
|
|
|
ýüzcommand.<locals>.decorator)rQ rP rN ÚcastÚTyper: r Ú _AnyCallable)r; r> r? Úfuncr2 r! rU r" r= ° s " ÚGrpTypec C s d S r r! r< r! r! r" Úgroup s r[ c K s d S r r! r@ r! r! r" r[ s c K s d S r r! r@ r! r! r" r[ s c K s d S r r! r@ r! r! r" r[ & s c K sF |dkrt t jt t¡}t| r8tf d|i|| S t| |f|S )a Creates a new :class:`Group` with a function as callback. This
|
works otherwise the same as :func:`command` just that the `cls`
|
parameter is set to :class:`Group`.
|
|
.. versionchanged:: 8.1
|
This decorator can be applied without parentheses.
|
Nr> )rN rV rW rZ r rQ r= r@ r! r! r" r[ - s
|
)r Úparamr c C s8 t | tr| j |¡ n t| ds(g | _| j |¡ d S )NrI )rF r rA ÚappendÚhasattrrI )r r\ r! r! r" Ú _param_memoB s
|
|
|
r_ )r> )Ú param_declsr> r? r c s( dkr t ttd fdd }|S )aØ Attaches an argument to the command. All positional arguments are
|
passed as parameter declarations to :class:`Argument`; all keyword
|
arguments are forwarded unchanged (except ``cls``).
|
This is equivalent to creating an :class:`Argument` instance manually
|
and attaching it to the :attr:`Command.params` list.
|
|
For the default argument class, refer to :class:`Argument` and
|
:class:`Parameter` for descriptions of parameters.
|
|
:param cls: the argument class to instantiate. This defaults to
|
:class:`Argument`.
|
:param param_decls: Passed as positional arguments to the constructor of
|
``cls``.
|
:param attrs: Passed as keyword arguments to the constructor of ``cls``.
|
Nr c s t | f | S r ©r_ r ©r? r> r` r! r" r2 a s zargument.<locals>.decorator)r r ©r> r` r? r2 r! rb r" ÚargumentL s rd c s( dkr t ttd fdd }|S )aÊ Attaches an option to the command. All positional arguments are
|
passed as parameter declarations to :class:`Option`; all keyword
|
arguments are forwarded unchanged (except ``cls``).
|
This is equivalent to creating an :class:`Option` instance manually
|
and attaching it to the :attr:`Command.params` list.
|
|
For the default option class, refer to :class:`Option` and
|
:class:`Parameter` for descriptions of parameters.
|
|
:param cls: the option class to instantiate. This defaults to
|
:class:`Option`.
|
:param param_decls: Passed as positional arguments to the constructor of
|
``cls``.
|
:param attrs: Passed as keyword arguments to the constructor of ``cls``.
|
Nr c s t | f | S r ra r rb r! r" r2 } s zoption.<locals>.decorator)r
|
r rc r! rb r" Úoptionh s re )r` r r c O sb t ttdddd}| s d} | dd¡ | d|¡ | d d
|
¡ | d d ¡ | d d¡ t| |S )a- Add a ``--yes`` option which shows a prompt before continuing if
|
not passed. If the prompt is declined, the program will exit.
|
|
:param param_decls: One or more option names. Defaults to the single
|
value ``"--yes"``.
|
:param kwargs: Extra arguments are passed to :func:`option`.
|
N©r0 r\ Úvaluer c S s |s | ¡ d S r )Úabort©r0 r\ rg r! r! r" rE s z%confirmation_option.<locals>.callback)z--yesÚis_flagTrE Ú expose_valueFÚpromptzDo you want to continue?rB z%Confirm the action without prompting.)r r ÚboolÚ
|
setdefaultre ©r` r rE r! r! r" Úconfirmation_option s rp c O s6 | sd} | dd¡ | dd¡ | dd¡ t| |S )a0 Add a ``--password`` option which prompts for a password, hiding
|
input and asking to enter the value again for confirmation.
|
|
:param param_decls: One or more option names. Defaults to the single
|
value ``"--password"``.
|
:param kwargs: Extra arguments are passed to :func:`option`.
|
)z
|
--passwordrl TZconfirmation_promptZ
|
hide_input)rn re )r` r r! r! r" Úpassword_option s rq )Ú package_nameÚ prog_nameÚmessage)Úversionr` rr rs rt r r c
|
sð dkrt d dkrdkrt ¡ }|dk r6|jnd}|dk rH|jnd}~|dk r| d¡dkrr| d¡r d¡d ttt dd fd d
|
} |sªd }|
|
d d ¡ |
|
dd¡ |
|
dd ¡ |
|
dt d¡ | |d< t ||S )aà Add a ``--version`` option which immediately prints the version
|
number and exits the program.
|
|
If ``version`` is not provided, Click will try to detect it using
|
:func:`importlib.metadata.version` to get the version for the
|
``package_name``. On Python < 3.8, the ``importlib_metadata``
|
backport must be installed.
|
|
If ``package_name`` is not provided, Click will try to detect it by
|
inspecting the stack frames. This will be used to detect the
|
version, so it must match the name of the installed package.
|
|
:param version: The version number to show. If not provided, Click
|
will try to detect it.
|
:param param_decls: One or more option names. Defaults to the single
|
value ``"--version"``.
|
:param package_name: The package name to detect the version from. If
|
not provided, Click will try to detect it.
|
:param prog_name: The name of the CLI to show in the message. If not
|
provided, it will be detected from the command.
|
:param message: The message to show. The values ``%(prog)s``,
|
``%(package)s``, and ``%(version)s`` are available. Defaults to
|
``"%(prog)s, version %(version)s"``.
|
:param kwargs: Extra arguments are passed to :func:`option`.
|
:raise RuntimeError: ``version`` could not be detected.
|
|
.. versionchanged:: 8.0
|
Add the ``package_name`` parameter, and the ``%(package)s``
|
value for messages.
|
|
.. versionchanged:: 8.0
|
Use :mod:`importlib.metadata` instead of ``pkg_resources``. The
|
version is detected based on the package name, not the entry
|
point name. The Python package name must match the installed
|
package name, or be passed with ``package_name=``.
|
Nz %(prog)s, version %(version)sr- Ú__main__Ú __package__Ú.r rf c sÒ |r
|
| j rd S d kr | ¡ jd krd k rzddlm} W n tk
|
r\ dd l}Y nX z| ¡W n& |jk
|
r t dd Y nX d kr¬t ddt
|
d | j d | ¡ d S )Nr )Úmetadataz6 is not installed. Try passing 'package_name' instead.z$Could not determine the version for z automatically.)ÚprogÚpackageru ©Úcolor) Úresilient_parsingZ find_rootZ info_nameÚ importlibry Ú ImportErrorZimportlib_metadataru ZPackageNotFoundErrorr, r r} Úexit)r0 r\ rg ry ©rt rr rs ru r! r" rE í s4
|
|
ÿý
|
ÿþz version_option.<locals>.callback)z --versionrj Trk FÚis_eagerrB zShow the version and exit.rE ) rC ÚinspectÚ currentframeÚf_backÚ f_globalsrM Ú partitionr r rm rn re )
|
ru rr rs rt r` r Úframer r rE r! r r" Úversion_option s, ,
|
|
& r c O sb t ttdddd}| s d} | dd¡ | dd ¡ | d
|
d¡ | d td ¡ ||d < t| |S )a Add a ``--help`` option which immediately prints the help page
|
and exits the program.
|
|
This is usually unnecessary, as the ``--help`` option is added to
|
each command automatically unless ``add_help_option=False`` is
|
passed.
|
|
:param param_decls: One or more option names. Defaults to the single
|
value ``"--help"``.
|
:param kwargs: Extra arguments are passed to :func:`option`.
|
Nrf c S s, |r
|
| j rd S t| ¡ | jd | ¡ d S )Nr| )r~ r Zget_helpr} r ri r! r! r" rE + s
|
z help_option.<locals>.callback)z--helprj Trk Fr rB zShow this message and exit.rE )r r rm rn rC re ro r! r! r" Ú help_option s r )F)N.).N)NN)N.).N)NN)N)6r ÚtypesÚtypingrN Ú functoolsr r rC Úcorer r r r r
|
r Úglobalsr Úutilsr rO Ztyping_extensionsÚteZ ParamSpecr ÚTypeVarr r ÚCallableÚAnyrX r Ú__annotations__ÚUnionr r% r( rW rm r3 ÚstrÚOptionalr9 r: Úoverloadr= rZ r[ r_ rd re rp rq r r r! r! r! r" Ú<module> s
|
|
|
ÿ þ 2ÿ þ !ü þü ÿ þ þ"ü Rü þü ÿ þ þ"ü ÿ þ ÿ þ ÿûù q
|
