SrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSKJ r SSKJ r SS K J r SS K Jr SSKrSS KJr SS KJr SS KJr SSKrSr\R,"S5r\R,"SR1\S95r\R,"S5rSrSrSr"SS\5r"SS\5r "SS\5r!"SS\5r""SS\5r#"S S!\5r$"S"S#\5r%"S$S%\ R>\5r&"S&S'\&5r'"S(S)\&5r("S*S+\&5r)"S,S-\&5r*"S.S/\&5r+"S0S1\,5r-"S2S3\,5r.S4r/S5r0"S6S7\&5r1"S8S9\15r2"S:S;\15r3"S<S=\15r4"S>S?\15r5"S@SA\15r6"SBSC\,5r7SDr8"SESF\,5r9\9"5r:SGr;SHrg)KajManage parsing resource arguments for the cloud platform. The Parse() function and Registry.Parse() method are to be used whenever a Google Cloud API resource is indicated in a command-line argument. URLs, bare names with hints, and any other acceptable spelling for a resource will be accepted, and a consistent python object will be returned for use in code. )absolute_import)division)unicode_literalsN) apis_internal) apis_util)resource) exceptions) properties)map)urllib)zipz[a-zA-Z_]+(?:\.[a-zA-Z0-9_]+)+z!(https?://[^/]+/[^/]+/[^/]+/)(.+)z!(?P{collection})\.get collectionz^gs://([^/]*)(?:/(.*))?$z&https://www.googleapis.com/storage/v1/z*https://storage.googleapis.com/storage/v1/zhttps://storage.googleapis.com/c\rSrSrSrSrg)Error8zExceptions for this module.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r$lib/googlecloudsdk/core/resources.pyrr8s#rrc\rSrSrSrSrg)_ResourceWithoutGetException<z+Exception for resources with no Get method.rNrrrrrr<s3rrc,^\rSrSrSrU4SjrSrU=r$)BadResolverException@z6Exception to signal that a resource has no Get method.cF>[[U] SRUS95 g)Nzbad resolver for [{param}])param)superr!__init__format)selfr$ __class__s rr&BadResolverException.__init__Cs$ .$++%+8:rrrrrrrr&r __classcell__r)s@rr!r!@s>::rr!c,^\rSrSrSrU4SjrSrU=r$)AmbiguousAPIExceptionHz5Exception for when two APIs try to define a resource.cZ>[[U] SRU[ U5S95 g)Nz:collection [{collection}] defined in multiple APIs: {apis})rapis)r%r/r&r'repr)r(r base_urlsr)s rr&AmbiguousAPIException.__init__Ks1 /DKK!i L "#rrr+r-s@rr/r/Hs=##rr/c,^\rSrSrSrU4SjrSrU=r$)AmbiguousResourcePathRz[[U] SRX55 g)NzOThere already exists parser {0} for same path, can not register another one {1})r%r7r&r')r(parser1parser2r)s rr&AmbiguousResourcePath.__init__Us# / ++16'+CErrr+r-s@rr7r7RsDEErr7c,^\rSrSrSrU4SjrSrU=r$)#ParentCollectionResolutionException[zMException for when the parent collection cannot be computed automatically. cf>[[U] SRUSR U5S95 g)NzuCould not resolve the parent collection of collection [{collection}]. No collections found with parameters [{params}], rparams)r%r>r&r'join)r(rrCr)s rr&,ParentCollectionResolutionException.__init___s6 -t= ::@&!$))F*;;A;=>rrr+r-s@rr>r>[s>>rr>c,^\rSrSrSrU4SjrSrU=r$)!ParentCollectionMismatchExceptionfzGException when the parent collection does not have the expected params.c >[[U] SRX!SR U5SR U5S95 g)NzThe parent collection [{parent_collection}] of collection [{collection}] does have have the expected parameters. Expected [{expected_params}], found [{actual_params}].rA)parent_collectionrexpected_params actual_params)r%rGr&r'rD)r(rrJrKrLr)s rr&*ParentCollectionMismatchException.__init__isB +T; 88>/ IIo6))M29?945rrr+r-s@rrGrGfsO55rrGc\rSrSrSrSrg) UserErrortz)Exceptions that are caused by user input.rNrrrrrOrOts1rrOc0^\rSrSrSrSU4SjjrSrU=r$)InvalidResourceExceptionxz5A collection-path that was given could not be parsed.ch>SRUS9nU(aUSU-- n[[U]U5 g)Nz!could not parse resource [{line}]linez: )r'r%rRr&)r(rVreasonmessager)s rr&!InvalidResourceException.__init__{s7188d8CG  g "D27;rrNr+r-s@rrRrRxs=<[[U] SRXUS95 X lX0lg)NzGwrong collection: expected [{expected}], got [{got}], for path [{path}]expectedgotpath)r%r\r&r'rarb)r(r`rarbr)s rr&)WrongResourceCollectionException.__init__s8 *D: T34HIr)rarbr+r-s@rr\r\s?rr\c,^\rSrSrSrU4SjrSrU=r$)RequiredFieldOmittedExceptionz6A command line that was given did not specify a field.cF>[[U] SRX!S95 g)Nz_value for field [{expected}] in collection [{collection_name}] is required but was not provided)r`collection_name)r%rer&r')r(rhr`r)s rr&&RequiredFieldOmittedException.__init__s, '7 ((.)/)@Arrr+r-s@rreres>AArrec,^\rSrSrSrU4SjrSrU=r$)UnknownCollectionException;A command line that was given did not specify a collection.cF>[[U] SRUS95 g)Nzunknown collection for [{line}]rU)r%rkr&r')r(rVr)s rr&#UnknownCollectionException.__init__s$ $d4)00d0;=rrr+r-s@rrkrksC==rrkc0^\rSrSrSrSU4SjjrSrU=r$)InvalidCollectionExceptionrmc|>SRUS9nU(aUSRUS9- n[[U]U5 g)Nz!unknown collection [{collection}]rz for API version [{version}])version)r'r%rqr&)r(r api_versionrXr)s rr&#InvalidCollectionException.__init__sB188J8OG /66{6KKg $d4W=rrrZr+r-s@rrqrqsC>>rrqcD\rSrSrSrSrS SjrS SjrSrSr S r g) _ResourceParserzFClass that turns command-line arguments into a cloud resource message.cXlX lg)zCreate a _ResourceParser for a given collection. Args: registry: Registry, The resource registry this parser belongs to. collection_info: resource_util.CollectionInfo, description for collection. N)registrycollection_info)r(r{r|s rr&_ResourceParser.__init__sM*rNc [R"U5nURRU5n[R "XQ5nU(d0[ USRURRU55eURRU5nUR5nU(a$[[RRU5n[UR URU[#[%Xx55US9$)aParse relative name into a Resource object. Args: relative_name: str, resource relative name. base_url: str, base url part of the api which manages this resource. subcollection: str, id of subcollection. See the api resource module (googlecloudsdk/generated_clients/apis/API_NAME/API_VERSION/resources.py). url_unescape: bool, if true relative name parameters will be unescaped. Returns: Resource representing this name. Raises: InvalidResourceException: if relative name doesn't match collection template. zBIt is not in {0} collection as it does not match path template {1}) param_values endpoint_url)rUniversifyAddressr| GetPathRegExrematchrRr' full_name GetParamsgroupsr r parseunquoteResourcer{dictr ) r( relative_namebase_url subcollection url_unescape path_templaterrCfieldss rParseRelativeName!_ResourceParser.ParseRelativeNames$..x8H((55mDM HH] 2E  $  N 6$&&00- @ BB ! ! + +M :F \\^F6<<''0f DMM4#7#7!%c&&9!:!) ++rcb^[R"U5nTbURTX4S9$URRU5n [UR55RU 5(dP[SR[UR55[U 5URR 55e[#5(a[$R'TURR US9n U R(n [+U 5[+U 5:a*[-TU U R.(aU R0S9eSS9e[+U 5[+U 5:aU S/[+U 5[+U 5- -- n [3U 5n OS/[+U 5-n TU S'[5[7X55n U R95HRupUbM UR;U5nU(a[=U5(aU"5OUX'M?U(dMHU"U5X'MT [?UR@URUX5nU$![af URR U5nUR U5n[U4SjU55n U (a[SRT55eGNf=f) aGiven a command line and some keyword args, get the resource. Args: resource_id: str, Some identifier for the resource. Can be None to indicate all params should be taken from kwargs. kwargs: {str:(str or func()->str)}, flags (available from context) or resolvers that can help parse this resource. If the fields in collection-path do not provide all the necessary information, kwargs will be searched for what remains. base_url: use this base url (endpoint) for the resource, if not provided default corresponding api version base url will be used. subcollection: str, name of subcollection to use when parsing this path. validate: bool, Validate syntax. Use validate=False to handle IDs under construction. An ID can be: fully qualified - All parameters are specified and have valid syntax. partially qualified - Some parameters are specified, all have valid syntax. under construction - Some parameters may be missing or too short and not meet the syntax constraints. With additional characters they would have valid syntax. Used by completers that build IDs from strings character by character. Completers need to do the string => parameters => string round trip with validate=False to handle the "add character TAB" cycle. default_resolver: func(str) => str, a default param resolver function called if kwargs doesn't resolve a param. Returns: protorpc.messages.Message, The object containing info about this resource. Raises: InvalidResourceException: If the provided collection-path is malformed. WrongResourceCollectionException: If the collection-path specified the wrong collection. RequiredFieldOmittedException: If the collection-path's path did not provide enough fields. GRIPathMismatchException: If the number of path segments in the GRI does not match the expected format of the URL for the given resource collection. ValueError: if parameter set in kwargs is not subset of the resource parameters. Nrrc32># UH oS-T;v M g7f)/Nr).0prefix resource_ids r 2_ResourceParser.ParseResourceId..s"E6CFSLK 'mszInvalid value: {}zPProvided params {} is not subset of the resource parameters {} for collection {}rvalidater)!rrrrRr|GetPathGetFieldNamesFromPathallrOr'rsetkeysissubset ValueErrorsortedr_GRIsAreEnabledGRI FromString path_fieldslenGRIPathMismatchExceptionis_fully_qualifiedrreversedrr itemsgetcallablerr{)r(rkwargsrrrdefault_resolverrb path_prefixescontains_all_fieldsrCgrirrr$valueresolverrefs ` rParseResourceId_ResourceParser.ParseResourceIdsX..x8H %% (&I I ! ! + +M :F v{{}  & &v . .   6&'&&00 2 33  NN;&*&:&:&D&D$,  .cf Vs6{ "& ),)?)?s~~K KEIK K v;V $4&CK#f+566fvF #ffRjF+,L$**,   E"h ,4X,>,>hjH   .u5 - 4==$"6"6  +C Jm& ##++M:2248 !"E6C"EE -44[AB B  sH>>A,J.-J.c[URS55VVs/sHup#US-S:XdMU(dMUPM snn$s snnf)zExtract field names from uri template path. Args: path: str, uri template path. Returns: list(str), list of field names in the template path. rr) enumeratesplit)r(rbidxrs rr%_ResourceParser.GetFieldNamesFromPathBsR#, JJsO# #;3 7a< " #  sAAAcSnURRHnSRXS9nM SRURRUS9$)Nz[{path}]/{param})rbr$z[{collection}::]{path})rrb)r|rCr'r)r(path_strr$s r__str___ResourceParser.__str__Qs[H%%,,#***Fh- # * *''11 + BBr)r|r{)NrF)NrTN) rrrrrr&rrrrrrrrrxrxs3N+JO +FAE'+gR Brrxc^\rSrSrSrSrU4SjrSrSrSr Sr SS jr S r S r S rSS jrSrSrSrSrSrSrU=r$)riYz#Information about a Cloud resource.cXlX lU(aXPlO%[R"UR 5UlX0lURU5UlURU5Ul [R"U5H*upgUc[URU5e[XU5 M, SR!UR["R$"URUR'555UlURR*S;a.[,R.R1UR(5UlSUlg)aCreate a Resource object that may be partially resolved. To allow resolving of unknown params to happen after parse-time, the param resolution code is in this class rather than the _ResourceParser class. Args: registry: Registry, The resource registry this parser belongs to. collection_info: resource_util.CollectionInfo, The collection description for this resource. subcollection: str, id for subcollection of this collection. param_values: {param->value}, A list of values for parameters. endpoint_url: str, override service endpoint url for this resource. If None default base url of collection api will be used. Raises: RequiredFieldOmittedException: if param_values have None value. Nz{0}{1})computestoragecertificatemanagerT) _registry_collection_info _endpoint_urlrrr_subcollectionr_pathr_paramssix iteritemsrersetattrr' uritemplateexpandAsDict _self_linkapi_namer rr _initialized)r(r{r|rrrr$rs rr&Resource.__init__\s &N+'(::  " "d( ((7DJ",,];DL l3  +O,E,EuMM d5!4 oo K..tzz4;;=IKDO %%*@@ ,,T__=doDrc|>[USS5b[SRU55e[[U]X5 g)Nrzt^T*6  //5vc{ << (D%c1rc6[SRU55e)Nz?Cannot delete attribute {0}. Resource references are immutable.)rr')r(rs r __delattr__Resource.__delattr__s  --3VC[ ::rcxURRnUR(aUS-UR-$U$)N.)rrr)r(rs r CollectionResource.Collections8&&00J  #  3 3 33 rcUR$rZ)rr(s rGetCollectionInfoResource.GetCollectionInfos   rcVUR(a[XRS5$g)Nrrrrs rName Resource.Names  || T<<+ ,, rc :U(a[RROSn[URVs/sHnX2"[ X5SS94PM sn5n[RR [R"URU55$s snf)aRelative resource name. A URI path ([path-noscheme](http://tools.ietf.org/html/rfc3986#appendix-A)) without the leading "/". It identifies a resource within the API service. For example: "shelves/shelf1/books/book2" Args: url_escape: bool, if true would url escape each parameter. Returns: Unescaped part of SelfLink which is essentially base_url + relative_name. For example if SelfLink is https://pubsub.googleapis.com/v1/projects/myprj/topics/mytopic then relative name is projects/myprj/topics/mytopic. cU$rZr)xsafes r'Resource.RelativeName..srr)r) r rquoterrrrrrr)r( url_escape escape_funckeffective_paramss r RelativeNameResource.RelativeNames")3&,,$$8IK,, Q [) 3 4 ! <<  4::'78 :: sBc [R"URVs/sHo[X5/PM sn5$s snf)z5Returns resource reference parameters and its values.) collections OrderedDictrrr(r$s rrResource.AsDicts=  " "7;|| 7CeGD( )|   s<cXURVs/sHn[X5PM sn$s snf)z"Returns resource reference values.rrs rAsListResource.AsLists#.2ll ;lUGD l ;; ;s'cUR$)zReturns URI for this resource.rrs rSelfLinkResource.SelfLinks ??rcURSSnURRURRURR nU(aAX1nURRS5nXR:wa[UR5XU5eO[R"U5HSupgURRS5U:XdM&URRS5UR;dMQUn O U(dB[R"U5H(upgURRS5U:XdM&Un O U(d[!UR5U5eUVs0sHo[#X5_M n nURR%SU US9n U $![ a [U5ef=fs snf)aGets a reference to the parent of this resource. If parent_collection is not given, we attempt to automatically determine it by finding the collection within the same API that has the correct set of URI parameters for what we expect. If the parent collection cannot be automatically determined, it can be specified manually. Args: parent_collection: str, The full collection name of the parent resource. Only required if it cannot be automatically determined. Raises: ParentCollectionResolutionException: If the parent collection cannot be determined or doesn't exist. ParentCollectionMismatchException: If the given or auto-resolved parent collection does not have the expected URI parameters. Returns: Resource, The reference to the parent resource. Nrrr)rrparsers_by_collectionrrruKeyErrorrkr|rrGrrrrrr>rParse) r(rJ parent_paramsall_collections parent_parseractual_parent_paramsrparserrparent_param_valuesrs rParentResource.Parents*LL"%Mnn:: &&((,(=(=(I(IKO<': +::DDRH  ./ OO 0 " " /!$ o > *  " " , ,R 0M A  " " * *2 .$** <(   !? "%--"@ J  # # - -b 1] B *  #A1 OO }. .9FF 1gd.. F ..  t%8*;  =C J9<():;;<2GsF+7G+GcUR$rZrrs rrResource.__str__  ??rcp[U[5(a!UR5UR5:H$gNF) isinstancerr r(others r__eq__Resource.__eq__ s*%"" ]]_ 0 00 rcDUR5UR5:$rZ)r rs r__lt__Resource.__lt__s ==?U^^- --rc,[UR5$rZ)hashrrs r__hash__Resource.__hash__s   rcUR$rZrrs r__repr__Resource.__repr__rr)rrrrrrrr)FrZ)rrrrrr&rrrrrrrrr rrrr"r&r)rr,r-s@rrrYs]+*X2:  ! :4< :x .!rrc[RRRR 5=(d5 [RRR R 5S:H$)z!Returns True if GRIs are enabled.r)r VALUEScore enable_griGetBoolresource_completion_styleGetrrrrrsO    + + 3 3 5 J    : : > > @E IKrc*URS5S$)zGet the API name from a collection name like 'api.parents.children'. Args: collection: str, The collection name. Returns: str: The API name. rr)rrs r_APINameFromCollectionr3"s   # q !!rc\rSrSrSrSrg) GRIExceptioni.z*Base class for all GRI related exceptions.rNrrrrr5r5.s2rr5c,^\rSrSrSrU4SjrSrU=r$)InvalidGRIFormatExceptioni3z2Exception for when a GRI is syntactically invalid.cF>[[U] SRUS95 g)NzlThe given GRI [{gri}] is invalid and could not be parsed. Valid GRIs take the form of: a:b:c::api.collection)r)r%r7r&r')r(rr)s rr&"InvalidGRIFormatException.__init__6s# #T3 ==CVV_rrr+r-s@rr7r73s:rr7c,^\rSrSrSrU4SjrSrU=r$)#InvalidGRICollectionSyntaxExceptioni=zLException for when the collection part of a GRI is syntactically invalid. cF>[[U] SRXS95 g)NzZThe given GRI [{gri}] could not be parsed because the collection [{collection}] is invalid)rr)r%r;r&r')r(rrr)s rr&,InvalidGRICollectionSyntaxException.__init__As$ -t= $$*FsF$Jrrr+r-s@rr;r;=rr;c,^\rSrSrSrU4SjrSrU=r$)GRICollectionMismatchExceptioniHzLException for when the parsed GRI collection does not match the expected. cJ>[[U] SRUUUS95 g)NzThe given GRI [{gri}] could not be parsed because collection [{expected_collection}] was expected but [{parsed_collection}] was provided. Provide a GRI with the correct collection or drop the specified collection.)rexpected_collectionparsed_collection)r%r@r&r')r(rrBrCr)s rr&'GRICollectionMismatchException.__init__Ls2 ($8 !'3;N9J!'!L rrr+r-s@rr@r@Hsrr@c,^\rSrSrSrU4SjrSrU=r$)InvalidGRIPathSyntaxExceptioniWzMException for when a part of the path of the GRI is syntactically invalid. cF>[[U] SRXS95 g)NzPThe given GRI [{gri}] could not be parsed because the path is invalid: {message})rrX)r%rFr&r')r(rrXr)s rr&&InvalidGRIPathSyntaxException.__init__[s$ '7 VV5rrr+r-s@rrFrFWr>rrFc0^\rSrSrSrSU4SjjrSrU=r$)ribz=Exception for when the path has the wrong number of segments.c >[[U] SRUSR [ U55U(aSU-OS-S95 g)NzxThe given GRI [{gri}] does not match the required structure for this resource type. It must match the format: [{format}]:::r)rr')r%rr&r'rDr)r(rrCrr)s rr&!GRIPathMismatchException.__init__esI "D2 > C(6*:!;7A$"3r"K MrrrZr+r-s@rrrbsErrc\rSrSrSrS SjrSr\SSj5r\SSj5r \S5r \S 5r \S 5r \S 5r S rg)rinaoEncapsulates a parsed GRI string. Attributes: path_fields: [str], The individual fields of the path portion of the GRI. collection: str, The collection portion of the GRI. is_fully_qualified: bool, True if the original GRI included the collection. This could be false if the collection is not defined, or if it was passed in explicitly during parsing. Nc@XlX lU=(a USLUlg)z$Use FromString() to construct a GRI.N)rrr)r(rrrs rr& GRI.__init__ys" O0KZt5KDrcSRURVs/sHnURU5PM sn5RS5nUR(aUSUR -- nU$s snf)NrKrL)rDr_EscapePathSegmentrstriprr)r(srs rr GRI.__str__sn ((!--/-++A.-/ 006s   TDOO ##c J /sA0cURXS9upEU(dUnO.U(a'URX5 U(aXR:wa [XUS9eURU5n[ Xb[ U5S9$)aParses a GRI from a string. Args: gri: str, The GRI to parse. collection: str, The collection this GRI is for. If provided and the GRI contains a collection, they must match. If not provided, the collection in the GRI will be used, or None if it is not specified. validate: bool, Validate syntax. Use validate=False to handle GRIs under construction. Returns: A parsed GRI object. Raises: GRICollectionMismatchException: If the given collection does not match the collection specified in the GRI. )r)rBrC)r)_SplitCollection_ValidateCollectionr@ _SplitPathrbool)clsrrrrbrCrs rrGRI.FromStrings{&"2232JD %j  c. 0>, /1 1..&K D9J4K MMrcfU(dg[R"SU5n[U5S:a [U5e[U5S:Xa"USUSpTU(aUR X5 OUSSpTU(a8UR S5(dUR S5(a [US5eXE4$) aSplits a GRI into its path and collection segments. Args: gri: str, The GRI string to parse. validate: bool, Validate syntax. Use validate=False to handle GRIs under construction. Returns: (str, str), The path and collection parts of the string. The collection may be None if not specified in the GRI. Raises: InvalidGRIFormatException: If the GRI cannot be parsed. InvalidGRIPathSyntaxException: If the GRI path cannot be parsed. )NNz6(?=(?<={)::+[^:}]|(?<=[^:{])::+}|(?<=[^:{])::+[^:}])::rrNrKz%GRIs cannot have empty path segments.)rrrr7rX startswithendswithrF)r[rrpartsrbrCs rrWGRI._SplitCollections"   HHN E 5zA~ %c ** Uq %a%(   7 %a$ T__S))T]]3-?-? ) 6 88  ""rcR[R"SU5(d [X5eg)Nz^\w+\.\w+(?:\.\w+)*$)rrr;)r[rrs rrXGRI._ValidateCollections& 88+Z 8 8 / @@ 9rcU(d/$[R"SU5nUVs/sHo0RU5PM sn$s snf)zSplits a GRI into its individual path segments. Args: path: str, The path segment of the GRI (from _SplitCollection) Returns: [str], A list of the path segments of the GRI. z2(?=(?<={):+[^:}]|(?<=[^:{]):+}|(?<=[^:{]):+[^:}]):)rr_UnescapePathSegment)r[rbraparts rrYGRI._SplitPathsE  i HHJ E8= =ut $ $T *u == =sAc2[R"SSU5$)Nz{(:+)}z\1rsubr[segments rrfGRI._UnescapePathSegments 66)UG ,,rc2[R"SSU5$)Nz(:+)z{\1}rjrls rrRGRI._EscapePathSegments 66'7G ,,r)rrrr)NT)T)rrrrrr&r classmethodrrWrXrYrfrRrrrrrrnsL $M$ML*#*#XAA >>&----rrc[RRRU5R 5n[ U5$![R a gf=f)z5Check if a URL is the result of an endpoint override.F)r r,api_endpoint_overridesPropertyr1NoSuchPropertyErrorrZ)rendpoint_overrides rHasOverriddenEndpointrwsX"))@@II#%     ' ' s7AAAc\rSrSrSrSSjrSrSSjrSrSr SS jr SS jr SS jr SS jr SS jrSSjrSSjrSrSrg)Registryi aKeep a list of all the resource collections and their parsing functions. Attributes: parsers_by_collection: {str: {str: {str: _ResourceParser}}}, All the resource parsers indexed by their api name, api version and collection name. parsers_by_url: {str: {str: }}, URL parsing tries indexed by api name and api version. Each key within a trie can be either a constant or a parameter name and represents a possible URL token after the API's base URL. At the end, a key of None indicates the value is a _ResourceParser. registered_apis: {str: str}, The most recently registered API version for each API. For instance, {'dns': 'v1', 'compute': 'alpha'}. NcdU=(d 0UlU=(d 0UlU=(d 0UlgrZr parsers_by_urlregistered_apis)r(r r|r}s rr&Registry.__init__s)!6!<"D(.BD*0bDrcp[URURURR 5S9$)zClones this registry. Clones share the same underlying parser data and differ only in which API versions were most recently registered. Returns: Registry, The cloned registry. r{)ryr r|r}copyrs rCloneRegistry.Clones5 "88**,,113 55rc:URRUS5nUc U(aUnO[R"U5nX RRU05;a.[R "X5HnUR U5 M X RU'U$)zRegister the given API if it has not been registered already. Args: api_name: str, The API name. api_version: str, The API version, None for the default version. Returns: api version which was registered. N)r}rr_GetDefaultVersionr _GetApiCollections_RegisterCollection)r(rruregistered_versionrs rRegisterApiByNameRegistry.RegisterApiByName-s--11(DA ( #66x@ 44882FF%88O*   ,P&1" rc,URnURn[X5nURR U05R U05nUR nU(dSUR 0n[R"U5HupxURU(aSU-OS-n URU 5n U b,[U URU RR/5eXEU 'UR(dMwURX#XtU5 M g)a#Registers given collection with registry. Args: collection_info: CollectionInfo, description of resource collection. Raises: AmbiguousAPIException: If the API defines a collection that has already been added. AmbiguousResourcePath: If api uses same path for multiple resources. rrN)rrurxr  setdefault flat_pathsrbrrrrr/rr|enable_uri_parsing_AddParserForUriPath) r(r|rrurcollection_parserscollection_subpathssubnamerbrhexisting_parsers rrRegistry._RegisterCollectionGs ''H!--K T 3F44??"M%:k26)44 !5!56':; '11"#-,o*..?o  $#O%4%=%=%4%D%D%M%M%OP P-3)  + + + !!($Ostr)}, flags (available from context) or resolvers that can help parse this resource. If the fields in collection-path do not provide all the necessary information, kwargs will be searched for what remains. validate: bool, Validate syntax. Use validate=False to handle IDs under construction. An ID can be: fully qualified - All parameters are specified and have valid syntax. partially qualified - Some parameters are specified, all have valid syntax. under construction - Some parameters may be missing or too short and not meet the syntax constraints. With additional characters they would have valid syntax. Used by completers that build IDs from strings character by character. Completers need to do the string => parameters => string round trip with validate=False to handle the "add character TAB" cycle. api_version: str, The API version, None for the default version. default_resolver: func(str) => str, a default param resolver function called if kwargs doesn't resolve a param. Returns: protorpc.messages.Message, The object containing info about this resource. Raises: InvalidCollectionException: If the provided collection-path is malformed. UnknownCollectionException: If the collection of the resource could not be determined. rrrr^N)rr) rrrrrkr GetApiBaseUrlr|rrurrr) r(rrrrrurrrparser_collectionrs rrRegistry.ParseResourceIdsH >> x"AAK  &{ 33  ( ( ( MFV33<<#33??AH..88M Z0 %6!7!9!:;m  ! !+x+33C " EErc[U5nURX2S9nURRU05RU05RUS5nUc [ X5eUR $)Nr)r3rr rrqr|)r(rhrurrs rrRegistry.GetCollectionInfosn%o6H(((KK((s8R ["!5s?D) ~ & DD  ! !!rc[RU5nU(d [USS9e[R"U5upEnU=(d Un[ R "U5nX';a@[U5(a0URRU[ R"U55nX';a[USRU55eXB/URS5-nUS[U5*n UR!XBS9 /n UR$n ['U5HupX;aXn MS0p[(R*"U 5H upUS :XdM O [US RU 5S9e[U5S :XaKSU;aESR-XS5n U R/[0R2R5U 55 Un O4U R/[0R2R5U 55 Un M SU ;a [US 5eU Sunn[7[9UR:R=U5U 55n UR?SXUS 9$![Ra [USRU55ef=f![Ra [USRU55e[R"a [USRU55ef=f)aParse a URL into a Resource. Searches self.parsers_by_url to find a _ResourceParser. The parsers_by_url attribute is a deeply nested dictionary, indexed by API name, API version, then a series of keys corresponding to URL segments (split on '/') after the API's base URL. Each of these keys can be either a literal segment (e.g. "projects" in "https://compute.googleapis.com/compute/v1/projects/{projectsId}/..."), in which case it must match exactly, or a wildcard parameter ("{}"), in which case it can match any token. For the URL provided, the API name (and if unspecified, the API version) is extracted from the base URL, then a path down the tree is followed, branching at each remaining token in the URL. If there are no URL tokens left, and one of the keys at the current level is None, the None points to a _ResourceParser that can turn the collected params into a Resource. Args: url: str, The URL of the resource. api_version: str, The API client version to use for parsing. For channel-based versioned clients, this argument is not needed as it can always be inferred from the URL. For interface-based versioned clients (as of 2024), this argument can be used to explicitly specify a client version (since multiple clients can share the same URL API version). If not provided, defaults to the API version in the URL. Returns: Resource, The resource indicated by the provided URL. Raises: InvalidResourceException: If the provided URL could not be turned into a cloud resource. zunknown API host)rWzunknown api {}zunknown api version {}rNrrrzCould not parse at [{}]r^zUrl too short.r) _URL_RErrR resource_utilSplitEndpointUrlr _GetVersionsrUnknownAPIErrorr'rwr}rrrrrUnknownVersionErrorr|rrrrDappendr rrrr r|rr)r(urlrurrurl_api_version resource_pathversionsrendpointrCrirr$ next_levelrrs rParseURLRegistry.ParseURLsB MM# E  $S1C DD &&s+-H}0KM++H5h" x ( (**.. m66x@B " $ '..{; == $}':':3'? ?F'S''(H= X?F##If%  $ bZ"}}Y7 % D=  8' 188?A A ZA $*"4$ fll**512   mmFLL((/0i5&: 9 $S*: ;;%dOM6 #f,,66}EvN OF  ! ! f# " %%{  $ $M $S*:*A*A(*K LLM(  $ $M $S*:*A*A(*K LL  ( (= $ '..{; ===s I,J0I>AKcURX$S9n[URRURR5nURR U5nUR XXs5$)z:Parser relative names. See Resource.RelativeName() method.r)rrr|rruGetSubcollectionr)r(rrrrurrrs rrRegistry.ParseRelativeNameHsm ( ( ( MFV33<<#33??AH**;;JGM  # # >>rc[RU5nU(d [US5eURS5(aLU(aUS:wa [ SUU5eUR SSURS5URS5S.S9$U(aUS:wa [ SX!5eUR SSS URS50S9$) z;Parse gs://bucket/object_path into storage.v1 api resource.zNot a storage urlrstorage.objectsNr^bucketobjectrrrstorage.bucketsr) _GCS_URL_RErrRgroupr\r)r(rrrs rParseStorageURLRegistry.ParseStorageURLSs   c "E  $S*= >> {{1~~  &77./@*/24 4  ! !&!KKNekk!nE"GG j$55 ,-> PP   $%++a.)  ++rc U(aURS5(dURS5(a]URX5nU(aBU(a;UR5U:wa'[UUR5UR5S 9eU$URS5(aURXS9$U(aUbU(d [U5eURX1U=(d 0UUUS9$![Gavn Sn [R"[ 5n [R"[ 5n [R"[5n URU 5(a=U[U 5SRSS5upnnO![a U ef=fX4S:waeOURU 5(aU[U 5SRSS5upnnO![a U ef=fX4S:waeO]![aPn U[U 5SnSU;aURSS5un nSn A O%URSSS U0S 9sSn A sSn A $Sn A ff=fU bURS SU WS .S 9sSn A $eSn A ff=f)aParse a Cloud resource from a command line. Args: line: str, The argument provided on the command line. params: {str:(str or func()->str)}, flags (available from context) or resolvers that can help parse this resource. If the fields in collection-path do not provide all the necessary information, params will be searched for what remains. collection: str, The resource's collection, or None if it should be inferred from the line. enforce_collection: bool, fail unless parsed resource is of this specified collection, this is applicable only if line is URL. validate: bool, Validate syntax. Use validate=False to handle IDs under construction. default_resolver: func(str) => str, a default param resolver function called if params doesn't resolve a param. api_version: str, The API version, None for the default version. Returns: A resource object. Raises: InvalidResourceException: If the line is invalid. RequiredFieldOmittedException: If resource is underspecified. UnknownCollectionException: If no collection is provided or can be inferred. WrongResourceCollectionException: If the provided URL points into a collection other than the one specified. zhttps://zhttp://Nr)bor^rrrrrr_zgs://r)rurr)r_rrRrr_GCS_URL _GCS_ALT_URL_GCS_ALT_URL_SHORTrrrrrr\r r)r(rVrCrenforce_collectionrrrurergcs_url gcs_alt_urlgcs_alt_url_short bucket_prefix object_prefix objectpaths rrRegistry.Parsehs>  $ $ (B(B(  d0#T : NN  *0!.."<<># # ??7 # ###D#@@D$T $T **    &,B,7)11A  CCm(& &!33H='%77 E++== "  __W % % s7|}%++C3?m]J g -;<011 -[)*+11#q9A }j/:=>+ -#/012d%)ZZQ%7" ++0 $$d+,---  - '', "(J?(A A M& sC.. I/9A&I* "FI* F"I*4"GG0 G$$ G0/I*0 I :)I#I*(I:I ;I*?I/I  I*#I/)I**I/c "URSXS9$)zCreate a Resource from known collection and params. Args: collection: str, The name of the collection the resource belongs to. **params: {str:str}, The values for each of the resource params. Returns: Resource, The constructed resource. NrB)r)r(rrCs rCreateRegistry.Creates ::dz: AArr{)NNNrZ)TNN)FN)NNTTNN)rrrrrr&rrrrrrrrrrrrrrrrryry sz AE#1 54PB,..GK9=9Ev"k%ZGL$( >+*JN>B\C| Brryc[[RRUS5nSnUb[ UR 5X5nU$)a'Determine base url to use for resources of given version from API endpoint override. If no override is set by the user, return None. Args: api_name: str, The API name. api_version: str, The API version. Returns: Base URL of the API namespace, with API version, None if no override set. N)rr r,rs_GetApiBaseUrlr1)rruendpoint_override_propertyrs rrrsM '..$ @ (+"&&((H /rcV[X5nUc[SRU55eU$)aZDetermine base url to use for resources of given version using current override endpoint for this resource name. If no override is found, raise an error. Args: api_name: str, The API name. api_version: str, The API version. Returns: Base URL of the API namespace, with API version. Raises: UserError: If override endpoint is not set. zLgcloud config property {} needs to be set in api_endpoint_overrides section.)rrOr')rru api_base_urls rGetApiBaseUrlOrThrowrs8x5,  6(# %% rc:[X5nUc [X U5$U$)avDetermine base url to use for resources of given version using current override endpoint for this resource name. If no override is found, returns the default base url, with API version. Args: api_name: str, The API name. api_version: str, The API version. default_base_url: str, The default API endpoint. Returns: Base URL of the API namespace, with API version. )rr)rrudefault_base_urlrs rGetApiBaseUrlOrDefaultrs(x5, *k BB rcUnUbO[R"X5n[R"U5upVnUcX2S-- n[R"U5nU$)zXDetermine base url to use for resources of given API version from the supplied base url.r)r_GetBaseUrlFromApirrr)rrrurclient_base_url_ url_versions rrrs],$66xMO%66GAAC''l 22<@L r)?r __future__rrrrrgooglecloudsdk.api_lib.utilrrrrgooglecloudsdk.corer r r six.movesr r r r_COLLECTION_SUB_REcompilerr' _METHOD_ID_RErrrr Exceptionrrr!r/r7r>rGrOrRr\rerkrqrrxrrr3r5r7r;r@rFrrrwryREGISTRYrrrrrrrrs'' 51A** 6 **9 : ?FF!G#$ jj34 3; 6$I$454:5:#E#EEE>%> 5 52   %2>lBflB^@v@FK "9  , \ L | M-&M-`!GBvGBT :..& r