
    ?g                       % S r SSKJr  SSKrSSKJr  SSKrSSKrSSKJr   " S S5      r	\R                  R                  S5      (       a   SSKr\	" 5       rS
\S'   SS jrgSS jrSrg! \ a    \R                  " S	5         N4f = f)a  Allow bash-completion for argparse with argcomplete if installed.

Needs argcomplete>=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<TAB>"
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).
    )annotationsN)glob)Anyc                  0    \ rS rSrSrSSS jjrS	S jrSrg)
FastFilesCompleterJ   zFast file completer class.c                    Xl         g Ndirectories)selfr   s     6/usr/lib/python3/dist-packages/_pytest/_argcomplete.py__init__FastFilesCompleter.__init__M   s    &    c                   [         R                  USS  ;   a:  [        [         R                  R	                  U5      [         R                  -   5      nOSn/ n/ nSU;  aF  SU;  a@  U(       a  US   [         R                  :X  a  UR                  [        US-   5      5        US-  nUR                  [        U5      5        [        U5       H?  n[         R                  R                  U5      (       a  US-  nUR                  XcS  5        MA     U$ )N   r   *?z.*/)
osseplenpathdirnameextendr   sortedisdirappend)r   prefixkwargs
prefix_dir
completionglobbedxs          r   __call__FastFilesCompleter.__call__P   s    66VABZRWW__V4rvv=>JJ
fF!2VBZ2661tFTM23cMFtF|$Aww}}QSan-	 !
 r   r   N)T)r   boolreturnNone)r!   strr"   r   r*   z	list[str])__name__
__module____qualname____firstlineno____doc__r   r'   __static_attributes__ r   r   r   r   J   s    $'r   r   _ARGCOMPLETEr   zFastFilesCompleter | Nonefilescompleterc                .    [         R                  " U SS9  g )NF)always_complete_options)argcompleteautocompleteparsers    r   try_argcompleter<   m   s      Gr   c                    g r
   r3   r:   s    r   r<   r<   r   s    r   )r;   zargparse.ArgumentParserr*   r+   )r1   
__future__r   argparser   r   systypingr   r   environgetargcomplete.completersr8   ImportErrorexitr5   __annotations__r<   r3   r   r   <module>rH      s   >@ #   	 
  8 ::>>.!!% 1C0DN-DH
 N  s   A+ +BB