"dZddlmZddlmZddlmZddlZddlZddlmZddl m Z ddl m Z dd l m Z dd lmZdd lmZdd lmZdd lmZddlmZ ddlmZddlmZddlmZGddeZGddeZGddeej8Zd3dZGddeZGddeZ Gdde Z!Gd d!e Z"d"Z#d#Z$d$Z%d%Z&d&Z'd'Z(d(Z)d)Z*d*Z+d+Z,d,Z-Gd-d.eej8Z.Gd/d0e.Z/Gd1d2e.Z0y)4zJHelpers for loading resource argument definitions from a yaml declaration.)absolute_import)division)unicode_literalsN)base)concepts) multitype)util) arg_utils)registry) update_args)update_resource_args)yaml_command_schema_util)concept_parsers)presentation_specs)textceZdZdZddZdZy) Argumentsz>Everything about cli arguments are registered in this section.Nc tjj|d|_|j dg}|j |j |||xsi}|Dcgc]'}tj||j d)c}|_|j drt|j dnd|_ |j dg|_ ycc}w)Nadditional_arguments_hookparams api_versionlabelsexclude) r HookFromDatargetextend_GetResourceData YAMLArgumentrLabelsrr)selfdata request_data params_data param_datas ;lib/googlecloudsdk/command_lib/util/apis/yaml_arg_schema.py__init__zArguments.__init__*s%)YY%7%7 )&+D"((8R(Kt,,T<@A%2L&'%J j,*:*:=*IJ%'DK150B&(+,DK88Ir*DL 's#,C!c|xsi}|jd}|sgSgd}|D]P}|j|}||j|$tjdj||||<R|jdi|d<|gS)aGets the resource data from the arguments and request data. This a temporary method to align the old and new schemas and should be removed after b/272076207 is complete. Args: data: arguments yaml data in command. request_data: request yaml data in command. Returns: resource data with missing request params. Raises: InvalidSchemaError: if the YAML command is malformed. resource)resource_method_paramsparse_resource_into_requestuse_relative_namez][{}] is defined in both request and argument.param. Recommend only defining in argument.paramspec resource_spec)rr InvalidSchemaErrorformat)r!r"r#r)moved_request_params request_paramparams r&rzArguments._GetResourceData:s  %2Lxx #H  i . }-e   << & 2''006}0EG G#(.!) VR 8H_ :N)__name__ __module__ __qualname____doc__r'rr4r&rr'sF + (r4rceZdZdZdZy)r z)Everything about labels of GCP resources.c|d|_y)N api_fieldr=)r!r"s r&r'zLabels.__init__hs+&DNr4N)r6r7r8r9r'r:r4r&r r es 1'r4r ceZdZdZeddZeejdZ ejdZ ejdZ ejdZ y) rzvRoot for generating all arguments from yaml data. Requires all subclasses to contain Generate and Parse methods. Nc|jd}|rtj||S|jdrtj||Stj|S)Ngroupr.)r ArgumentGrouprYAMLConceptArgumentArgument)clsr"rrAs r&rzYAMLArgument.FromDatarsV HHW E  # #E; 77 xx ) )$ <<   T ""r4cy)z)List of api fields this argument maps to.Nr:r!s r& api_fieldszYAMLArgument.api_fields}r4cy)zEWhether the argument with an api field is specified in the namespace.Nr:r! namespaces r&IsApiFieldSpecifiedz YAMLArgument.IsApiFieldSpecifiedrIr4cy)z(Generates and returns the base argument.Nr:r!methodsshared_resource_flagss r&GeneratezYAMLArgument.GeneraterIr4cy)zGParses namespace for argument's value and appends value to req message.Nr:r!methodmessagerLgroup_requireds r&ParsezYAMLArgument.ParserIr4r5) r6r7r8r9 classmethodrpropertyabcabstractmethodrHrMrRrXr:r4r&rrls ## 4 4PP33RRr4r) metaclassc:td|jjD}|xrtj|}||vry|rdt j D}nd}d}tj||D]}dj|||vsyy)aTProvides whether or not the argument has been specified. Args: namespace: user specified arguments arg_dest: str, normalize string of the argument name clearable: Boolean, True if param has clearable arguments such as clear, add, etc Returns: Boolean, whether or not the argument is specified in the namespace c3FK|]}tj|ywr5) resource_utilNormalizeFormat).0keys r& z_IsSpecified..s#64###C(4!Tc34K|]}|jywr5)value)rbprefixs r&rdz_IsSpecified..sE2Dv||2Dr:)noz{}_{}F) setGetSpecifiedArgskeysr`rar Prefix itertoolschainr0)rLarg_dest clearablespecified_args_listdestupdate_prefixesnegative_prefixesrhs r& _IsSpecifiedrws6++-22466  =m33H=$  E+2D2DEOO1BCf~~fd#':: D r4ceZdZdZeddZ dfd ZedZedZ dZ dZ dZ d Z d Zd Zdd Zdd ZxZS)rBaEncapsulates data used to generate argument groups. Most of the attributes of this object correspond directly to the schema and have more complete docs there. Attributes: help_text: Optional help text for the group. required: True to make the group required. mutex: True to make the group mutually exclusive. hidden: True to make the group hidden. arg_name: The name of the argument that will be generated. clearable: True to automatically generate update flags such as `clear` settable: True to automatically generate arg_object flag to set the value of the whole argument argument group. arguments: The list of arguments in the group. c|jddrtj|}nd}|jddrtj|}nd}||jd|jdd|jdd|jdd|jd |jd |jd Dcgc]}tj||c}|| Scc}w) aGets the arg group definition from the spec data. Args: data: The group spec data. api_version: Request method api version. Returns: ArgumentGroup, the parsed argument group. Raises: InvalidSchemaError: if the YAML command is malformed. settableFNrr help_textrequiredmutexhiddenr=arg_namer) r{r|r}r~r=r arguments settable_arg clearable_arg)rSettableArgumentForGrouprClearableArgumentForGroupr)rEr"rrritems r&rzArgumentGroup.FromDatas xx E"-66tmm ((;'*e,hhw&xx%(((;'*%#xx131t (({;13!#  3s C4c tt| ||_||_||_||_||_||_||_ | |_ ||_ yr5) superrBr'r{r|r}r~rr _settable_arg_clearable_arg _api_field) r!r{r|r}r~r=rrrr __class__s r&r'zArgumentGroup.__init__sS -')DNDMDJDKDMDN%D'DDOr4cbg}|jD]}|j|j|Sr5)rrrH)r!rHargs r&rHzArgumentGroup.api_fieldss-J~~' r4cp|jr |jStj|jS)zDReturns api field that is the parent of all api fields in the group.)rr GetSharedParentrHrGs r&parent_api_fieldzArgumentGroup.parent_api_fields*  __  & &t 77r4cD|jx}xr|j|Sr5)rrMr!rLrs r&_SettableIsSpecifiedz"ArgumentGroup._SettableIsSpecifieds#%% %C M3+B+B9+MMr4cD|jx}xr|j|Sr5)rrMrs r&_ClearableIsSpecifiedz#ArgumentGroup._ClearableIsSpecifieds#&& &C NC,C,CI,NNr4c|j|s|j|ry|jD]}|j|syy)NTF)rrrrMrs r&rMz!ArgumentGroup.IsApiFieldSpecified sE !!), ""9- ~~  +r4cV|jxr|jj||S)z;Returns the clear flag for the argument group if specified.)rrRrOs r&_GenerateClearFlagz ArgumentGroup._GenerateClearFlags.    I    ( (2G HJr4cV|jxr|jj||S)z9Returns the set flag for the argument group if specified.)rrRrOs r&_GenerateSetFlagzArgumentGroup._GenerateSetFlags.    H    ' '1F GIr4c 8d|jD}tjd|j|jd|j d|j jddj|d}|j||j||S) z.!s"M .*S(2K s))TzSet the value of z by using flag [z ] or flags [, ].)r}r|r~help) rrrBr|r~rrrjoin AddArgument)r! base_groupset_flag arg_names mutex_groups r&_GenerateMutexGroupz!ArgumentGroup._GenerateMutexGroupsM $MI$${{01""++,- )$%R ) KJ'H% r4ctj|j|j|j|j }|j D]#}|j|j||%|j||x}r|j||j||x}r |j r|j||S|S|S)aGenerates and returns the base argument group. Args: methods: list[registry.APIMethod], used to generate other arguments shared_resource_flags: [string], list of flags being generated elsewhere Returns: The base argument group. )r}r|rr~) rrBr}r|r{r~rrrRrrr)r!rPrQrr clear_flagrs r&rRzArgumentGroup.Generate1s##jj4==t~~{{J~~S\\'3HIJ,,W6KLLzLZ(((2GHHxH   '' H== r4c@tj||||jr|jj|||||jr|jj|||||j D]$}|j||||xr |j &y)aUSets argument group message values, if any, from the parsed args. Args: method: registry.APIMethod, used to parse sub arguments. message: The API message, None for non-resource args. namespace: The parsed command line argument namespace. group_required: bool, if true, then parent argument group is required N)r ClearUnspecifiedMutexFieldsrrXrrr|)r!rUrVrLrWrs r&rXzArgumentGroup.ParseOs))'9dC  NK  vw >J~~ iiN,Lt}}Mr4r5) NFFFNNNNNT)r6r7r8r9rYrr'rZrHrrrrMrrrrRrX __classcell__rs@r&rBrBs"""HJO(,@D      8 8NO J I $<Nr4rBceZdZdZedZddddddddejdddddddddffd Ze dZ dZ d Z d Z d Zd Zdd ZddZxZS)rDayEncapsulates data used to generate arguments. Most of the attributes of this object correspond directly to the schema and have more complete docs there. Attributes: api_field: The name of the field in the request that this argument values goes. disable_unused_arg_check: Disables yaml_command_test check for unused arguments in static analysis. arg_name: The name of the argument that will be generated. Defaults to the api_field if not set. help_text: The help text for the generated argument. metavar: The metavar for the generated argument. This will be generated automatically if not provided. completer: A completer for this argument. is_positional: Whether to make the argument positional or a flag. type: The type to use on the argparse argument. choices: A static map of choice to value the user types. default: The default for the argument. fallback: A function to call and use as the default for the argument. processor: A function to call to process the value of the argument before inserting it into the request. required: True to make this a required flag. hidden: True to make the argument hidden. action: An override for the argparse action to use for this argument. repeated: False to accept only one value when the request field is actually repeated. generate: False to not generate this argument. This can be used to create placeholder arg specs for defaults that don't actually need to be generated. clearable: True to automatically generate update flags such as `clear`, `update`, `remove`, and `add` c j|jd}|jd}|jd|}|stjd|jd}|r|nd|z}|jdr&|jdrtjd  |d }|jd }|did|d|d |d |jd dtjj |dd|dtj |d |r#|D cgc]} tj| c} ndd|jdtjdtjj |ddtjj |dd|jddd|jdddtj|jd|d|jdd|d|jddS#t$rtjd wxYwcc} w)zGets the arg definition from the spec data. Args: data: The spec data. Returns: Argument, the parsed argument. Raises: InvalidSchemaError: if the YAML command is malformed. r=disable_unused_arg_checkrz *%  ":! "((;.#  H  # #$F GGH2sHH0H-NFTc&tt| ||_||_||_||_||_||_||_ ||_ ||_ | |_ | |_ | |_| |_| |_||_||_||_||_yr5)rrDr'r=rrr{rrrrrrrrr|r~rrgeneraterr)r!r=rr{rrrrrrrrr|r~rrrrrrrs r&r'zArgument.__init__s& (D"$DN$rGs r&rHzArgument.api_fieldss#~~DNN 525r4c|jsyt|tj|j|j S)NF)rLrqrr)rHrwr`rarrrrKs r&rMzArgument.IsApiFieldSpecifieds5 ??  ..t}}=.. ""r4c`|r,|jr tj||jSy)z.Gets apitools field associated with api_field.N)r=r GetFieldFromMessage)r!rVs r& _GetFieldzArgument._GetFields%4>>  * *7DNN CC r4c|r |jsy|j|dj}|D]}|j|j}|j|jk7s3|j|jk7s|j |j k7sndj d|D}tjd|jd|d|S)z;Gets apitools field associated with api_field from methods.Nrrc3PK|]}|jj ywr5)GetRequestTyper6rbrUs r&rdz0Argument._GetFieldFromMethods..s$"D;BF ! ! # , ,7s$&z&Unable to generate flag for api field z,. Found non equivalent fields in messages: [r) r=rrnamevariantrrr r/)r!rPfieldrU other_field message_namess r&_GetFieldFromMethodszArgument._GetFieldFromMethodss $..  NN71:446 7ENN6#8#8#:;k ** (( ( --;.. . ..K00 0 "D;B"DD %%4T^^4DE99Fr KL L Lr4cBtjj||S)z4Creates update flags generator using aptiools field.)r UpdateBasicArgumentGenerator FromArgData)r!rs r&_GenerateUpdateFlagszArgument._GenerateUpdateFlagss  3 3 ? ?e LLr4cf|j|}|j|j||Sz@Parses update flags and returns modified apitools message field.)rrrX)r!rLrVrs r&_ParseUpdateArgsFromNamespacez&Argument._ParseUpdateArgsFromNamespaces. NN7 #E  $ $U + 1 1)W EEr4c|j|}|jr!|r|j|jSt j ||S)zGenerates and returns the base argument. Args: methods: list[registry.APIMethod], used to generate other arguments. shared_resource_flags: [string], list of flags being generated elsewhere. Returns: The base argument. )rrrrrRr GenerateFlag)r!rPrQrs r&rRzArgument.GeneratesJ  % %g .E ~~%  & &u - 6 6 88  # #E4 00r4c 0~~|jy|jrE|j||}|j|r!t j ||j|yt j ||j|j}|y|j|}t j|||j|jtjj|j }t j ||j|y)dSets the argument message value, if any, from the parsed args. Args: method: registry.APIMethod, used to parse other arguments. message: The API message, None for non-resource args. namespace: The parsed command line argument namespace. group_required: bool, whether parent argument group is required. Unused here. N)r)rrr)r=rrrrMr SetFieldInMessageGetFromNamespacerrr ConvertValuerrr r ToChoiceMapr)r!rUrVrLrWrgrs r&rXzArgument.Parse(s  ~~  ~~00GDe ! !) ,##GT^^UC  & &4==4== :E } NN7 #E  " " ut}} '' 5 7E?r4r5r)r6r7r8r9rYrr rr'rZrHrMrrrrrRrXrrs@r&rDrDfs!F22l! ,,(-%%N 6 6"(MF 1"@r4rDc8eZdZdZedZ dfd ZxZS)rzFEncapsulates data used to generate arg_object flag for argument group.c  |d}|d}||||jd|jdd|jddtjj |d  S#t$rtjdwxYw) 1Gets the arg group definition from the spec data.r=rz=Settable argument group must have api_field and arg_name set.r{r|Fr~T)disable_key_description)r=rr{r|r~arg_type)rr r/r ArgObjectrrEr"r=rs r&rz!SettableArgumentForGroup.FromDataLsK{#ij!h ((;'*e,xx%(((t(L   K  # # I KKKs A((Bc8tt| ||||||y)Nr=rr{r|r~r)rrr')r!r=rr{r|r~rrs r&r'z!SettableArgumentForGroup.__init___s* "D2  3r4)NFFN)r6r7r8r9rYrr'rrs@r&rrIs,N$DI&*  r4rc<eZdZdZedZdfd ZddZxZS)rzEncapsulates data used to generate a clearable flag. Clearable flag is specifically for clearing a message field corresponding to the argument group. c  |d}|d}|||d|jddS#t$rtjdwxYw)rr=rz>Clearable argument group must have api_field and arg_name set.Fr~)r=rr|r~)rr r/rrs r&rz"ClearableArgumentForGroup.FromDatarsmL{#ij!h xx%(   L  # # J LLLs (Ac tt| |djtj j jtj|fd|d||ty)N-zSet z back to default value.r) rrr'rr rnCLEARrgr` KebabCasebool)r!r=rr|r~rs r&r'z"ClearableArgumentForGroup.__init__sg #T3    % % + +  $ $X . 01 #:; 4 r4ctj||jr!tj||jyyr5)r rrResetFieldInMessager=rTs r&rXzClearableArgumentForGroup.Parses/!!)T]];##GT^^<.s@%?QVV%?ri)rrr Pluralize)r.rcountrs r&_GetPresentationNamer s7"!Q% @[%?@ @$ t $$r4ctd|D}t|dkDrtjd|r|j Sy)Nc3<K|]}|jywr5)IsListrs r&rdz_GetIsList..s6gF gsrzMethods used to generate YAMLConceptArgument cannot contain both list and non-list methods. Update the list of methods to only use list or non-list methods.F)rklenr r/pop)rPis_lists r& _GetIsListrsJ 6g6 6'\A  ! ! $ %%  ;;= r4ci}|jD]Y\}}|d}nJt|tr$|Dcgc]}tj||}}ntj||}|||<[|Scc}w)aGenerates a map of message fields to respective resource attribute value. Ex: If you have a resource arg... projects/foo/locations/us-central1/instances/bar ...and you want to set the `parent` field in the request message to the resource's relative name, you would use this function like... _GetResourceMap(ref, {'parent': '__relative_name__'}) ...and it would return... {'parent': 'projects/foo/locations/us-central1/instances/bar'} Args: ref: Parsed resource arg. resource_method_params: A dict of message field name to resource attribute name. Returns: A dict of message field name to resource attribute value. N)itemsrlistr FormatResourceAttrStr)refr*message_resource_mapmessage_field_name param_strvaluesrs r&_GetResourceMaprs*'='C'C'E#) {f C BEF#Q**9a8#fF)))S9f/5+,(F  GsA1c|jddrtj|dStj|dS)z>Returns the fallthrough string for the given fallthrough data.rFr)rr`PositionalFormatFlagNameFormat)fallthrough_datas r&_FallthroughFlagFromDatar!s@/51  ) )*::*F GG  ' '(8(D EEr4ci}|xsijD]"\}}|Dcgc] }t|}}|||<$|Scc}w)zB&E&E&G"i",=?,=[2+>,=?,=y)'H $# ?s>c |xsg}i}|j}|j|jDcic] \}}||vr|tj|g"c}}t j ||||Scc}}w)axGenerate a map of fallthroughs for the given argument. Generates a map of a resource attribute name and the flag it should default to for the ConceptParser. The shared (ignored) flags have to be added manually since they are not added by the ConceptParser. Args: arg_fallthroughs: A dict of fallthroughs for the given argument. attribute_to_flag_map: The names of the attributes in the resource spec. shared_resource_flags: Flags that are already generated elsewhere. presentation_flag_name: The name of the anchor argument. Returns: A dictionary of resource attributes to fallthrough flags )copyupdaterr`rrUpdateFallthroughsMap) arg_fallthroughsattribute_to_flag_maprQpresentation_flag_namesharedr$full_arg_fallthroughsrflags r&_GenerateFullFallthroughsMapr3s& ! &B&!*//1-335 5*$ ] ) )$ / 005  '' "8:OQ ## s%A= cp||xsgz}|jDcic] \}}||vr|dc}}Scc}}w)aGenerate a map of flags that should be ignored. Flags are either ignored because they have already been generated elsewhere or because the command explicitly removed them. Args: shared_resource_flags: Flags that are already generated elsewhere ignored_flags: Flags that have been explicitly removed in the command attribute_to_flag_map: Attributes mapped to flag names Returns: A map of flags to ignore to an empty string. )r)rQ ignored_flagsr.all_ignored_flagsrr2s r&_GenerateIgnoredFlagsMapr8(sT$'<'BC!6! !>:4 " " Bh!>  s2cttdtjj D}|Dcgc] }||vr|| }}||zScc}w)z.Returns all the flags that need to be removed.c3FK|]}tj|ywr5)r`r)rbr2s r&rdz#_AllRemovedFlags..@s#42$""4(2re)rrkrIGNORED_FIELDSr) removed_attrsatribute_to_flag_mapignoredr removed_flagss r&_AllRemovedFlagsr@>sp 4))00244 5'.;'-:T % %4 ]' =  'sAc8eZdZdZeddZ ddZeejdZ eejdZ eejdZ eejdZ eejd Zeejd Zeejd Zejd Zej dd ZejddZejdZedZddZddZdZy)rCaEncapsulate data used to generate and parse all resource args. YAMLConceptArgument is parent class that parses data and standardizes the interface (abstract base class) for YAML resource arguments by requiring methods Generate, Parse, and ParseResourceArg. All of the methods on YAMLConceptArgument are private helper methods for YAML resource arguments to share minor logic. Nc|sy|d}|d}id|jdd|jddd|jdd|jdd|jdd |jd id |jd d |jd d |jd id |jd dd|jddd|jddd|jdd|jddd|d|jdd}d|dvr t||fi|St||fi|S)Nr.r{ris_parent_resourceFis_primary_resourcer?rr$display_name_hookrequest_id_fieldr*r+Tr,override_resource_collectionr|rrequest_api_versionrr resources)rYAMLMultitypeResourceArgumentYAMLResourceArgument)rEr"rr.r{kwargss r&rzYAMLConceptArgument.FromDataSs  )M[!I/2dhh';UC txx(=> /2  DHHZ(  %dhh ("'.  TXX&9: DHH%78 !$((+CR"H &txx )4(1 TXX&94@ ' *E)3 DHHZ(!" DHHZ/#$ {%& TXXk51'F,d?++ *=) Nv NN !- Ef EEr4c ||_||_||_||_||_|xsg|_t ||_| xs|jd|_ | xsi|_ | |_ | |_ ||_ ||_||_||_|d|_|jd|_| r%t&j(j+| |_yd|_y)NrFr plural_name)flag_name_override group_help_is_positionalrCrD_removed_attrsr(r$rrFr*r+r,rG _requiredrrrr _plural_namer rFromPathrE)r!r"rPrr?rCrDrr$rErFr*r+r,rGr|rrr unused_kwargss r&r'zYAMLConceptArgument.__init__us'D DO'D0D2D'-2D&F"'$D#-L9K0LD"8">BD'BD$.D(DD%DNDMDNV DI/D2C ,- HL r4cy)z@"Get registry.APICollection based on collection and api_version.Nr:rGs r& collectionzYAMLConceptArgument.collection r4cy)z?Get registry.APICollection based on collection and api_version.Nr:rGs r& collectionszYAMLConceptArgument.collectionsrYr4cy)z'Get the anchors from the resource spec.Nr:rGs r&anchorszYAMLConceptArgument.anchorsrYr4cy)z&Whether the resource arg is multitype.Nr:rGs r&rzYAMLConceptArgument.multityperYr4cy)z)Names of attributes in the resource spec.Nr:rGs r&attribute_namesz#YAMLConceptArgument.attribute_namesrYr4cy8Returns a map of attribute name to normalized flag name.Nr:rGs r&r.z)YAMLConceptArgument.attribute_to_flag_maprYr4cyrbr:rGs r&r6z!YAMLConceptArgument.ignored_flagsrYr4cy)z8Determines if this resource arg is the primary resource.Nr:r!resource_collections r&IsPrimaryResourcez%YAMLConceptArgument.IsPrimaryResource r4cy)z/Generate the resource arg for the given method.Nr:)r!rUr/rOrQrPs r&GenerateResourceArgz'YAMLConceptArgument.GenerateResourceArgs  r4cy)z9Parses the resource ref from namespace (no update flags).Nr:)r!rLrWs r&ParseResourceArgz$YAMLConceptArgument.ParseResourceArgrir4cy)z3Get the anchor argument name for the resource spec.Nr:)r!rgis_list_methods r&GetPresentationFlagNamez+YAMLConceptArgument.GetPresentationFlagNamerir4cd|jr#t|jjSgS)z:Where the resource arg is mapped into the request message.)r*rrmrGs r&rHzYAMLConceptArgument.api_fieldss, "" $--224 55 ir4cb|j |jS|j|}|xr| S)a~Determines if the resource arg is positional. Args: resource_collection: APICollection | None, collection associated with the api method. None if a methodless command. is_list_method: bool | None, whether command is associated with list method. None if methodless command. Returns: bool, whether the resource arg anchor is positional )rQrh)r!rgrorDs r& IsPositionalz YAMLConceptArgument.IsPositionals< &   001DE  5~#55r4cT|j |jS|j|S)zDetermines if the resource arg is required. Args: resource_collection: APICollection | None, collection associated with the api method. None if a methodless command. Returns: bool, whether the resource arg is required )rSrhrfs r& IsRequiredzYAMLConceptArgument.IsRequireds* ~~! ^^  ! !"5 66r4c|D]+}|j|js|jcS|r|djSdS)Nr)rhresource_argument_collection)r!rPrUs r&_GetMethodCollectionz(YAMLConceptArgument._GetMethodCollectionsF   C C D222 9@WQZ 4 4ITIr4r5)NNFNNNNNNTTFNFFNNNNrNF)r6r7r8r9rYrr'rZr[r\rXr[r]rr`r.r6rhrkrmrprHrsrurxr:r4r&rCrCIsFFBJN=A9=8EF F'r4cXtj|j|jS)Nr)r GetAPICollectionrrrGs r&rXzYAMLResourceArgument.collection8s(  $ $ ""0A0A CCr4c|jgSr5)rXrGs r&r[z YAMLResourceArgument.collections=s OO r4cyrzr:rGs r&rzYAMLResourceArgument.multitypeAs r4c,t|jSr5r_resource_specrGs r&r]zYAMLResourceArgument.anchorsE t** ++r4c,t|jSr5rrrGs r&r`z$YAMLResourceArgument.attribute_namesI d11 22r4c ~tj|j|jj}tj |jj f|j|jj|j|j|jd|Dcic]}|j|c}Scc}w)&Resource spec generated from the YAML.) resource_namerrrNr) rParseAttributesFromDatarrXdetailed_params ResourceSpec full_namerrrrTrQparameter_name)r!r attributes r&rz#YAMLResourceArgument._resource_specMs 11 T__<<>J   !! MiiOO// $ = =%% )) MAK K 99 # #Y . K M M Ls!B: cr|jr |jSt|j|jSr5rOr rrrGs r&rz&YAMLResourceArgument.presentation_namec0   $ $$ !$"5"5t}} EEr4cz|jdtj|jdidjS)-Returns a map of attribute name to flag name.FN_GeneratePresentationSpecr`rrattribute_to_args_maprGs r&r.z*YAMLResourceArgument.attribute_to_flag_mapl<  ) ) }++D,B,BC b$ r4c|jjDcic]\}}|tj|c}}Scc}}wr5r.rr`rar!rr2s r&_attribute_to_flag_dest_mapz0YAMLResourceArgument._attribute_to_flag_dest_mapwL44::< 1;;FFsKq!  $ $t'8'8 ::r4cN|js |jy|r |jry|jr|j|}|j|j k7rQ|jrDt jdj|j|j|j y|jrj|j|jk7rQ|jrDt jdj|j|j|jyy)Determines whether this resource arg is primary for a given method. Primary indicates that this resource arg represents the resource the api is fetching, updating, or creating Args: resource_collection: APICollection | None, collection associated with the api method. None if a methodless command. Returns: bool, true if this resource arg corresponds with the given method collection FTzaCollection names do not match for resource argument specification [{}]. Expected [{}], found [{}]z]API versions do not match for resource argument specification [{}]. Expected [{}], found [{}]) rDrGrCrrrr r/r0rrrrfs r&rhz&YAMLResourceArgument.IsPrimaryResources   # #(@(@(L  $"C"C   334GH$$(B(BB ! !%% . VDII2<<..01 1   0<<< ! !%% . VDII2>>%%'( (  r4c rtj||j|d|i|xsi||jSNF)rPprefixesr|flag_name_overridesplural)rResourcePresentationSpecrrr! is_requiredr/rOignored_flag_maprPs r&rz.YAMLResourceArgument._GeneratePresentationSpecsG  6 6 N 2 8bN=MN}} r4ct|j|j||}t||j|j}|j |j |||||}tj|g|Sz2Generates only the resource arg (no update flags).)r$ r3r$r.r8r6rrur ConceptParser r!rUr/rOrQrPr$rpresentation_specs r&rkz(YAMLResourceArgument.GenerateResourceArg "> '' ""5"7 0  ""$ 66 !7,j:  ( ( #= ??r4ct|j||j|j|j}|s|syt j |j|j}|xr|jSa$Parses the resource ref from namespace (no update flags). Args: namespace: The argparse namespace. group_required: bool, whether parent argument group is required Returns: The parsed resource ref or None if no resource arg was generated for this method. N) rrrrrrr rCONCEPTSrX)r!rLrWanchor_specifiedresults r&rmz%YAMLResourceArgument.ParseResourceArgsr$*  ((    N   ' 'D224F  $flln$r4c|jsyt|j||j|j|j SrzrHrrrrrrrKs r&rMz(YAMLResourceArgument.IsApiFieldSpecifieds> ??    ((    r4cb|j|| }|rd|jzS|jSaGet the anchor argument name for the resource spec. Args: resource_collection: APICollection | None, collection associated with the api method. None if a methodless command. is_list_method: bool | None, whether command is associated with list method. None if methodless command. Returns: string, anchor in flag format ie `--foo-bar` or `FOO_BAR` rrsrr!rgroanchor_arg_is_flags r&rpz,YAMLResourceArgument.GetPresentationFlagNameG"..^--  t%%%;#'#9#9;r4cFtjj||||Sz6Creates update flags generator using aptiools message.r UpdateResourceArgumentGeneratorrr!rgrorQs r&rz)YAMLResourceArgument._GenerateUpdateFlags* ? ? K K !>3H JJr4cF|j||j||SrrrXr!rgrorLrVs r&rz2YAMLResourceArgument._ParseUpdateArgsFromNamespace)  $ $^ --2U9g-FGr4c|j|}t|}|jr!|j|||j S|j ||j ||d||jS)zGenerates and returns resource argument. Args: methods: list[registry.APIMethod], used to generate other arguments. shared_resource_flags: [string], list of flags being generated elsewhere. Returns: Resource argument. Nr/rOrQrPrxrrrrrRrkrprPr!rPrQrgros r&rRzYAMLResourceArgument.Generate#s33G<(N ~~  & & ~/DFFNhjQ % % !%!=!=!>"3! 5__ &&&r4c |jr1|j|xr |j|j||}n|j ||}|j xs|j |}|jr|s|sytj|||t||j|j|j|j|xr |jy)rNrrFr,rDrrrrwr rmrHrMr+r ParseResourceIntoMessagerr*rFr,rhr!rUrVrLrWruser_specifieds r&rXzYAMLResourceArgument.Parse<s ~~  . .  8V88 --/ W c  ! !)^ "3! 5__ &&&r4c |jr1|j|xr |j|j||}n|j ||}|j xs|j |}|jr|s|sytj|||t||j|j|j|j|xr |jy)Nrrrs r&rXz#YAMLMultitypeResourceArgument.ParseJs ~~  . .  8V88 --/ W c  ! !)^ rs Q&' (56B:9<EQDG);;|'V' R6S[[ RFBsNLsNl`@|`@FxD&=&=R:,  %. BF $$@,!~J,#++~JBQ=.Q=h B=$7B=r4