o }$@sdZddlmZddlmZddlmZddlZddlmZGdddeZ Gd d d ej Z d d Z d dZ ddZddZddZddZddZdS)zUtilities for cloud resources.)absolute_import)division)unicode_literalsN) exceptionsc@seZdZdZ d ddZeddZddZd d Zd d Z d dZ ddZ ddZ e ddZddZddZddZddZddZdS)!CollectionInfoaHolds information about a resource collection. Attributes: api_name: str, name of the api of resources parsed by this parser. api_version: str, version id for this api. path: str, Atomic URI template for this resource. flat_paths: {name->path}, Named detailed URI templates for this resource. If there is an entry ''->path it replaces path and corresponding param attributes for resources parsing. path and params are not used in this case. Also note that key in this dictionary is referred as subcollection, as it extends 'name' attribute. params: list(str), description of parameters in the path. name: str, collection name for this resource without leading api_name. base_url: str, URL for service providing these resources. docs_url: str, URL to the API reference docs for this API. enable_uri_parsing: bool, whether to register a parser to build up a search tree to match URLs against URL templates. Tc Cs:||_||_||_||_||_||_||_||_| |_dSN) api_name api_versionbase_urldocs_urlnamepath flat_pathsparamsenable_uri_parsing) selfrr r r r r rrrrA/tmp/google-cloud-sdk/lib/googlecloudsdk/api_lib/util/resource.py__init__.s  zCollectionInfo.__init__cCs|jd|jS)N.)rr rrrr full_nameBszCollectionInfo.full_namecCs4|j}||r|t|ddStd||)Nz{0} does not exist in {1})r startswithlenKeyErrorformat)rcollection_namer rrrGetSubcollectionFs zCollectionInfo.GetSubcollectioncCs~||}g}d}td|D] }|||||d|dr+|d|}q|t|kr:d|d<d|S) z)Returns regex for matching path template.rz({[^}]+}/)|({[^}]+})$z([^/]+)r/z(.*)$) GetPathrefinditerappendstartgroupendrjoin)r subcollectionr partsprev_endmatchrrr GetPathRegExNs       zCollectionInfo.GetPathRegExcCs|s|js|jSt|j|S)aReturns ordered list of parameters for given subcollection. Args: subcollection: str, key name for flat_paths. If self.flat_paths is empty use '' (or any other falsy value) for subcollection to get default path parameters. Returns: Paramaters present in specified subcollection path. Raises: KeyError if given subcollection does not exists. )rrGetParamsFromPathrr*rrr GetParams]s zCollectionInfo.GetParamscCs|s|js|jS|j|S)z2Returns uri template path for given subcollection.)rr r0rrrr"os  zCollectionInfo.GetPathcCs$|j|jko|j|jko|j|jkSr)rr r rotherrrr__eq__vs   zCollectionInfo.__eq__cCs ||k Srrr2rrr__ne__zs zCollectionInfo.__ne__cCs||k||kS)z;Just a helper equivalent to the cmp() function in Python 2.r)clsxyrrr _CmpHelper}szCollectionInfo._CmpHelpercCs(||j|j|jf|j|j|jfdkSNrr9rr r r2rrr__lt__ zCollectionInfo.__lt__cCs(||j|j|jf|j|j|jfdkSr:r;r2rrr__gt__r=zCollectionInfo.__gt__cC || Sr)r>r2rrr__le__ zCollectionInfo.__le__cCr?r)r<r2rrr__ge__rAzCollectionInfo.__ge__cCs|jSr)rrrrr__str__szCollectionInfo.__str__N)T)__name__ __module__ __qualname____doc__rpropertyrrr.r1r"r4r5 classmethodr9r<r>r@rBrCrrrrrs&    rcs eZdZdZfddZZS)InvalidEndpointExceptionz0Exception for when an API endpoint is malformed.cstt|d|dS)Nz5URL does not start with 'http://' or 'https://' [{0}])superrJrr)rurl __class__rrrs z!InvalidEndpointException.__init__)rDrErFrGr __classcell__rrrMrrJsrJc Cst|d}t|}|d}|dkr4t|}t|dkr&|d|kr&d}nd}|dd||dfS||}d||dd}|dkrNt|||fS|dkrat|p[||d}|||fSt|)aPReturns api_name, api_version, resource_path tuple for an API URL. Supports the following formats: # Google API production/staging endpoints. http(s)://www.googleapis.com/{api}/{version}/{resource-path} http(s)://stagingdomain/{api}/{version}/{resource-path} http(s)://{api}.googleapis.com/{api}/{version}/{resource-path} http(s)://{api}.googleapis.com/apis/{kube-api.name}/{version}/{resource-path} http(s)://{api}.googleapis.com/{version}/{resource-path} http(s)://{api}.googleapis.com/{api}/{resource-path} http(s)://{api}.googleapis.com/{resource-path} http(s)://googledomain/{api} # Non-Google API endpoints. http(s)://someotherdomain/{api}/{version}/{resource-path} Args: url: str, The resource url. Returns: (str, str, str): The API name, version, resource_path. Raises: InvalidEndpointException. rrr rN) _StripUrlsplit_GetApiVersionIndex_ExtractApiNameFromDomainrr)_FindKubernetesApiNamerJ) rLtokens version_indexdomainapiresource_indexversion resource_pathrrrrSplitEndpointUrls" r]cCsr|dd}|d}g}|D]&}|dr6|dr6|dd}|dr1||dd q||q|S) a/Extract parameters from uri template path. See https://tools.ietf.org/html/rfc6570. This function makes simplifying assumption that all parameter names are surrounded by /{ and }/. Args: path: str, uri template path. Returns: list(str), list of parameters in the template path. :rr{}rr +N)rRrendswithr%)r r+rpartrrrr/s    r/cCs8|ds |dr||ddddSt|)zHStrip a http: or https: prefix, then strip leading and trailing slashes.zhttps://zhttp://r^rNr)rindexstriprJ)rLrrrrQsrQcCs d}|D] }||vr dSqdS)z2Check if the token parsed from Url is API version.)alphabetav1v2v3v4dogfoodheadTFr)tokenversionsr rrr IsApiVersions rpcCs&t|D] \}}t|r|SqdS)Nr ) enumeraterp)rVidxrnrrrrSs rScCs|ddS)Nrr)rR)rXrrrrTsrTcCs>d}|dd}|D]}||ks|d|r|Sq dS)a>Find the name of the kubernetes api. Determines the kubernetes api name from the domain of the resource uri. The domain may from a global resource or a regionalized resource. Args: domain: Domain from the resource uri. Returns: Api name. Returns None if the domain is not a kubernetes api domain. )runrr-N)rRrb)rX k8s_api_namesdomain_first_partrrrrrUs rU)rG __future__rrrr#googlecloudsdk.corerobjectrErrorrJr]r/rQrprSrTrUrrrrs    z7