B/gintSSKrSSKrSSKrSSKJr SSKJrJrJrJ r J r J r J r SSK Jr SSKJrJrJrJr SSKJrJr SSKJr SS KJrJrJrJr \R<\R>\R@\RB\RD\RF\RH1r%S r&"S S \'5r("S S\(5r)g)N)Mapping)CallableDictListOptionalSequenceTextIOUnion)io) BaseCompleterChoicesCompleterFilesCompleterSuppressCompleter)debug mute_stderr) split_line)IntrospectiveArgumentParseraction_is_greedyaction_is_openaction_is_satisfiedc$URU5$N) startswith) completionprefixs 5/usr/lib/python3/dist-packages/argcomplete/finders.pydefault_validatorrs   ((c\rSrSrSrSSSSS\"5S4SjrS\RSSSSS\"54S\ RS\ \ \ 4S \S \\S \\\ S \\S \ S\\ S\SS4SjjrSrSrSrSrSrSr\S5rSrS\\ RS\ R<S\ S\\ 4SjrSr S\\ S\\ 4S jr!S\\ S!\ S"\\"S\\ 4S#jr#S$r$S%r%S&r&g)'CompletionFinder!z Inherit from this class if you wish to override any of the stages below. Otherwise, use ``argcomplete.autocomplete()`` directly (it's a convenience instance of this class). It has the same signature as :meth:`CompletionFinder.__call__()`. NTFcXlX lX0lUc[nX@lXPlSUl0UlX`lUc"[RRS5S:gnXpl g)NF_ARGCOMPLETE_SUPPRESS_SPACE1) _parseralways_complete_optionsexcluder validatorprint_suppressed completing_display_completionsdefault_completerosenvironget append_space)selfargument_parserr'r(r)r*r-r1s r__init__CompletionFinder.__init__(sc' '>$  )I" 046!!2  ::>>*GHCOL(rr3r' exit_method output_streamr(r)r*r1r-returnc URUUUUUUU S9 S[R;agUR5 UcH[RR S5n U b&[ SR U 55 [U S5nUc[R"SS5nUce[RR S S 5n [U 5S :wa [ S R U S 95 U"S 5 [RR S5n U (a/[U 5S :wa [ SR U S 95 U"S 5 [RSn [[RS5n[X5unnnnn[[RS5S - nUUSnU(aGUSURR;a*SU;a$URUR!SS 5S5 [ SR U 5SR U5SR U5SR U5SR U5SU5 UR#UUUU5nU (aUR$R'5VVs0sH"unnUU(aUR)U S5OS_M$ nnnUVs/sH.nU R+UUR U5=(d S45PM0 nn[RR S5S:Xa0UVs/sH#nUSUR$R U53PM% nn[ SU5 UR-U R+U55 UR/5 [0R2R/5 U"S5 g![a [ S5 U"S 5 GN,f=fs snnfs snfs snf) a :param argument_parser: The argument parser to autocomplete on :param always_complete_options: Controls the autocompletion of option strings if an option string opening character (normally ``-``) has not been entered. If ``True`` (default), both short (``-x``) and long (``--x``) option strings will be suggested. If ``False``, no option strings will be suggested. If ``long``, long options and short options with no long variant will be suggested. If ``short``, short options and long options with no short variant will be suggested. :param exit_method: Method used to stop the program after printing completions. Defaults to :meth:`os._exit`. If you want to perform a normal exit that calls exit handlers, use :meth:`sys.exit`. :param exclude: List of strings representing options to be omitted from autocompletion :param validator: Function to filter all completions through before returning (called with two string arguments, completion and prefix; return value is evaluated as a boolean) :param print_suppressed: Whether or not to autocomplete options that have the ``help=argparse.SUPPRESS`` keyword argument set. :param append_space: Whether to append a space to unique matches. The default is ``True``. .. note:: If you are not subclassing CompletionFinder to override its behaviors, use :meth:`argcomplete.autocomplete()` directly. It has the same signature as this method. Produces tab completions for ``argument_parser``. See module docs for more info. Argcomplete only executes actions if their class is known not to have side effects. Custom action classes can be added to argcomplete.safe_actions, if their values are wanted in the ``parsed_args`` completer argument, or their execution is otherwise desirable. )r'r(r)r*r1r- _ARGCOMPLETEN_ARGCOMPLETE_STDOUT_FILENAMEzUsing output file {}wz)Unable to open fd 8 for writing, quittingr _ARGCOMPLETE_IFS z%Invalid value for IFS, quitting [{v}])v_ARGCOMPLETE_DFSz%Invalid value for DFS, quitting [{v}] COMP_LINE COMP_POINTr=z LINE: {!r}z POINT: {!r}z PREQUOTE: {!r}z PREFIX: {!r}z SUFFIX: {!r}z WORDS: _ARGCOMPLETE_SHELLzsh:z Returning completions:)r4r.r/_init_debug_streamr0rformatopenfdopen Exceptionlenintrr& prefix_charsappendsplit_get_completionsr,itemsreplacejoinwriteflush_io debug_stream)r2r3r'r6r7r(r)r*r1r-filenameifsdfs comp_line comp_pointcword_prequote cword_prefix cword_suffix comp_wordslast_wordbreak_posstart completionskeyvaluedisplay_completionscs r__call__CompletionFinder.__call__@syT $;-%/    +  !  zz~~&DEH#,33H=> $Xs 3    " !S 1 (((jjnn/8 s8q= 9@@3@G H Njjnn/0 3s8q= 9@@3@G H NJJ{+ L12 U_`iUvR lJ@RBJJ~./!3' LOt||/H/HHST`M`   l00a8; <  ! !) ,  " ": .  % %n 5  # #L 1  # #L 1   ++J nVhi PTPiPiPoPoPq#Pq*#uU]]3,2=Pq #[ffZeSV388S*=*A*A#*F*L"$MNZeKf ::>>. /5 8NYZkaS$";";"?"?"B!CDkKZ (+6CHH[12  Au ABA \#g[s$ N-)O5O*O-O Oc[R"SS5[l[5 g![a [ R [lN0f=f)zInitialize debug output stream By default, writes to file descriptor 9, or stderr if that fails. This can be overridden by derived classes, for example to avoid clashes with file descriptors being used elsewhere (such as in pytest). r<N)r.rMrZr[rNsysstderrrr2s rrJ#CompletionFinder._init_debug_streams> *!yyC0C   *"zzC  *s -#AAcUR5n[R"5nSUl[ SUSS5 [ 5 UR RUSSUS9nSSS5 [ SW5 SUlS U;aSUl URXVU5n URU 5n URXU5n U $!,(df  Ne=f![a*n[ S[U5[U5S5 SnANSnAff=f) NTzinvoking parser withr ) namespacez parsed args:z exceptionzwhile parsing argsFz--)_patch_argument_parserargparse Namespacer+rrr&parse_known_args BaseExceptiontypestrr'collect_completionsfilter_completionsquote_completions) r2rdrbrareactive_parsers parsed_argsaergs rrT!CompletionFinder._get_completionss446((*  H (*QR. 9LL11*QR.K1X .! $  : +0D (..~LY --k: ,,[J\]  H -a#a&2F G G Hs/CC%C CC D  DD c^^/Ul/UlUmUU4SjmT"UR5 [SUR5 [SUR5 UR$)a Since argparse doesn't support much introspection, we monkey-patch it to replace the parse_known_args method and all actions with hooks that tell us which action was last taken or about to be taken, and let us have the parser figure out which subparsers need to be activated (then recursively monkey-patch those). We save all active ArgumentParsers to extract all their possible option names later. c>TRRU5 TRRU5 [U[5(agSn[ U[UR 405UlURHWn[US5(aM"UU4SjSUR 5nUR Ul URUl X2lMY g)N(MonkeyPatchedIntrospectiveArgumentParser _orig_classc(>\rSrSrSUU4SjjrSrg)PCompletionFinder._patch_argument_parser..patch..IntrospectActionNc0>[SU5 [SXX45 [SUR5 [SUR5 TR(dURXX4S9 g[ UR[ R 5(a4[S5 T"URUS5 URXX4S9 gUR[;a=UR(dTRRU5 URXX4S9 gg)NzAction stub called onz args:z orig class:z orig callable:) option_stringz:orig class is a subparsers action: patching and running itr) rr_orig_callabler+ issubclassrw_SubParsersAction_name_parser_map safe_actionsoption_stringsvisited_positionalsrR)r2parserruvaluesr completerpatchs rrlYCompletionFinder._patch_argument_parser..patch..IntrospectAction.__call__s5t<iFRot/?/?@0$2E2EF(33 //6/g'(8(8(:T:TUU!"^_!$"7"7q "BC //6/g!--=#'#6#6 ) = = D DT J //6/g >rr)__name__ __module__ __qualname____firstlineno__rl__static_attributes__)rrsrIntrospectActionrshhrr) rrRr isinstancerr{ __class___actionshasattrrrlr)r classnameactionrrrs rr6CompletionFinder._patch_argument_parser..patchs  ) ) 0 0 8  $ $ + +F 3&"=>>BI#I0KVM]M]/^`bcF  //6=11hhv'7'7h&&,%5%5"(.%#3 5*rzActive parsers:zVisited positionals:)rrr&r)r2rrs @@rrv'CompletionFinder._patch_argument_parsers]>@:<  % 4N dll !4!45 $d&>&>?"""rc0nURR5H3nURUnURU/5RU5 M5 UR 5H_nX1RUR H=nUR U5(dMUR=(d SURU'M? Ma URR5Vs/sHoR U5(dMUPM n nU $s snf)NrF) choiceskeys setdefaultrR_get_subactionsdestrhelpr,) r2rrbaliases_by_parserrhpraliassubcmdrgs r_get_subparser_completions+CompletionFinder._get_subparser_completionssFH>>&&(Cs#A  ( (B / 6 6s ;),,.F*>>&+++FG##L117={{7HbD--e4H/ -3NN,?,?,Ae,A&EVEVWcEdv,A efs #D D c[U5S:dURSLa4URVs/sHo3RU5(dMUPM sn$URVs/sHn[U5S:dMUPM nnURVs/sHn[U5S::dMUPM nnURS:Xa U(aU$U$URS:Xa U(aU$U$/$s snfs snfs snf)NrTlongshort)rOr'rr)r2rrbopt long_opts short_optss r_include_options!CompletionFinder._include_options,s | q D$@$@D$H#)#8#8Y#8CNN< i):;; @R@R@T@T;;("3"33''77fh&@&@AA"&;&;F&QQ"&"!rclURRU/5HnX!R;dM g gNFT)_action_conflictsr0_seen_non_default_actions)rrconflict_actions rr CompletionFinder._action_allowedLs6 &77;;FBGO"B"BB Hrcv[SR[UR5URS95 U=(a USUR;nSnURVs/sHn[ X5(dMUPM n nU (a0[U 5S:XdS5e[SU SS5 0Ul/nO$U(aS U;aURS 5upznOU$S n U =(d URGHn U R(dG[U 5(aS n U (d.[U 5(a[U 5(d[S U 5 M\[S XR5 [U SS5n U cmU Rb5[U [R 5(d[#U R5n O+[U [R 5(d UR$n U (dM[U [&5(aU R)5(aGM%[+U 5(aU "XunnUR1X5(dMUR3U5 UUR U'M@ OUHtnUR1X5(dMUR3U5 [U ["5(a$U R4=(d SUR U'MeSUR U'Mv Om[S5 [7S5HSnU R9UU5nUc O=UR1UU5(dM3SUR U'UR3U5 MU U(aUVs/sH oS -U-PM nn[SU5 GM U$s snfs snf)NzActive actions (L={l}): {a})lrrrFr zexpect at most 1 greedy actionzResetting completions becausezmust consume the next argumentrDFTSkippingzActivating completion forr)rrrrzICompleter is not callable, trying the readline completer protocol insteadi'z Completions:)rrKrOactive_actionsrQrr, partitionrrrrrrrrwrrr-rrcallablerrUr)rRrrangecomplete)r2rnext_positionalrbrrg isoptionaloptional_prefixxgreedy_actions_complete_remaining_positionals active_actionrcompleter_outputr descriptioninext_completions r_complete_active_option(CompletionFinder._complete_active_optionUsK +22S9N9N5OSYShSh2ij!Ll1o9L9L&L %+%:%:^%:>Nq>]!%:^ ~&!+ M-M M+ 1>!3DFf g(*D %K l"4@3I3I#3N0L#").&+Dv/D/DDM //!-00 6:25*=99.Q^B_B_j-8 -}>W>W X {DAI  ((4Z W_WqWq=r=r 01F1F GI#M83M3MNN $ 6 6Iyi):;; @R@R@T@TI&&'0+&($""2G<<7G7M7M7O3J #~~jGG + 2 2: >HS 9 9* E8P +;J#~~jGG + 2 2: >#-i9I#J#JLYL^L^LdbdD$=$=j$ILND$=$=j$I +;ef"4[*3*<*<\1*M*2!>>/<HHIKD55oF'..? )#Xc"dXc*S#8:#EXcK"dnk2qEr[_V#es"N1:N1 N6rrrbc/n[SU5 USn[SU5 UR(d"[U5S:a&USUR;aX@R XS5- n[SU5 UR 5n[SU5 [ U[R5(aX@RXc5- nURXVX2U5n[SU5 [SUR5 U$) a Visits the active parsers and their actions, executes their completers or introspects them to collect their option strings. Returns the resulting completions as a list of strings. This method is exposed for overriding in subclasses; there is no need to use it directly. zall active parsers:zactive_parser:rzoptional options:znext_positional:zactive options:zdisplay completions:) rr'rOrQr_get_next_positionalrrwrrrr,)r2rrrbrg active_parserrs rr}$CompletionFinder.collect_completionss"$  #^4&r*   .  ' 'C ,=,AlSToYfYsYsFs 77 T TK !;/335  /2 ox'A'A B B ::?Y YK22 L{  - $d&?&?@rcURSnURSnUR5nU(dgX:XaUS$Sn[[ U55H nX4U:XdM O US-[ U5:aX4S-$g)z. Get the next positional action if it exists. rNrr )rr_get_positional_actionsrrO)r2rlast_positionalall_positionalsrs rr%CompletionFinder._get_next_positionals++B/ 2226'??A  +"1% % s?+,A!_4- q53' '"q5) )rrgc/nUH9nURbX0R;aM!X2;dM(URU5 M; U$)z De-duplicates completions and excludes those specified by ``exclude``. Returns the filtered completions as a list. This method is exposed for overriding in subclasses; there is no need to use it directly. )r(rR)r2rgfiltered_completionsrs rr~#CompletionFinder.filter_completionssG "%J||'-5$++J7 & $#rrarec4SnUS:Xa UbUVs/sH oUUS-SPM nnUS- nO US:XaUS- n[RRS5S ;aSnO)US :Xa#SnUVs/sHoURS S 5PM nn[RRS5S :XaS nURS S5nO*Sn[RRS5S:XaUS- n/nUH`nUn UHn U RXU -5n M UR U 5 XR ;dMDUR UUR U 'Mb UR (a0Sn [U5S:XaUSSU ;aUS:Xa US==S- ss'U$s snfs snf)a If the word under the cursor started with a quote (as indicated by a nonempty ``cword_prequote``), escapes occurrences of that quote character in the completions, and adds the quote to the beginning of each completion. Otherwise, escapes all characters that bash splits words on (``COMP_WORDBREAKS``), and removes portions of completions before the first colon if (``COMP_WORDBREAKS``) contains a colon. If there is only one completion, and it doesn't end with a **continuation character** (``/``, ``:``, or ``=``), adds a space after the completion. This method is exposed for overriding in subclasses; there is no need to use it directly. \rFNr z();<>|&!`$* "'"z"`$!rG)tcshfish'z'\'' powershell`rHrIz=/:rrrE)r.r/r0rVrRr,r1rO) r2rgrare special_charsrk escape_charescaped_completionsrescaped_completioncharcontinuation_charss rr"CompletionFinder.quote_completionss  R "-DOPKq!3a!7!9:K P 2 2M s " V #M ::>>. /3C CM s "M>. /< ?K)11#r:MKzz~~23u<$  %J!+ %%7%?%?TXFX%Y"&  & &'9 :666@D@Y@YZd@e))*<= &   "' &'1,1DQ1G1KSe1e!R''*c1*""UQIs F&Fc>US:Xaj[U5up4pVnURS[RS5 UR XdX75nUV s/sHoU [ U5S-PM sn UlU[ UR 5:aUR U$gs sn f)a Alternate entry point for using the argcomplete completer in a readline-based REPL. See also `rlcompleter `_. Usage: .. code-block:: python import argcomplete, argparse, readline parser = argparse.ArgumentParser() ... completer = argcomplete.CompletionFinder(parser) readline.set_completer_delims("") readline.set_completer(completer.rl_complete) readline.parse_and_bind("tab: complete") result = input("prompt> ") rN)rinsertrpargvrTrO _rl_matches) r2textstaterarbrcrdfirst_colon_posmatchesmatchs r rl_completeCompletionFinder.rl_complete3s" A:V`aeVf SN,O   a! -++JnfGOVWweuS->-@'A AwWD  3t''( (##E* * XsBcUR$)zb This function returns a mapping of completions to their help strings for displaying to the user. )r,rrs rget_display_completions(CompletionFinder.get_display_completionsOs(((r) r,r&rrr'r1r+r-r(r*r)r)'rrrr__doc__rr4r._exitrwArgumentParserr boolr|rrr rr rlrJrTrvrrr staticmethodrrrrxr}rr~rPrrr rrrrr!r!!s $(*)659 "*.+/(,!&'++9+;}!00}"'tSy!1} }  ' } (3-( }H%}}tn})} }~ 08#t  "*Rh"8#:#:;JRJ\J\lo c@0$d3i$DI$ @#9@#69@#OWX[}@# c@#D8)rr!c$\rSrSr\S5rSrg)ExclusiveCompletionFinderiVc[RX5(dg[R[R4nUR U;agXR ;aggr)r!rrw _AppendAction_AppendConstActionrr)rrappend_classess rr)ExclusiveCompletionFinder._action_allowedWsO//??"00(2M2MN    / 99 9rrN)rrrrrrrrrrrrVs  rr)*rwr.rpcollections.abcrtypingrrrrrr r rFr rZ completersr rrrrrlexersrpackages._argparserrrr _StoreAction_StoreConstAction_StoreTrueAction_StoreFalseActionrr _CountActionrrobjectr!rrrrr$s  #JJJZZ"rr        )r)vr)j  0 r