o L)jT@szUddlmZddlmZddlZddlZddlZddl m Z ddl m Z ddl m Z ddl mZddl mZdd l mZdd l mZdd l mZdd lmZdLddZGdddZdZdZdZGdddZGd d!d!eZGd"d#d#eZGd$d%d%eZejd&d'd(Zeeed)Z d*e!d+< dMdNd/d0Z"dOd3d4Z#dPd7d8Z$dQd>d?Z%dRdAdBZ&dSdDdEZ'dTdFdGZ(dUdJdKZ)dS)V) annotationsN)gettext)Argument)Command)Context)Group)Option) Parameter)ParameterSource)echoclirctx_argscabc.MutableMapping[str, t.Any] prog_namestr complete_var instructionreturnintc Csr|d\}}}t|}|durdS|||||}|dkr)t|dddS|dkr7t|dSdS) aPerform shell completion for the given CLI program. :param cli: Command being called. :param ctx_args: Extra arguments to pass to ``cli.make_context``. :param prog_name: Name of the executable in the shell. :param complete_var: Name of the environment variable that holds the completion instruction. :param instruction: Value of ``complete_var`` with the completion instruction and shell, in the form ``instruction_shell``. :return: Status code to exit with. _NrsourceF)nlrcomplete) partitionget_completion_classr rencoder) r rrrrshellrcomp_clscompr {/var/www/html/finance-dev.cargoinsureonline.com/_shared/backend-venv/lib/python3.10/site-packages/click/shell_completion.pyshell_completesr"c@s.eZdZdZdZ  ddddZdddZdS)CompletionItema)Represents a completion value and metadata about the value. The default metadata is ``type`` to indicate special shell handling, and ``help`` if a shell supports showing a help string next to the value. Arbitrary parameters can be passed when creating the object, and accessed using ``item.attr``. If an attribute wasn't passed, accessing it returns ``None``. :param value: The completion suggestion. :param type: Tells the shell script to provide special completion support for the type. Click uses ``"dir"`` and ``"file"``. :param help: String shown next to the value if supported. :param kwargs: Arbitrary metadata. The built-in implementations don't use this, but custom type completions paired with custom shell support could use it. valuetypehelp_infoplainNr%t.Anyr&rr' str | NonekwargsrNonecK||_||_||_||_dSNr$)selfr%r&r'r,r r r!__init__O zCompletionItem.__init__namecCs |j|Sr/)r(get)r0r3r r r! __getattr__[s zCompletionItem.__getattr__)r)N) r%r*r&rr'r+r,r*rr-)r3rrr*)__name__ __module__ __qualname____doc__ __slots__r1r5r r r r!r#:s  r#a%(complete_func)s() { local IFS=$'\n' local response response=$(env COMP_WORDS="${COMP_WORDS[*]}" COMP_CWORD=$COMP_CWORD %(complete_var)s=bash_complete $1) for completion in $response; do IFS=',' read type value <<< "$completion" if [[ $type == 'dir' ]]; then COMPREPLY=() compopt -o dirnames elif [[ $type == 'file' ]]; then COMPREPLY=() compopt -o default elif [[ $type == 'plain' ]]; then COMPREPLY+=($value) fi done return 0 } %(complete_func)s_setup() { complete -o nosort -F %(complete_func)s %(prog_name)s } %(complete_func)s_setup; a#compdef %(prog_name)s %(complete_func)s() { local -a completions local -a completions_with_descriptions local -a response (( ! $+commands[%(prog_name)s] )) && return 1 response=("${(@f)$(env COMP_WORDS="${words[*]}" COMP_CWORD=$((CURRENT-1)) %(complete_var)s=zsh_complete %(prog_name)s)}") for type key descr in ${response}; do if [[ "$type" == "plain" ]]; then if [[ "$descr" == "_" ]]; then completions+=("$key") else completions_with_descriptions+=("$key":"$descr") fi elif [[ "$type" == "dir" ]]; then _path_files -/ elif [[ "$type" == "file" ]]; then _path_files -f fi done if [ -n "$completions_with_descriptions" ]; then _describe -V unsorted completions_with_descriptions -U fi if [ -n "$completions" ]; then compadd -U -V unsorted -a completions fi } if [[ $zsh_eval_context[-1] == loadautofunc ]]; then # autoload from fpath, call function directly %(complete_func)s "$@" else # eval/source/. command, register function for later compdef %(complete_func)s %(prog_name)s fi afunction %(complete_func)s; set -l response (env %(complete_var)s=fish_complete COMP_WORDS=(commandline -cp) COMP_CWORD=(commandline -t) %(prog_name)s); for completion in $response; set -l metadata (string split $completion); if test $metadata[1] = "dir"; __fish_complete_directories $metadata[2]; else if test $metadata[1] = "file"; __fish_complete_path $metadata[2]; else if test $metadata[1] = "plain"; if test $metadata[3] != "_"; echo $metadata[2] $metadata[3]; else; echo $metadata[2]; end; end; end; end; complete --no-files --command %(prog_name)s --arguments "(%(complete_func)s)"; c@szeZdZUdZded< ded< d'ddZed(ddZd)ddZd(ddZ d*ddZ d+ddZ d,d"d#Z d(d$d%Z d&S)- ShellCompleteaBase class for providing shell completion support. A subclass for a given shell will override attributes and methods to implement the completion instructions (``source`` and ``complete``). :param cli: Command being called. :param prog_name: Name of the executable in the shell. :param complete_var: Name of the environment variable that holds the completion instruction. .. versionadded:: 8.0 zt.ClassVar[str]r3source_templater rrrrrrrr-cCr.r/)r rrr)r0r rrrr r r!r1r2zShellComplete.__init__cCs*tjdd|jddtjd}d|dS)zQThe name of the shell function defined by the completion script. z\W*-r)flags _completion)resubrreplaceASCII)r0 safe_namer r r! func_names zShellComplete.func_namedict[str, t.Any]cCs|j|j|jdS)zVars for formatting :attr:`source_template`. By default this provides ``complete_func``, ``complete_var``, and ``prog_name``. ) complete_funcrr)rFrrr0r r r! source_varsszShellComplete.source_varscCs|j|S)zProduce the shell script that defines the completion function. By default this ``%``-style formats :attr:`source_template` with the dict returned by :meth:`source_vars`. )r<rJrIr r r!rszShellComplete.sourcetuple[list[str], str]cCt)zUse the env vars defined by the shell script to return a tuple of ``args, incomplete``. This must be implemented by subclasses. NotImplementedErrorrIr r r!get_completion_args sz!ShellComplete.get_completion_argsargs list[str] incompletelist[CompletionItem]cCs0t|j|j|j|}t|||\}}|||S)aTDetermine the context and last complete command or parameter from the complete args. Call that object's ``shell_complete`` method to get the completions for the incomplete value. :param args: List of complete args before the incomplete value. :param incomplete: Value being completed. May be empty. )_resolve_contextr rr_resolve_incompleter")r0rPrRctxobjr r r!get_completionss zShellComplete.get_completionsitemr#cCrL)zFormat a completion item into the form recognized by the shell script. This must be implemented by subclasses. :param item: Completion item to format. rMr0rYr r r!format_completion szShellComplete.format_completioncs4\}}||}fdd|D}d|S)zProduce the completion data to send back to the shell. By default this calls :meth:`get_completion_args`, gets the completions, then calls :meth:`format_completion` for each completion. csg|]}|qSr )r[).0rYrIr r! 1sz*ShellComplete.complete.. )rOrXjoin)r0rPrR completionsoutr rIr!r(s   zShellComplete.completeN) r rrrrrrrrr-rr)rrGrrK)rPrQrRrrrSrYr#rr)r6r7r8r9__annotations__r1propertyrFrJrrOrXr[rr r r r!r;s        r;csLeZdZdZdZeZedddZdfdd Z dd d Z dddZ Z S) BashCompletezShell completion for Bash.bashrr-cCsddl}ddl}|d}|durd}n|j|dddg|jd}td|j}|durM| \}}|dks?|dkrI|dkrKt t d d d dSdSdSt t d d d dS) Nrrhz--norcz-czecho "${BASH_VERSION}")stdoutz^(\d+)\.(\d+)\.\d+4zCShell completion is not supported for Bash versions older than 4.4.T)errz@Couldn't detect Bash version, shell completion is not supported.) shutil subprocesswhichrunPIPErAsearchridecodegroupsr r)rlrmbash_exematchoutputmajorminorr r r!_check_version;s0      zBashComplete._check_versionrcs|tSr/)rysuperrrI __class__r r!r\s zBashComplete.sourcerKcCXttjd}ttjd}|d|}z ||}W||fSty+d}Y||fSwN COMP_WORDS COMP_CWORDrr=split_arg_stringosenvironr IndexErrorr0cwordscwordrPrRr r r!rO`   z BashComplete.get_completion_argsrYr#cCs|jd|jS)N,)r&r%rZr r r!r[lszBashComplete.format_completion)rr-rbrcrd) r6r7r8r9r3 _SOURCE_BASHr< staticmethodryrrOr[ __classcell__r r r{r!rg5s   rgc@,eZdZdZdZeZd ddZdd d Zd S) ZshCompletezShell completion for Zsh.zshrrKcCr}r~rrr r r!rOvrzZshComplete.get_completion_argsrYr#rcCs<|jpd}|dkr|jddn|j}|jd|d|S)Nr:z\:r^r'r%rCr&)r0rYhelp_r%r r r!r[s  zZshComplete.format_completionNrcrd) r6r7r8r9r3 _SOURCE_ZSHr<rOr[r r r r!rps   rc@r) FishCompletezShell completion for Fish.fishrrKcCsXttjd}tjd}|rt|d}|dd}|r(|r(|d|kr(|||fS)Nrrrr)rrrpop)r0rrRrPr r r!rOs   z FishComplete.get_completion_argsrYr#rcCs:|jpd}|jdd}|dd}|jd|d|S)z .. versionchanged:: 8.4.0 Escape newlines in value and help to fix completion errors with multi-line help strings. rr^z\nr)r0rYrr% help_escapedr r r!r[s  zFishComplete.format_completionNrcrd) r6r7r8r9r3 _SOURCE_FISHr<rOr[r r r r!rs  rShellCompleteTypeztype[ShellComplete])bound)rhrrzdict[str, type[ShellComplete]]_available_shellsclsr3r+cCs|dur|j}|t|<|S)amRegister a :class:`ShellComplete` subclass under the given name. The name will be provided by the completion instruction environment variable during completion. :param cls: The completion class that will handle completion for the shell. :param name: Name to register the class under. Defaults to the class's ``name`` attribute. N)r3r)rr3r r r!add_completion_classs rrtype[ShellComplete] | NonecCs t|S)zLook up a registered :class:`ShellComplete` subclass by the name provided by the completion instruction environment variable. If the name isn't registered, returns ``None``. :param shell: Name the class is registered under. )rr4)rr r r!rs rstringrQcCsbddl}|j|dd}d|_d|_g}z |D]}||qW|Sty0||jY|Sw)aSplit an argument string as with :func:`shlex.split`, but don't fail if the string is incomplete. Ignores a missing closing quote or incomplete escape sequence and uses the partial token as-is. .. code-block:: python split_arg_string("example 'my file") ["example", "my file"] split_arg_string("example my\") ["example", "my"] :param string: String to split. .. versionchanged:: 8.2 Moved to ``shell_completion`` from ``parser``. rNT)posixr=)shlexwhitespace_split commentersappend ValueErrortoken)rrlexrarr r r!rs  rrVrparamr boolcCs^t|tsdS|j|j}|jdkp.||jtjup.|jdko.t|t t fo.t ||jkS)zDetermine if the given parameter is an argument that can still accept values. :param ctx: Invocation context for the command represented by the parsed complete args. :param param: Argument object being checked. Frr) isinstancerparamsr4r3nargsget_parameter_sourcer COMMANDLINEtuplelistlen)rVrr%r r r!_is_incomplete_arguments     rr%cCs|sdS|d}||jvS)z5Check if the value looks like the start of an option.Fr) _opt_prefixes)rVr%cr r r!_start_of_options rrPcCsnt|tsdS|js |jrdSd}tt|D]\}}|d|jkr$n t||r-|}nq|duo6||jvS)zDetermine if the given parameter is an option that needs a value. :param args: List of complete args before the incomplete value. :param param: Option object being checked. FNr) rr is_flagcount enumeratereversedrropts)rVrPr last_optionindexargr r r!_is_incomplete_option&s   rc Csd|d<|j||fi|}|j|j}|r|j}t|tr|js\|||\}}}|dur:|WdS|j|||dd}|}|j|j}Wdn1sVwYnH|}|r|||\}}}|durv|WdS|j|||dddd } | }|j}Wdn1swY|s`|}g|j|j}nn|sWd|SWd|SWd|S1swY|S)a`Produce the context hierarchy starting with the command and traversing the complete arguments. This only follows the commands, it doesn't trigger input prompts or callbacks. :param cli: Command being called. :param prog_name: Name of the executable in the shell. :param args: List of complete args before the incomplete value. Tresilient_parsingN)parentrF)rallow_extra_argsallow_interspersed_argsr) make_contextcopy_protected_argsrPcommandrrchainresolve_command) r rrrPrVrr3cmdsub_ctx sub_sub_ctxr r r!rT?sh    + + ++rTrRtuple[Command | Parameter, str]cCs|dkrd}nd|vrt||r|d\}}}||d|vr+t||r+|j|fS|j|}|D]}t|||rA||fSq3|D] }t||rQ||fSqD|j|fS)ahFind the Click object that will handle the completion of the incomplete value. Return the object and the incomplete value. :param ctx: Invocation context for the command represented by the parsed complete args. :param args: List of complete args before the incomplete value. :param incomplete: Value being completed. May be empty. =r=z--)rrrr get_paramsrr)rVrPrRr3rrrr r r!rU|s"        rU) r rrrrrrrrrrrr/)rrr3r+rr)rrrr)rrrrQ)rVrrr rr)rVrr%rrr)rVrrPrQrr rr) r rrrrrrPrQrr)rVrrPrQrRrrr)* __future__rcollections.abcabccabcrrAtypingtrrcorerrrrr r r utilsr r"r#rrrr;rgrrTypeVarrrrerrrrrrrTrUr r r r!sJ           '&&,h;$%  %  =