g SrSSKJr SSKJr SSKJr SSKrSSKrSSKrSSKrSSK J r SSK r SSK r SSK r SSKJr SSKJr SS KJr SS KJr SS KJr SS KJr SSKr\R rS rSrSrSrSrSrSr Sr!Sr"Sr#Sr$Sr%Sr&Sr'Sr(Sr)Sr*Sr+Sr,S r-S!r.S"r/S#r0S$r1S%r2S&r3S'r4S(r5S)r6S*r7S+r8S,r9S-r:S.r;S/rS2r?S,r9S3r@S4rAS5rBS6rCS7rDS8rES9rFS:rG"S;S<\R5rI\R"S=S>\R55rL"S?S@\R"\R\O55rP"SASB\P5rQ"SCSD\P5rRSErS\R"SFSGS\SSHSI9rT\R"SJSKS\R"5\SSLSM9rV\R"SNS\SSORSPR\R"555SQ9rZSRr[\R"SSSTSUSVSW9r\\R"SXSYSZ\[S[S\9r]\R"S]\R"S^\ RS_S`9SZ\[SaSb9r`\R"Sc\R"S^\ RS_S`9SZ\[SdSb9ra\R"SeSf\R"5SZ\[SgSh9rb\R"SiSTSZ\[SjSk9rcSlrd\R"SmS_STSZ\dSnSo9re"SpSq\R"\R\O55rf"SrSs\f5rg"StSu\R"\R\f55rh"SvSw\R"\R\h55ri"SxSy\R"\R\h55rj"SzS{\R"\R\h55rk"S|S}\R"\R\h55rl"S~S\R"\R\h55rm"SS\R"\R\h55rn"SS\R"\R\h55ro"SS\R"\R\h55rp"SS\R"\R\p55rq"SS\p\j5rr"SS\p\j5rs"SS\p\j5rt"SS\j5ruSrvSrwSrxSrySrzSr{Sr|Sr}Sr~SrSrSSjrSrSrSSjr\GR S5rSrSrSrSrSrSrSrSrSrSrSrg!\a \rGNf=f)z.Base classes for calliope commands and groups.)absolute_import)division)unicode_literalsNwraps) arg_parsers)display) exceptions)log) properties)resource_printerBackupRestorezAI and Machine Learningz Vertex AIzAI Platform TensorboardzAPI Platform and Ecosystemsz Anthos CLIz Anthos Authz App EngineBatchComposerComputezData Analytics Databasesz GDCc ZonezIdentity and SecurityzInternet of ThingszManagement ToolsMobile NetworkingzNetwork Securityz SDK ToolsDisksInfo InstanceszLoad BalancingToolsStorageTransferBillingSecurityIdentityzBig DatazCI/CD Monitoring Solutions ServerlessOtherCommercezDeclarative Resource Management MicroservicesWeb3SaaS*_`c\rSrSrSrSrg)DeprecationExceptionaz=An exception for when a command or group has been deprecated.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r-#lib/googlecloudsdk/calliope/base.pyr+r+asEr5r+c\rSrSrSrSrSr\S5rSr SSR\ 5S 4r S S R\ 5S 4r S SR\ 5S4r\S5r\S5r\S5rSrg) ReleaseTrackea:An enum representing the release track of a command or command group. The release track controls where a command appears. The default of GA means it will show up under gcloud. If you enable a command or group for the alpha, beta, or preview tracks, those commands will be duplicated under those groups as well. c(XlX lX0lgN)prefixhelp_tag help_note)selfr<r=r>s r6__init__ReleaseTrack.__init__osKMNr5cUR$r;namer?s r6__str__ReleaseTrack.__str__ts 99r5cUR$r;rCrEs r6idReleaseTrack.idws 99r5)NNNpreviewz{0}(PREVIEW){0} zThis command is currently in DEVELOPER PREVIEW and may change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist.betaz {0}(BETA){0} zBThis command is currently in beta and might change without notice.alphaz{0}(ALPHA){0} zThis command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist.c [[5$)zFGets all possible enum values. Returns: list, All the enum values. )listr8r-r5r6 AllValuesReleaseTrack.AllValuess  r5cF[HnURU:XdMUs $ g)zGets a ReleaseTrack from the given release track prefix. Args: prefix: str, The prefix string that might be a release track name. Returns: ReleaseTrack, The corresponding object or None if the prefix was not a valid release track. N)r8r<)r<tracks r6 FromPrefixReleaseTrack.FromPrefixs$    r5cf[U$![a [SRU55ef=f)zGets a ReleaseTrack from the given release track prefix. Args: id: str, The id string that must be a release track name. Raises: ValueError: For unknown release track ids. Returns: ReleaseTrack, The corresponding object. zUnknown release track id [{}].)r8KeyError ValueErrorformat)rIs r6FromIdReleaseTrack.FromIds;D "  D 7>>rB CCDs %0)r>r=r<N)r/r0r1r2r3r@rFpropertyrIGArY MARKDOWN_BOLDPREVIEWBETAALPHA staticmethodrPrTrZr4r-r5r6r8r8es   "  . K ' ]+J $ m, 5 %  DDr5r8c^\rSrSrSrSr\S5r\RS5r Sr Sr Sr g ) ActionzBA class that allows you to save an Action configuration for reuse.cXlX lg)zCreates the Action. Args: *args: The positional args to parser.add_argument. **kwargs: The keyword args to parser.add_argument. Nargskwargs)r?rhris r6r@Action.__init__sIKr5c URS$Nr)rhrEs r6rD Action.names 99Q<r5cg)zAdds this Action to the given parser. Args: parser: The argparse parser. Returns: The result of adding the Action to the parser. Nr-r?parsers r6 AddToParserAction.AddToParsers r5cg)zQRemoves this Action from the given parser. Args: parser: The argparse parser. Nr-ros r6RemoveFromParserAction.RemoveFromParsers  r5cg)zSets the default value for this Action in the given parser. Args: parser: The argparse parser. default: The default value. Nr-)r?rpdefaults r6 SetDefaultAction.SetDefault r5rgN)r/r0r1r2r3r@r\rDabcabstractmethodrqrtrxr4r-r5r6rdrdsBJ        r5rdc>^\rSrSrSrU4SjrSrSrSrSr U=r $) ArgumentGroupzJA class that allows you to save an argument group configuration for reuse.c<>[[U] "U0UD6 /Ulgr;)superr~r@ argumentsr?rhri __class__s r6r@ArgumentGroup.__init__s -'88DNr5c:URRU5 gr;)rappend)r?args r6 AddArgumentArgumentGroup.AddArgumentsNN#r5cpURU5nURHnURU5 M U$)zAdds this argument group to the given parser. Args: parser: The argparse parser. Returns: The result of parser.add_argument(). ) _CreateGrouprrq)r?rpgrouprs r6rqArgumentGroup.AddToParsers3   f %E~~ ooe Lr5cNUR"UR0URD6$r;) add_grouprhriros r6rArgumentGroup._CreateGroup s   TYY 6$++ 66r5)r) r/r0r1r2r3r@rrqrr4 __classcell__rs@r6r~r~sR 77r5r~c6\rSrSrSrSrSrSrSrSr Sr g ) ArgumentizDA class that allows you to save an argument configuration for reuse.c[R"URUR5H!nURUR ;dMUs $ g)z"Returns the flag object in parser.N) itertoolschain flag_argsancestor_flag_argsrDoption_strings)r?rpflags r6 __GetFlagArgument.__GetFlags@ 0 0&2K2KL d)) ) M r5cNUR"UR0URD6$)zAdds this argument to the given parser. Args: parser: The argparse parser. Returns: The result of parser.add_argument(). ) add_argumentrhriros r6rqArgument.AddToParsers"    9T[[ 99r5cURU5nU(GaRURSnX24/nSUSS-n[R"URUR 5H&nXVR;dMUR XV45 M( URRX$5 UHuprURRURS5 URUR;a%URRUR5 X!R;aURRU5 X!R;dMURRU5 M gg)zORemoves this flag from the given parser. Args: parser: The argparse parser. rz--no-N)_Argument__GetFlagrrrrrr container_handle_conflict_resolvedefaultspopdestdestsremover)r?rprrD conflictsno_nameno_flagr(s r6rtArgument.RemoveFromParser%s$ >>& !D   #d<.i$qr("g__   F55' ,, ,   G- .   nn--d>'!DIIt, 99 $ ,,  dii ( ## #    ! !$ ' ## #    ! !$ ' r5c~URU5nU(aURU0nUR"S0UD6 URn[R "SU[R 5nU(a1SRURS5X&RS55nOUSRU5-nXslgg)zSets the default value for this flag in the given parser. Args: parser: The argparse parser. default: The default flag value. z%(.*The default is ).*?(\.([ \t\n].*))z{}*{}*{}rz The default is *{}*.Nr-) rr set_defaultshelpresearchDOTALLrYr)r?rprwrri original_helpmatchnew_helps r6rxArgument.SetDefaultBs >>& !D  7#f #F#iimii 2M299e $$U[[^Wkk!nM #:#A#A'#JJi r5c2[URS5$)Nhidden)boolrirEs r6IsHiddenArgument.IsHiddenYs  H% &&r5r-N) r/r0r1r2r3rrqrtrxrr4r-r5r6rrsL :(:.'r5rz COMMONLY USEDz --flags-file YAML_FILEaS A YAML or JSON file that specifies a *--flag*:*value* dictionary. Useful for specifying complex flag values with special characters that work with any command interpreter. Additionally, each *--flags-file* arg is replaced by its constituent flags. See $ gcloud topic flags-file for more information.)metavarrwcategoryrz --flattenKEYa Flatten _name_[] output resource slices in _KEY_ into separate records for each item in each slice. Multiple keys and slices may be specified. This also flattens keys for *--format* and *--filter*. For example, *--flatten=abc.def* flattens *abc.def[].ghi* references to *abc.def.ghi*. A resource record containing *abc.def[]* with N elements will expand to N records in the flattened output. This allows us to specify what `resource-key` the `filter` will operate on. This flag interacts with other flags that are applied in this order: *--flatten*, *--sort-by*, *--filter*, *--limit*.)rrwtyperrz--formata Sets the format for printing command output resources. The default is a command-specific human-friendly output format. If both `core/format` and `--format` are specified, `--format` takes precedence. `--format` and `core/format` both take precedence over `core/default_format`. The supported formats are limited to: `{0}`. For more details run $ gcloud topic formats. Run `$ gcloud config set --help` to see more information about `core/format`z`, `)rwrrz LIST COMMANDz--async store_trueasync_zV Return immediately, without waiting for the operation in progress to complete.)actionrrz--filter EXPRESSIONFa` Apply a Boolean filter _EXPRESSION_ to each resource item to be listed. If the expression evaluates `True`, then that item is listed. For more details and examples of filter expressions, run $ gcloud topic filters. This flag interacts with other flags that are applied in this order: *--flatten*, *--sort-by*, *--filter*, *--limit*.)rrequire_coverage_in_testsrrz--limitrT) unlimitedz Maximum number of resources to list. The default is *unlimited*. This flag interacts with other flags that are applied in this order: *--flatten*, *--sort-by*, *--filter*, *--limit*. )rrrrz --page-sizeaM Some services group resource list output into pages. This flag specifies the maximum number of resources per page. The default is determined by the service if it supports paging, otherwise it is *unlimited* (no paging). Paging may be applied before or after *--filter* and *--limit* depending on the service. z --sort-byFIELDa% Comma-separated list of resource field key names to sort by. The default order is ascending. Prefix a field with ``~'' for descending order on that field. This flag interacts with other flags that are applied in this order: *--flatten*, *--sort-by*, *--filter*, *--limit*. )rrrrrz--uria Print a list of resource URIs instead of the default output, and change the command output to a list of URIs. If this flag is used with *--format*, the formatting is applied on this URI list. To display URIs alongside other keys instead, use the *uri()* transform. )rrrrzBINARY BACKED COMMANDz--show-exec-errorz^If true and command fails, print the underlying command that was executed and its exit status.)rrrequiredrrcR\rSrSrSrSrSrSrSrSr Sr Sr Sr Sr SrSrSSjr\S5r\S5r\S 5r\S 5r\S 5r\S 5r\S 5r\S5r\S5r\S5r\S5r\SSj5r\S5r\S5r \S5r!\S5r"Sr#g)_Commoniz!Base class for Command and Group.NFTcSUlXlgrl exit_codeis_group)r?rs r6r@_Common.__init__sDNMr5cg)zPSet up arguments for this command. Args: parser: An argparse.ArgumentParser. Nr-rps r6Args _Common.Argsrzr5cg)zIAdds subclass flags. Args: parser: An argparse.ArgumentParser object. Nr-rs r6_Flags_Common._Flags rzr5cUR$r; _is_hiddenclss r6r_Common.IsHiddens >>r5cUR$)z?Returns whether or not this command or group is auto generated._is_auto_generatedrs r6IsAutoGenerated_Common.IsAutoGenerateds  ! !!r5cUR$r;_universe_compatiblers r6IsUniverseCompatible_Common.IsUniverseCompatibles  # ##r5cUR$r;)_default_universe_compatiblers r6IsDefaultUniverseCompatible#_Common.IsDefaultUniverseCompatible!s  + ++r5cF[R(a UR$gNT)sixPY2_is_unicode_supportedrs r6IsUnicodeSupported_Common.IsUnicodeSupported%s ww  & && r5cUR$r;)_release_trackrs r6r8_Common.ReleaseTrack,   r5cUR$r;)_valid_release_tracksrs r6ValidReleaseTracks_Common.ValidReleaseTracks0s  $ $$r5cP[HnX0R;aM/nURUS-UR-5 UR(a!URUS-UR-5 UH"n[ X5(dM[ X5s s $ M [ XS5$)zGets the attribute value from obj for tracks. The values are checked in ReleaseTrack order. Args: obj: The object to extract attribute from. attribute: The attribute name in object. Returns: The attribute value from obj for tracks. r(N)r8rrrIr<hasattrgetattr)robj attributerSnamesrDs r6GetTrackedAttribute_Common.GetTrackedAttribute4s // /e ll9s?UXX-.  Y_u||34$ 3  # # 34 ((r5cUR$r;_noticesrs r6Notices_Common.NoticesMs <<r5c~UR(d0UlXR;aU(agX RU'gr;r)rtagmsgpreserve_existings r6 AddNotice_Common.AddNoticeQs, <<cl ll0 LLr5cUR$r;_is_deprecatedrs r6 Deprecated_Common.DeprecatedYrr5cXlgr;r)r is_deprecateds r6 SetDeprecated_Common.SetDeprecated]s&r5cRUR(aURR$g)zGet a generator function that can be used to execute a gcloud command. Returns: A bound generator function to execute a gcloud command. N)_cli_generatorGeneraters r6GetCLIGenerator_Common.GetCLIGeneratoras"     ( (( r5c0[RRRR 5(agUR 5(aIUR 5U;a4[RRRR S5 ggg)aEnable self signed jwt feature for the given tracks. The feature can be disabled manually by running `gcloud config set auth/service_account_use_self_signed_jwt false`. Args: tracks: [base.ReleaseTrack], A list of release tracks where self signed jwt feature is enabled. NT)r VALUESauth#service_account_use_self_signed_jwtIsExplicitlySetr8Set)rtrackss r6EnableSelfSignedJwtForTracks$_Common.EnableSelfSignedJwtForTrackslso BBRRTT  c..0F:@@DDTJ;r5r)F)$r/r0r1r2r3rrrrrrrrrrrr@rbrr classmethodrrrrrr8rrr rrrrr&r4r-r5r6rrs) (.*.!% (.    ""$$,, %%))0''KKr5rc6^\rSrSrSrSrU4SjrSrSrU=r $)Groupiz.Group is a base class for groups to implement.Tc(>[[U] SS9 g)NTr)rr*r@)r?rs r6r@Group.__init__s %.r5cg)a"Modify the context that will be given to this group's commands when run. Args: context: {str:object}, A set of key-value pairs that can be used for common initialization among commands. args: argparse.Namespace: The same namespace given to the corresponding .Run() invocation. Nr-)r?contextrhs r6Filter Group.Filters r5r-) r/r0r1r2r3IS_COMMAND_GROUPr@r0r4rrs@r6r*r*s6/   r5r*c^\rSrSrSrSrU4Sjr\S5rSr \ S5r \ RS5rS rS rS rS rU=r$) CommandiaCommand is a base class for commands to implement. Attributes: _cli_do_not_use_directly: calliope.cli.CLI, The CLI object representing this command line tool. This should *only* be accessed via commands that absolutely *need* introspection of the entire CLI. context: {str:object}, A set of key-value pairs that can be used for common initialization among commands. _uri_cache_enabled: bool, The URI cache enabled state. TcN>[[U] SS9 XlX lSUlg)NFr,)rr4r@_cli_do_not_use_directlyr/_uri_cache_enabled)r?clir/rs r6r@Command.__init__s( '4!5!1$'!L#Dr5cUR$r;)r6rEs r6_cli_power_users_onlyCommand._cli_power_users_onlys  ( ((r5c6URRUSS9$)a0Execute a command using the given CLI. Do not introduce new invocations of this method unless your command *requires* it; any such new invocations must be approved by a team lead. Args: args: list of str, the args to Execute() via the CLI. Returns: pass-through of the return value from Execute() F)call_arg_complete)r;Executer?rhs r6ExecuteCommandDoNotUseCommand.ExecuteCommandDoNotUses   % % - -de - LLr5cURR[RRR R 55 g)zFSets the default output format. Args: parser: The argparse parser. N) display_info AddFormatr r coredefault_formatGetrs r6rCommand._Flagss3 !!*"3"3"8"8"G"G"K"K"MNr5cg)zRuns the command. Args: args: argparse.Namespace, An object that contains the values for the arguments specified in the .Args() method. Returns: A resource object dispatched by display.Displayer(). Nr-r@s r6Run Command.Runs r5cUng)Called after resources are displayed if the default format was used. Args: resources_were_displayed: True if resources were displayed. Nr-)r?resources_were_displayedr(s r6EpilogCommand.Epilogs !Ar5cL[R"XS5R5$)zFReturns the key names referenced by the filter and format expressions.N)r DisplayerGetReferencedKeyNamesr@s r6rTCommand.GetReferencedKeyNamess   T . D D FFr5cg)zReturns a function that transforms a command resource item to a URI. Returns: func(resource) that transforms resource into a URI. Nr-rEs r6 GetUriFuncCommand.GetUriFuncs r5)r6r7r/)r/r0r1r2r3 IS_COMMANDr@r\r;rArbrr{r|rKrPrTrWr4rrs@r6r4r4ss *$  ) ) MOO    !Gr5r4c\rSrSrSrSrSrg) TopicCommandiz2A command that displays its own help on execution.cHURURSSS/-5 g)Nrz--document=style=topic)rA command_pathr@s r6rKTopicCommand.Runs. !"!9 :: r5r-N)r/r0r1r2r3rKr4r-r5r6r[r[s :r5r[c(\rSrSrSr\S5rSrg) SilentCommandiz"A command that produces no output.c:URRS5 g)Nnone)rDrErs r6rSilentCommand._Flagss !!&)r5r-N)r/r0r1r2r3rbrr4r-r5r6r`r`s***r5r`c\rSrSrSrSrg)DescribeCommandiz;A command that prints one resource in the 'default' format.r-Nr.r-r5r6rereCr5rec\rSrSrSrSrg) ImportCommandiz5A command that imports one resource from yaml format.r-Nr.r-r5r6rhrhs=r5rhc\rSrSrSrSrg) ExportCommandiz;A command that outputs one resource to file in yaml format.r-Nr.r-r5r6rjrjrfr5rjc\rSrSrSrSrg)DeclarativeCommandiz[[U] "U0UD6 SUlgr)rr|r@r7rs r6r@CacheCommand.__init__!s ,&77"Dr5)r7)r/r0r1r2r3r@r4rrs@r6r|r|s6##r5r|c.\rSrSrSr\S5rSrSrg) ListCommandi&z+A command that pretty-prints all resources.cl[RU5 [RU5 [RU5 [RU5 [ RU5 UR R[RRRR55 g)z[Adds the default flags for all ListCommand commands. Args: parser: The argparse parser. N) FILTER_FLAGrq LIMIT_FLAGPAGE_SIZE_FLAG SORT_BY_FLAGURI_FLAGrDrEr r rFrGrHrs r6rListCommand._Flags)syF#6"v&V$   !!*"3"3"8"8"G"G"K"K"MNr5cRU(d [RRS5 gg)rNzListed 0 items.N)r rvrt)r?rOs r6rPListCommand.Epilog8s $ jj() $r5r-N) r/r0r1r2r3rbrrPr4r-r5r6rr&s3 O O*r5rc\rSrSrSrSrg) CreateCommandiBz!A command that creates resources.r-Nr.r-r5r6rrB)r5rc\rSrSrSrSrg) DeleteCommandiFz!A command that deletes resources.r-Nr.r-r5r6rrFrr5rc\rSrSrSrSrg)RestoreCommandiJz"A command that restores resources.r-Nr.r-r5r6rrJs*r5rc\rSrSrSrSrg) UpdateCommandiNz!A command that updates resources.r-Nr.r-r5r6rrNs)r5rcSUlU$)a1Decorator for hiding calliope commands and groups. Decorate a subclass of base.Command or base.Group with this function, and the decorated command or group will not show up in help text. Args: cmd_class: base._Common, A calliope command or group. Returns: A modified version of the provided class. Tr cmd_classs r6HiddenrTs) r5cSUlU$)auDecorator for making visible calliope commands and groups. Decorate a subclass of base.Command or base.Group with this function, and the decorated command or group will show up in help text. This is the default for base.Command and base.Group subclasses. Args: cmd_class: base._Common, A calliope command or group. Returns: A modified version of the provided class. Frrs r6Visibleres) r5cSUlU$)aDecorator for marking calliope groups as autogenerated. Decorate a subclass of base.Group with this function, and the decorated group will be treated as autogenerated. Args: group_class: base.Group, A calliope group. Returns: A modified version of the provided class. Tr) group_classs r6 Autogeneratedrws$(+ r5cSUlU$)aDecorator for marking calliope commands and groups available in universes. Decorate a subclass of base.Command or base.Group with this function, and the decorated command or group will display help text with information about command or group is supported in universes. Args: cmd_class: base._Common, A calliope command or group. Returns: A modified version of the provided class. Trrs r6UniverseCompatiblers$() r5cSUlU$)aDecorator for marking commands & groups available only in default universe. Decorate a subclass of base.Command or base.Group with this function, and the decorated command or group will display help text with disclaimer information about the command or group is not available in universes. Args: cmd_class: base._Common, A calliope command or group. Returns: A modified version of the provided class. Frrs r6DefaultUniverseOnlyrs$)) r5c"SUlSUlU$)aDecorator for marking commands & groups not available in default universe. Decorate a subclass of base.Command or base.Group with this function, and the decorated command or group will display help text with disclaimer information about the command or group is supported only outside the default universe. Args: cmd_class: base._Common, A calliope command or group. Returns: A modified version of the provided class. TF)rrrs r6NonDefaultUniverseOnlyrs$() +0)( r5c^U4SjnU$)aReturns decorator that sets regional endpoint mode on commands/groups. Args: mode: Value of properties.VALUES.regional.endpoint_mode to set. Returns: Decorator function that modifies the Filter/Run method to set the given endpoint mode for the group/command in question. c>[RRRR 5(aU$U4Sjn[ U[ 5(aU"UR5UlU$U"UR5UlU$)Wrapper Function that creates actual decorated class. Args: cmd_class: base.Command or base.Group subclass to be decorated Returns: The decorated class. c4>^[T5UU4Sj5nU$)Nc>[RR[RRRTS5 T"U0UD6$r;)r r SetInvocationValueregional endpoint_mode)rhkwmoderun_funcs r6 WrappedRunX_RegionalEndpointMode..DecorateCommand..RunDecorator..WrappedRunsA,,    & & 4 4dD B$$$r5r)rrrs` r6 RunDecoratorD_RegionalEndpointMode..DecorateCommand..RunDecorators! X%%r5) r r rrr# issubclassr*r0rK)rrrs r6DecorateCommand._RegionalEndpointMode..DecorateCommandss!!//??AA )U##%i&6&67i #9==1im r5r-)rrs` r6_RegionalEndpointModers8 r5cl[[RRR5nU"U5$r;)rr r r REGIONAL_ONLYr decorators r6RegionalEndpointsOnlyrs)#J$5$5$>$>$L$LM) 9 r5cl[[RRR5nU"U5$r;)rr r rAUTOrs r6RegionalEndpointsPreferredrs)#J$5$5$>$>$C$CD) 9 r5cSUlU$)aeDecorator for calliope commands and groups that support unicode. Decorate a subclass of base.Command or base.Group with this function, and the decorated command or group will not raise the argparse unicode command line argument exception. Args: cmd_class: base._Common, A calliope command or group. Returns: A modified version of the provided class. T)rrs r6UnicodeIsSupportedrs%))! r5c^U4SjnU$)zMark this class as the command implementation for the given release tracks. Args: *tracks: [ReleaseTrack], A list of release tracks that this is valid for. Returns: The decorated function. c(>[T5UlU$)z#Wrapper function for the decorator.)setr)rr%s r6ApplyReleaseTracks)ReleaseTracks..ApplyReleaseTrackss'*&kI# r5r-)r%rs` r6 ReleaseTracksrs r5c^^^UUU4SjnU$)aDecorator that marks a Calliope command as deprecated. Decorate a subclass of base.Command with this function and the decorated command will be modified as follows: - If is_removed is false, a warning will be logged when *command* is run, otherwise an *exception* will be thrown containing error message -Command help output will be modified to include warning/error message depending on value of is_removed - Command help text will automatically hidden from the reference documentation (e.g. @base.Hidden) if is_removed is True Args: is_removed: boolean, True if the command should raise an error when executed. If false, a warning is printed warning: string, warning message error: string, error message Returns: A modified version of the provided class. ct>T(aTnSR[5nOTnSR[5nURX!5 URS5 UUU4Sjn[ U[ 5(aU"UR 5UlOU"UR5UlT(a [U5$U$)rz{0}(REMOVED){0} z{0}(DEPRECATED){0} Tc8>^[T5UUUU4Sj5nU$)Ncd>T(a [T5e[R"T5 T"U0UD6$r;)r+r warning)rhrerror is_removedrrs r6rMDeprecate..DeprecateCommand..RunDecorator..WrappedRunIs- $U+ + G$$$r5r)rrrrrs` r6r9Deprecate..DeprecateCommand..RunDecoratorHs! X%% r5) rYr^rrrr*r0rKr)rr deprecation_tagrrrrs r6DeprecateCommand#Deprecate..DeprecateCommand5s c*11-@o c-44]Co - D!)U##%i&6&67i"9==1im I  r5r-)rrrrs``` r6 Deprecaters<%N r5cBURSS5R5$)aReturns a function that ensures choice flag values match Cloud SDK Style. Args: value: string, string representing flag choice value parsed from command line. Returns: A string value entirely in lower case, with words separated by hyphens. r(-)replacelowervalues r6_ChoiceValueTyper_s sC & & ((r5cDUVs/sHn[U5PM sn$s snf)z4Applies _ChoiceValueType to a collection of choices.)r)iterablexs r6SanitizeChoicesrms '/ 0x! 1 x 00 0sc  U(d [S5e[U[R5(a[U[R 5(a)[ SRSRU555e[R"S5n UV s/sHoRU 5(aMU PM n n U (a)[SRSRU 555e[UUU[UUUUUUU S9 $s sn f)aFReturns Argument with a Cloud SDK style compliant set of choices. Args: name_or_flag: string, Either a name or a list of option strings, e.g. foo or -f, --foo. choices: container, A container (e.g. set, dict, list, tuple) of the allowable values for the argument. Should consist of strings entirely in lower case, with words separated by hyphens. help_str: string, A brief description of what the argument does. required: boolean, Whether or not the command-line option may be omitted. action: string or argparse.Action, The basic type of argeparse.action to be taken when this argument is encountered at the command line. metavar: string, A name for the argument in usage messages. dest: string, The name of the attribute to be added to the object returned by parse_args(). default: string, The value produced if the argument is absent from the command line. hidden: boolean, Whether or not the command-line option is hidden. hidden_choices: list, A subset of 'choices' that should be hidden from documentation. Returns: Argument object with choices, that can accept both lowercase and uppercase user input with hyphens or undersores. Raises: TypeError: If choices are not an iterable container of string options. ValueError: If provided choices are not Cloud SDK Style compliant. zChoices must not be empty.z7Choices must be an iterable container of options: [{}]., z^([a-z0-9]\.?-?)+[a-z0-9]$z^Invalid choices [{}]. Choices must be entirely in lowercase with words separated by hyphens(-)) choicesrrrrrrrwrhidden_choices)rX isinstancecollections_abcIterabler string_types TypeErrorrYjoinrcompilerrr) name_or_flagrhelp_strrrrrrwrr choice_rerinvalid_choicess r6ChoiceArgumentrrsT  1 22 Wo66 7 7 GS-- . . AHH IIg   jj67) 'B1q/AQ/B  , &?+ ,        #  Cs D1Dc## [RR5 [RR[RRR [RRR S5 Sv [RR5 g![RR5 f=f7f)aContext where x-goog-user-project header is not populated. In this context, user's setting of quota_project will be ignored, including settings in: - --billing-project - configuration of billing/quota_project - CLOUDSDK_BILLING_QUOTA_PROJECT quota_project settings by the command group's Filter functions will also be ignored. Use this context when you don't want to send the x-goog-user-project header. Yields: yield to the surrounded code block. N)r r PushInvocationValuesrbilling quota_projectLEGACYPopInvocationValuesr-r5r6WithLegacyQuotars  ((* &&--&&  , ))+J))+sBC B* C * C  C c^[RRRR 5 [RRRR U4Sj5 g)Nc>T$r;r-rsr6._SetUserProjectQuotaFallback..ser5)r r rr ClearCallback AddCallbackrs`r6_SetUserProjectQuotaFallbackrsC ))779 ))55mDr5c^[[RRR5 g)aQDisable the quota project header. This function will set the value for properties.VALUES.billing.quota_project which is used to decide if we want to send the quota project header x-goog-user-project and what value to put in the header. Gcloud's property has multiple layers of fallbacks when resolving its value. Specifically for quota_project property: L1: invocation stack populated by parsing --billing-project. L2: its env variable CLOUDSDK_BILLING_QUOTA_PROJECT L3: user configuration or installation configuration from gcloud config set. L4: value provided by its fallbacks if exists. L5: default value This function sets the value at L4 (fallbacks). It should be used in command group's Filter function so that the command group will work in LEGACY mode (DO NOT send the quota project header). It sets at L4 because: 1. L1-L3 are user settings we want to honor. This func cannot operate in L1-L3 because it will mix with user settings. Whether the setting is from user is an important information when we decide how override works. 2. L4 can override the default value (L5). N)rr r rrr-r5r6DisableUserProjectQuotars2z0088??@r5c^[[RRR5 g)afEnable the quota project header for current project. The project in core/project will be used to populate the quota project header. It should be used in command group's Filter function so that commands in the group will send the current project (core/project) in the quota project header. See the docstring of DisableUserProjectQuota for more information. N)rr r rCURRENT_PROJECTr-r5r6EnableUserProjectQuotarsz0088HHIr5c^[[RRR5 g)aTries the current project and fall back to the legacy mode. The project in core/project will be used to populate the quota project header. It should be used in command group's Filter function so that commands in the group will send the current project (core/project) in the quota project header. If the user does not have the permission to use the project, we will retry the request after removing the quota project header. See the docstring of DisableUserProjectQuota for more information. N)rr r rCURRENT_PROJECT_WITH_FALLBACKr-r5r6"EnableUserProjectQuotaWithFallbackrs!==r5c[RRRR 5[RRR :H$)z=Returns if the CURRENT_PROJECT_WITH_FALLBACK mode is enabled.)r r rrrHrr-r5r6#UserProjectQuotaWithFallbackEnabledr#sB--113    " " @ @Ar5cj[RRRR S5 g)zOpts the command group out of using requests to make HTTP requests. Call this function in the Filter method of the command group to disable requests. TN)r r  transportopt_out_requestsr$r-r5r6OptOutRequestsr+s$  ..2248r5c[5=(au [RRRR 5(+=(a7 [RRR R 5(+$)zReturns True if using requests to make HTTP requests. transport/disable_requests_override is a global switch to turn off requests in case support is buggy. transport/opt_out_requests is an internal property to opt surfaces out of requests. ) UseGoogleAuthr r rrGetBooldisable_requests_overrider-r5r6 UseRequestsr 4s\oN))::BBD DN))CCKKM Mr5cj[RRRR S5 g)zOpt-out the command group to use google auth for authentication. Call this function in the Filter method of the command group to opt-out google-auth. TN)r r r!opt_out_google_authr$r-r5r6OptOutGoogleAuthrCs$  ,,006r5c[RRRR 5=(d2 [RRR R 5(+$)zReturns True if using google-auth to authenticate the http request. auth/disable_load_google_auth is a global switch to turn off google-auth in case google-auth is crashing. auth/opt_out_google_auth is an internal property to opt-out a surface. )r r r!rr disable_load_google_authr-r5r6r r LsP0088:C      8 8 @ @ B r5c [[R"UR555nSR UVVs/sHup4SR X45PM snn5n[ R"SR X55 gs snnf)amLog (to debug) the command/arguments being run in a standard format. `gcloud feedback` depends on this format. Example format is: Running [gcloud.example.command] with arguments: [--bar: "baz"] Args: prog: string, the dotted name of the command being run (ex. "gcloud.foos.list") args: argparse.namespace, the parsed arguments from the command line rz{}: "{}"z!Running [{}] with arguments: [{}]N)sortedr iteritemsGetSpecifiedArgsrrYr debug)progrhspecified_argskv arg_strings r6 LogCommandrYsh#--(=(=(?@A.yynMnda*++A1nMN*)) / 6 6t HINsB c\UR(a6URR5(a[R"S5eg[RR RR 5nU(a,UR5(a[R"S5egg)zProhibit specifying project as a project number. Most APIs accept both project number and project id, some of them accept only project ids. Args: args: argparse.namespace, the parsed arguments from the command line zlThe value of ``--project'' flag was set to Project number.To use this command, set it to PROJECT ID instead.NzThe value of ``core/project'' property is set to project number.To use this command, set ``--project'' flag to PROJECT ID or set ``core/project'' property to PROJECT ID.)projectisdigitr InvalidValueErrorr rFrH)rhprojs r6RequireProjectIDr#ls \\ ||  ( ( ?      ! ! ) ) - - /D    ( ( 9 tr5)TzThis command is deprecated.zThis command has been removed.)NFNNNNFN)r3 __future__rrrr{ collections contextlibenum functoolsrrrsysgooglecloudsdk.callioperr googlecloudsdk.corer r r googlecloudsdk.core.resourcer rrAttributeErrorBACKUP_CATEGORYRESTORE_CATEGORY AI_AND_MACHINE_LEARNING_CATEGORYVERTEX_AI_CATEGORYTENSORBOARD_CATEGORY$API_PLATFORM_AND_ECOSYSTEMS_CATEGORYANTHOS_CLI_CATEGORYANTHOS_AUTH_CATEGORYAPP_ENGINE_CATEGORYBATCH_CATEGORYCOMPOSER_CATEGORYCOMPUTE_CATEGORYDATA_ANALYTICS_CATEGORYDATABASES_CATEGORYGDCC_ZONE_CATEGORYIDENTITY_AND_SECURITY_CATEGORYINTERNET_OF_THINGS_CATEGORYMANAGEMENT_TOOLS_CATEGORYMOBILE_CATEGORYNETWORKING_CATEGORYNETWORK_SECURITY_CATEGORYSDK_TOOLS_CATEGORYDISKS_CATEGORY INFO_CATEGORYINSTANCES_CATEGORYLOAD_BALANCING_CATEGORYTOOLS_CATEGORYSTORAGE_CATEGORYTRANSFER_CATEGORYBILLING_CATEGORYSECURITY_CATEGORYIDENTITY_CATEGORYBIG_DATA_CATEGORYCI_CD_CATEGORYMONITORING_CATEGORYSOLUTIONS_CATEGORYSERVERLESS_CATEGORYUNCATEGORIZED_CATEGORYCOMMERCE_CATEGORY"DECLARATIVE_CONFIGURATION_CATEGORYMICROSERVICES_CATEGORY WEB3_CATEGORY SAAS_CATEGORYr^MARKDOWN_ITALIC MARKDOWN_CODEErrorr+uniqueEnumr8with_metaclassABCMetaobjectrdr~rCOMMONLY_USED_FLAGSFLAGS_FILE_FLAGArgList FLATTEN_FLAGrYrSupportedFormats FORMAT_FLAGLIST_COMMAND_FLAGS ASYNC_FLAGr BoundedIntmaxsizerrrrBINARY_BACKED_COMMAND_FLAGSrprr*r4r[r`rerhrjrlrnr|rrrrrrrrrrrrrrrrrrrrcontextmanagerrrrrrrrr rr rr#r-r5r6rms5&'   /+*#*9  OO/ #<  0'D$"$"*  !82.".   *" " %F"(    F:++F\D499\D \D~, S   V 4, ^7F78J'vJ'b&    ;         /  $    &v $5578  $       #  +     3;;$ ?#       3;;$ ?#        #      #   6    ( 1 OKc  f5OKd G (Nc  g6Nb3%%ckk7;*C&&s{{G<*Dc((g>D>C&&s{{G<>DC&&s{{G<DE++CKKAE#,,S[['B,#3%%ckk7;#*#$$S[[,?*8*L-**L-*+\=+M "$"$$&&R  $( ) *EP )1     Qh ,,6EA8 J  9 7 J&G* / s Q66RR