zj!ddlZddlZddlZddlZddlZddlZddlmZddlm Z m Z m Z m Z m Z mZmZmZddlmZmZmZmZddlmZmZddlmZmZmZmZddlmZm Z m!Z!dd l"m#Z#dd l$m%Z%m&Z&m'Z'e rdd l(m)Z)dd lm*Z*dd l$m+Z+GddZ,y)N) import_module) TYPE_CHECKINGAnyDictListOptionalSequenceTupleType) CollectionConfigExecutorFilesystemLoader)completeprint_completion_script)CollectionNotFoundExit ParseErrorUnexpectedExit)ArgumentParser ParserContext)pty_size)debugenable_logginghelpline)Loader) ParseResult)Lexiconc2eZdZUdZded<dedfdZdedfdZeeed<d Z d e zZ d Z d e zZ d Z dCdeededdeedeedeeddeeddeeddeeedd fdZdDdZdEdedd fdZdFdeeededd fdZdeeedd fd ZdDd!ZdDd"ZdDd#ZdDd$Zdeeedd fd%Zedefd&Zedefd'Zedefd(Zedeefd)ZedGd*Z ede!fd+Z"dDd,Z#dDd-Z$dDd.Z%dDd/Z&d0e!d1e'ee(fdd fd2Z)de*fd3Z+dDd4Z,dedd fd5Z-dDd6Z.dDd7Z/dDd8Z0 dHd9dd:eeedee1eeeffd;Z2dDd<Z3dId=edefd>Z4 dId?e5e1eeefd=edd fd@Z6dAe5e1eeefdd fdBZ7y )JProgramau 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 rcorereturnrc2tdtdtdtddtdd td tdd td tddtdtddtdddtdd tdddtdtddtdddtd td!d"td#tdd$td%tdd&td'tdd(td)tdd*td+tdd,gS)-zd 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 O/var/www/api.ozpay.ru/ozpay/venv/lib/python3.12/site-packages/invoke/program.py core_argszProgram.core_args0sm .N  #Q   %9  $+   "8   #=   #;  A  #O  )J   *y  2`   3Z   "?   &-   (J   $5  s_ _ cZtddtdtddtdd gS) aU 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.r/) no-dedupeFzDisable task deduplication.r+) search-rootrz4Change root directory used for finding task modules.)rrJrLs rN task_argszProgram.task_argssB )7  $2   *K   rPargv NrD namespacer namebinary loader_classrexecutor_classr config_classr binary_namesc |dn||_||_||_||_||_g|_|xst |_|xst|_ |xst|_ y)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) rDr]_name_binary _binary_namesrXrr`rrarrb) rMrDr]r^r_r`rarbrcs rN__init__zProgram.__init__s`j%,Oy "  ) (<,<,8(2FrPc.|j|_y)a 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)rbr-rLs rN create_configzProgram.create_configs'') rPmergec6i}|jdjrd|d<|jjjrd|d<|jjjr#|jjj|d<|jjjrd|d<|jj jrd|d<i}d|jvr|jdjrd |d <i}|jd j}|r||d <i}|jd jrd}t j ||d<t||||}|jj|d |jjj} | tjjdd} |jj| |jjd |r|jjyy)as 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 rFTwarnrBr7r3r1rTFdeduper&commandrAz&Desired 'sudo.password' config value: password)runtaskssudotimeouts)rlNINVOKE_RUNTIME_CONFIG)argsvaluerBr7r3r1getpassdictr-load_overridesosenvirongetset_runtime_path load_runtimerl) rMrlrrrsrurprtprompt overrides runtime_paths rN update_configzProgram.update_config.s& 99[ ! ' 'CK 99==  CJ 99>>  ))....CK 99>>  CK 99==  CJ $)) # +(>(D(D#E(O))-.44 ")HY  99/ 0 6 6=F&v6D SD8L  ""9E":yy''--  ::>>*A4HL $$\2   u -  KK    rPexitc |j|j||j|j|j |j |j y#tttf$rP}tdj|t|trt|tjt|tr1|j r%t|j tjt|tr2|j"j$rt|tjd|rlt|tr|j"j&}n/t|tr |j(}nt|trd}tj*ntdYd}~yYd}~yd}~wt,$rtj*dYywxYw)a 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})filer@)rendr z3Invoked as run(..., exit=False), ignoring exceptionN)rk parse_coreparse_collection parse_tasks parse_cleanuprexecuterrrrformat isinstanceprintsysstderrmessageresultr7exitedcoderKeyboardInterrupt)rMrXrr4rs rNrrz Program.runcsY(/     OOD !  ! ! #             LLNj1 M AHHK L!Z(acjj)!T"qyyaiicjj1!^,acjjb1a088??D4(66D:.DKLL!  HHQK sA1A44G8 EG!G87G8cFtdj||j||jtd|jdj t _|jjj r t|jjj r!td|jt|jdj r4t|jdj |jty)Nzargv given to Program.run: {!r}zFinished parsing core argsrHz)Saw --version, printing version & exitingr?)shellr()rrnormalize_argvparse_core_argsrwrxrdont_write_bytecoderrD print_versionrrrcrMrXs rNrzProgram.parse_cores /66t<= D!  *+'+ii &<&B&B"B 99??   99   " " = >    J 99. / 5 5 #ii 9:@@'' J 6rPc^|jtd|j|_n^td|jjj dur!td|j t|jd|_ d|_ d|_ |j|_ y)z` 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]rrRrwr*rx print_helprload_collection list_root list_depth list_formatscoped_collectionrLs rNrzProgram.parse_collections >> % M #nnDO M  yy~~##t+N!  ")-)-!!%rPc |jjj}|dur!td|j t |rV||j jvr$d}t||j|t tdj||jjj}|jdj|_ |jdj|_ |rPt|tr*||_ |j"j%|}||_|j+t |jj,jrFt-|j.|j0|j2|j"|j5|j6s(|j"j8s|j;y y y #t($rd}t |j|wxYw) zo 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_contextrRparserN)rwr*rxrrrrcontextsprint_task_helprrr8rrrrKrrRsubcollection_from_pathrKeyError list_tasksrrcr#r _make_parserrsr,no_tasks_given)rMhalpmsgrsubs rNrzProgram.parse_cleanups yy~~## 4< < = OO J t{{+++Oc $$T* !!8!?!?!EFFIINN(( 99]399))L177 )S)!*6//AA)LC-0D* OO J 99   # # ''YY $ 4 4??((* zz$//"9"9    !#:z- 6:Cszz)4556s "G''&H cDtd|jt)NzVNo tasks specified for execution and no default task; printing global help as fallback)rrrrLs rNrzProgram.no_tasks_given(s d   rPc:|j}|jjj}|,|jd\}}}t |}t ||}||j |j|j}|j|jy)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.) rar-rs rpartitionrgetattrrRr#r)rMklass config_path module_path_ class_namemoduleexecutors rNrzProgram.execute/s##kk''66  ")4)?)?)D &KJ#;/FFJ/E$++tyyA$**%rPc|2tj}tdj|||_yt |t r*|j }tdj|||_y)a 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})rrXrrrrKsplitrs rNrzProgram.normalize_argvIsa <88D 7>>tD E c "::> ! DNN$ $D$''rPcjtdj|j|jxsdy)N{} {}re)rrr^rDrLs rNrzProgram.print_versions" gnnTYY (A BCrPc<d}|jd}tdj|j|tdtdtd|j |j j |j|jyy)Nz-task1 [--task1-opts] ... taskN [--taskN-opts]z$ [--subcommand-opts] ...zUsage: {} [--core-opts] {}r@z Core options:)r]rrr_ print_columnsr help_tuplesr)rM usage_suffixs rNrzProgram.print_helps|F >> %AL *11$++|LM b  o b  4//;;=> >> % OO  &rPctdt|jd}|j|jdd|_d}t|j |j |j jy)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_argvrXr#runparsed)rMrrs rNrzProgram.parse_core_argssa 34 4 4TJ%%diim4 = cjjDII$6$678rPc$|jdj}|j|j|}|jjj} |j |\}}|jj ||jjtj|||jjj|_y#t$r)}tdj|jd}~wwxYw)zq Load a task collection based on parsed core args, or die trying. .. versionadded:: 1.0 rU)r-start) loaded_fromauto_dash_namesz%Can't find any collection named {!r}!N)rwrxr`r-rRloadset_project_location load_projectr from_modulersrrrrr^)rMrloader coll_namerparentr4s rNrzProgram.load_collections -(.."";;e# II((..  O#[[3NFF KK , ,V 4 KK $ $ &(44" $ 1 1 A ADO " O>EEaffMN N OsBC D&$D  Dcontextnew_argsc|jD]0\}}|js|j|j|_2yN)items got_value_valuerw)rMrrkeyargs rN_update_core_contextzProgram._update_core_contexts:!( 6HC}}+.:: S!( 6rPct|j|jj|jj j S)N)ignore_unknown_help)rr)rrrR to_contextsr-rsrrLs rNrzProgram._make_parsersB((__00$(KK$5$5$I$I1  rPc|j|_tdj|j|jj |j j}|jd|_ |j|j d|jj||_ tdj|jy)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) rrrrrRrr#rpopcore_via_tasksrrwrs)rMrs rNrzProgram.parse_taskss'')  *11$//BC'' (:(:;$jjm !!IIaL4+>+>+C+C "   -44TZZ@ArPc|jj|}|j}tj|j |}d}|rdnd}t |j|j||t dt d|rU|jD]6}|jrt |j|z,t d8t dn#t |jdzt dt d|r|j|yt |jdzt dy)zp Print help for a specific task, e.g. ``inv --help ``. .. versionadded:: 1.0 z3Usage: {} [--core-opts] {} {}[other tasks here ...]z [--options] r@z Docstring:nonezOptions:N) rrrinspectgetdocrRrrr_ splitlinesstripleading_indentr)rMr^ctxtuples docstringheaderoptslines rNrzProgram.print_task_helpskk""4("NN4??4#89 F!'~R fmmDKKt45 b  l !,,. ::<$--45"I   "I $%%. / "I j    v & $%%. / "IrPc|j}|s&d}t|j|jt |dj|j y)Nz"No tasks found in collection '{}'!zlist_{})rrrr^rr)rMfocusrs rNrzProgram.list_tasks'sO&&6Cszz%**-. . :i&&t'7'789;rPc^|j|j}|j|y)N)pairs _make_pairsrdisplay_with_columns)rMrs rN list_flatzProgram.list_flat1s)  !7!78 !!!.rPcd|j|j}d}|j||y)Nz'*' denotes collection defaults)rextrar)rMrrs rN list_nestedzProgram.list_nested5s0  !7!781 !!U!;rPcoll ancestorsc  |g}g}t||jz}djd|D}t|jj D]2\}}||j k(}|} tt|jt|j} |s |jr/dj| } | D cgc]} dj| } } |jdk(r |} |r| dz } |jdk(r=|} | r|jrd| z} | D cgc]} | | z } } |r|r| jd| | r djd j| nd } | z|z}|j|t!|f5|j"xrt|d z|j"k\}t|j$j D]\}}|} |s |jrdj| } |rad Dcgc]3}t'||r%d jtt'|||5}}| djd j|z } |jdk(r |j|| zt!|fn0|jdk(r!|r|j|| zt!|f|r|j)|||gz}|j+||Scc} wcc} wcc}w)Nrc3 K|]}|ywr.0xs rN z&Program._make_pairs..Cs 6q 6s .{}nested*r>rz ({})z, r@r )rs collectionsrz [{}])r r )lenindentjoinsortedrsrr,r8map transformaliasesrrrinsertappendrrrrrextend)rMr r rr ancestor_pathr^task is_default displaynamerrprefixalias alias_strfulltruncatesubcollattrtalliesrecursed_pairss rNrzProgram._make_pairs:s  IY$++- 6I 66  !1!1!34 1JD$-JK3t~~vdll/CDEGDNN#ll;7 4;?e6E>??)NN1f->Etyy'9:2IK')3D LL$/ 0A 1D??NI(:t'N#D$4$4$:$:$<= -MD'KDNN#ll;7 !9w-NN3ww'=#>E w~~dii.@AA 8+ f{2HW4EFG!!V+ mk98G;LMN!%!1!1 I,>"2" ^,+ -, ]=@sK6! K; 8Lc|jr td|j}|j}t t j |y)Nz:The --list-depth option is not supported with JSON format!)rrr serializedrjsondumps)rMr datas rN list_jsonzProgram.list_jsonsE ??L  %%  djjrPrc |j}|j}|rdj|nd}d}|s|r0|rdj|nd}|r|rdnd}dj|||}dj||}|jd}|S)N '{}'r@zdepth={}z; z ({}{}{})zAvailable{} tasks{} Subcommands)rrrr]) rMrrootdepth specifiertaildepthstrjoinertexts rNtask_list_openerzProgram.task_list_openers~~,0GNN4(b  E38z((/bH#TBF%%h>D$++It< >> % D rPrcF|j}tdj|j||j ||j j }|rBd}|r"dj|}dj|}tdj||yy)Nz{}: )rr@r4rzDefault{} task: {} )rrrr=rrr,)rMrrr6r,specifics rNrzProgram.display_with_columnss~~ gnnT222?@A 5!((00 H">>$/,,w/ (//'B C rPrctd|D}td|z |jz |jz dz }t j |}|D]\}}|d}|j |}|t|z }dj|j||dz|jdzf} |r6t| |dz|ddD]} tdt| z| zt| jtdy)z Print tabbed columns from (name, help) ``tuples``. Useful for listing tasks + docstrings, flags + help strings, etc. .. versionadded:: 1.0 c38K|]}t|dyw)rN)rrs rNrz(Program.print_columns..s3qQqT3srr )widthNr@rZ) maxrleading_indent_width col_paddingtextwrap TextWrapperwraprrrrrstrip) rMr name_width desc_widthwrapperr^help_str help_chunks name_paddingspecchunks rNrzProgram.print_columnss,3F33 JqM '' (    &&Z8$ %ND(!,,x0K%D 1L77'' 3&$$s* Dd[^+,(_5E3T?e345dkkm$+ %, b rP)NNNNNNNN)r$N)T)NT)r$r r)r@)8__name__ __module__ __qualname____doc____annotations__rrOrWrKrDr indent_widthrrErr rirkrJrrrrrrrrrpropertyr^rr_rcrwrrrrrrrrrrrrrrrrr rr2r=r rrr rPrNr"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+ +rPr")-ryrr/r|rrF importlibrtypingrrrrrr r r r@r rrrcompletion.completerr exceptionsrrrrrrrr terminalsrutilrrrrrrr r"r rPrNr_sa #   =<BLL3311#{{rP