U
|
ß=®dÜG ã @ s U d dl Z d dlZd dlZd dlmZ ddlmZ ddlmZ ddlm Z ddlm
|
Z
|
ddlm Z dd lm Z dd
|
lm Z dd lmZ dd lmZ eejeejf eeeed ddZG dd dZdZdZdZG dd dZG dd deZ G dd deZ G dd d eZ ej d ej e d Z!e e e d Z"ej#eej e f e$d < d6e!ej%e e!d!d"d#Z&eej%ej e d$d%d&Z'e e e(d'd(d)Z)e ee(d*d+d,Z*e ej+e e e(d-d.d/Z,eejeejf eej+e e d0d1d2Z-e ej+e eej.ej/ee f ef d3d4d5Z0dS )7é N)Úgettexté )ÚArgument)Ú BaseCommand)ÚContext)Ú MultiCommand)ÚOption)Ú Parameter)ÚParameterSource)Úsplit_arg_string)Úecho)ÚcliÚctx_argsÚ prog_nameÚ complete_varÚ instructionÚreturnc C sf | d¡\}}}t|}|dkr$dS || |||}|dkrJt| ¡ dS |dkrbt| ¡ dS dS )a Perform 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.
|
Ú_Nr Úsourcer Úcomplete)Ú partitionÚget_completion_classr r r ) r r r r r Úshellr Zcomp_clsÚcomp© r úMd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\click/shell_completion.pyÚshell_complete s r c @ sH e Zd ZdZdZd ejeeje ejddddZ eejdd d
|
Z
|
dS ) Ú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.
|
©ÚvalueÚtypeÚhelpÚ_infoÚplainN)r r r! Úkwargsr c K s || _ || _|| _|| _d S ©Nr )Úselfr r r! r$ r r r Ú__init__L s zCompletionItem.__init__)Únamer c C s | j |¡S r% )r" Úget)r& r( r r r Ú __getattr__X s zCompletionItem.__getattr__)r# N) Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__Ú __slots__ÚtÚAnyÚstrÚOptionalr' r* r r r r r 7 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
|
aX function %(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"
|
echo $metadata[2]
|
end
|
end
|
end
|
|
complete --no-files --command %(prog_name)s --arguments "(%(complete_func)s)"
|
c @ sä e Zd ZU dZeje ed< eje ed< eej eej
|
f eeddddZ e edd d
|
Z ejeej
|
f dd d Zedd dZejeje ef dddZeje eeje dddZeedddZedddZdS )Ú ShellCompletea¯ Base 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
|
r( Úsource_templateN)r r r r r c C s || _ || _|| _|| _d S r% )r r r r )r& r r r r r r r r' Ø s zShellComplete.__init__©r c C s( t dd| j dd¡t j¡}d| dS )zQThe name of the shell function defined by the completion
|
script.
|
z\W*Ú ú-r Z _completion)ÚreÚsubr ÚreplaceÚASCII)r& Ú safe_namer r r Ú func_nameä s zShellComplete.func_namec C s | j | j| jdS )zVars for formatting :attr:`source_template`.
|
|
By default this provides ``complete_func``, ``complete_var``,
|
and ``prog_name``.
|
)Z complete_funcr r )r> r r ©r& r r r Ú source_varsì s ýzShellComplete.source_varsc C s | j | ¡ S )zÊProduce the shell script that defines the completion
|
function. By default this ``%``-style formats
|
:attr:`source_template` with the dict returned by
|
:meth:`source_vars`.
|
)r5 r@ r? r r r r ø s zShellComplete.sourcec C s t dS )zUse the env vars defined by the shell script to return a
|
tuple of ``args, incomplete``. This must be implemented by
|
subclasses.
|
N©ÚNotImplementedErrorr? r r r Úget_completion_args s z!ShellComplete.get_completion_args)ÚargsÚ
|
incompleter c C s0 t | j| j| j|}t|||\}}| ||¡S )aT Determine 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 r r Ú_resolve_incompleter )r& rD rE ÚctxÚobjr r r Úget_completions s
|
z ShellComplete.get_completions©Úitemr c C s t dS )z°Format a completion item into the form recognized by the
|
shell script. This must be implemented by subclasses.
|
|
:param item: Completion item to format.
|
NrA ©r& rL r r r Úformat_completion s z ShellComplete.format_completionc s4 ¡ \}} ||¡} fdd|D }d |¡S )zÛProduce 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.
|
c s g | ]} |¡qS r )rN )Ú.0rL r? r r Ú
|
<listcomp>& s z*ShellComplete.complete.<locals>.<listcomp>Ú
|
)rC rJ Újoin)r& rD rE Z completionsÚoutr r? r r s zShellComplete.complete)r+ r, r- r. r0 ÚClassVarr2 Ú__annotations__r ÚMutableMappingr1 r' Úpropertyr> ÚDictr@ r ÚTupleÚListrC r rJ rN r r r r r r4 À s(
|
ú þ r4 c sj e Zd ZdZdZeZddddZed fdd Z e
|
j e
|
j e ef dd d
|
Z eed d d Z ZS )Ú BashCompletezShell completion for Bash.ÚbashNr6 c C sz dd l }|jdddg|jd}t d|j ¡ ¡}|d k rj| ¡ \}}|dk s\|dkrv|dk rvtt dn tt d d S )
|
Nr r\ z-czecho "${BASH_VERSION}")Ústdoutz^(\d+)\.(\d+)\.\d+Ú4zCShell completion is not supported for Bash versions older than 4.4.z@Couldn't detect Bash version, shell completion is not supported.)
|
Ú
|
subprocessÚrunÚPIPEr9 Úsearchr] ÚdecodeÚgroupsÚ RuntimeErrorr )r& r_ ÚoutputÚmatchÚmajorÚminorr r r Ú_check_version0 s" ÿ ÿÿÿzBashComplete._check_versionc s | ¡ t ¡ S r% )rj Úsuperr r? ©Ú __class__r r r G s zBashComplete.sourcec C sV t tjd }ttjd }|d|
}z || }W n tk
|
rL d}Y nX ||fS ©NÚ
|
COMP_WORDSÚ
|
COMP_CWORDr r7 ©r ÚosÚenvironÚintÚ
|
IndexError©r& ÚcwordsÚcwordrD rE r r r rC K s
|
z BashComplete.get_completion_argsrK c C s |j d|j S )Nú,)r r rM r r r rN W s z BashComplete.format_completion)r+ r, r- r. r( Ú _SOURCE_BASHr5 rj r2 r r0 rY rZ rC r rN Ú __classcell__r r rl r r[ * s r[ c @ sF e Zd ZdZdZeZejej e
|
e
|
f dddZ e e
|
dddZ d S )
|
Ú ZshCompletezShell completion for Zsh.Úzshr6 c C sV t tjd }ttjd }|d|
}z || }W n tk
|
rL d}Y nX ||fS rn rq rv r r r rC a s
|
z ZshComplete.get_completion_argsrK c C s$ |j d|j d|jr |jnd S )NrQ r )r r r! rM r r r rN m s z ZshComplete.format_completionN)r+ r, r- r. r( Ú _SOURCE_ZSHr5 r0 rY rZ r2 rC r rN r r r r r| [ s
|
r| c @ sF e Zd ZdZdZeZejej e
|
e
|
f dddZ e e
|
dddZ d S )
|
Ú FishCompletezShell completion for Fish.Úfishr6 c C sH t tjd }tjd }|dd
}|r@|r@|d |kr@| ¡ ||fS )Nro rp r éÿÿÿÿ)r rr rs Úpop)r& rw rE rD r r r rC w s
|
z FishComplete.get_completion_argsrK c C s2 |j r |j d|j d|j S |j d|j S )Nry ú )r! r r rM r r r rN s z FishComplete.format_completionN)r+ r, r- r. r( Ú _SOURCE_FISHr5 r0 rY rZ r2 rC r rN r r r r r q s
|
r ÚShellCompleteType)Úbound)r\ r r} Ú_available_shells)Úclsr( r c C s |dkr| j }| t|< | S )am Register 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)r( r )r r( r r r Úadd_completion_class s r )r r c C s
|
t | ¡S )zñLook 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.
|
)r r) )r r r r r ¨ s r )rH Úparamr c C sl t |tsdS |jdk s t| j |j¡}|jdkpj| |j¡tj k pj|jdkojt |t
|
t fojt ||jk S )zìDetermine 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.
|
FNr r ) Ú
|
isinstancer r( ÚAssertionErrorÚparamsr) ÚnargsZget_parameter_sourcer
|
Z COMMANDLINEÚtupleÚlistÚlen)rH r r r r r Ú_is_incomplete_argument² s
|
|
ÿ
|
ÿ úr )rH r r c C s |sdS |d }|| j kS )z5Check if the value looks like the start of an option.Fr )Z _opt_prefixes)rH r Úcr r r Ú_start_of_optionË s r )rH rD r r c C sj t |tsdS |js|jr dS d}tt|D ](\}}|d |jkrH qXt| |r.|}q.|dk oh||jkS )zºDetermine 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 ) r r Zis_flagÚcountÚ enumerateÚreversedr r Úopts)rH rD r Z last_optionÚindexÚargr r r Ú_is_incomplete_optionÔ s
|
|
r )r r r rD r c C sÞ d|d< | j || ¡ f|}|j|j }|rÚ|j}t|trÚ|js| ||¡\}}}|dkr`|S |j |||dd}|j|j }qØ|}|rÄ| ||¡\}}}|dkr¦|S |j |||dddd}|j}q|}|j|j}q(qÚq(|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.
|
TÚresilient_parsingN)Úparentr F)r Zallow_extra_argsÚallow_interspersed_argsr ) Z make_contextÚcopyZprotected_argsrD Úcommandr r ÚchainZresolve_command) r r r rD rH r r( ÚcmdZsub_ctxr r r rF ì s<
|
úrF )rH rD rE r c C s® |dkrd}n,d|kr:t | |r:| d¡\}}}| |¡ d|krVt | |rV| j|fS | j | ¡}|D ] }t| ||rf||f S qf|D ]}t| |r||f S q| j|fS )ah Find 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.
|
ú=r7 z--)r r Úappendr Ú
|
get_paramsr r )rH rD rE r( r r r r r r rG % s
|
|
|
rG )N)1rr r9 Útypingr0 r r Úcorer r r r r r r
|
Úparserr Úutilsr rV r2 r1 rt r r rz r~ r r4 r[ r| r ÚTypeVarÚTyper
r rX rU r3 r r Úboolr r rZ r rF rY ÚUnionrG r r r r Ú<module> sl ú && ,j1ý ÿ þ
|
û : þ
|
