71SrSSKJr SSKJr SSKJr SSKJr SSKJr "SS\ 5r "S S \ 5r "S S \ 5r "S S\ 5rg)zClasses to define how concept args are added to argparse. A PresentationSpec is used to define how a concept spec is presented in an individual command, such as its help text. ResourcePresentationSpecs are used for resource specs. )absolute_import)division)unicode_literals)util) info_holderscZ\rSrSrSrS Sjr\S5r\S5rSr Sr S r g) PresentationSpecaClass that defines how concept arguments are presented in a command. Attributes: name: str, the name of the main arg for the concept. Can be positional or flag style (UPPER_SNAKE_CASE or --lower-train-case). concept_spec: googlecloudsdk.calliope.concepts.ConceptSpec, The spec that specifies the concept. group_help: str, the help text for the entire arg group. prefixes: bool, whether to use prefixes before the attribute flags, such as `--myresource-project`. required: bool, whether the anchor argument should be required. If True, the command will fail at argparse time if the anchor argument isn't given. plural: bool, True if the resource will be parsed as a list, False otherwise. group: the parser or subparser for a Calliope command that the resource arguments should be added to. If not provided, will be added to the main parser. attribute_to_args_map: {str: str}, dict of attribute names to names of associated arguments. hidden: bool, True if the arguments should be hidden. Nc XlX lX0lX@lXPlXplXlURU5UlXl g)aInitializes a ResourcePresentationSpec. Args: name: str, the name of the main arg for the concept. concept_spec: googlecloudsdk.calliope.concepts.ConceptSpec, The spec that specifies the concept. group_help: str, the help text for the entire arg group. prefixes: bool, whether to use prefixes before the attribute flags, such as `--myresource-project`. This will match the "name" (in flag format). required: bool, whether the anchor argument should be required. flag_name_overrides: {str: str}, dict of attribute names to the desired flag name. To remove a flag altogether, use '' as its rename value. plural: bool, True if the resource will be parsed as a list, False otherwise. group: the parser or subparser for a Calliope command that the resource arguments should be added to. If not provided, will be added to the main parser. hidden: bool, True if the arguments should be hidden. N) name _concept_spec group_helpprefixesrequiredpluralgroup_GetAttributeToArgsMap_attribute_to_args_maphidden) selfr concept_specrrrflag_name_overridesrrrs Blib/googlecloudsdk/command_lib/util/concepts/presentation_specs.py__init__PresentationSpec.__init__5sC:I% OMMKJ"&"="=#DKcUR$)zThe ConceptSpec associated with the PresentationSpec. Returns: (googlecloudsdk.calliope.concepts.ConceptSpec) the concept spec. )r rs rrPresentationSpec.concept_spec]s   rcUR$)zPThe map of attribute names to associated args. Returns: {str: str}, the map. )rrs rattribute_to_args_map&PresentationSpec.attribute_to_args_mapfs  & &&rc[e)a2Generate a ConceptInfo object for the ConceptParser. Must be overridden in subclasses. Args: fallthroughs_map: {str: [googlecloudsdk.calliope.concepts.deps. _FallthroughBase]}, dict keyed by attribute name to lists of fallthroughs. Returns: info_holders.ConceptInfo, the ConceptInfo object. NotImplementedErrorrfallthroughs_maps r _GenerateInfoPresentationSpec._GenerateInfoos  rc[e)zGenerate a map of attributes to primary arg names. Must be overridden in subclasses. Args: flag_name_overrides: {str: str}, the dict of flags to overridden names. Returns: {str: str}, dict from attribute names to arg names. r$)rrs rr'PresentationSpec._GetAttributeToArgsMap~s  r) rr rrrr rrr)FFNFNF) __name__ __module__ __qualname____firstlineno____doc__rpropertyrr!r(r__static_attributes__rrr r sS4#'&P   ' '  rr cH\rSrSrSrSrSr\S Sj5rSr Sr S r g) ResourcePresentationSpeczGClass that specifies how resource arguments are presented in a command.c ZU(dgUR5HnURRHnURU:XdM M1 [ SR USR URRVs/sHnURPM sn555e gs snf)NzmAttempting to override the name for an attribute not present in the concept: [{}]. Available attributes: [{}], )keysr attributesr ValueErrorformatjoin)rrattribute_name attributes r_ValidateFlagNameOverrides3ResourcePresentationSpec._ValidateFlagNameOverridess  -224((33) >>^ + 4 <>,HJK=LM M 5JsB(c TURU5 0n[URR5Hqup4U[ URR5S- :HnUR UR UR XRUS9nU(dMcXbUR 'Ms U$)N) is_anchor)r@ enumerater r:len GetFlagNamer r)rrr!ir?rDr s rr/ResourcePresentationSpec._GetAttributeToArgsMaps##$78!$"4"4"?"?@ s4--889A==i    ..$))%8--d 04inn- A ! rNcvU=(d 0nX;aURU5$US:XagU(aU$[RnU(anUR[R5(a%XQ[ [R5SS-- nXP-$XQR 5R SS5S-- nXP-$)aGets the flag name for a given attribute name. Returns a flag name for an attribute, adding prefixes as necessary or using overrides if an override map is provided. Args: attribute_name: str, the name of the attribute to base the flag name on. presentation_name: str, the anchor argument name of the resource the attribute belongs to (e.g. '--foo'). flag_name_overrides: {str: str}, a dict of attribute names to exact string of the flag name to use for the attribute. None if no overrides. prefixes: bool, whether to use the resource name as a prefix for the flag. is_anchor: bool, True if this it he anchor flag, False otherwise. Returns: (str) the name of the flag. projectN-_)getrPREFIX startswithrFlowerreplace)r>presentation_namerrrDprefixs rrG$ResourcePresentationSpec.GetFlagNames(.3, $ $^ 44"   [[F  % %dkk 2 2C $4$56<<  "" ))+33C=CC  ""rc [R"URURURUR UUR URURURS9 $)aGets the ResourceInfo object for the ConceptParser. Args: fallthroughs_map: {str: [googlecloudsdk.calliope.concepts.deps. _FallthroughBase]}, dict keyed by attribute name to lists of fallthroughs. Returns: info_holders.ResourceInfo, the ResourceInfo object. )rrrr) r ResourceInfor rrr!rrrrr&s rr(&ResourcePresentationSpec._GenerateInfosV  $ $    ""{{jj{{  rc*[U[U55(dgURUR:H=(a URUR:H=(a URUR:H=(a UR UR :H=(ay UR UR :H=(aY URUR:H=(a9 URUR:H=(a URUR:H$NF isinstancetyper rrrrrrrrothers r__eq__ResourcePresentationSpec.__eq__ eT$Z ( (  II # (   !3!3 3 ( OOu// / ( MMU^^ + (15 u||0K ( MMU^^ +  (15 ekk0I  ( KK5<< ' )rr3NFF) r,r-r.r/r0r@r staticmethodrGr(rar2r3rrr5r5s5O M !IM,1 # #D,)rr5c\rSrSrSrSrg)InvalidPresentationSpecErrorz$Error for invalid presentation spec.r3N)r,r-r.r/r0r2r3rrrgrgs,rrgcB\rSrSrSrSr\S Sj5rSrSr Sr g) !MultitypeResourcePresentationSpecz&A resource-specific presentation spec.c 0nURRVs/sH'nURRU5(dM%UPM) nn[U5S:az[R "UR 5(aUSRSU55n[SUSUR S[R"UR 5S35eURRHQnU/U:HnURUR UR UURUS9nU(dMCXUR 'MS U$s snf) NrCr8c38# UHoRv M g7f)N)r ).0as r KMultitypeResourcePresentationSpec._GetAttributeToArgsMap..s<|!vv|sz Multitype resource has anchors [z] and positional name [z]. Multitype resource can only be non-positional or have a single anchor. Update multitype collections or change the presentation name to .)rrrD) r r: IsLeafAnchorrFr IsPositionalr r=rgFlagNameFormatrGr) rrr!ro leaf_anchors anchor_namesr?rDr s rr8MultitypeResourcePresentationSpec._GetAttributeToArgsMaps4#11<<;rTrrrDs rrG-MultitypeResourcePresentationSpec.GetFlagNamesl(.3, $ $^ 44 "   +<*M!N OO   00rc [R"URURURUR UUR URURS9$)a"Gets the MultitypeResourceInfo object for the ConceptParser. Args: fallthroughs_map: {str: [googlecloudsdk.calliope.concepts.deps. _FallthroughBase]}, dict keyed by attribute name to lists of fallthroughs. Returns: info_holders.MultitypeResourceInfo, the ResourceInfo object. )rrr) rMultitypeResourceInfor rrr!rrrr&s rr(/MultitypeResourcePresentationSpec._GenerateInfo/sO  - -    ""{{jj rc*[U[U55(dgURUR:H=(a URUR:H=(a URUR:H=(a UR UR :H=(ay UR UR :H=(aY URUR:H=(a9 URUR:H=(a URUR:H$r[r\r_s rra(MultitypeResourcePresentationSpec.__eq__Drcrr3rd) r,r-r.r/r0rrerGr(rar2r3rrrjrjs/.!.IM,111@*)rrjN)r0 __future__rrr googlecloudsdk.calliope.conceptsr(googlecloudsdk.command_lib.util.conceptsrobjectr r5 Exceptionrgrjr3rrrsU''1Akvk\`)/`)F-9- X)(8X)r