=dZddlmZddlmZddlmZddlZddlmZddlmZddl m Z dd l m Z dd l mZdd lmZddlZdd lmZd ZdZGddej,ej.eZGddeZGddeZy)z2Classes for runtime handling of concept arguments.)absolute_import)division)unicode_literalsN) arg_parsers)base)deps)util) completers)text)filterzFID of the {resource} or fully qualified identifier for the {resource}.zHIDs of the {resource} or fully qualified identifiers for the {resource}.ceZdZdZedZedZejdZ dZ dZ dZ ejd d Z d Zy) ConceptInfoaHolds information for a concept argument. The ConceptInfo object is responsible for holding information about the dependencies of a concept, and building a Deps object when it is time for lazy parsing of the concept. Attributes: concept_spec: The concept spec underlying the concept handler. attribute_to_args_map: A map of attributes to the names of their associated flags. fallthroughs_map: A map of attributes to non-argument fallthroughs. ct)z1The concept spec associated with this info class.NotImplementedErrorselfs r<rrequiredr=r@rA __class__s rr8zResourceInfo.__init__}sn: ,&(.D%D-D!6DDK DO#|DDJDKDL!DDMrc|jSr,)r:rs rrzResourceInfo.concept_specs   rc|jSr,)rrs r resource_speczResourceInfo.resource_specs   rc|jSr,)r;rs rrzResourceInfo.fallthroughs_maps  ! !!rc|jj}|dj|ddz}|jddjddS)zAThe title of the arg group for the spec, in all caps with spaces.rN_ -)rnameupperreplace)rrPs rtitlezResourceInfo.titlesM    ! !D 7==?T!"X %D <<S ! ) )#s 33rc8|jj|Sr,rIsAnchorr attributes r _IsAnchorzResourceInfo._IsAnchors    % %i 00rcb|jj|j|jSr,)rBuildFullFallthroughsMapr<rrs rr[z%ResourceInfo.BuildFullFallthroughsMaps-    5 5 ""  rcl|jj|g}tj|S)aAGets a list of string hints for how to set an attribute. Given the attribute name, gets a list of hints corresponding to the attribute's fallthroughs. Args: attribute_name: str, the name of the attribute. Returns: A list of hints for its fallthroughs, including its primary arg if any. )r[getdeps_libr)rr fallthroughss rrzResourceInfo.GetHintss000266~rJL   \ **rc ttttt|jj dk(rd}nd}dj |j|j|g}|jjDcgc]3}|jj|js |j5}}|rz|jd|D]d}|j|Dcgc]}dj |}}|s3dj |dj|}|j|fd j|Scc}wcc}w) z(Build group help for the argument group.rLz!This represents a Cloud resource.zSThe arguments in this group can be used to specify the attributes of this resource.z{} resource - {} {}zZ(NOTE) Some attributes are not given arguments in this group but can be set in other ways. * {} To set the `{}` attribute:{}.;rN)lenlistr boolr<valuesformatrSr>rI attributesr]rPappendrjoin)r generic_help descriptionrX skip_flags attr_namehinthintss rr zResourceInfo.GetGroupHelpsQ 4tT$"<"<"C"C"EFG HIQN8l5l(//  K )-(:(:(E(E?(E9))--inn= (E?DE!).2mmI.FH.FdHOOD !.F H 299 sxx  4 " 88K  #?Hs 8E1Ec|jry|jj}|jj |j dr'|j j |j gsyy)a8True if the resource is required and any arguments have no fallthroughs. If fallthroughs can ever be configured in the ResourceInfo object, a more robust solution will be needed, e.g. a GetFallthroughsForAttribute method. Returns: bool, whether the argument group should be required. FNT)r?rIanchorr<r]rPr)rrss r args_requiredzResourceInfo.args_requireds[      & &F ""&&v{{D9%%))&++r:  rc  |j|r|jstnt}n |j}t j |jrdnd|jjt|jdd}|j|jDcgc]}dj|}}|r0dj|jdj|}||z }|j| Scc}w) z2Helper to get the help text for the attribute arg.rL plural_nameNr=rarbrc)resource) rYr= ANCHOR_HELPPLURAL_ANCHOR_HELP help_textr PluralizerIrPgetattrrrhrk)rrXr|expansion_namerprqs r_GetHelpTextForAttributez%ResourceInfo._GetHelpTextForAttributes ~~i %)[[+6Hi%%i^^ [[a t))=$?AN +/-- *G I*G$*G  I 0 7 7 ..#((5/d4i   ^  44 Is#Dc|j xr:|j|xr'|jj|jg Sr,)rArYrr]rPrWs r_IsRequiredArgzResourceInfo._IsRequiredArgsC{{? ; y! :  ! ! % %innb 99;rc@|j|xr |jSr,)rYr=rWs r _IsPluralArgzResourceInfo._IsPluralArgs >>) $ 44rc|j|}|j|}|j|}|jr |j}nC|jj s+t j|j|j}nd}||j||jd}tj|rI|r|r|jddi|S|r|s|jddi|S|s|jddi|S|jdtj|i|r|jdd i|r%|jd tj i|S) z:Constructs the kwargs for adding an attribute to argparse.N)helptype completerrAnargs+*?metavarrETr)rrrrrIdisable_auto_completersr CompleterForAttributerP value_typerAr IsPositionalupdate MetavarFormatrArgList)rrPrXrEfinal_help_textr=r kwargs_dicts r_KwargsForAttributez ResourceInfo._KwargsForAttribute!se ""9-H33I>O   y )F%%i    7 722    ..ii$$++ K   HGS>*  (GS>* GS>*  )T%7%7%=>? J-. FK$7$7$9:; rc|jj|jd}|sytj|fi|j ||S)z*Creates argument for a specific attribute.N)r<r]rPrArgumentr)rrXrPs r_GetAttributeArgzResourceInfo._GetAttributeArgIsM  % % ) ))..$ ?D   ==  5  " "4 3 55rcg}|jjD]'}|j|}|s|j|)|S)z+Generate args to add to the argument group.)rIrirrj)rargsrXargs rr#zResourceInfo.GetAttributeArgsSsC D''22  ! !) ,c  C3 Krc|j}|sy|jxs|}td|D}|j|j |j |}|D]}|j |y)a.Adds all attributes of the concept to argparse. Creates a group to hold all the attributes and adds an argument for each attribute. If the presentation spec is required, then the anchor attribute argument will be required. Args: parser: the parser for the Calliope command. Nc3<K|]}|jywr,)IsHidden).0xs r z+ResourceInfo.AddToParser..os,t!ts)rrErA)r#r@any add_groupr rtr&)rr%rrAresource_grouprs rr&zResourceInfo.AddToParser]sz  "D  ZZ !6F ,t, ,F%%    4+=+=f&NN oon%rc6|j}g}|D]}|jjdr*dj|j|jdd}n)dj|jj }|j ||S)zCReturns a list of command line example arg strings for the concept.z--z{}=my-{}rvNzmy-{})r#rP startswithrhlowerrj)rrexamplesrexamples rGetExampleArgListzResourceInfo.GetExampleArgListvs}  "DH   T "##CHHchhqrl;..!12oog  Orc|jsV|jj|j|j||j |j }d|_||_|jS)zLazy, cached parsing function for resource. Args: parsed_args: the parsed Namespace. Returns: the initialized resource or a list of initialized resources if the resource argument was pluralized. )r(r=r?T)rCrr)r<rr=r?rB)rr(results rr)zResourceInfo.Parsesh    &&t'A'A'+'<'<3>.2kk373C3C 'Ef #ddl <<rc d|_d|_y)NF)rBrCrs rr+zResourceInfo.ClearCachesDL!Dr)FFNFr,)r-r.r/r0r8r1rrIrrSrYr[rr rtrrrrrr#r&rr)r+ __classcell__rFs@rr5r5zs2*X     " " 4 4 1 +!<  $5(; 5&P5&2 ("rr5cTeZdZdZdZdZdZdZedZ fdZ fdZ xZ S) MultitypeResourceInfoz9ResourceInfo object specifically for multitype resources.c8|jj|S)z+Returns true if the attribute is an anchor.rUrWs rrYzMultitypeResourceInfo._IsAnchors    % %i 00rcx|jjDcgc]}|j|s|c}Scc}wr,)rrirY)ras r _GetAnchorsz!MultitypeResourceInfo._GetAnchorss3((33 I3!t~~a7HA3 II Is77c|j}||gk(xr'|jj|jg S)z5Returns True if the attribute arg should be required.)rrr]rP)rrXanchorss rrz$MultitypeResourceInfo._IsRequiredArgsE G yk ! $*?*?*C*C+'rcP|jj||jS)Nrx)rr}r=rWs rrz"MultitypeResourceInfo._IsPluralArgs"    & &y & EErc|jry|j}t|dk7ry|d}|jj |j gryy)zTrue if resource is required & has a single anchor with no fallthroughs. Returns: bool, whether the argument group should be required. FrLrT)r?rrdrr]rP)rrrss rrtz#MultitypeResourceInfo.args_requiredsV   G 7|q  QZF   b1  rctt| }|jjDcgc]}|j }}|dj dj|zScc}w)Nz7 This resource can be one of the following types: [{}].z, )r7rr r type_enumrPrhrk)r base_texttype_ all_typesrFs rr z"MultitypeResourceInfo.GetGroupHelpsj+T?AI $ 1 1 ; ;= ;u ;=  &tyy'; < >>=sA$c tt| |}t|jj j |jDcgc]}|jc}}|jjDcgc]}|j}}tt|t|k(r|S|djdj|Dcgc]}dj|c}zScc}wcc}wcc}w)Nz+ Must be specified for resource of type {}.z or z[{}]) r7rrsortedr_attribute_to_types_mapr]rPrrdsetrhrk)rrXrrrelevant_typesrtrFs rrz.MultitypeResourceInfo._GetHelpTextForAttributes+TKI $ 1 1 I I M M NN!!u !N !% 1 1 ; ;= ;u ;= 3~ 3y>1  5  ~F~!V]]1-~FG H JJ=Gs C4=C9C>) r-r.r/r0rYrrrr1rtr rrrs@rrrsAA1J F  $>JJrr)r0 __future__rrrr2googlecloudsdk.callioperr googlecloudsdk.calliope.conceptsrr^r (googlecloudsdk.command_lib.util.conceptsr googlecloudsdk.core.utilr six six.movesr rzr{with_metaclassABCMetaobjectrr5rrrrrs}9&' /(=1?)  ,O $#$$S[[&9O d^";^"B <JL<Jr