|=0.5.6 for python 3.2/3.3 (older versions fail
to find the magic string, so _ARGCOMPLETE env. var is never set, and
this does not need special code).
Function try_argcomplete(parser) should be called directly before
the call to ArgumentParser.parse_args().
The filescompleter is what you normally would use on the positional
arguments specification, in order to get "dirname/" after "dirn"
instead of the default "dirname ":
optparser.add_argument(Config._file_or_dir, nargs='*').completer=filescompleter
Other, application specific, completers should go in the file
doing the add_argument calls as they need to be specified as .completer
attributes as well. (If argcomplete is not installed, the function the
attribute points to will not be used).
SPEEDUP
=======
The generic argcomplete script for bash-completion
(/etc/bash_completion.d/python-argcomplete.sh)
uses a python program to determine startup script generated by pip.
You can speed up completion somewhat by changing this script to include
# PYTHON_ARGCOMPLETE_OK
so the python-argcomplete-check-easy-install-script does not
need to be called to find the entry point of the code and see if that is
marked with PYTHON_ARGCOMPLETE_OK.
INSTALL/DEBUGGING
=================
To include this support in another application that has setup.py generated
scripts:
- Add the line:
# PYTHON_ARGCOMPLETE_OK
near the top of the main python entry point.
- Include in the file calling parse_args():
from _argcomplete import try_argcomplete, filescompleter
Call try_argcomplete just before parse_args(), and optionally add
filescompleter to the positional arguments' add_argument().
If things do not work right away:
- Switch on argcomplete debugging with (also helpful when doing custom
completers):
export _ARC_DEBUG=1
- Run:
python-argcomplete-check-easy-install-script $(which appname)
echo $?
will echo 0 if the magic line has been found, 1 if not.
- Sometimes it helps to find early on errors using:
_ARGCOMPLETE=1 _ARC_DEBUG=1 appname
which should throw a KeyError: 'COMPLINE' (which is properly set by the
global argcomplete script).
N)glob)Any)List)Optionalc D e Zd ZdZd
deddfdZdededee fd Z dS ) FastFilesCompleterzFast file completer class.T directoriesreturnNc || _ d S N)r )selfr s f/builddir/build/BUILD/cloudlinux-venv-1.0.12/venv/lib/python3.11/site-packages/_pytest/_argcomplete.py__init__zFastFilesCompleter.__init__L s & prefixkwargsc 0 t j |dd v r:t t j | t j z }nd}g }g }d|vrFd|vrB|r|d t j k r%| t
|dz |dz
}| t
| t | D ]C}t j | r|dz
}| ||d D|S )N r *?z.*/)
osseplenpathdirnameextendr sortedisdirappend)r
r r
prefix_dir
completionglobbedxs r __call__zFastFilesCompleter.__call__O s
6VABBZ RW__V 4 4rv =>>JJJ
f F!2!2
4VBZ26 1 1tFTM 2 2333 cMFtF||$$$ . .Aw}}Q
S a
n - - - -r )T)
__name__
__module__ __qualname____doc__boolr strr r r& r r r r I sn $$' 'D 'D ' ' ' 's c d3i r r _ARGCOMPLETEr filescompleterparserr
c 2 t j | d d S )NF)always_complete_options) argcomplete autocompleter0 s r try_argcompleter6 l s GGGGGGr c d S r r- r5 s r r6 r6 q s r )r* argparser sysr typingr r r r environgetargcomplete.completersr3 ImportErrorexitr/ __annotations__ArgumentParserr6 r- r r rB s > > >~
8 :>>.!! %%%%% 3E3E3G3GNH /0GGGH 7 HD H H H H H H
7
D
NNNs A A-,A-