`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 KJr SS KJr SSKJr SSKJr SSKJr SSKJr SSKrSr"SS\R<5r"SS\5r "SS\!5r""SS\!5r#"SS\RH5r$"SS\RJ"\RL\RN55r("SS \(5r)"S!S"\RJ"\RL\(55r*g)#aCalliope argparse intercepts and extensions. Calliope uses the argparse module for command line argument definition and parsing. It intercepts some argparse methods to provide enhanced runtime help document generation, command line usage help, error handling and argument group conflict analysis. The parser and intercepts are in these modules: parser_extensions (this module) Extends and intercepts argparse.ArgumentParser and the parser args namespace to support Command.Run() method access to info added in the Command.Args() method. parser_arguments Intercepts the basic argument objects and collects data for command flag metrics reporting. parser_errors Error/exception classes for all Calliope arg parse errors. Errors derived from ArgumentError have a payload used for metrics reporting. Intercepted argument definitions for a command and all its ancestor command groups are kept in a tree of ArgumentInterceptor nodes. Inner nodes have is_group==True and an arguments list of child nodes. Leaf nodes have is_group==False. ArgumentInterceptor keeps track of the arguments and flags specified on the command line in a set that is queried to verify the specified arguments against their definitions. For example, that a required argument has been specified, or that at most one flag in a mutually exclusive group has been specified. The collected info is also used to generate help markdown documents. The markdown is annotated with extra text that collates and describes argument attributes and groupings. For example, mutually exclusive, required, and nested groups. The intercepted args namespace object passed to the Command.Run() method adds methods to access/modify info collected during the parse. )absolute_import)division)unicode_literalsN) arg_parsers)base)parser_arguments) parser_errors)suggest_commands) usage_text) argv_utils)config)log)metrics) console_attr) console_iozNTo search the help text of gcloud commands, run: gcloud help -- SEARCH_TERMSc^\rSrSrSrU4SjrSrSrSrSSjr Sr \ S 5r \ S 5r S rS rS rSrSrSrSrSrSrSrSrU=r$) Namespace\aA custom subclass for parsed args. Attributes: _deepest_parser: ArgumentParser, The deepest parser for the last command part. _parsers: ArgumentParser, The list of all parsers for the command. _specified_args: {dest: arg-name}, A map of dest names for known args specified on the command line to arg names that have been scrubbed for metrics. This dict accumulate across all subparsers. c X>SUl/Ul0Ul[[U]"S0UD6 g)N)_deepest_parser_parsers_specified_argssuperr__init__)selfkwargs __class__s 0lib/googlecloudsdk/calliope/parser_extensions.pyrNamespace.__init__hs,DDMD )T#-f-cXlg)z2Sets the parser for the first part of the command.Nr)rparsers r _SetParserNamespace._SetParserns!r!cUR$)z+Returns the deepest parser for the command.r#rs r _GetParserNamespace._GetParserrs   r!c6UR5R$)z+Returns the command for the deepest parser.)r)_calliope_commandr(s r _GetCommandNamespace._GetCommandvs ??  . ..r!cpSnUR5RR5RXS9$)zExecutes command in the current CLI. Args: command: A list of command args to execute. call_arg_complete: Enable arg completion if True. Returns: Returns the list of resources from the command. F)call_arg_complete)r-_cli_generatorGenerateExecute)rcommandr0s r_ExecuteNamespace._Execute{s>     , , 5 5 7 ? ? @ 66r!cJUR5RR$)z Returns the parser display_info.)r-ai display_infor(s rGetDisplayInfoNamespace.GetDisplayInfos     - --r!cdUR5RRnUcU$XlU$)z%The holder for concepts v1 arguments.)r-r8concept_handler parsed_argsrhandlers rCONCEPTSNamespace.CONCEPTSs3 ##33G n Nr!cdUR5RRnUcU$XlU$)z%The holder for concepts v2 arguments.)r-r8conceptsr>r?s r CONCEPT_ARGSNamespace.CONCEPT_ARGSs3 ##,,G n Nr!cH[URR55$)zReturns the scrubbed names for args specified on the command line. For example, `$ {command} positional_value --foo=bar, --lorem-ipsum=hello` returns ['POSITIONAL_NAME', '--foo', '--lorem-ipsum']. sortedrvaluesr(s rGetSpecifiedArgNamesNamespace.GetSpecifiedArgNamess $&&--/ 00r!c [R"UR5VVs0sHupU[XS5_M snn$s snnf)a4Gets the argument names and values that were actually specified. For example, `$ {command} positional_value --foo=bar, --lorem-ipsum=1,2,3` returns { 'POSITIONAL_NAME': 'positional_value' '--foo': 'bar', '--lorem-ipsum': [1,2,3], } In the returned dictionary, the keys are the specified arguments, including positional argument names and flag names, in string type; the corresponding values are the user-specified flag values, converted according to the type defined by each flag. Returns: {str: any}, A mapping of argument name to value. UNKNOWN)six iteritemsrgetattr)rdestnames rGetSpecifiedArgsNamespace.GetSpecifiedArgssF0--(<(<= =JD gd),,=  sAcUR$)aReturns the _specified_args dictionary. For example, $ {command} positional_value --foo=bar, --lorem-ipsum=hello --async, returns { 'positional_name', 'POSITIONAL_NAME' 'foo': '--foo', 'lorem_ipsum': '--lorem-ipsum', 'async_': '--async', }. In the returned dictionary, the keys are destinations in the argparse namespace object. In the above example, the destination of `--async` is set to 'async_' in its flag definition, other flags use underscore separated flag names as their default destinations. )rr(s rGetSpecifiedArgsDictNamespace.GetSpecifiedArgsDicts,   r!c[X5(d%[R"SRU55eXR;$)aReturns True if args.dest was specified on the command line. Args: dest: str, The dest name for the arg to check. Raises: UnknownDestinationException: If there is no registered arg for dest. Returns: True if args.dest was specified on the command line. 'No registered arg for destination [{}].)hasattrr UnknownDestinationExceptionformatrrrRs r IsSpecifiedNamespace.IsSpecifiedsA 4    5 5 3 : :4 @ BB '' ''r!cB[X5=(a XR;$)zReturns True if dest is a known and args.dest was specified. Args: dest: str, The dest name for the arg to check. Returns: True if args.dest is a known argument was specified on the command line. )r[rr^s rIsKnownAndSpecifiedNamespace.IsKnownAndSpecifieds 4  AD,@,@$@Ar!cURS5(aUSSRSS5nUnOUnSURSS5-nUR5RnURUR -H;nX%R :Xd'UR(dM%X5RS:XdM9Us $ [R"SRU55e)zReturns the flag argument object for name. Args: name: The flag name or Namespace destination. Raises: UnknownDestinationException: If there is no registered flag arg for name. Returns: The flag argument object for name. --N-_rz No registered flag arg for [{}].) startswithreplacer-r8 flag_argsancestor_flag_argsrRoption_stringsr r\r])rrSrRflagr8args rGetFlagArgumentNamespace.GetFlagArguments t !"X  c3 'd d d DLLc* *d     B||b333 ((    ););A)>!> 4  3 3*11$7 99r!cURSS5R5nURSS5R5nUR5RR H<n[ U[5(aMX$R:XdX4R:XdM:Us $ [R"SRU55e)zReturns the positional argument object for name. Args: name: The Namespace metavar or destination. Raises: UnknownDestinationException: If there is no registered positional arg for name. Returns: The positional argument object for name. rgrhz&No registered positional arg for [{}].) rjlowerupperr-r8positional_args isinstancetyperRmetavarr r\r])rrSrRmetaros rGetPositionalArgumentNamespace.GetPositionalArguments <<S ! ' ' )D <<S ! ' ' )D!$$44 C    T[[0 5  3 3077= ??r!chURU5nUR(aURS$S$)aReturns the flag name registered to dest or None is dest is a positional. Args: dest: The dest of a registered argument. Raises: UnknownDestinationException: If no arg is registered for dest. Returns: The flag name registered to dest or None if dest is a positional. rN)rprm)rrRros rGetFlagNamespace.GetFlag,s2   t $C$'$6$63  a @D@r!c[X5$![a& [R"SR U55ef=f)zReturns the value of the argument registered for dest. Args: dest: The dest of a registered argument. Raises: UnknownDestinationException: If no arg is registered for dest. Returns: The value of the argument registered for dest. rZ)rQAttributeErrorr r\r]r^s rGetValueNamespace.GetValue;sGB T  B  5 5 3 : :4 @ BBBs 0=c^^UU4SjnU$)aReturns a function to get given flag value or raise if it is not set. This is useful when given flag becomes required when another flag is present. Args: flag_name: str, The flag_name name for the arg to check. Raises: parser_errors.RequiredError: if flag is not specified. UnknownDestinationException: If there is no registered arg for flag_name. Returns: Function for accessing given flag value. c>TRS5(aTSSOTn[TU5nUc*TRU5(d[R"TS9eU$)Nrerf)argument)rirQr_r RequiredError)rn flag_value flag_namers r_Func'Namespace.MakeGetOrRaise.._Func]sY'22488Yqr]id4&j  D$4$4T$:$:))9== r!r)rrrs`` rMakeGetOrRaiseNamespace.MakeGetOrRaiseMs  Lr!)rrr)F)__name__ __module__ __qualname____firstlineno____doc__rr%r)r-r5r:propertyrArErKrTrWr_rbrprzr}rr__static_attributes__ __classcell__rs@rrr\s . " / 6.      16 0(" B94?. AB$r!rc$\rSrSrSrSrSrSrg) _ErrorContextigacContext from the most recent ArgumentParser.error() call. The context can be saved and used to reproduce the error() method call later in the execution. Used to probe argparse errors for different argument combinations. Attributes: message: The error message string. parser: The parser where the error occurred. error: The exception error value. cx[R"SSU5UlX lX0lUR Ulg)N\bu'')resubmessager$errorflags_locations)rrr$rs rr_ErrorContext.__init__ts.66'30DLKJ!11Dr!cURRU5nU(a*SRUSR[ U555nU$)z4Adds locaton info from context for arg if specified.{} ({}),)rgetr]joinrI)rro locationss r AddLocations_ErrorContext.AddLocationszs@$$((-I   S#((6)+<"= >c Jr!)rrrr$N)rrrrrrrrrr!rrrgs 2 r!rc\rSrSrSrSrg)_HandleLaterErroria6Error to be handled in a subsequent call to self.error. This error exists to provide a way to break out of self.error so that we can deduce a better error later; it will always be caught in parser_extensions and never surfaced as a user-facing error (at least in theory; if that does happen then it's a bug.) rNrrrrrrrr!rrrs r!rc\rSrSrSrSrg) DryRunErrorizURS5Ul[URS5UlSUl0UlSUlSUl[R"[5Ul SUl [[U]>"U0UD6 g)Ncalliope_commandcommandsF)popr,r[ _is_group_remainder_actionr_error_context _probe_error collections defaultdictsetr raise_errorrrrrargsrrs rrArgumentParser.__init__sz#ZZ(:;DT33Z@DN!DDDD&2237DD .$($9&9r!c^UR[[R"U5X5S9 g)N)context)rrrSafeText)rrs r_ErrorArgumentParser._Errors"JJ}\%:%:5%A4OJPr!cUR(a%UR[R"S55 [R US'UR "U0UD6UlUR$)apAdd an argument representing '--' followed by anything. This argument is bound to the parser, so the parser can use its helper methods to parse. Args: *args: The arguments for the action. **kwargs: They keyword arguments for the action. Raises: ArgumentException: If there already is a Remainder Action bound to this parser. Returns: The created action. z,There can only be one pass through argument.action)rrr ArgumentExceptionrRemainderAction add_argument)rrrs rAddRemainderArgument#ArgumentParser.AddRemainderArguments]"  kk-11 8:;"22F8!..??D  ! !!r!cH[URR55$)zBReturns the scrubbed names for args specified on the command line.rHr(s rrK#ArgumentParser.GetSpecifiedArgNamess $&&--/ 00r!cU(aSU;aSRX5nOUnURRU5nU(a*SRUSR[ U555nU$)z:Adds file and line info from context for arg if specified.=z{}={}rr)r]rrrrI)rrovalueargvalrs r _AddLocationsArgumentParser._AddLocationss\ C~~c)ff$$((0I   VSXXfY.?%@ Ac Jr!c /n[R"5nURRSS9HSnURnU(dMUR U5 [ USS5nU(dM?URXeS5 MU 0nUGHbn[U[R5(dM%URS5Sn[URS55S:aURS5SOSn URS5(dU (a#URU5n URU5nOSn X;aMUR!U5(aTUR!U5n UR#S R%U55 UR#S R'U 5S -5 U (a*XU'UR#US R%U 5-5 GMQUR#U5 GMe [U5S:aS upOSupUR#SR%U [(55 UR+[,R."SR%XR'U55U[U5[U5US95 g)zDError out with a suggestion based on text distance for each unknown.Finclude_hiddensuggestion_aliasesNrrrezE {} flag is available in one or more alternate release tracks. Try:   z (did you mean '{0}'?))r) z z{}{}zunrecognized arguments:{0}{1})r$total_unrecognizedtotal_suggestions suggestions)r TextChoiceSuggesterr,GetAllAvailableFlagsrm AddChoicesrQ AddAliasesrvrO string_typessplitlenri GetSuggestionr%_ExistingFlagAlternativeReleaseTracksappendr]r_HELP_SEARCH_HINTrr UnrecognizedArgumentsError)r unknown_argsmessages suggesterrnoptionsaliasesrror suggestionexisting_alternatives separatorprefixs r_SuggestArgumentParser._Suggests)H..0I&&;;<##g W%$ 4d; 7   w 3K S-- . . YYs^A d#&syy~#6#:ciinQe   %,,T2   %  3 3D 9 9 $ J J4 P117 ? $9:D@A %C6==jIIJ/6 8}q$i%i OOFMM&*;<=KK 88'.. ~~h/ 1|,k* !"r!cXlg)zDSets the current error context to context -- called by self.error().N)r)rrs r_SetErrorContextArgumentParser._SetErrorContext!s!r!c,>SUlU(aUO[[U5nURX5up%URnSUlU(d0[ US5(a[ R"[5Ul X%U4$![a /nN\f=f)aCalls parse_known_args() and adds error_context to the return. Args: args: The list of command line args. namespace: The parsed args namespace. wrapper: Calls the parse_known_args() wrapper if True, otherwise the wrapped argparse parse_known_args(). Returns: namespace: The parsed arg namespace. unknown_args: The list of unknown args. error_context: The _ErrorContext if there was an error, None otherwise. Nr) rrrparse_known_argsrr[rrrr)rr namespacewrapperr$r error_contextrs r_ParseKnownArgsArgumentParser._ParseKnownArgs%sDT%"=F & 7 7 Hi''MD GF,=>>*66s;f M 11 lsB BBchSUlUH>nURS5(d O&URU/U5u pVU(dM<Un O SUlUR UR R 5UR lURR USS9 g![a  Mdf=f)aThere is an argparse error in context, see if we can do better. We are committed to an argparse error. See if we can do better than the observed error in context by isolating each flag arg to determine if the argparse error complained about a flag arg value instead of a positional. Args: context: The _ErrorContext containing the error to improve. args: The subset of the command lines args that triggered the argparse error in context. namespace: The namespace for the current parser. TrgF)r reproduceN)rrirrrrrr$)rrrrrorhrs r_DeduceBetterError!ArgumentParser._DeduceBetterError?sD~~c"" #!00# Ba g D$11'--2H2HIGMM NND9 sB"" B10B1c Z[UVs/sHn[USU5PM sn5$s snf)z=Returns the set of 'dest' attributes (or the arg if no dest).rR)rrQ)ras rGetDestinationsArgumentParser.GetDestinations\s* t4t!61%t4 554s(c  /n/n/n/n UR(a"[UR[RS9O URn U Hn U R (a'UR U UUU=(a U RSS9n OU RU;n U (a7U R(aURU 5 MuURU 5 MU R(a*[U [5(dU RU 5 MMURU 5 M U (GaU(dU(agU(d`U(dY[R"U SURS9n UR[R"U[R "U SSUS9S95 U(dU(a[R"Xx-SURS9n[R"U SURS9n UR[R""U[R "USSUS9[R "U SSUS9S95 [%UR'U55[%UR'U55-nUR((GaZ[R "USSUS9nU(aUR(aUS :waU(a[R "[X-[RS9S SSUS9nUR+U5nU(aMUR/UR5n[U[0[2[445(dUR7UU5nOS nUR[R8"UUUS95 O]US :aW[R "[X-[RS9S SSUS9nUR[R:"UUUS95 [1U5$![R,a S nNf=f) aValidate specified args against the arg group constraints. Each group may be mutually exclusive and/or required. Each argument may be required. Args: ai: ArgumentInterceptor, The argument interceptor containing the ai.arguments argument group. specified_args: set, The dests of the specified args. namespace: object, The parsed args namespace. is_required: bool, True if all containing groups are required. top: bool, True if ai.arguments is the top level group. Raises: ModalGroupError: If modal arg not specified. OptionalMutexError: On optional mutex group conflict. RequiredError: If required arg not specified. RequiredMutexError: On required mutex group conflict. Returns: True if the subgroup was specified. keyF) is_requiredtopT) argumentsis_group sort_args)rhiddenr )r$r)r$rconflictrrN)rrIr r GetArgSortKeyrvalidate_specified_argsr rRrrvDynamicPositionalActionArgumentWrapperrr r GetArgUsageModalGroupErrorrris_mutexrpr\rbooldictlistrRequiredMutexErrorOptionalMutexError)rr8specified_argsrr r  also_optional have_optional have_required need_requiredr roarg_was_specified need_args have_argscountrrrnrs rr&ArgumentParser.validate_specified_argsbs~2MMMM << r||!9!9:\\  88   #7 9 HH6  ??   s #   s # ??#677   s #8 S!'* } ..#dbllL  M//++t>? @ -..#3dll$ ..#dll$  M11++t>++t> ? @%%m4 5 %%m4 56E {{{''%#Nh  A: !--}4%335568Dc3H ..x8d((3edD'9::--h>H ++m66HxA B 19)) =0!// 112 4#/ M44(X? @ ;%!<< d s4O**PPcUc[R"5SSnUc [5nURU5 UR(aCUR R UR5 URRX5up!URUl URXSS9up#nURRUR5 U(aURU5 O>U(a7UR(a [5eURR!XAU5 UR"R%U5 UR(a%UR R%UR5 X#4$![a GNf=f!UR(a&UR R%UR5 ff=f)z=Overrides argparse.ArgumentParser's .parse_known_args method.NrF)r)r GetDecodedArgvrr%r_actionsremove ValueErrorParseKnownArgsrrupdaterrrr$rrr)rrrrrs rrArgumentParser.parse_known_argss |  & & ( ,d+i 5    --  t55 600??P &66d/3/C/C 50D0*,i}&&t';';<  l#    !# #//  ,%    T334  $$-   (    T334 s0F %F2CF F FFF9G c6U(a USSUlgSUlgN_args)cls original_argss r_SaveOriginalArgs ArgumentParser._SaveOriginalArgss"cicir!cSUlgr1r2r4s r_ClearOriginalArgs!ArgumentParser._ClearOriginalArgss CIr!cUR$r1r2r9s r_GetOriginalArgsArgumentParser._GetOriginalArgss 99r!cURU5 X0lURX5up$nUR5nURUlU(dmUR H+nUR URURU5 M- UR5R(aURS5 U$UR(a)URRXBU5up$U(dU$UR%U5 g![RanURU5 SnAMSnAff=f![ R"a N[f=f)z7Overrides argparse.ArgumentParser's .parse_args method.NCommand name argument expected.)r6rrr)rrrr8argparse ArgumentErrorrr-rrrParseRemainingArgsr rr) rrrrrrhdeepest_parserr$es r parse_argsArgumentParser.parse_argss?4 "!%!5!5d!FIQ))+N%.%>%>N" &&& #  ( (ii22I ?'    ) )>?''   , , ? ? /  L)3%% #    " " #( 5 5   s*$'D &E D=!D88D=EEc ^[U[5nU(a)S[R;a[R UlURbX!R;ag[U[R5(aUnO[R"U5nU(aURU5(agURRnURURR5U/-5nU(a=SSKJn SR%SR'U5S9nUR(R+XhS9 U(aUR-5 S R%U5n UR/U5n U (a?U S - n U S R'U 5- n UR1[2R4"U UUU S 95 Sn [7US /5m[9U4SjUR55n U(d[:R<"U 5n U R?U5n U (aU SR%U 5- n OHU SR%SR'U Vs/sHn[R"U5PM sn55- n UR1[2R@"U URB(aURBSOSSU (aSOSU (aU /OU S95 gs snf)aJOverrides argparse.ArgumentParser's ._check_value(action, value) method. Args: action: argparse.Action, The action being checked against this value. value: The parsed command line argument provided that needs to correspond to this action. Raises: argparse.ArgumentError: If the action and value don't work together. _ARGCOMPLETENr)update_managerzYou do not currently have this command group installed. Using it requires the installation of components: [{missing_components}]z, )missing_components)msgzInvalid choice: '{0}'.zL This command is available in one or more alternate release tracks. Try: r)r$extra_path_argrhidden_choicesc36># UHoT;dM Uv M g7fr1r).0crNs r .ArgumentParser._check_value..sJ1>2IQQs  z Did you mean '{0}'?z Valid choices are [{0}].r)rrrr)"rvCloudSDKSubParsersActionosenvironrA_SubParsersAction _orig_classchoicesrOr text_type IsValidChoicer,r1ComponentsForMissingCommandGetPathgooglecloudsdk.core.updaterrJr]r UpdateManagerEnsureInstalledAndRestartLoadAllChoices(_ExistingCommandAlternativeReleaseTracksrr WrongTrackErrorrQrIr rrUnknownCommandErrorrm)rrr is_subparserro cli_generatorrKrJrLrrrrYrrQrNs @r _check_valueArgumentParser._check_value1sf&>?L"**4#55f ~~..!8 %))** c MM% c,,S11 **99M&BB &&(C502<&&,f$(II.@$A'-'C ""<< =' '--e4G!II#N ./g 233g  kk-// + -.JV%5r:NJJJG 009i**3/j )00<< 188 II9As}}Q'9 :< < KK 11-3-B-B&&q))!q$.ZLG =>:s Kc/nURRnURURR5U(aU/O/-5nU(aURR 5n[ [ R"U5SS9HJupgURUSS5nU(dM"UR5(aM9URU5 ML U$)zGets alternatives for the command in other release tracks. Args: value: str, The value being parsed. Returns: [CommandCommon]: The alternatives for the command in other release tracks. c2USR=(d S$)Nrr)r)xs rAArgumentParser._CommandAlternativeReleaseTracks..s!A$++2C2Cr!r rN) r,r1%ReplicateCommandPathForAllOtherTracksr]_TopCLIElementrIrOrPLoadSubElementByPathIsHiddenr) rrrrf alternates top_elementrh command_pathalternative_cmds r _CommandAlternativeReleaseTracks/ArgumentParser._CommandAlternativeReleaseTrackss**99MDD &&(uUG"EGJ**99;k#CMM*$=(CE/!%::<;KL ??#;#;#=#=  & & 7 E ! r!c /nUR5HhnXRSS9Vs/sHoDRSPM sn;dM4URSR UR 55S-U-5 Mj U$s snf)zChecks whether the arg exists in other tracks of the command. Args: arg: str, The argument being parsed. Returns: [str]: The names of alternate commands that the user may use. Frrr)rvrrmrrr])rrores alternatefs rr4ArgumentParser._ExistingFlagAlternativeReleaseTrackss C::< .L.L/M/ !/ !!!$/ ! ! 388I--/036<== J!sBcURUS9Vs/sH"nSRUR55PM$ sn$s snf)zGets the path of alternatives for the command in other release tracks. Args: value: str, The value being parsed. Returns: [str]: The names of alternate commands that the user may use. )rr)rvrr])rrrzs rrb7ArgumentParser._ExistingCommandAlternativeReleaseTrackssM  1 1 1 > @ >/8CHHY&&( ) > @@ @s)>cUR5n[R"U[RUUUS9 [R "UUUUS9 g)aLogs `Commands` and `Error` Google Analytics events for an error. Args: dotted_command_path: str, The dotted path to as much of the command as we can identify before an error. Example: gcloud.projects error: class, The class (not the instance) of the Exception for an error. error_extra_info: {str: json-serializable}, A json serializable dict of extra info that we want to log with the error. This enables us to write queries that can understand the keys and values in this dict. )rerror_extra_info)rN)rKrCommandsr CLOUD_SDK_VERSIONError)rdotted_command_pathrrrs r_ReportErrorMetricsHelper(ArgumentParser._ReportErrorMetricsHelpersO..0N   ) +  MM ) +r!cSRURR55n[U[R 5(aVUR (aSRUUR /5nURUURUR5 gSU;a!URU[R5 gURU[R5 g)zReports Command and Error metrics in case of argparse errors. Args: error: Exception, The Exception object. message: str, The exception error message. .Ntoo few arguments) rr,r]rvr rBrMrrrTooFewArgumentsErrorOtherParsingError)rrrrs rReportErrorMetrics!ArgumentParser.ReportErrorMetricss((4#9#9#A#A#CD%4455   !hh(;(-(<(<(>? $$%8%*__%*%;%;= g% $$%8%2%G%GI  ""#6#0#B#BDr!c S[R;ar[R"SU5(ag[R"SU5(a9[R"SU5(d[R"SU5(dgU(aHU(aAURnUR nUR nU(d[R"XS9nGOU(a%URnUR nUR nONSU;a[RnO[RnU(a[R"S S U5nU"XS9nUnS[R;a[U[R5(dfUR(dS U;aOUR(aS U;a [5eURU=(d [!XU55 [5eS nU(a]UR#U5(aGUR%SS5nUR'US[)U5S5n SR+XyUS5nS[R;a7UR,R.(aUR,R15 GOUR2(Gd[4R6"U5n[8R "SR+UR:US95 S[R;a"[RSS:Xa [=U5eSU;GaSn S U;=(a SU;n U (a4[>R@"URC55n URE5 U (a[FRHRJRMSROS/U -5S-5 [FRHRJRMS[P-S-5 U [)U 5SS.Ul)GOSU:XGa_SSK*J+n UR,RY5n SnU (dSnUR,R[5n SnU(d[\R^"SS9nU(a4[`Rb"5nURMS R+US!95 O[FRHRJnURMS5 U Re[`Rb"U 5US"9 U(a)URMUR,Rg55 U(a;[\Rh"URk5[FRHRJS#9 OCUR,Rm5n [FRHRJRMU 5 URoXQ5 URqS$US%9 g)&aOverrides argparse.ArgumentParser's .error(message) method. Specifically, it avoids reprinting the program name and the string "error:". Args: message: str, The error message to print. context: _ErrorContext, An error context with affected parser. reproduce: bool, Reproduce a previous call to this method from context. Raises: _HandleLaterError: if the error should be handled in a subsequent call to this method. DryRunError: If CLOUDSDK_CORE_DRY_RUN is set to 1. rIrNzarguments? .* requiredzin dict arg but not providedz\[.*\brequired\b.*\])r$zInvalid choice:rrzInvalid choicezexpected one argumentz argument :rrz{}{}:{}z({prog}) {message})progrCLOUDSDK_CORE_DRY_RUN1rz Valid choicesrzMaybe you meant:)rrrr@)render_documentFT)rz {message} )r)finout)rrf) exception)9rUrVrsearchrr$rr rBrrrvDetailedArgumentErrorrrrrrirrrr]r, _sub_parserLoadAllSubElementsrrrrrrr GetCommandSuggestionsr=r:rA_sysstderrwriterrr&googlecloudsdk.core.document_renderersrGetCategoricalUsageGetUncategorizedUsager IsInteractiveioStringIORenderDocument GetHelpHintMoregetvalueGetUsagerexit)rrrrr$rexcrpartsroris_invalid_commandr usage_stringuncategorized_usage interactivers rrArgumentParser.errorsj"RZZ' & 0 0 )),g 6 6ii6@@ii/99Wg~~fmme ++GA //   '88#++# FF7C1'G)  * C CDD')   !8G!C!# # gNw)NO!!F7%%f--mmC#e  q#f+,!7 8c  eAh7g #   + + 113    %%g.g ii$++G+LM !RZZ /jj01S8'"" W  .'9=-W<  (>>##%'+  ! ! #  --   $ $kk-.<=D F --   $ $T,=%=%D E(#&{#3$%$ % /' 9 L//CCE,!& "& 11GGIL+$$22>K ++-C IIm**7*; <--&&C ))D/  ( (++l+ ) 6 IId,,88: ;  OOCLLN 0D0D E//88:, --   $ $\ 2 e-IIa5I!r!cXAUR(aUe[R"U5 g)zOverrides argparse.ArgumentParser's .exit() method. Args: status: int, The exit status. message: str, The error message to print. exception: Exception, The exception that caused the exit, if any. N)rsysr)rstatusrrs rrArgumentParser.exits!   oHHVr!c>[U[R5(dgUR5n[[ U]U5nU=(a USn[U5S:Xa)USR[R:XaU(dgU$)a)Overrides argparse.ArgumentParser's ._parse_optional method. This allows the parser to have leading flags included in the grabbed arguments and stored in the namespace. Args: arg_string: str, The argument string. Returns: The normal return value of argparse.ArgumentParser._parse_optional. Nrr) rvrOr_get_positional_actionsrr_parse_optionalrnargsrA REMAINDER)r arg_stringpositional_actions option_tuple known_optionrs rrArgumentParser._parse_optionals~ j#"2"2 3 3 557>zJL 3LOL 1$1##x'9'99   r!c>UR[R:waSnUR(aURSnOvU(aoUR(a URO URnUR (a5UR S:wa%US[ R"[U55-- nU(aX0RUR'[[U]3X5$)aIntercepts argparse.ArgumentParser's ._get_values method. This intercept does not actually change any behavior. We use this hook to grab the flags and arguments that are actually seen at parse time. The resulting namespace has entries for every argument (some with defaults) so we can't know which the user actually typed. Args: action: Action, the action that is being processed. arg_strings: [str], The values provided for this action. Returns: Whatever the parent method returns. Nr?r) rRrASUPPRESSrmrxrrOrZrrrr _get_values)rr arg_stringsrSrs rrArgumentParser._get_valuess{{h'''d   $$Q'  "(v~~V[[ <S[R;a[[U]U5$/$)a4Intercepts argparse.ArgumentParser's ._get_option_tuples method. Cloud SDK no longer supports flag abbreviations, so it always returns [] for the non-arg-completion case to indicate no abbreviated flag matches. Args: option_string: The option string to match. Returns: A list of matching flag tuples. rI)rUrVrr_get_option_tuples)r option_stringrs rr!ArgumentParser._get_option_tupless(# >4 ;M JJ Ir!)r,rrrrrrrr1)T)TT)NN)NNF)rNF)rNN)%rrrrrr3rrrrKrrrrr staticmethodrrr classmethodr6r:r=rFrgrvrrbrrrrrrrrrrs@rrrs. % :Q"21 9"v"24::66 59l\"%H ,*\h>T!. @26+2D:M"^ 4"HHr!rc`\rSrSrSr\R S5r\R S5rSr g)rTizA custom subclass for arg parsing behavior. While the above ArgumentParser overrides behavior for parsing the flags associated with a specific group or command, this class overrides behavior for loading those sub parsers. cg)zDetermines if the given arg is a valid sub group or command. Args: choice: str, The name of the sub element to check. Returns: bool, True if the given item is a valid sub element, False otherwise. Nrrchoices rr[&CloudSDKSubParsersAction.IsValidChoices r!cg)z:Load all the choices because we need to know the full set.Nrr(s rra'CloudSDKSubParsersAction.LoadAllChoicess r!rN) rrrrrabcabstractmethodr[rarrr!rrTrTs;      r!rTcH^\rSrSrSrU4SjrSrSrSU4SjjrSr U=r $) CommandGroupActioni zA subparser for loading calliope command groups on demand. We use this to intercept the parsing right before it needs to start parsing args for sub groups and we then load the specific sub group it needs. cZ>URS5Ul[[U]"U0UD6 g)Nr)rr,rrrrs rrCommandGroupAction.__init__s*#ZZ(:;D d,d=f=r!cS[R;aURRU5 URR U5$)NrI)rUrVr,LoadSubElementIsValidSubElementrs rr[ CommandGroupAction.IsValidChoices;# ++F3  ! ! 3 3F ;;r!c8URR5 gr1)r,rr(s rra!CommandGroupAction.LoadAllChoices#s--/r!c>USnUR(aURRU5 [[U]XX4S9 g)Nrr)r,rrr__call__)rr$rrJr parser_namers rrCommandGroupAction.__call__&sH)K  ++K8 d,6-@r!)r,r1) rrrrrrr[rarrrrs@rrr s# > <0 @ @r!rc^\rSrSrSrU4SjrSrSrSr\ RS5r \ RS5r S U4S jjr S rU=r$) ri2avAn argparse action that adds new flags to the parser when it is called. We need to use a subparser for this because for a given parser, argparse collects all the arg information before it starts parsing. Adding in new flags on the fly doesn't work. With a subparser, it is independent so we can load flags into here on the fly before argparse loads this particular parser. c>URSS5UlURS5Ul[[U]"U0UD6 g)NrF parent_ai)rr _parent_airrrrs rr DynamicPositionalAction.__init__<s:**Xu-DKjj-DO !414B6Br!c&URU5 g)NT) _AddParserrs rr[%DynamicPositionalAction.IsValidChoiceAs OOF r!cgr1rr(s rra&DynamicPositionalAction.LoadAllChoicesQs r!cURUSURRRURRRS9$)NF)add_helprr) add_parserrr$rr,rs rr"DynamicPositionalAction._AddParserWsF ??T__%;%;%@%@//AA  CCr!cgr1r)rrrs r GenerateArgs$DynamicPositionalAction.GenerateArgs^r!c gr1r)rrr>rs r Completions#DynamicPositionalAction.Completionsbrr!cH>USnURX%5nURUn[R"USSSURR S9n[ R"URRURR5H8n U R(dU R(aM'URU 5 M: URRURR5 UH_n U RU5 U R!U5n S["R$;dM;['U S5(aMNU R(U lMa [,[.U]cXX4S9 S["R$;aURR35 gg)NrFT) is_globalrfallow_positionaldatarIrXr)r_name_parser_maprArgumentInterceptorrr itertoolschainrkrldo_not_propagater  _add_actionr9AddLowerDisplayInfoRemoveFromParser AddToParserrUrVr[rrXrrrclear) rr$rrJrrr sub_parserr8rnro added_argrs rr DynamicPositionalAction.__call__fsZ AYF   Y /D&&v.J  - -e4DOO$8$8 :B 9 9 $ B BD   $"2"2T"DOO''(D(DE 2//"%i 2:: %gi.O.O ) 3 3  !4162@"RZZ' !!#(r!)rrr1)rrrrrrr[rarrrrrrrrrs@rrr2s^C   C    A$A$r!r)+r __future__rrrrrArrrrUrrgooglecloudsdk.callioperrrr r r googlecloudsdk.corer r rrgooglecloudsdk.core.consolerrrOrrobjectr Exceptionrrrwith_metaclassABCMetarWrTrrrr!rrs )V''   /(414.*&#'42 ! H""HVF6 ) Z X,,Z | s11#++2:2L2L N 6#@1#@Lu$c001IKu$r!