cQSrSSKJr SSKJr SSKJr SSKrSSKJr SSK J r SSK J r SS K J r SS K Jr SSKr\R R#5Vs/sHn\R%U5PM snr"S S \ R(5r"S S\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS \5r"S!S"\R@"\RB55r""S#S$\#5r$"S%S&\#5r%"S'S(\%5r&gs snf))z4Utility for retrieving and parsing the Resource Map.)absolute_import)division)unicode_literalsN)base) exceptions)yaml)yaml_validator)filesc\rSrSrSrSrg)ResourceMapError#zGeneral Purpose Exception.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r8lib/googlecloudsdk/command_lib/util/resource_map/base.pyr r #s"rr c,^\rSrSrSrU4SjrSrU=r$)ResourceMapInitializationError'zGException for when an error occurs while initializing the resource map.cJ>[[U] SRU55 g)Nz+Error while initializing resource map: [{}])superr__init__format)self init_error __class__s rr'ResourceMapInitializationError.__init__*s& ( ;;A6*;MOrrrrrrrrr __classcell__r s@rrr'sOOOrrc,^\rSrSrSrU4SjrSrU=r$)PrivateAttributeNotFoundError0zFException for when a private attribute that doesn't exist is accessed.cJ>[[U] SRX55 g)Nz*[{}] does not have private attribute [{}].)rr&rr)r data_wrapperattribute_namer s rr&PrivateAttributeNotFoundError.__init__3s' ' ELL,-rrr"r$s@rr&r&0sN--rr&c,^\rSrSrSrU4SjrSrU=r$)ApiNotFoundError9z[[U] SRU55 g)Nz"[{}] API not found in ResourceMap.)rr-rrrapi_namer s rrApiNotFoundError.__init__<s"  =DDXNOrrr"r$s@rr-r-9sDPPrr-c,^\rSrSrSrU4SjrSrU=r$)ApiAlreadyExistsErrorAzHException for when an API being added already exists in the ResourceMap.cJ>[[U] SRU55 gNz'[{}] API already exists in ResourceMap.)rr4rrr0s rrApiAlreadyExistsError.__init__Ds" /188BDrrr"r$s@rr4r4AsPDDrr4c,^\rSrSrSrU4SjrSrU=r$)ResourceNotFoundErrorIz8Exception for when a Resource does not exist in the API.cJ>[[U] SRU55 g)Nz'[{}] resource not found in ResourceMap.)rr:rr)r resource_namer s rrResourceNotFoundError.__init__Ls" /188GIrrr"r$s@rr:r:Is@IIrr:c,^\rSrSrSrU4SjrSrU=r$)ResourceAlreadyExistsErrorQzLException for when a Resource being added already exists in the ResourceMap.cJ>[[U] SRU55 gr7)rr@rrr0s rr#ResourceAlreadyExistsError.__init__Ts" $d4188BDrrr"r$s@rr@r@QsTDDrr@c,^\rSrSrSrU4SjrSrU=r$)MetadataNotFoundErrorYCException for when a metadata field does not exist in the Resource.cJ>[[U] SRX!55 g)Nz/[{}] metadata field not found in [{}] Resource.)rrErrrr=metadata_fieldr s rrMetadataNotFoundError.__init__\s$ /9@@  +,rrr"r$s@rrErEYK,,rrEc,^\rSrSrSrU4SjrSrU=r$)#TrackLevelResourceReleaseTrackErrorbzGException for when an attempt to access a releast track of a RT occurs.cJ>[[U] SRX55 g)Nz?Attempted accessing of [{}] track of TrackLevelResourceData[{}])rrNrr)r attempted_rt accessed_rtr s rr,TrackLevelResourceReleaseTrackError.__init__es& - #VL>@rrr"r$s@rrNrNbsO@@rrNc,^\rSrSrSrU4SjrSrU=r$)MetadataAlreadyExistsErrorlrGcJ>[[U] SRX!55 g)Nz.[{}] metadata already exists in [{}] Resource.)rrUrrrIs rr#MetadataAlreadyExistsError.__init__os$ $d48??  +,rrr"r$s@rrUrUlrLrrUc,^\rSrSrSrU4SjrSrU=r$)UnwrappedDataExceptionuz6Exception for when unwrapped data is added to the map.cJ>[[U] SRX55 g)NzhThe following data must be wrapped in a(n) {}Data wrapper prior to being added to the resource map: [{}])rrZrr)r field_typedatar s rrUnwrappedDataException.__init__xs" $0 0  !#rrr"r$s@rrZrZus>##rrZc\rSrSrSrSrSrSrSrSr \ RS5r S r SS jrS rS rSrSrSrSrSrSSjrSrg )ResourceMapBaseaBase data wrapper class for Resource Map metadata yaml files. This object loads the relevant resource map file upon instantiation and sets the parsed dictionary as the internal attribute _resource_map_data. Underlying dictionary data is never interacted with directly, and is instead is set/retrieved/interacted with via an ApiData wrapper object. Attributes: _resource_map_data: Dict containing metadata for each resource in each api. cnSUlSUlUR5 0UlUR 5 gN)_map_file_path_schema_file_path_register_paths_resource_map_data_load_resource_maprs rrResourceMapBase.__init__s2D!D DrchURS5(a [SU5eURU5$)z5Returns underlying API data when accessing attribute._ ResourceMap) startswithr&get_apirr1s r __getattr__ResourceMapBase.__getattr__s/3 )- BB << !!rcXR;$)z;Returns True if api_name exists in self._resource_map_data.rhrqs r __contains__ResourceMapBase.__contains__s .. ..rc#x# [R"UR5Hup[X5v M g7f)zBYields ApiData wrapper objects for each API in _resource_map_data.N)six iteritemsrhApiDatarr1api_datas r__iter__ResourceMapBase.__iter__s-!mmD,C,CD H ''Es8:cDUR5UR5:H$rdto_dictrothers r__eq__ResourceMapBase.__eq__ <<>U]]_ ,,rcg)zMust be overridden by child classes to register map and schema paths. Must explicitly set self._map_file_path and self._schema_file_path to appropriate filepaths in the overridden method of the child class. Nrrjs rrgResourceMapBase._register_pathss rc0[R"UR5n[R"U5UlSSS5 UR (d0Ulgg!,(df  N(=f![R an[U5eSnAff=f)z@Loads the ~/resource_map.yaml file into self._resource_map_data.N)r FileReaderrerloadrhMissingFileErrorr)rferrs rri"ResourceMapBase._load_resource_mapss0   D// 0A"&))A, 1  $ $"$% 1 0  ! !0 *3 //0s- A1A  A1 A.*A11B BBNctU(aUR5 U(aUR5 [R"U=(d UR5n[ R "URUS9 SSS5 g!,(df  g=f![Ran[U5eSnAff=f)zBPrunes and exports self._resource_map_data to ~/resource_map.yaml.)streamN) prune_validate_resource_mapr FileWriterrerdumprhrr)r file_pathrvalidaterrs r_export_resource_map$ResourceMapBase._export_resource_maps}0   ##%   I<)<)< = $))!4 > = =  ! !0 *3 //0s6AB B9B B BBB7' B22B7cv[R"UR5RUR5 g)z:Validates resource map against ~/resource_map_schema.yaml.N)r ValidatorrfValidaterhrjs rr&ResourceMapBase._validate_resource_maps*T334== !rcUR$rdrurjs rrResourceMapBase.to_dicts  " ""rcH[U5HnUR5 M g)aPrunes the resource map, removing redundant metadata values in the map. Calls prune() on each ApiData wrapper object, which in turn calls prune() on each underlying resource. Pruning each resource will remove any instances of a track-specific metadata field being set to the same value as the parent resource metadata field, eliminating any redundancies and keeping the map as clean as possible. Niterrrr}s rrResourceMapBase.prunesJnnrcfXR;a [U5e[XRU5$)z2Returns the api data wrapped in an ApiData object.)rhr-r{rqs rrpResourceMapBase.get_apis/... X && 844X> ??rc[U[5(d [SU5eUR5UR;a[ UR55eURR UR55 g)a,Adds an api to the resource map. Args: api_data: Data for api being added. Must be wrapped in an ApiData object. Raises: ApiAlreadyExistsError: API already exists in resource map. UnwrappedDataException: API data attempting to be added without being wrapped in an ApiData wrapper object. ApiN) isinstancer{rZ get_api_namerhr4updaterrs radd_apiResourceMapBase.add_apisf h ( ( "5( 33    D$;$; ; !("7"7"9 :: $$X%5%5%78rc[U[5(d [SU5eUR5UR;a[ UR55eURR UR55 g)a@Updates an API's data with the provided api data. Args: api_data: API Data to update the api with. Must be provided as an ApiData object. Raises: ApiNotFoundError: Api to be updated does not exist. UnwrappedDataException: API data attempting to be added without being wrapped in an ApiData wrapper object. rN)rr{rZrrhr-rrrs r update_apiResourceMapBase.update_apisf h ( ( "5( 33d&=&== X224 55 $$X%5%5%78rcRXR;a [U5eURU g)z%Removes an API from the resource map.N)rhr-rqs r remove_apiResourceMapBase.remove_apis'... X && )rc&URU5 g)z-Public method to export resource map to file.N)r)rrs rexportResourceMapBase.export si(r)rerhrf)NFTrd)rrrrrrrrrvr~rabcabstractmethodrgrirrrrrprrrrrrrrrarasm " /( -  0 0! # @ 9$9&* )rracp\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSSjrSrSrg)r{izData wrapper for an API object in the Resource Map metadata file. Attributes: _api_name: Name of the API. _api_data: Dict of resources and associated metadata constituting the api. cXlX lgrd) _api_name _api_datar|s rrApiData.__init__s NNrcURS5(a [SU5e[XRURU5$)zGReturns the specified resource's data wrapped in a ResourceData object.rmr{)ror& ResourceDatarrrr=s rrrApiData.__getattr__s?$$ ))] CC  ~~}5 77rcXR;$rd)rrs rrvApiData.__contains__!s NN **rc## URR5Hup[XRU5v M g7f)zGYields ResourceData wrapper objects for each API in _resource_map_data.N)ritemsrr)rr= resource_datas rr~ApiData.__iter__$s0(,(<(<(>$  FF)?s=?c,[UR5$rd)reprrrjs r__repr__ApiData.__repr__)s  rcDUR5UR5:H$rdrrs rrApiData.__eq__,rrcJ[R"UR55$rd)ry text_typerrjs rto_strApiData.to_str/s == ((rc:UR5UR0$rd)rrrjs rrApiData.to_dict2s     00rcB[R"UR5$rd)ryrrrjs rrApiData.get_api_name5s == ((rc|XR;a [U5e[XRURU5$)zEReturns the data for the specified resource in a ResourceData object.)rr:rrrs r get_resourceApiData.get_resource8s6NN* !- 00  ~~}5 77rc[U[5(d [SU5eUR5UR;a[ UR55eURR UR55 gNResource)rrrZget_resource_namerr@rrrrs r add_resourceApiData.add_resource?s` m\ 2 2 ":} ==  ( ( *dnn < &}'F'F'H II nnM1134rc[U[5(d [SU5eUR5UR;a[ UR55eURR UR55 gr)rrrZrrr:rrrs rupdate_resourceApiData.update_resourceGs` m\ 2 2 ":} ==  ( ( *$.. @ !-"A"A"C DD nnM1134rc`U(aXR;a [U5eURU grd)rr:)rr= must_exists rremove_resourceApiData.remove_resourceOs%m>>9 !- 00 }%rcH[U5HnUR5 M grdrrs rr ApiData.pruneTsd $r)rrN)T)rrrrrrrrrvr~rrrrrrrrrrrrrrr{r{sN7+G  -)1)755& rr{c^\rSrSrSrSrSrU4SjrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrU=r$)riYzData wrapper for a Resource object in the ResourceMap metadata file. Attributes: _resource_name: Name of the resource. _api_name: Name of the parent api. _resource_data: Metadata for the resource. c(XlX lX0lgrd)_resource_namer_resource_data)rr=r1rs rrResourceData.__init__bs'N'rcU[;aURU5$URS5(a [SU5eUR U5$)a Returns metadata value or TrackLevelResourceData object. Attribute being accessed will be either a metadata field for the resource, or the release track (GA, BETA, or ALPHA). If the attribute is a metadata field the appropriate value will be returned from self._resource_data. If the atatribute is a release track, a TrackLevelResourceData object will be returned. This enables both of the following usecases: `value = map.api.resource.metadata_field` OR 'value = map.api.resource.ALPHA.metadata_field` Args: metadata_field: Field or release track being accessed Returns: Metadata field value OR TrackLevelResourceData object. Raises: MetadataNotFoundError: Metadata field does not exist. PrivateAttributeNotFoundError: Private attribute doesn't exist in object. rmr)_RELEASE_TRACKSget_release_track_dataror& get_metadatarrJs rrrResourceData.__getattr__gsL.(  ( ( 88  " "3 ' ' ).. II   ~ ..rc>URS5(a[[U]X5 gXR;aUR X5 gUR X5 g)aSets the specified metadata field to the provided value. If the object is not yet instantiated, then standard __setattr__ behavior is observed, allowing for proper object instantiation. After initialization, the specified metadata field within self._resource_data is set to the provided value Args: metadata_field: Metadata field to set the value for. value: Value to set the specified metadata field to. Returns: True rmN)rorr __setattr__r add_metadataupdate_metadatarrJvaluer s rrResourceData.__setattr__sM   %% L$+NB 22 2 . >1rcDUR5UR5:H$rdrrs rrResourceData.__eq__rrc$URU5$rd)has_metadata_fieldrs rrvResourceData.__contains__s  " "> 22rc[HnXR;dMURUn[UR55H-nX0R;dMURUX#:XdM+X# M/ U(aMvURU M g)zDRemoves any redundant metadata specifications between track and top.N)rrlistkeys)rtracktrack_resource_datakeys rrResourceData.prunes  %% %"11%8+0023C '' 'D,?,?-).-/#(4 #"!!%(!rc:UR5UR0$rd)rrrjs rrResourceData.to_dicts  " " $d&9&9 ::rcXR;$rd)rrs rrResourceData.has_metadata_fields 00 00rcUR$rd)rrjs rrResourceData.get_resource_names   rcUR$rd)rrjs rrResourceData.get_api_names >>rc^SRUR5UR55$)Nz{}.{})rrrrjs rget_full_collection_name%ResourceData.get_full_collection_names% >>$++-t/E/E/G HHrcjXR;a[URU5eURU$rdrrErrs rrResourceData.get_metadatas2000 !$"5"5~ FF   ~ ..rcV[URURURUS9$)Nr)TrackLevelResourceDatarrrr release_tracks rr#ResourceData.get_release_track_datas+ !     rcjXR;a[URU5eX RU'grd)rrUrrrJrs rrResourceData.add_metadatas/,,, &t':':N KK,1.)rcjXR;a[URU5eX RU'grdrrs rrResourceData.update_metadatas/000 !$"5"5~ FF,1.)rchXR;a[URU5eURU grdrrs rremove_metadataResourceData.remove_metadatas/000 !$"5"5~ FF   n -r)rrr)rrrrrrrrrrrvrrrrrrrrrrr"rr#r$s@rrrYs^( /<2.-3 );1I/ 2 2 ..rrch^\rSrSrSrU4SjrSrU4SjrSrSr Sr S r S r S r S rS rU=r$)riaData wrapper for track-specific resource metadata. This data wrapper represents the metadata for a specific release track of a resource. Retrieval of metadata will first check for a track level specification of the metadata, and if not found will then retrieve the top level metadata value. Attributes: _resource_name: Name of the resource. _api_name: Name of the parent api. _resource_data: Metadata for the resource. _track: Release track for the resource. _track_resource_data: Track specific metadata for the resource. c|>X@lURUR05Ul[[U]XU5 grd)_trackget_track_resource_datarrr)rr=r1rrr s rrTrackLevelResourceData.__init__s7K - 1 1$++r BD $01>@rchURS5(a [SU5eURU5$)a"Retrieves the track-specific metadata value for the resource. If the specified release track does not have a specified value, the parent metadata field value for the resource will be returned. Args: metadata_field: Metadata field value to retrieve Returns: Metadata field value for the specified release track-specific or the parent metadata field. Raises: MetadataNotFoundError: Metadata field value wasn't found for the specific track or for the parent. PrivateAttributeNotFoundError: Private attribute doesn't exist in object. rmr)ror&rrs rrr"TrackLevelResourceData.__getattr__s;$  %% )*B*8 ::  ~ ..rc>URS5(a[[U]X5 gXR;aUR X5$UR X5$)aSets the specified metadata field to the provided value. If the object is not yet instantiated, then standard __setattr__ behavior is observed, allowing for proper object intitialization. After initialization, the specified metadata field for the release track is set to the provided value. Args: metadata_field: Metadata field to set the value for. value: Value to set the specified metadata field to. Returns: True rmN)rorrrr(rrrs rr"TrackLevelResourceData.__setattr__ sT   %% "D5nL 44 4##N::  77rc2URUR0$rd)rrrjs rrTrackLevelResourceData.to_dict$s   !4!4 55rcXR;aURU$XR;aURU$[URU5erd)r(rrErrs rr#TrackLevelResourceData.get_metadata'sO222  & &~ 66 .. .   00 !$"5"5~ FFrcjXR;a[URU5eX RU'grd)r(rUrrs rr#TrackLevelResourceData.add_metadata/s/222 &t':':N KK27/rcjXR;a[URU5eX RU'grdr(rErrs rr&TrackLevelResourceData.update_metadata5s/666 !$"5"5~ FF27/rchXR;a[URU5eURU grdr5rs rr"&TrackLevelResourceData.remove_metadata;s/666 !$"5"5~ FF  # #N 3rcUR$rd)r&rjs rget_release_track(TrackLevelResourceData.get_release_trackAs ;;rc,[XR5erd)rNr&rs rr-TrackLevelResourceData.get_release_track_dataDs -m[[ IIr)r&r()rrrrrrrrrrrrrr"r:rrr#r$s@rrrsC @ /0806G8 8 4 JJrr)'r __future__rrrrgooglecloudsdk.callioper calliope_basegooglecloudsdk.corerrr googlecloudsdk.core.utilr ry ReleaseTrack AllValuesrrErrorr rr&r-r4r:r@rErNrUrZwith_metaclassABCMetaraobjectr{rrrs0rrIsN;&' 9*$.* '4&@&@&J&J&L&LUCMM%&L #z''#O%5O-$4-P'PD,DI,ID!1D,,,@*:@,!1,#-#L)c((5L)^HfHVB.6B.JgJ\gJAsD?