&Nj!"SSKrSSKrSSKrSSKrSSKrSSKrSSKJr SSKJ r J r J r J r J r JrJrJr SSKJrJrJrJr SSKJrJr SSKJrJrJrJr SSKJrJ r J!r! SS K"J#r# SS K$J%r%J&r&J'r' \ (aSS K(J)r) SS KJ*r* SS K$J+r+ "SS5r,g)N) import_module) TYPE_CHECKINGAnyDictListOptionalSequenceTupleType) CollectionConfigExecutorFilesystemLoader)completeprint_completion_script)CollectionNotFoundExit ParseErrorUnexpectedExit)ArgumentParser ParserContext)pty_size)debugenable_logginghelpline)Loader) ParseResult)Lexiconc\rSrSr%SrS\S'S\S4SjrS\S4Sjr\\ \S 'S r S \ -r S r S \ -r S rSES\\ S\SS\\ S\\ S\\SS\\SS\\SS\\\ SS4SjjrSFSjrSGS\SS4SjjrSHS \\\ S\SS4S jjrS \\\ SS4S!jrSFS"jrSFS#jrSFS$jrSFS%jrS \\\ SS4S&jr\S\ 4S'j5r\S\ 4S(j5r\S\ 4S)j5r\S\\ 4S*j5r \SIS+j5r!\S\"4S,j5r#SFS-jr$SFS.jr%SFS/jr&SFS0jr'S1\"S2\(\ \)4SS4S3jr*S\+4S4jr,SFS5jr-S\ SS4S6jr.SFS7jr/SFS8jr0SFS9jr1SJS:SS;\\\ S\\2\ \\ 44S<jjr3SFS=jr4SKS>\ S\ 4S?jjr5SKS@\6\2\ \\ 4S>\ SS4SAjjr7SB\6\2\ \\ 4SS4SCjr8SDr9g)LProgram aU Manages top-level CLI invocation, typically via ``setup.py`` entrypoints. Designed for distributing Invoke task collections as standalone programs, but also used internally to implement the ``invoke`` program itself. .. seealso:: :ref:`reusing-as-a-binary` for a tutorial/walkthrough of this functionality. .. versionadded:: 1.0 rcorereturnrc[S[SS9[S[SSS9[SS S 9[S [SS S9[S [SSS9[S[SSS9[SSSS9[SSS 9[SSSS9[S[SSS9[SSSS9[S [S!S"S9[S#[SS$S9[S%[SS&S9[S'[SS(S9[S)[SS*S9[S+[SS,S9/$)-zL Return default core `.Argument` objects, as a list. .. versionadded:: 1.0 )command-timeoutTz7Specify a global command execution timeout, in seconds.)nameskindhelp)rFz:Print tab-completion candidates for given parse remainder.r)r*defaultr+)configfz"Runtime configuration file to use.r)r+)rdzEnable debug output.)dryRz!Echo commands instead of running.)echoez&Echo executed commands before running.)r+hTz$Show core or per-task help and exit.)r)optionalr+)hidez*Set default value of run()'s 'hide' kwarg.)listlz8List available tasks, optionally limited to a namespace.) list-depthDrz3When listing tasks, only show the first INT levels.) list-formatFzbChange the display format used when listing tasks. Should be one of: flat (default), nested, json.flat)r)r+r-)print-completion-scriptzIPrint the tab-completion script for your preferred shell (bash|zsh|fish).)prompt-for-sudo-passwordzCPrompt user at start of session for the sudo.password config value.)ptypz(Use a pty when executing shell commands.)versionVzShow version and exit.) warn-onlywz3Warn, instead of failing, when shell commands fail.) write-pyczEnable creation of .pyc files.)rintboolstrselfs K/home/mande/repo/quber/.venv/lib/python3.13/site-packages/invoke/program.py core_argsProgram.core_args0sm .N  #Q   %9  $+   "8   #=   #;  A  #O  )J   *y  2`   3Z   "?   &-   (J   $5  s_ _ cH[SSS9[S[SSS9[SS S9/$) a% Return default task-related `.Argument` objects, as a list. These are only added to the core args in "task runner" mode (the default for ``invoke`` itself) - they are omitted when the constructor is given a non-empty ``namespace`` argument ("bundled namespace" mode). .. versionadded:: 1.0 ) collectioncz Specify collection name to load.r0) no-dedupeFzDisable task deduplication.r,) search-rootrz4Change root directory used for finding task modules.)rrKrMs rO task_argsProgram.task_argssB )7  $2   *K   rRargv NrE namespacer namebinary loader_classrexecutor_classr config_classr binary_namesc UcSOUUlX lX0lX@lXl/UlU=(d [ UlU=(d [Ul U=(d [Ul g)a Create a new, parameterized `.Program` instance. :param str version: The program's version, e.g. ``"0.1.0"``. Defaults to ``"unknown"``. :param namespace: A `.Collection` to use as this program's subcommands. If ``None`` (the default), the program will behave like ``invoke``, seeking a nearby task namespace with a `.Loader` and exposing arguments such as :option:`--list` and :option:`--collection` for inspecting or selecting specific namespaces. If given a `.Collection` object, will use it as if it had been handed to :option:`--collection`. Will also update the parser to remove references to tasks and task-related options, and display the subcommands in ``--help`` output. The result will be a program that has a static set of subcommands. :param str name: The program's name, as displayed in ``--version`` output. If ``None`` (default), is a capitalized version of the first word in the ``argv`` handed to `.run`. For example, when invoked from a binstub installed as ``foobar``, it will default to ``Foobar``. :param str binary: Descriptive lowercase binary name string used in help text. For example, Invoke's own internal value for this is ``inv[oke]``, denoting that it is installed as both ``inv`` and ``invoke``. As this is purely text intended for help display, it may be in any format you wish, though it should match whatever you've put into your ``setup.py``'s ``console_scripts`` entry. If ``None`` (default), uses the first word in ``argv`` verbatim (as with ``name`` above, except not capitalized). :param binary_names: List of binary name strings, for use in completion scripts. This list ensures that the shell completion scripts generated by :option:`--print-completion-script` instruct the shell to use that completion for all of this program's installed names. For example, Invoke's internal default for this is ``["inv", "invoke"]``. If ``None`` (the default), the first word in ``argv`` (in the invocation of :option:`--print-completion-script`) is used in a single-item list. :param loader_class: The `.Loader` subclass to use when loading task collections. Defaults to `.FilesystemLoader`. :param executor_class: The `.Executor` subclass to use when executing tasks. Defaults to `.Executor`; may also be overridden at runtime by the :ref:`configuration system ` and its ``tasks.executor_class`` setting (anytime that setting is not ``None``). :param config_class: The `.Config` subclass to use for the base config object. Defaults to `.Config`. .. versionchanged:: 1.2 Added the ``binary_names`` argument. Nunknown) rEr`_name_binary _binary_namesr[rrcrrdrre) rNrEr`rarbrcrdrerfs rO__init__Program.__init__sXj%,Oy "  ) (<,<,8(2FrRc.UR5Ulg)ak Instantiate a `.Config` (or subclass, depending) for use in task exec. This Config is fully usable but will lack runtime-derived data like project & runtime config files, CLI arg overrides, etc. That data is added later in `update_config`. See `.Config` docstring for lifecycle details. :returns: ``None``; sets ``self.config`` instead. .. versionadded:: 1.0 N)rer.rMs rO create_configProgram.create_configs'') rRmergec0nURSR(aSUS'URRR(aSUS'URRR(a#URRRUS'URRR(aSUS'URR R(aSUS'0nSUR;a#URSR(aS US '0nURS RnU(aXTS '0nURS R(aSn[ R "U5US'[X#XdS9nURRUS S9 URRRn U c [RRSS5n URRU 5 URRS S9 U(aURR5 gg)a3 Update the previously instantiated `.Config` with parsed data. For example, this is how ``--echo`` is able to override the default config value for ``run.echo``. :param bool merge: Whether to merge at the end, or defer. Primarily useful for subclassers. Default: ``True``. .. versionadded:: 1.0 rGTwarnrCr8r4r2rVFdeduper'commandrBz&Desired 'sudo.password' config value: password)runtaskssudotimeouts)rqNINVOKE_RUNTIME_CONFIG)argsvaluerCr8r4r2getpassdictr.load_overridesosenvirongetset_runtime_path load_runtimerq) rNrqrwrxrzruryprompt overrides runtime_paths rO update_configProgram.update_config.s& 99[ ! ' 'CK 99==  CJ 99>>  ))....CK 99>>  CK 99==  CJ $)) # +(>(D(D#E(O))-.44 ")Y  99/ 0 6 6=F&v6D SDL  ""9E":yy''--  ::>>*A4HL $$\2   u -  KK    rRexitcDUR5 URU5 UR5 UR5 UR 5 UR 5 UR 5 g![[[4Gatn[SRU55 [U[5(a[U[RS9 [U[5(a3UR (a"[UR [RS9 [U[5(a4UR"R$(a[U[RSS9 U(a[U[5(aUR"R&nO9[U[5(a UR(nO[U[5(aSn[R*"W5 SnAg[S5 SnAgSnAf[,a [R*"S5 gf=f)aP Execute main CLI logic, based on ``argv``. :param argv: The arguments to execute against. May be ``None``, a list of strings, or a string. See `.normalize_argv` for details. :param bool exit: When ``False`` (default: ``True``), will ignore `.ParseError`, `.Exit` and `.Failure` exceptions, which otherwise trigger calls to `sys.exit`. .. note:: This is mostly a concession to testing. If you're setting this to ``False`` in a production setting, you should probably be using `.Executor` and friends directly instead! .. versionadded:: 1.0 z-Received a possibly-skippable exception: {!r})filerA)rendr z3Invoked as run(..., exit=False), ignoring exceptionN)ro parse_coreparse_collection parse_tasks parse_cleanuprexecuterrrrformat isinstanceprintsysstderrmessageresultr8exitedcoderKeyboardInterrupt)rNr[rr5rs rOrw Program.runcsf(/     OOD !  ! ! #             LLNj1 M AHHK L!Z((acjj)!T""qyyaiicjj1!^,,acjjb1a0088??D4((66D:..DKLL   HHQK s%A1A44H EG9) G99#HHcf[SRU55 URU5 UR5 [S5 URSR (+[ lURRR (a [5 URRR (a![S5 UR5 [eURSR (a1[URSR URS9 [eg)Nzargv given to Program.run: {!r}zFinished parsing core argsrIz)Saw --version, printing version & exitingr@)shellr))rrnormalize_argvparse_core_argsr|r}rdont_write_bytecoderrE print_versionrrrfrNr[s rOrProgram.parse_cores /66t<= D!  *+'+ii &<&B&B"B 99??   99   " " = >    J 99. / 5 5 #ii 9:@@'' J 6rRcbURb[S5 URUlO_[S5 URRR SLa![S5 UR 5 [eUR5 SUl SUl SUl URUl g)zH Load a tasks collection & project-level config. .. versionadded:: 1.0 Nz;Program was given default namespace, not loading collectionz;No default namespace provided, trying to load one from diskTz8No bundled namespace & bare --help given; printing help.r?) r`rrTr|r+r} print_helprload_collection list_root list_depth list_formatscoped_collectionrMs rOrProgram.parse_collections >> % M #nnDO M  yy~~##t+N!  ")-)-!!%rRcXURRRnUSLa![S5 UR 5 [ eU(aWXR R;a$Sn[U5 URU5 [ e[SRU55eURRRnURSRUl URSRUl U(aS[U[5(a(X0lUR"R%U5nX@lUR+5 [ eURR,R(aC[-UR.UR0UR2UR"UR55S9 UR6(d-UR"R8(dUR;5 g g g ![(a Sn[ URU55ef=f) zW Post-parsing, pre-execution steps such as --help, --list, etc. .. versionadded:: 1.0 Tz(Saw bare --help, printing help & exitingz7Saw --help , printing per-task help & exitingzNo idea what '{}' is!r=r;zSub-collection '{}' not found!)r)r$initial_contextrTparserN)r|r+r}rrrrcontextsprint_task_helprrr9rrrrLrrTsubcollection_from_pathrKeyError list_tasksrrfr$r _make_parserrxr-no_tasks_given)rNhalpmsgrsubs rOrProgram.parse_cleanups yy~~## 4< < = OO J {{+++Oc $$T* !!8!?!?!EFFIINN(( 99]399))L177 )S))!*6//AA)LC-0* OO J 99   # # ''YY $ 4 4??((* zz$//"9"9    !#:z- 6:Cszz)4556s $!H'H)cD[S5 UR5 [e)NzVNo tasks specified for execution and no default task; printing global help as fallback)rrrrMs rOrProgram.no_tasks_given(s d   rRc8URnURRRnUb*URS5up4n[ U5n[ Xe5nU"UR URUR5nUR"UR6 g)a~ Hand off data & tasks-to-execute specification to an `.Executor`. .. note:: Client code just wanting a different `.Executor` subclass can just set ``executor_class`` in `.__init__`, or override ``tasks.executor_class`` anywhere in the :ref:`config system ` (which may allow you to avoid using a custom Program entirely). .. versionadded:: 1.0 N.) rdr.rx rpartitionrgetattrrTr$r)rNklass config_path module_path_ class_namemoduleexecutors rOrProgram.execute/s##kk''66  ")4)?)?)D &KJ#;/FF/E$++tyyA$**%rRcUc+[Rn[SRU55 O?[ U[ 5(a*UR 5n[SRU55 Xlg)aa Massages ``argv`` into a useful list of strings. **If None** (the default), uses `sys.argv`. **If a non-string iterable**, uses that in place of `sys.argv`. **If a string**, performs a `str.split` and then executes with the result. (This is mostly a convenience; when in doubt, use a list.) Sets ``self.argv`` to the result. .. versionadded:: 1.0 Nz#argv was None; using sys.argv: {!r}z%argv was string-like; splitting: {!r})rr[rrrrLsplitrs rOrProgram.normalize_argvIsW <88D 7>>tD E c " "::> ! NN$ $D$''rRct[SRURUR=(d S55 g)N{} {}rh)rrrarErMs rOrProgram.print_versions" gnnTYY (A BCrRc@SnURbSn[SRURU55 [S5 [S5 [S5 UR UR R 55 URbUR5 gg)Nz-task1 [--task1-opts] ... taskN [--taskN-opts]z$ [--subcommand-opts] ...zUsage: {} [--core-opts] {}rAz Core options:)r`rrrb print_columnsr help_tuplesr)rN usage_suffixs rOrProgram.print_helps|F >> %AL *11$++|LM b  o b  4//;;=> >> % OO  &rRc[S5 [URSS9nURURSS5UlSn[UR UR UR R55 g)z Filter out core args, leaving any tasks or their args for later. Sets ``self.core`` to the `.ParseResult` from this step. .. versionadded:: 1.0 z#Parsing initial context (core args)T)initialignore_unknownr Nz-Core-args parse result: {!r} & unparsed: {!r})rrr parse_argvr[r$runparsed)rNrrs rOrProgram.parse_core_argssa 34 4 4TJ%%diim4 = cjjDII$6$678rRcURSRnURURUS9nURRRnUR U5upEURR U5 URR5 [R"UUURRRS9Ulg![a)n[SRUR55eSnAff=f)zY Load a task collection based on parsed core args, or die trying. .. versionadded:: 1.0 rW)r.start) loaded_fromauto_dash_namesz%Can't find any collection named {!r}!N)r|r}rcr.rTloadset_project_location load_projectr from_modulerxrrrrra)rNrloader coll_namerparentr5s rOrProgram.load_collections -(.."";;e# II((..  O#[[3NF KK , ,V 4 KK $ $ &(44" $ 1 1 A ADO " O>EEaffMN N OsBC D !$DD contextnew_argscUR5H6up4UR(dMURURUlM8 gN)items got_value_valuer|)rNrrkeyargs rO_update_core_contextProgram._update_core_contexts5!(HC}}}+.:: S!()rRc[URURRURR R S9S9$)N)ignore_unknown_help)rr)rrrT to_contextsr.rxrrMs rOrProgram._make_parsersB((__00$(KK$5$5$I$I1  rRcUR5Ul[SRUR55 URR UR R5nURS5Ul URUR SURRS9 Xl [SRUR55 g)a Parse leftover args, which are typically tasks & per-task args. Sets ``self.parser`` to the parser used, ``self.tasks`` to the parsed per-task contexts, and ``self.core_via_tasks`` to a context holding any core flags seen within the task contexts. Also modifies ``self.core`` to include the data from ``core_via_tasks`` (so that it correctly reflects any supplied core flags regardless of where they appeared). .. versionadded:: 1.0 zParsing tasks against {!r}r)rrzResulting task contexts: {!r}N) rrrrrTrr$rpopcore_via_tasksrr|rx)rNrs rOrProgram.parse_taskss'')  *11$//BC'' (:(:;$jjm !!IIaL4+>+>+C+C "   -44TZZ@ArRcURRUnUR5n[R"UR U5nSnU(aSOSn[ URURX55 [ S5 [ S5 U(a]UR5H=nUR5(a[ URU-5 M2[ S5 M? [ S5 O#[ URS-5 [ S5 [ S5 U(aURU5 g[ URS-5 [ S5 g)zX Print help for a specific task, e.g. ``inv --help ``. .. versionadded:: 1.0 z3Usage: {} [--core-opts] {} {}[other tasks here ...]z [--options] rAz Docstring:nonezOptions:N) rrrinspectgetdocrTrrrb splitlinesstripleading_indentr)rNractxtuples docstringheaderoptslines rOrProgram.print_task_helpskk""4("NN4??4#89 F!'~R fmmDKK45 b  l !,,.::<<$--45"I / "I $%%. / "I j    v & $%%. / "IrRcURnU(d&Sn[URUR55e[ USRUR 55"5 g)Nz"No tasks found in collection '{}'!zlist_{})rrrrarr)rNfocusrs rOrProgram.list_tasks'sM&&6Cszz%**-. . i&&t'7'789;rRcXURUR5nURUS9 g)N)pairs _make_pairsrdisplay_with_columns)rNrs rO list_flatProgram.list_flat1s)  !7!78 !!!.rRc\URUR5nSnURXS9 g)Nz'*' denotes collection defaults)rextrar)rNrr$s rO list_nestedProgram.list_nested5s.  !7!781 !!!;rRcoll ancestorsc Uc/n/n[U5UR-nSRSU55n[URR 55GH`upgXaR :HnUn [[UR[UR555n U(dUR(a2SRU 5n U V s/sHn SRU 5PM n n URS:XaUn U(aU S- n URS:XaSUn U (aUR(aSU -n U V s/sHoU -PM n n U(aU(aU RSU 5 U (a SRS RU 55OS nW U -U-nURU[!U545 GMc UR"=(a [U5S -UR":n[UR$R 55GH6unnUn U(dUR(aSRU 5n U(akS Vs/sH;n['UU5(dMS R[['UU55U5PM= nnU SRS RU55- n URS:XaURXI-[!U545 O5URS:Xa%U(aURXY-[!U545 U(aGMUR)UX&/-S9nUR+U5 GM9 U$s sn fs sn fs snf)Nrc3$# UHov M g7fr.0xs rO &Program._make_pairs..Cs 6IqIs.{}nested*r?rz ({})z, rAr )rx collectionsrz [{}])r'r()lenindentjoinsortedrxrr-r9map transformaliasesrrrinsertappendrrr4rrextend)rNr'r(rr6 ancestor_pathratask is_default displaynamer;r.prefixalias alias_strfulltruncatesubcollattrtalliesrecursed_pairss rOrProgram._make_pairs:s  IY$++- 6I 66  !1!1!34JD-JK3t~~vdll/CDEGDNN#ll;7 4;?weE>w?)NN1f->Etyy'9:2IK')3D LL$/ 0A5D??NI(:t'N#D$4$4$:$:$<=MD'KDNN#ll;7 !9 8w-FGNN3ww'=#>E 8 w~~dii.@AA 8+ f2HW4EFG!!V+ m98G;LMN8!%!1!1 I,>"2" ^,+>, ]=@sM>MM')McUR(a [S5eURnUR5n[ [ R "U55 g)Nz:The --list-depth option is not supported with JSON format!)rrr serializedrjsondumps)rNr'datas rO list_jsonProgram.list_jsonsE ??L  %%  djjrRr$cFURnURnU(aSRU5OSnSnU(dU(a>U(aSRU5OSnU(a U(aSOSnSRXgU5nSRXE5nURbSnU$)N '{}'rAzdepth={}z; z ({}{}{})zAvailable{} tasks{} Subcommands)rrrr`) rNr$rootdepth specifiertaildepthstrjoinertexts rOtask_list_openerProgram.task_list_openers~~,0GNN4(b  E38z((/bH#TBF%%h>D$++I< >> % D rRrcRURn[SRURUS955 UR U5 UR R nU(aFSnU(a"SRU5nSRU5n[SRXT55 gg)Nz{}: )r$rArUr1zDefault{} task: {} )rrrr^rrr-)rNrr$rWr-specifics rOr Program.display_with_columnss~~ gnnT222?@A 5!((00 H">>$/,,w/ (//B C rRrc,[SU55n[5SU- UR- UR- S- n[R "US9nUHupVUcSnUR U5nU[U5- nSRURUUS-URS-45n U(a8[XS-5 USSHn [S[U 5-U -5 M M[U R55 M [S5 g)z Print tabbed columns from (name, help) ``tuples``. Useful for listing tasks + docstrings, flags + help strings, etc. .. versionadded:: 1.0 c3># UHn[US5v M g7f)rN)r5r,s rOr/(Program.print_columns..s3FqQqTFsrr )widthNrAr]) maxrleading_indent_width col_paddingtextwrap TextWrapperwrapr5r7rrrstrip) rNr name_width desc_widthwrapperrahelp_str help_chunks name_paddingspecchunks rOrProgram.print_columnss3F33 JqM '' (    &&Z8$ND!,,x0K%D 1L77'' 3&$$s* Dd^+,(_E3T?e34-dkkm$+%, b rR)rjrkrir[rTr.rer$r rdrrrrcr`rrrxrE)NNNNNNNN)r%N)T)NT)r%r r)rA):__name__ __module__ __qualname____firstlineno____doc____annotations__rrPrYrLrhr indent_widthr6rirr rlrorKrrwrrrrrrpropertyrarrbrfr|rrrrrrrrrrrrrrr!r%r rrRr^r r r__static_attributes__r+rRrOr"r" s  f 4 +f P 4 + : s)O//NL < FK"&,0" $155915,0_3#_3L)_3sm _3  _3 tH~. _3!j!12_3tH~._3tCy)_3 _3B *3 43 43 jCc+C$C$CJxS 2t< 1H<"|&48DI#64.6c66 C3 C C...6d3i66!! ( ( (D  9O: 6$ 604S#X 6  6 f B0CDB</<*.CCDI&C eC#&' ( CJ c3"HJDeC#$678DADD D"+uS(3-%789+ +rRr")-r~r rOrrrj importlibrtypingrrrrrr r r rAr rrrcompletion.completerr exceptionsrrrrrrrr terminalsrutilrrrrrrr r"r+rRrOrsa #   =<BLL3311#{{rR