k^SrSSKJr SSKJr SSKJr SSKrSSKrSSKrSSKrSSK r SSK r SSK r SSK r SSK Jr SSK Jr SSK Jr SS K Jr SS K Jr SS K Jr SS K Jr SS KJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJr SSKJ r SSK!J"r" SSK!J#r# SSK!J$r$ SSK%r%Sr&Sr'"SS\(5r)"SS\(5r*S/Sjr+Sr,"S S!\(5r-"S"S#\R\5r/\R`"\'S\/S$S%S&9r1"S'S(\(5r2"S)S*\ Rf5r4S+r5S/S,jr6"S-S.\(5r7g)0zDThe calliope CLI/API is a framework for building library interfaces.)absolute_import)division)unicode_literalsN)actions)backend)base)command_loading) exceptions) parser_errors)parser_extensions) argv_utils)config)log)metrics) properties)yaml) named_configs) console_attr)encoding)files) pkg_resourcesz.pyz---flag-file-line-c$\rSrSrSrSrSrSrg) _FlagLocation9z&--flags-file (file,line_col) location.c8XlURS-Ulg)N file_nameline)selfrline_cols "lib/googlecloudsdk/calliope/cli.py__init___FlagLocation.__init__<sN !DIcNSRURUR5$)Nz{}:{})formatrrr s r"__str___FlagLocation.__str__@s >>$..$)) 44r%rN)__name__ __module__ __qualname____firstlineno____doc__r#r)__static_attributes__r%r"rr9s."5r%rc.\rSrSrSrSSjrSrSrSrg) _ArgLocationsDz"--flags-file (arg,locations) info.NcXlU(aURSSO/UlURR[X#55 gN)arg locationsappendr)r r7rr!r8s r"r#_ArgLocations.__init__Gs4H/8Y((+bDNNN- <=r%cSRURVs/sHn[R"U5PM sn5$s snf)N;)joinr8six text_type)r locations r"r)_ArgLocations.__str__Ls0 88T^^L^S]]8,^L MMLs Acp[URVs/sHo!UR:HPM sn5$s snf)z4Returns True if file_name is in the locations stack.)anyr8r)r rxs r" FileInStack_ArgLocations.FileInStackOs* $..A.QQ[[(.A BBAs3)r7r8r6) r+r,r-r.r/r#r)rEr0r1r%r"r3r3Ds*> NCr%r3c [RRnU(a;URU5(a%[R "SR X255eUS:Xa[RR5nO_[RRU5(d%[R "SR X155e[R"U5nU(d%[R "SR X155e[R "USS9n[#U[$5(aUOU/nUGHn[#UR&[(5(d=[R "SR XR*R,S-U55e[.R0"UR&5GH8upU R*n [R2"U 5n X:Xa[[#U R&[$5(a U R&O U R&/n U Hn [5XX5n[7X U5 M M[#U [9S 5[:45(aS nO1[#U [$[(45(aSnOS nS R X5nUR=[>5 UR=[5XX55 UR=U5 U(dGM'UR=U 5 GM; GM g ) z2Recursively append the flags file flags to inject.z{} recursive reference ({}).-z{} [{}] not found.z{} [{}] is empty.T)location_valuezJ{}:{}: {} file must contain a dictionary or list of dictionaries of flags.rNFz{}={}) calliope_baseFLAGS_FILE_FLAGnamerEr ArgumentErrorr'sysstdinreadospathexistsrReadFileContentsrload isinstancelistvaluedictlcrr> iteritemsstrip_locationsr3_AddFlagsFileFlagstypeboolr9_FLAG_FILE_LINE_NAME)inject flags_fileparent_locationsflagcontentsdatagroupmemberr7objr!rX file_listrRr8separate_value_args r"r]r]TsK  & & + +$*66zBB  % %&--dE GG 3yy~~H 77>>* % %  % %##D5 77%%j1H   % %""44 66 8D 1$T4(($tf%f fllD ) )  ' ' fZ!);TB DDMM&,,/h""3'e !+CIIt!r?)r parser namespacevalues option_strings r"__call___SetFlagsFileLine.__call__sN 6, - - f')@)@)EF 6::&**3==+@Ar%r1r6)r+r,r-r.r/rr0r1r%r"rrs ,Br%rTz;Internal *--flags-file* flag, line number, and source file.defaultactionhiddenhelpc\rSrSrSr\R "S5rSSjr\ S5r SSjr SSjr S r S rSS jrSS jrS rSrSrSSjrSrSrSrg) CLILoaderzBA class to encapsulate loading the CLI and bootstrapping the REPL.z(?:([\w\.]+)\.)?([^\.]+)NcxXlX lUR(d[R"S5eX0lU=(d [ R "5RUlXPl X`l Xpl /Ul /Ul /Ul[R "["5Ul0Ul0Ulg)aInitialize Calliope. Args: name: str, The name of the top level command, used for nice error reporting. command_root_directory: str, The path to the directory containing the main CLI module. allow_non_existing_modules: True to allow extra module directories to not exist, False to raise an exception if a module does not exist. logs_dir: str, The path to the root directory to store logs in, or None for no log files. version_func: func, A function to call for a top-level -v and --version flag. If None, no flags will be available. known_error_handler: f(x)->None, A function to call when an known error is handled. It takes a single argument that is the exception. yaml_command_translator: YamlCommandTranslator, An instance of a translator that will be used to load commands written as a yaml spec. Raises: backend.LayoutException: If no command root directory is given. z*You must specify a command root directory.N)_CLILoader__name"_CLILoader__command_root_directoryr LayoutException&_CLILoader__allow_non_existing_modulesrPathslogs_dir_CLILoader__logs_dir_CLILoader__version_func_CLILoader__known_error_handler#_CLILoader__yaml_command_translator_CLILoader__pre_run_hooks_CLILoader__post_run_hooks_CLILoader__modulesrrrW_CLILoader__modules_by_parent_CLILoader__missing_components_CLILoader__release_tracks)r rLcommand_root_directoryallow_non_existing_modulesr version_funcknown_error_handleryaml_command_translators r"r#CLILoader.__init__s2K$:!  ( (  + + 6 88)C%9&,,."9"9DO&!4%<"DDDN*66tURRXU45 g)aAdds a module to this CLI tool. If you are making a CLI that has subgroups, use this to add in more directories of commands. Args: name: str, The name of the group to create under the main CLI. If this is to be placed under another group, a dotted name can be used. path: str, The full path the directory containing the commands for this group. component: str, The name of the component this command module is in, if you want calliope to auto install it for users. N)rr9)r rLrRrs r" AddModuleCLILoader.AddModuleDs NN4y12r%cUR$)z'Returns modules added to this CLI tool.)rr(s r" GetModulesCLILoader.GetModulesTs >>r%cUR$)zReturns info about added modules (if any) for each parent command group. Returns: {str: [(str, bool, str)]}, Mapping of parent group to list of (module_name, module_is_command, module_impl_path) tuples for each additional module. )rr(s r"GetModulesByParentCLILoader.GetModulesByParentXs  # ##r%cR[XU5nURRU5 g)atRegister a function to be run before command execution. Args: func: function, The function to run. See RunHook for more details. include_commands: str, A regex for the command paths to run. If not provided, the hook will be run for all commands. exclude_commands: str, A regex for the command paths to exclude. If not provided, nothing will be excluded. N)rvrr9r r|r}r~hooks r"RegisterPreRunHookCLILoader.RegisterPreRunHookbs% 4+; r[rrn)r r path_stringrRrs r"ComponentsForMissingCommand%CLILoader.ComponentsForMissingCommand~sc((<(K#&==1J1J#K J#K"k&<&H  ifG  " "6QXXJ&1gj#  .04v/@gm((++, Nr%c jURGHupnUR[5nU(aUS[[5*n[R R U5nURSS5upgURUURS9n[RR/URQHn U(a|SRUR/U R (a U R /O/-U(aUR#SS5/O/-5n UR$U R'XtU45 MU(dMSRUR/U R (a U R /O/-UR#SS5/-5n X0R(U 'M GM URUR*SS9n[,R."U/UR/[RR[0R2"5R4US5n UR7U 5 [9S URR;555n [<R>"UR5Hun upURUURS9nU(aFU/U R@U R 'U RCU R S U S 9nU REXS 9 MoU(dMxX0R(URSU R 3'M URGU 5nU$) zcUses the registered information to generate the CLI tool. Returns: CLI, The generated CLI tool. Nrr)rr_rHFc38# UHoRv M g7fr6)r).0rs r" %CLILoader.Generate..sM0Lull0LsT) allow_emptyrelease_track_override)ignore)$rendswith_COMMAND_SUFFIXrorPATH_RErrg&_CLILoader__ValidateCommandOrGroupInforrJrrrr=rrreplacerr9rrr CommandGroupuuiduuid4hex!_CLILoader__AddBuiltinGlobalFlagsrkeysr>r[_groups_to_loadLoadSubElementCopyAllSubElementsTo_CLILoader__MakeCLI)r module_dot_pathmodule_dir_pathr is_commandrrcmd_or_grp_name impl_pathrparent_group_name group_name top_group track_names module_dir track_groupclis r"GenerateCLILoader.Generates8<~~3)"++O$>$A$A $&I   +M0E0E0J0J0LMMK*---8M8M*N&& 33 %)%F%F4Hi 4=+ !!%,,/ .. LLd5/J  &&{&G 9EN!!T[[M5<<."AB+O" .. #C Jr%c[RRU5up4[R"XC5(d-U(ag[ R "SRU55eU$)aGenerates the information necessary to be able to load a command group. The group might actually be loaded now if it is the root of the SDK, or the information might be saved for later if it is to be lazy loaded. Args: impl_path: str, The file path to the command implementation for this command or group. allow_non_existing_modules: True to allow this module directory to not exist, False to raise an exception if this module does not exist. Raises: LayoutException: If the module directory does not exist and allow_non_existing is False. Returns: impl_path or None if the module directory does not exist and allow_non_existing is True. Nz.The given module directory does not exist: {0})rQrRsplitr IsImportabler rr')r rr module_rootmodules r"__ValidateCommandOrGroupInfo&CLILoader.__ValidateCommandOrGroupInfos\*''-- 2K  % %f : : #  + + : A A   r%c X[RRUR5 [RRUR5 [R RUR5 UR bJURRSSS[R[R"UR 5SS9 URRSS[RS R[R5S 9 URRS [R"5[R [RS [R""[$R&R(R*5S 9 URRSS[R,"[$R&R(R.5SS9 URRSS[R,"[$R&R(R05SS9 URRSS[R""[$R&R2R45SSS9 URRSS[R""[$R&R2R65SSS9 URRS[R""[$R&R2R85SSS9 URRSS[R""[$R&R(R:5SSS9 [<RUR5 g)a/Adds in calliope builtin global flags. This needs to happen immediately after the top group is loaded and before any other groups are loaded. The flags must be present so when sub groups are loaded, the flags propagate down. Args: top_element: backend._CommandCommon, The root of the command tree. Nz-vz --versionTzTPrint version information and exit. This flag is only available at the global level.)do_not_propagatecategoryrrz--configuration CONFIGURATIONa+ File name of the configuration to use for this command invocation. For more information on how to use configurations, run: `gcloud topic configurations`. You can also use the {0} environment variable to set the equivalent of this flag for a terminal session.)metavarrrz --verbosityz0Override the default verbosity for this command.)choicesrrrrz--user-output-enabledz*Print user intended output to the console.)rrrz --log-httpz5Log all HTTP server requests and responses to stderr.z--authority-selectorzTHIS ARGUMENT NEEDS HELP TEXT.rz--authorization-token-filez--credential-file-override)rrrz--http-timeout)rJrK AddToParserai FLATTEN_FLAG FORMAT_FLAGr add_argumentCOMMONLY_USED_FLAGSrFunctionExitActionr'rCLOUDSDK_ACTIVE_CONFIG_NAMErOrderedVerbosityNamesDEFAULT_VERBOSITY_STRING StorePropertyrVALUEScore verbosityStoreBooleanPropertyuser_output_enabledlog_httpauthauthority_selectorauthorization_token_filecredential_file_override http_timeoutFLAG_INTERNAL_FLAG_FILE_LINE)r top_elements r"__AddBuiltinGlobalFlags!CLILoader.__AddBuiltinGlobalFlagss!!--knn=**;>>:))+..9 &nn!!   44++D,?,?@" "#NN22 F6==> @NN))+,,22 ?$$Z%6%6%;%;%E%EF  HNN++    " " 6 6 :  NN++J,=,=,B,B,K,KL D  F NN$$Z%6%6%;%;%N%NO -  /NN$$$    " " ; ;= -  /NN$$$    " " ; ;= -  /NN$$Z%6%6%;%;%H%HI -  /!,,[^^URnURUl[[U]5nU(aXlU$r6)_parserrsuperrS_patch_argument_parser)r ractive_parsers __class__s r"rW(_CompletionFinder._patch_argument_parsers5 B99DL,dJLN l r%c2UR5n[R"5nSUlURR USSUS9 SUlURXVUS5nURU5nURXsU5$![ a NJf=f)NTr)rFcgr6r1)rs r"4_CompletionFinder._get_completions..sdr%) rWr Namespace completingrUparse_known_args BaseExceptioncollect_completionsfilter_completionsquote_completions)r comp_words cword_prefixcword_prequotelast_wordbreak_posrX parsed_args completionss r"_get_completions"_CompletionFinder._get_completionss002N#--/KDO  ll##JqrNk#JDO**\?DK))+6K  ! !%7 99    sB BBc (SnSnSnSnSnU(d!U(aUV s/sH oUS-SPM nn Un O US:XaUn OUn [R"[RS 5U;aS n O)US :Xa#S n UV s/sHoR S S 5PM nn U H'n UV s/sHoR U SU -5PM nn M) [ US S5(a1Un [ U5S:Xa USSU ;aU(d US==S- ss'U$s sn fs sn fs sn f)aSReturns the completion (less aggressively) quoted for the shell. 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 *most* 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. Args: completions: The current completion strings. cword_prequote: The current quote character in progress, '' if none. last_wordbreak_pos: The index of the last wordbreak. Returns: The completions quoted for the shell. z\();<>|&$* `"'z\`"$\z=/:)tcshfishzshrN"_ARGCOMPLETE_SHELL'z'\'' append_spaceFr )rr8rQr6rgetattrro) r rkrhrino_quote_specialdouble_quote_specialsingle_quote_specialcontinuation_specialno_escaping_shellsc special_charscharcontinuation_charss r"re#_CompletionFinder.quote_completionssC4." 0  ;FG;a+a/01; G&m 3 *m*m 469KLm 3 m6ABkYYsG,kkB;FG;aYYtTD[1;kGkt^U++ 0 [ Q ;q>"#5=O#O a.C . ?HCHsD6D D)rUr`) r+r,r-r.r/rWrlrer0 __classcell__)rYs@r"rSrSs 9(GGr%rSc S[R;agSnSn[RRn[ R[RlS[R;a[R nSnU[l[5nU"U4SS0UD6 U(aU[RlU(a U[lgg!U(aU[RlU(a U[lff=f)zARuns argcomplete.autocomplete on a calliope argument interceptor.r3Nr4cgr6r1r1r%r"_DisableMuteStderr(_ArgComplete.._DisableMuteStderr s r%always_complete_optionsF)rQr6 argcompleteargparser_r mute_stderrrS)rkwargsrrr completers r" _ArgCompleters2::% +),$$..I%6%@%@K"rzz)++k !3k!#I   %  '0k$ +k'0k$ +ks BC1Dc.AUSnUSSnUR[RLa[X RU5 URUnURXb5up&U(aS[U5R[R/5 [U[R5RU5 gg![ aM USR UR54n[R"SU-5n[R"X5ef=f)z>argparse._SubParsersAction.__call__ version 1.2.1 MonkeyPatch.rrNz, zunknown parser %r (choices: %s))destrSUPPRESSr_name_parser_mapKeyErrorr=rrMravars setdefault_UNRECOGNIZED_ARGS_ATTRrzextend) r rrrr parser_name arg_stringstupmsgs r"_SubParsersActionCallrsq +qr + YYh''' Iyy+.,  " "; /F"22;J)Ox??D Ix778?? L , tyy!6!67 7C **6< =C   ++,s B==ADcZ\rSrSrSrSrSr\S5r\S5r Sr S S jr S r S r g) r?i<zA generated command line tool.cbXlURUlX lX0lX@lXPlgr6) _CLI__namerU _CLI__parser_CLI__top_element_CLI__pre_run_hooks_CLI__post_run_hooks_CLI__known_error_handler)r rLr/ pre_run_hookspost_run_hooksrs r"r# CLI.__init__?s.K''DM$(*!4r%cUR$r6rr(s r" _TopElementCLI._TopElementIs   r%cUR$r6)rr(s r"rLCLI.nameLs ;;r%cUR$r6rr(s r"r/CLI.top_elementPs   r%c8URRU5$)zChecks if given command exists. Args: cmd: [str], The command path not including any arguments. Returns: True, if the given command exist, False otherwise. )rIsValidSubPath)r cmds r"IsValidCommandCLI.IsValidCommandTs    , ,S 11r%Nc ^^ ^ ^ [U[R5(a [S5e[R[ l[ RS:Xa[[ Rl U(a[TRR5 U(d[R"5SSn[ R"R%U5 [&R(R+5 TR,m Sm [R.(a'UVs/sHn[0R2"U5PM snOUnSnSnTR4R7[9U55nUR:bUR:R=5 UR?5nSRAURC55m URE5m URFbURFRI5 [JRL"S5n[JRN"S5n[Q[&R(RS55S:Xa3[&R(RTRVRYT 5 [&R(R[[&R(RTRVT S5 TR\HnUR_T 5 M UR_TUS9m TR`HnUR_T 5 M [T [bRd5(aU U UU 4Sjn U "5[&R(Rg5 [ R"Ri5 Ub[JRL"U5 Ub[JRN"U5 $$[TRj"T [lRnT 5 T [&R(Rg5 [ R"Ri5 Ub[JRL"U5 Ub[JRN"U5 $$s snf![pRran U RtsSn A [&R(Rg5 [ R"Ri5 Ub[JRL"U5 Ub[JRN"U5 $$Sn A f[van TRyU T T 5 Sn A OSn A ff=f[&R(Rg5 [ R"Ri5 Ub[JRL"U5 Ub[JRN"U5 gg![&R(Rg5 [ R"Ri5 Ub[JRL"U5 Ub[JRN"U5 ff=f) aIExecute the CLI tool with the given arguments. Args: args: [str], The arguments from the command line or None to use sys.argv call_arg_complete: Call the _ArgComplete function if True Returns: The result of executing the command determined by the command implementation. Raises: ValueError: for ill-typed arguments. z5Execute expects an iterable of strings, not a string.z1.1rNrr)rrpc3~># THnUv M g![anTRUTT5 SnAgSnAff=f7f)zActivates generator exceptions.N) Exception_HandleAllErrors)resourceexccommand_path_string resourcesr specified_arg_namess r"_YieldCLI.Execute.._YieldsC Q%n& Q  ! !#': string_typesrr?rstr __version__r_SubParsersActionrrrrr GetDecodedArgvrFLAG_OVERRIDE_STACK PushFromArgsrr#PushInvocationValuesrPY2rDecoder parse_argsrt CONCEPT_ARGS ParseConcepts _GetCommandr=GetPathGetSpecifiedArgNamesCONCEPTSResetrSetUserOutputEnabledr;roGetInvocationStackr command_nameSetSetInvocationValuerrrtypes GeneratorTypePopInvocationValuesPopCommandsrCLOUD_SDK_VERSIONr DryRunErrorrequestrr)r rpcall_arg_completer7argvold_user_output_enabled old_verbositycalliope_commandrrrrrrs` @@@r"Execute CLI.Execute_s$(()) N OO==HLu$,Ah  )4%%(()   & & ( ,d%%2248**,++:= 5L   $ 5dD"MF( ]] % %od&; &&t,m Z   1 1 3 4 9!!..223FG**    # # 0 02EtM&&$ $%'"&&4d&;i''$ $%( Iu22 3 3 Q Qx++-''++- ! ,   !89  " ' ## v779L++-''++- ! ,   !89  " ' #Q 6x  ! ! [[ ++-''++- ! ,   !89  " ' # K C!46IJJKJ++-''++- ! ,   !89  " ' # ++-''++- ! ,   !89  " ' #sP QHQ<'QT, S,7T8V , T9T V TV A1W;cS[R;a[RSS:XaUeS[USS50n[[USS5SS5nUbXTS '[R"U[ R UURUS 9 [R"X!RUUS 9 [R"XUR5 g) a$Handle all errors. Args: exc: Exception, The exception that was raised. command_path_string: str, The '.' separated command path. specified_arg_names: [str], The specified arg named scrubbed for metrics. Raises: exc or a core.exceptions variant that does not produce a stack trace. CLOUDSDK_CORE_DRY_RUN1 error_code exit_coderpayloadN status_codehttp_status_code)errorerror_extra_info)r) rQr6rzrrrrrYErrorr HandleErrorr)r rrrrrs r"rCLI._HandleAllErrorss 2::- JJ. /3 6 i$gc;&BCwsIt<,d4#-=)* V557Jmm.>@ MM%}}6I#353T5O5OPr%)rErJ__parserrKrL __top_element)NT)r+r,r-r.r/r#rrQrLr/rrrr0r1r%r"r?r?<sI&5     2x(t Qr%r?r6)8r/ __future__rrrrrrQrrNrrrgooglecloudsdk.callioperrrrJr r r r googlecloudsdk.corer rrrrr"googlecloudsdk.core.configurationsrgooglecloudsdk.core.consolergooglecloudsdk.core.utilrrrr>rr`objectrr3r]rtrvActionrArgumentr.rCompletionFinderrSrrr?r1r%r"rs K&' ++93.15*&#'*$<4-*2 +5F5 CF C <~'T$f$NBB -55    F  HSSl j 44jZ!,HM@}Q&}Qr%