o @sdZddlmZddlmZddlmZddlZddlZddlmZddlm Z ddlm Z dd l m Z dd l mZddlZdd lmZdd lmZdd lmZddlZdZedZedjedZedZdZdZdZGdddeZGdddeZ GdddeZ!GdddeZ"GdddeZ#Gd d!d!eZ$Gd"d#d#eZ%Gd$d%d%e jeZ&Gd&d'd'e&Z'Gd(d)d)e&Z(Gd*d+d+e&Z)Gd,d-d-e&Z*Gd.d/d/e&Z+Gd0d1d1e,Z-Gd2d3d3e,Z.d4d5Z/d6d7Z0Gd8d9d9e&Z1Gd:d;d;e1Z2Gdd?d?e1Z4Gd@dAdAe1Z5GdBdCdCe1Z6GdDdEdEe,Z7dFdGZ8GdHdIdIe,Z9e9Z:dJdKZ;dLdMZdS)RajManage 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@eZdZdZdS)ErrorzExceptions for this module.N__name__ __module__ __qualname____doc__rr:/tmp/google-cloud-sdk/lib/googlecloudsdk/core/resources.pyr8rc@r)_ResourceWithoutGetExceptionz+Exception for resources with no Get method.Nrrrrrr<rrc eZdZdZfddZZS)BadResolverExceptionz6Exception to signal that a resource has no Get method.ctt|dj|ddS)Nzbad resolver for [{param}])param)superr__init__format)selfr __class__rrrC  zBadResolverException.__init__rrrrr __classcell__rrr"rr@rcr)AmbiguousAPIExceptionz5Exception for when two APIs try to define a resource.cs"tt|dj|t|ddS)Nz:collection [{collection}] defined in multiple APIs: {apis})rapis)rr(rr repr)r!r base_urlsr"rrrKs zAmbiguousAPIException.__init__r%rrr"rr(Hr'r(cr)AmbiguousResourcePathzreasonmessager"rrr{s  z!InvalidResourceException.__init__Nr%rrr"rr<xr<cr) WrongResourceCollectionExceptionz7A command line that was given had the wrong collection.cs,tt|dj|||d||_||_dS)NzGwrong collection: expected [{expected}], got [{got}], for path [{path}]expectedgotpath)rrCrr rFrG)r!rErFrGr"rrrs  z)WrongResourceCollectionException.__init__r%rrr"rrCr'rCcr)RequiredFieldOmittedExceptionz6A command line that was given did not specify a field.cstt|dj||ddS)Nz_value for field [{expected}] in collection [{collection_name}] is required but was not provided)rEcollection_name)rrHrr )r!rIrEr"rrrs z&RequiredFieldOmittedException.__init__r%rrr"rrHr'rHcr)UnknownCollectionException;A command line that was given did not specify a collection.cr)Nzunknown collection for [{line}]r=)rrJrr )r!r>r"rrrr$z#UnknownCollectionException.__init__r%rrr"rrJr'rJcr;)InvalidCollectionExceptionrKNcs4dj|d}|r|dj|d7}tt||dS)Nz!unknown collection [{collection}]r z for API version [{version}])version)r rrLr)r!r api_versionr@r"rrrs z#InvalidCollectionException.__init__rAr%rrr"rrLrBrLc@sBeZdZdZddZ dddZ dd d Zd d ZddZdS)_ResourceParserzFClass that turns command-line arguments into a cloud resource message.cCs||_||_dS)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!rPrQrrrrs z_ResourceParser.__init__NFc Cst|}|j|}t||}|st|d|jj||j |}| }|r1t t j j|}t|j|j|tt|||dS)aFParse 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)rUniversifyAddressrQ GetPathRegExrematchr<r full_name GetParamsgroupsr r parseunquoteResourcerPdictr ) r! relative_namebase_url subcollection url_unescape path_templaterXr2fieldsrrrParseRelativeNames"       z!_ResourceParser.ParseRelativeNameTcst|}durstr)}, 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. Nrarbc3s|] }|dvVqdS)/Nr).0prefix resource_idrr s  z2_ResourceParser.ParseResourceId..zInvalid value: {}zPProvided params {} is not subset of the resource parameters {} for collection {}rvalidater )!rrUrfr<rQGetPathGetFieldNamesFromPathallr:r rZsetkeysissubset ValueErrorsortedrY_GRIsAreEnabledGRI FromString path_fieldslenGRIPathMismatchExceptionis_fully_qualifiedrreversedr_r itemsgetcallabler^rP)r!rlkwargsrarbrodefault_resolverrG path_prefixescontains_all_fieldsr2grirerSrvalueresolverrefrrkrParseResourceIdsp ,          z_ResourceParser.ParseResourceIdcCsddt|dDS)zExtract field names from uri template path. Args: path: str, uri template path. Returns: list(str), list of field names in the template path. cSs$g|]\}}|ddkr|r|qS)rr)riidxrjrrr Ks z9_ResourceParser.GetFieldNamesFromPath..rh) enumeratesplit)r!rGrrrrrBs  z%_ResourceParser.GetFieldNamesFromPathcCs2d}|jjD] }dj||d}qdj|jj|dS)NrRz[{path}]/{param})rGrz[{collection}::]{path})rrG)rQr2r rY)r!path_strrrrr__str__Qs  z_ResourceParser.__str__)NrRF)NrRTN) rrrrrrfrrrrrrrrrOs # i rOcseZdZdZddZfddZddZdd Zd d Zd d Z d$ddZ ddZ ddZ ddZ d%ddZddZddZddZd d!Zd"d#ZZS)&r^z#Information about a Cloud resource.cCs||_||_|r ||_nt|j|_||_|||_| ||_ t |D]\}}|dur5t |j|t|||q'd|jt|j||_|jjdvrYtj|j|_d|_dS)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_urlrrUra_subcollectionrq_pathrZ_paramssix iteritemsrHrYsetattrr uritemplateexpandAsDict _self_linkapi_namer r\r] _initialized)r!rPrQrbrSrTrrrrrr\s(     zResource.__init__cs4t|dddurtd|tt|||dS)Nrzsz'Resource.RelativeName..cs"g|] }|t|ddfqS)rR)rrrik escape_funcr!rrrsz)Resource.RelativeName..) r r\quoter_rr]rrr)r! url_escapeeffective_paramsrrr RelativeNames  zResource.RelativeNamecstfddjDS)z5Returns resource reference parameters and its values.csg|] }|t|gqSrrrirrrrrsz#Resource.AsDict..) collections OrderedDictrrrrrrs  zResource.AsDictcsfddjDS)z"Returns resource reference values.csg|]}t|qSrrrrrrrz#Resource.AsList..)rrrrrAsListszResource.AsListcCr)zReturns URI for this resource.rrrrrSelfLinkszResource.SelfLinkNc sjdd}jjjjjj}|r;z||}Wn ty&t|w|j d}||kr:t |||n@t |D]\}}|j d|krY|jdjvrY|}nq@|srt |D]\}}|j d|krq|}nqa|s{t |fdd|D}jjd||d} | S)aCGets 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. NrprRcsi|]}|t|qSrrrrrr sz#Resource.Parent..r )rrparsers_by_collectionrrrNKeyErrorrJrQrZr6rrrrqrr/Parse) r!r7 parent_paramsall_collections parent_parseractual_parent_paramsrparserparent_param_valuesrrrrParentsP     zResource.ParentcCrrArrrrrr rzResource.__str__cCst|tr ||kSdSNF) isinstancer^rr!otherrrr__eq__ s zResource.__eq__cCs||kSrA)rrrrr__lt__szResource.__lt__cCs t|jSrA)hashrrrrr__hash__s zResource.__hash__cCrrArrrrr__repr__rzResource.__repr__)FrA)rrrrrrrrrrrrrrrrrrrrr&rrr"rr^Ys$ ,  <r^cCs tjjjptjjjdkS)z!Returns True if GRIs are enabled.r)r VALUEScore enable_griGetBoolresource_completion_styleGetrrrrrysrycCs|ddS)zGet the API name from a collection name like 'api.parents.children'. Args: collection: str, The collection name. Returns: str: The API name. rr)rr rrr_APINameFromCollection"s rc@r) GRIExceptionz*Base class for all GRI related exceptions.Nrrrrrr.srcr)InvalidGRIFormatExceptionz2Exception for when a GRI is syntactically invalid.cr)NzlThe given GRI [{gri}] is invalid and could not be parsed. Valid GRIs take the form of: a:b:c::api.collection)r)rrrr r!rr"rrr6s z"InvalidGRIFormatException.__init__r%rrr"rr3r'rcr)#InvalidGRICollectionSyntaxExceptionzLException for when the collection part of a GRI is syntactically invalid. ctt|dj||ddS)NzZThe given GRI [{gri}] could not be parsed because the collection [{collection}] is invalid)rr)rrrr )r!rrr"rrrA z,InvalidGRICollectionSyntaxException.__init__r%rrr"rr=r5rcr)GRICollectionMismatchExceptionzLException for when the parsed GRI collection does not match the expected. cs tt|dj|||ddS)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)rrrr )r!rrrr"rrrLs z'GRICollectionMismatchException.__init__r%rrr"rrHr5rcr)InvalidGRIPathSyntaxExceptionzMException for when a part of the path of the GRI is syntactically invalid. cr)NzPThe given GRI [{gri}] could not be parsed because the path is invalid: {message})rr@)rrrr )r!rr@r"rrr[rz&InvalidGRIPathSyntaxException.__init__r%rrr"rrWr5rcr;)r~z=Exception for when the path has the wrong number of segments.Ncs8tt|dj|dt||rd|ndddS)NzxThe given GRI [{gri}] does not match the required structure for this resource type. It must match the format: [{format}]:::rR)rr )rr~rr r3r)r!rr2rr"rrres z!GRIPathMismatchException.__init__rAr%rrr"rr~brBr~c@sneZdZdZdddZddZedd d Zedd d Zed dZ eddZ eddZ eddZ dS)rza}Encapsulates 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. NFcCs||_||_|o |du|_dS)z$Use FromString() to construct a GRI.N)r|rr)r!r|rrrrrrysz GRI.__init__cs8dfddjDd}jr|dj7}|S)Nrcg|]}|qSr)_EscapePathSegment)risrrrrszGRI.__str__..r)r3r|rstriprrrrrrrsz GRI.__str__TcCsb|j||d\}}|s|}n|r#||||r#||kr#t|||d||}t||t|dS)aBParses 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. )ro)rr)r)_SplitCollection_ValidateCollectionr _SplitPathrzbool)clsrrrorGrr|rrrr{s    zGRI.FromStringcCs|sdStd|}t|dkrt|t|dkr,|d|d}}|r+|||n|dd}}|rD|ds?|drDt|d||fS) 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(?=(?<={)::+[^:}]|(?<=[^:{])::+}|(?<=[^:{])::+[^:}])::rrNrz%GRIs cannot have empty path segments.)rWrr}rr startswithendswithr)rrropartsrGrrrrrs$   zGRI._SplitCollectioncCstd|s t||dS)Nz^\w+\.\w+(?:\.\w+)*$)rWrXr)rrrrrrrs  zGRI._ValidateCollectioncs&|sgStd|}fdd|DS)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(?=(?<={):+[^:}]|(?<=[^:{]):+}|(?<=[^:{]):+[^:}]):crr)_UnescapePathSegment)ripartrrrrrz"GRI._SplitPath..)rWr)rrGrrrrrs  zGRI._SplitPathcCtdd|S)Nz{(:+)}z\1rWsubrsegmentrrrrzGRI._UnescapePathSegmentcCr)Nz(:+)z{\1}rrrrrrrzGRI._EscapePathSegmentr)NT)T) rrrrrr classmethodr{rrrrrrrrrrzns   & ,   rzcCs4ztjj|}Wt|StjyYdSw)z5Check if a URL is the result of an endpoint override.F)r rapi_endpoint_overridesPropertyrNoSuchPropertyErrorr)rendpoint_overriderrrHasOverriddenEndpointsrc@seZdZdZ  dddZddZd ddZd d Zd d Zd d dZ  d!ddZ d ddZ d ddZ  d"ddZ d ddZ  d#ddZddZdS)$RegistryaKeep 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'}. NcCs"|pi|_|pi|_|p i|_dSrArparsers_by_urlregistered_apis)r!rr r rrrrs  zRegistry.__init__cCst|j|j|jdS)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 )rrr r copyrrrrClones  zRegistry.ClonecCsf|j|d}|dur|r|}nt|}||j|ivr,t||D]}||q$||j|<|S)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!rrNregistered_versionrrrrRegisterApiByName-s    zRegistry.RegisterApiByNamec Cs|j}|j}t||}|j|i|i}|j}|s d|ji}t|D]2\}}|j |r1d|nd} | | } | durGt | |j | j j g||| <|jrW||||||q%dS)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. rRrN)rrNrOr setdefault flat_pathsrGrrrYrr(rarQenable_uri_parsing_AddParserForUriPath) r!rQrrNrcollection_parserscollection_subpathssubnamerGrIexisting_parserrrrrGs2     zRegistry._RegisterCollectionc Cs||g|d}|j}|r/|d}|ddkr!|ddkr!d}||vr)i||<||}|sd|vrstr)}, 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. rnr#rRrN)ror) ryrzr{rrJr$ GetApiBaseUrlrQrrNrYr}r) r!rrlrrorNrrraparser_collectionrbrrrrs($ zRegistry.ParseResourceIdcCsLt|}|j||d}|j|i|i|d}|dur#t|||jS)Nr#)rrrrrLrQ)r!rIrNrrrrrrs zRegistry.GetCollectionInfocCst|}|s t|ddt|\}}}|p|}zt|}Wntjy0t|d |w||vrCt |rC|j |t |}||vrOt|d |||g|d}|dt| } z |j||dWntjyzt|d |tjyt|d |wg} |j} t|D]V\} } | | vr| | } qdi}}t| D] \}}|d krn qt|d | dt|d krd|vrd|| d} | tj| |} n | tj| |} qd| vrt|d | d\}}tt|j|| } |jd| | |d S)acParse 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)r?zunknown api {}zunknown api version {}rhNr#rRrzCould not parse at [{}]rzUrl too short.rg) _URL_RErXr< resource_utilSplitEndpointUrlr _GetVersionsrUnknownAPIErrorr rr rrrr}rUnknownVersionErrorr rrrr3appendr r\r]r_r rQrZr)r!urlrNrXrurl_api_version resource_pathversionsr endpointr2r!ir"r next_levelrbrrrrParseURLsx !        zRegistry.ParseURLFcCs<|j||d}t|jj|jj}|j|}|||||S)z:Parser relative names. See Resource.RelativeName() method.r#)r$r%rQrrNGetSubcollectionrf)r!r`rrcrNrrarbrrrrfHs zRegistry.ParseRelativeNamecCst|}|s t|d|dr.|r|dkrtd|||jdd|d|dddS|r:|dkr:td|||jddd |didS) z;Parse gs://bucket/object_path into storage.v1 api resource.zNot a storage urlrstorage.objectsNrbucketobjectrrlrstorage.bucketsr9) _GCS_URL_RErXr<grouprCr)r!r.rrXrrrParseStorageURLSs(       zRegistry.ParseStorageURLc Cs2|r|ds |drz|||}Wnty} zd} tt} tt} tt} || rVz|t| d dd\}} }}Wn t yM| w||fdkrUnh|| rz%z|t| d dd\}} }}Wn t yw| w||fdkrWn=ty} z1|t| d}d|vr| dd\} }n|j ddd |id WYd} ~ WYd} ~ SWYd} ~ nd} ~ ww| dur|j d d| |d d WYd} ~ Sd} ~ ww|r|r| |krt || |d |S|dr|j||dS|r |dur |s t||j |||pi|||dS)a+Parse 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://Nrh)borr<r9r;r7r8rDzgs://r )rNror)rr5r<rrU_GCS_URL _GCS_ALT_URL_GCS_ALT_URL_SHORTr}rrwrrrCrr?)r!r>r2renforce_collectionrorrNrer9gcs_url gcs_alt_urlgcs_alt_url_short bucket_prefix object_prefix objectpathrrrrhs          )  zRegistry.ParsecKs|jd||dS)a Create 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. Nr1)rr4rrrCreates zRegistry.Create)NNNrA)TNN)FN)NNTTNN)rrrrrr rrrr$rrr5rfr?rrNrrrrr s.  !  ; m  ^rcCs0ttjj|d}d}|durt|||}|S)a5Determine 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 rr_GetApiBaseUrlr)rrNendpoint_override_propertyrarrrr%s  r%cCs$t||}|durtd||S)alDetermine 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. NzLgcloud config property {} needs to be set in api_endpoint_overrides section.)r%r:r )rrN api_base_urlrrrGetApiBaseUrlOrThrows rRcCs"t||}|durt|||S|S)aDetermine 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. N)r%rO)rrNdefault_base_urlrQrrrGetApiBaseUrlOrDefaults  rTcCsJ|}|dur#t||}t|\}}}|dur||d7}t|}|S)zXDetermine base url to use for resources of given API version from the supplied base url.Nrh)r_GetBaseUrlFromApir(r)rU)rarrNrQclient_base_url_ url_versionrrrrOs   rO)?r __future__rrrrrWgooglecloudsdk.api_lib.utilrrrr(googlecloudsdk.corerr r six.movesr r r r_COLLECTION_SUB_REcompiler'r _METHOD_ID_REr=rCrDrE Exceptionrrrr(r,r/r6r:r<rCrHrJrLr:rOr^ryrrrrrrr~rzrrREGISTRYr%rRrTrOrrrrs|                   0D      M