z.SrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSKJ r SSKJ r SS K Jr SS KJr SS KJr SS KJr S S S S.r"SS\R(5r"SS\5r"SS\5r"SS\5r"SS\\R2S9r"SS\5r"SS\5r"SS\5r"S S!\5rS"r\"S S#\ R@"S$5\ RB"\RDRFRH5/S%9r%S \%0r&S \%0r'g)&aClasses to specify concept and resource specs. Concept specs hold information about concepts. "Concepts" are any entity that has multiple attributes, which can be specified via multiple flags on the command line. A single concept spec should be created and re-used for the same concept everywhere it appears. Resource specs (currently the only type of concept spec used in gcloud) hold information about a Cloud resource. "Resources" are types of concepts that correspond to Cloud resources specified by a collection path, such as 'example.projects.shelves.books'. Their attributes correspond to the parameters of their collection path. As with concept specs, a single resource spec should be defined and re-used for each collection. For resources, attributes can be configured by ResourceParameterAttributeConfigs using kwargs. In many cases, users should also be able to reuse configs for the same attribute across several resources (for example, 'example.projects.shelves.books.pages' could also use the shelf and project attribute configs). )absolute_import)division)unicode_literalsN)deps) deps_map_util)util)yaml_command_schema_util) exceptions) properties) resourcesproject)r projectId projectsIdc\rSrSrSrSrg)Error<z%Base class for errors in this module.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r0lib/googlecloudsdk/calliope/concepts/concepts.pyrr<-rrc\rSrSrSrSrg)InitializationError@z%Raised if a spec fails to initialize.rNrrrrrr@rrrc\rSrSrSrSrg)ResourceConfigurationErrorDz,Raised if a resource is improperly declared.rNrrrrr"r"Ds4rr"c,^\rSrSrSrU4SjrSrU=r$)InvalidResourceArgumentListsHz8Exception for missing, extra, or out of order arguments.c>UVs/sHo3[;aSU-S-OUPM nn[[U]SR SR U5SR U555 gs snf)N[]z6Invalid resource arguments: Expected [{}], Found [{}]., )IGNORED_FIELDSsuperr%__init__formatjoin)selfexpectedactuale __class__s rr-%InvalidResourceArgumentLists.__init__KsdEMNXn!4a# !;XHN &6@GG IIh 6!2 45OsA'r)rrrrrr-r __classcell__r4s@rr%r%Hs@55rr%c>\rSrSrSr\\RS55r\\RS55r \RS5r \RS5r \RSSj5r \RSS j5r \RS 5rS rS rS rg) ConceptSpecRzBase class for concept args.cg)zLA list of Attribute objects representing the attributes of the concept. Nrr0s r attributesConceptSpec.attributesUrcg)z The name of the overall concept.Nrr<s rnameConceptSpec.name[r?rcg)z'Returns True if attribute is an anchor.Nrr0 attributes rIsAnchorConceptSpec.IsAnchor`r?rcg)z+Returns True if attribute is a leaf anchor.NrrDs r IsLeafAnchorConceptSpec.IsLeafAnchordr?rNcg)z;Initializes the concept using fallthroughs and parsed args.Nr)r0fallthroughs_map parsed_argss r InitializeConceptSpec.Initializehr?rcg)z#Lazy parsing function for resource.Nrr0attribute_to_args_mapbase_fallthroughs_maprMplural allow_emptys rParseConceptSpec.Parselr?rcg)z/Builds list of fallthroughs for each attribute.Nr)r0rRrSs rBuildFullFallthroughsMap$ConceptSpec.BuildFullFallthroughsMapqr?rc[U[U55(dgURUR:H=(a URUR:H$)NF) isinstancetyperAr=r0others r__eq__ConceptSpec.__eq__vs= eT$Z ( (  YY%** $ LE%>  K 6$< I (DDONM$*DN 'CDOrc[U[U55(dgURUR:H=(a URUR:H=(a URUR:H=(ay UR UR :H=(aY UR UR :H=(a9 URUR:H=(a URUR:H$) Overrides.F) r\r]rArtrurvrxrwrzr^s rr`_Attribute.__eq__s eT$Z ( (  II # 45;K;K(K 4%//1 4 / 4%//1 4!!U%7%77  4 5#3#33 5rc [[[URURUR UR URUR/55[[[UR55-$rc) summaprdrArtrurvrxrzrwr<s rre_Attribute.__hash__s_ s4 4??DNNDMM )* +-0T4;L;L1M-N OOr)rxrwrurArtrvrz)NFNNN) rrrrrr-r`rerrrrrmrms!&AF=A($ 5OrrmcL^\rSrSrSrSU4SjjrU4SjrU4SjrSrU=r $) AttributeayAn attribute of a resource. Has all attributes of the base class along with resource-specific attributes. Attributes: completion_request_params: {str: str}, a dict of field names to params to use as static field values in any request to complete this resource. completion_id_field: str, the ID field of the return value in the response for completion requests. c \>U=(d 0UlX0l[[U]"U40UD6 g)rpN)completion_request_paramscompletion_id_fieldr,rr-)r0rArrkwargsr4s rr-Attribute.__init__s,&?%D"D"2 )T#D3F3rc>[[U] U5=(aY URUR:H=(a9 URUR:H=(a UR UR :H$)r})r,rr`rxrrr0r_r4s rr`Attribute.__eq__sg )T )% 0 F%//1 F..../ F((E,E,EE Grc >[[U] 5[[ [ [ UR5[ UR5UR/55-$rc) r,rrerrrdryrxrrr0r4s rreAttribute.__hash__sR D * ,s D3t~~&t556++- .0/ //r)rrNN) rrrrrr-r`rerr6r7s@rrrs% 6:#'4G//rrc ^\rSrSrSrSr\SSj5rSS\SS4Sjr\ S5r \ S 5r \ S 5r S r S r\ S 5r\ S5rSrSrSSjrSSjrSSjrSSjrSSjrSSjrSSjrU4SjrU4SjrSrU=r$) ResourceSpeczIDefines a Cloud resource as a set of attributes for argument creation. TNc dSSKJn URUSUS9n[UR S5UR 5nU"S UR USURUR S[R5UR S5US .UVs0sHowRU_M snD6$s snf) aConstructs an instance of ResourceSpec from yaml data. Args: yaml_data: dict, the parsed data from a resources.yaml file under command_lib/. is_positional: bool, optional value that determines if anchor argument is a positional and reformats anchor attribute name accordingly. api_version: string, overrides the default version in the resource registry if provided. Returns: A ResourceSpec object. r)registry collection api_versionr=rAdisable_auto_completers plural_name)resource_collection resource_namerrr is_positionalr) $googlecloudsdk.command_lib.util.apisrGetAPICollectionParseAttributesFromDatagetdetailed_params full_namerrdisable_auto_completeparameter_name)cls yaml_datarrrrr=rEs rFromYamlResourceSpec.FromYamls >**,[+:J( l#Z%?%?AJ  M&00'** ) %|'I'I!KMM-0# MAK K 9 # #Y . K MM LsB- resourcec X lXPlXl[RR 5UlUR RXS9UlX@l URRS5n/Ul 0Ul [UR55n Sn [U5HupU [!U5S- :XaSn UR#U [%55n UR'XU US9n[)UU U R*SU R,U R.U R0U R2U R4S9 nURR7U5 XRUR8'M UR(d$[;SR=UR55eU(aD[;S R=URS R?U5S R?U 555eg ) a!Initializes a ResourceSpec. To use a ResourceSpec, give a collection path such as 'cloudiot.projects.locations.registries', and optionally an API version. For each parameter in the collection path, an attribute is added to the resource spec. Names can be created by default or overridden in the attribute_configs dict, which maps from the parameter name to a ResourceParameterAttributeConfig object. ResourceParameterAttributeConfigs also contain information about the help text that describes the attribute. Attribute naming: By default, attributes are named after their collection path param names, or "name" if they are the "anchor" attribute (the final parameter in the path). Args: resource_collection: The collection path of the resource. resource_name: The name of the resource, which will be used in attribute help text. Defaults to 'resource'. api_version: Overrides the default version in the resource registry. disable_auto_completers: bool, whether to add completers automatically where possible. plural_name: str, the pluralized name. Will be pluralized by default rules if not given in cases where the resource is referred to in the plural. is_positional: bool, optional value that determines if anchor argument is a positional and reformats anchor attribute name accordingly. **kwargs: Parameter names (such as 'projectsId') from the collection path, mapped to ResourceParameterAttributeConfigs. Raises: ResourceConfigurationError: if the resource is given unknown params or the collection has no params. rFT)anchorr) rArtrurvrwrxrzrrz?Resource [{}] has no parameters; no arguments will be generatedz_Resource [{}] was given an attribute config for unknown attribute(s): Expected [{}], Found [{}]r*N) _namerrr REGISTRYClone _resourcesGetCollectionInfo_collection_infor GetParams _attributes_param_names_maplistkeys enumeratelenpop ResourceParameterAttributeConfig_AttributeNamerrurwrxrzrrappendrAr"r.r/)r0rrrrrrrcollection_params orig_kwargsrirtattribute_configattribute_name new_attributes rr-ResourceSpec.__init__sLJ")O((..0DO OO==>6D#: --77;DDv{{}%K F"#45  c#$q( (J$D$FH**:289F+Hn $..'44$..%00$4$N$N.BB Dm m,3=M..//60    &(EEKV+/::F7 88 &(C)/tzz/3yy9J/K/3yy/E)G HHrcUR$rc)rr<s rr=ResourceSpec.attributesVs   rcUR$rc)rr<s rrAResourceSpec.nameZs ::rc URS$)z'The "anchor" attribute of the resource.)r=r<s rrResourceSpec.anchor^s ??2 rcXR:H$zConvenience method.)rrDs rrFResourceSpec.IsAnchords  ##rc$URU5$r)rFrDs rrIResourceSpec.IsLeafAnchorhs == ##rcUR$)z.A map from all attribute names to param names.)rr<s rattribute_to_params_map$ResourceSpec.attribute_to_params_mapls   rcUR$rc)rr<s rcollection_infoResourceSpec.collection_infoqs   rc XR;aK[SRUSR[ URR 55555eURU$)z^UUU4Sj$)Nc4>[R"TTT5$rc)deps_libGet)rLrArMsr:ResourceSpec.Initialize..LazyGet..sX\\$(8+Frr)rArLrMs`rLazyGet(ResourceSpec.Initialize..LazyGets FFrrM)rparamsrz/The [{}] resource is not properly specified. {}N)r=rArtrRegisterApiByNamerapi_namerrVrrrrAttributeNotFoundErrorrr.ryr UserError)r0rLrMrrrEr3s `` rrNResourceSpec.Initializes$F G__ %,Y^^%[[U] U5=(a9 URUR:H=(a URUR:H$rc)r,rr`rrrs rr`ResourceSpec.__eq__]sL , ,U 3 N,,0M0MM N,,0M0MMOrc>[[U] 5[[ [ UR UR/55-$rc)r,rrerrrdrrrs rreResourceSpec.__hash__bs? t - /# D4//1M1MNO3Q QQr)rrrrrrrrrrcrg)F)FN)rrrrrr classmethodrr-rhr=rArrFrIrrrrrNrVrYrrrrr`rerr6r7s@rrrsMM>9C9NtVHp       $$ ! ! ! ! 8*(Z9>#@GK"JGK H %  %M&AF#' 3DO QQrrcB\rSrSrSr\S5rSSjrSrg)rigzAConfiguration used to create attributes from resource parameters.c USnUSnUSn[RRUS5nURSS5nURS/5nUVs0sH$nURS5URS 5_M& n n[RU5=n (aU R R 5n O/n [R"URS S 55n U =(a [R"U 5n U (aX;aU RU 5 URS /5n/nUHnS U;a6UR[R"US S U;aUS OS55 M?SU;dMGUR[R"[RRUS5US S95 M X- n U"UUU UUU US9$s snf)zConstructs an attribute config from data defined in the yaml file. Args: data: {}, the dict of data from the YAML file for this single attribute. Returns: ResourceParameterAttributeConfig rrhelprxrNr fieldNamevaluerhrrwhinthook)r)rArurwrxrrr)rHookFromDatar"DEFAULT_RESOURCE_ATTRIBUTE_CONFIGSrwcopyr FromStringrPropertyFallthroughrValueFallthrough FallthroughFromPath)rdatarrrurxrcompletion_request_params_listparamrdefault_configrwpropprop_fallthroughfallthrough_datafallthroughs_from_hookfs rr)ResourceParameterAttributeConfig.FromDatajs*+N*+NV I ""45I((#8$?%)XX.I2%N"4!3E  + ' 223! <??OO~O#00557ll  *b!9 :DB < QvY O *L  !/";% ''A!s+GNc XlX lU=(d /UlU(aU(dU(a [S5eX@lXPlX`lU=(d [UlXl g)aCreate a resource attribute. Args: name: str, the name of the attribute. This controls the naming of flags based on the attribute. help_text: str, generic help text for any flag based on the attribute. One special expansion is available to convert "{resource}" to the name of the resource. fallthroughs: [deps_lib.Fallthrough], A list of fallthroughs to use to resolve the attribute if it is not provided on the command line. completer: core.cache.completion_cache.Completer, the completer associated with the attribute. completion_request_params: {str: value}, a dict of field names to static values to fill in for the completion request. completion_id_field: str, the ID field of the return value in the response for completion commands. value_type: the type to be accepted by the attribute arg. Defaults to str. parameter_name: the API parameter name that this attribute maps to. zLCustom completer and auto-completer should not be specified at the same timeN) rrurwrsrxrrryrzr) r0rArurwrxrrrzrs rr-)ResourceParameterAttributeConfig.__init__sZ8N$*D/3F 4 55N%>"2 'CDO(r)rrxrrrwrurrz)NNNNNNNN) rrrrrrrr-rrrrrrgs7I6'6'r )-#'"&)rrcUVs/sHn[RU5PM nnUVs/sHo"RPM nn/nUHnU(a4XcSR:Xa"URUR S55 M>U[ ;a7[ Un[ RU5nXhlURU5 M[UU5e U(a [UU5eU$s snfs snf)aParses a list of ResourceParameterAttributeConfig from yaml data. Args: attributes_data: dict, the attributes data defined in command_lib/resources.yaml file. expected_param_names: [str], the names of the API parameters that the API method accepts. Example, ['projectsId', 'instancesId']. Returns: [ResourceParameterAttributeConfig]. Raises: InvalidResourceArgumentLists: if the attributes defined in the yaml file don't match the expected fields in the API method. r) rrrrrr+rrr%) attributes_dataexpected_param_namesaraw_attributesregistered_param_namesfinal_attributes expected_namerignored_attributes rrrs"=LrEs2 *'' =:@Q**).J  ..%.55555+3&CKK+3\4O4On/ /DKQ;KQ\ b)vb)J0f$D J  ,$$Z%6%6%;%;%C%CD $ /&1"?@r