edZddlmZddlmZddlmZddlZddlZddlZddlm Z ddl m Z ddl m Z dd l mZdd l mZdd lmZdd lmZdd lmZddlZdZdZdZGdde j0ZGdde j0ZGddeZGddeZGddeZGddeZGddeZ Gdd eZ!Gd!d"eZ"Gd#d$e Z#Gd%d&eZ$Gd'd(eZ%Gd)d*e%Z&Gd+d,eZ'Gd-d.e Z(Gd/d0eZ)Gd1d2eZ*Gd3d4eZ+Gd5d6eZ,Gd7d8eZ-y)9aYClasses to specify concept and resource specs. To use a concept, give it at least help text and a name (or use the default name if the concept provides one) and add it to a concept manager. During command.Run, the parsed concept will be available under args. For example: from googlecloudsdk.command_lib.concepts import concept_managers def Args(self, parser): manager = concept_managers.ConceptManager() concept = concepts.SimpleArg('foo', help_text='Provide the value of foo.') manager.AddConcept(concept) manager.AddToParser(parser) def Run(self, args): return args.foo )absolute_import)division)unicode_literalsN)deps)base)dependency_managers) exceptions)names)scaled_integer)semver)timesc|tj|jd}|dj|ddzS)z4Return the string representation of sub-exception e..rN)six text_typerstripupper)emessages @lib/googlecloudsdk/command_lib/concepts/all_concepts/concepts.py _SubExceptionr7s9 MM!  # #C ('    gabk ))c<|sy|djr|S|dzS)z:Appends a space to text if it is not empty and returns it. isspacetexts r_Insertr"=s'  "X K rc<|sy|djr|Sd|zS)z:Inserts a space to text if it is not empty and returns it.rrrrr s r_Appendr$Fs'  "X K trcFeZdZdZ dfd ZdZdZdZdZdZ xZ S) SimpleArgaA basic concept with a single attribute. Attributes: fallthroughs: [calliope.concepts.deps.Fallthrough], the list of sources of data, in priority order, that can provide a value for the attribute if not given on the command line. These should only be sources inherent to the attribute, such as associated properties, not command- specific sources. positional: bool, True if the concept is a positional value. completer: core.cache.completion_cache.Completer, the completer associated with the attribute. metavar: string, a name for the argument in usage messages. default: object, the concept value if one is not otherwise specified. choices: {name: help}, the possible concept values with help text. action: string or argparse.Action, the basic action to take when the concept is specified on the command line. Required for the current underlying argparse implementation. c  |tjd|xsg|_||_||_||_||_||_||_tt|.|fi| yzInitializes the concept.NzConcept name required.) r InitializationError fallthroughs positional completermetavardefaultchoicesactionsuperr&__init__) selfnamer*r+r,r-r.r/r0kwargs __class__s rr2zSimpleArg.__init__csg |  * *+C DD$*D DODNDLDLDLDK )T#D3F3rc tjd||j|j|j|j |j |jd|jS)N)conceptr*r,r-r.r0r/) r Attributer*r,r-r.r0r/ MakeArgKwargsr3s rr:zSimpleArg.AttributeqsY >> 2$'+'8'8$(NN"&,,"&,,!%"&,,  2!..0 22rcy)zReturns the type constraints message text if any. This message text decribes the Validate() method constraints in English. For example, a regex validator could provide prose for a better UX than a raw 100 char regex pattern. rr9r<s r ConstraintszSimpleArg.Constraints{s rc |jS#tj$rC}|jr-t j |j t|Yd}~yd}~wwxYw)aaParses the concept. Args: dependencies: googlecloudsdk.command_lib.concepts.dependency_managers .DependencyView, the dependency namespace for the concept. Raises: exceptions.MissingRequiredArgumentException, if no value is provided and one is required. Returns: str, the value given to the argument. N)valuedeps_libAttributeNotFoundErrorrequiredr MissingRequiredArgumentErrorGetPresentationNamer)r3 dependenciesrs rParsezSimpleArg.ParsesY     * * 55  $ $ & a(8: :  s A$9AA$c|jrtj|jStj|jS)zDGets presentation name for the attribute, either positional or flag.)r+r ConvertToPositionalNamer4ConvertToFlagNamer<s rrEzSimpleArg.GetPresentationNames3   * *499 55  " "499 --rc8|jxr |j S)aiDetermines whether command line argument for attribute is required. Returns: bool: True, if the command line argument is required to be provided, meaning that the attribute is required and that there are no fallthroughs. There may still be a parsing error if the argument isn't provided and none of the fallthroughs work. )rCr*r<s r IsArgRequiredzSimpleArg.IsArgRequireds == 2!2!222r)NFNNNNN) __name__ __module__ __qualname____doc__r2r:r>rGrErL __classcell__r6s@rr&r&Os0&KO@D 42,. 3rr&cHeZdZdZd fd ZdZdZdZdZdZ dZ xZ S) GroupArgzgA group concept. Attributes: mutex: bool, True if this is a mutex (mutually exclusive) group. c |tjd||_||_g|_t t ||fi|yr()r r)mutexprefixesconceptsr1rTr2)r3r4rVrWr5r6s rr2zGroupArg.__init__sC |  * *+C DDDJDMDM (D"4262rctj|}|j|j|_|jj |yN)copy_GetSubConceptNamer4rXappend)r3r8 new_concepts r AddConceptzGroupArg.AddConcepts;))G$K..{/?/?@KMM%rc tjd||jDcgc]}|jc}|jd|j Scc}w)N)r8 attributesrVr9)rAttributeGrouprXr:rVr;)r3cs rr:zGroupArg.AttributesV    +/==9=aAKKM=9jj       9sA ch|jr%tj|jdz|zS|S)N_)rWr ConvertToNamespaceNamer4)r3attribute_names rr\zGroupArg._GetSubConceptNames- }}  ) )$))c/N*J KK rc|S)z:Returns a namespace with the values of the child concepts.r9)r3rFs rrGzGroupArg.Parses rc|jS)z/Gets presentation name for the attribute group.)r4r<s rrEzGroupArg.GetPresentationNames 99rcX|jxrtd|jD S)agDetermines whether the concept group is required to be specified. Returns: bool: True, if the command line argument is required to be provided, meaning that the attribute is required and that there are no fallthroughs. There may still be a parsing error if the argument isn't provided and none of the fallthroughs work. c34K|]}|jywrZ)r*).0rcs r z)GroupArg.IsArgRequired..s$K]Q^^]s)rCanyrXr<s rrLzGroupArg.IsArgRequireds% == K$KT]]$K!KKKr)FF) rMrNrOrPr2r_r:r\rGrErLrQrRs@rrTrTs, 3&   LrrTc:eZdZdZdZdZdZfdZdZxZ S) ConceptTypezConcept type base class. All concept types derive from this class. The methods implement lexing, parsing, constraints, help text, and formatting. c|S)axConverts a value from string and returns it. The converter must do syntax checking and raise actionable exceptions. All non-space characters in string must be consumed. This method may raise syntax exceptions, but otherwise does no validation. Args: string: The string to convert to a concept type value. Returns: The converted value. r9r3strings rConvertzConceptType.Converts  Mrc,tj|S)akReturns the string representation of a parsed concept value. This method is the inverse of Convert() and Parse(). It returns the string representation of a parsed concept value that can be used in formatted messages. Args: value: The concept value to display. Returns: The string representation of a parsed concept value. )rrr3r@s rDisplayzConceptType.Displays == rc|S)ahReturns the normalized value. Called after the value has been validated. It normalizes internal values for compatibility with other interfaces. This can be accomplished by subclassing with a shim class that contains only a Normalize() method. Args: value: The concept value to normalize. Returns: The normalized value. r9rvs r NormalizezConceptType.Normalizes  Lrctt| |}|j|}|j ||j |S)zDConverts, validates and normalizes a value string from dependencies.)r1rprGrtValidatery)r3rFrsr@r6s rrGzConceptType.Parses= ; +L 9F LL EMM% >>%  rcy)a&Validates value. Syntax checking has already been done by Convert(). The validator imposes additional constraints on valid values for the concept type and must raise actionable exceptions when the constraints are not met. Args: value: The concept value to validate. Nr9rvs rr{zConceptType.Validates r) rMrNrOrPrtrwryrGr{rQrRs@rrprps!    !  rrpceZdZdZddZy)EndpointzTypeWithIntervalConstraint endpoint. Attributes: string: string, the representation of the endpoint value. closed: bool, True if the interval is closed (the endpoint is included). c.||_||_d|_yrZ)rsclosedr@)r3rsrs rr2zEndpoint.__init__2sDKDKDJrN)T)rMrNrOrPr2r9rrr~r~*s rr~c<eZdZdZ dfd ZdZdZdZxZS)TypeWithIntervalConstraintaConcept type with value interval constraints. Validates that a ConceptType value is within the interval defined by min and max endpoints. A missing min or max endpoint indicates that there is no min or max value, respectively. Attributes: _min_endpoint: Endpoint, the minimum value interval endpoint. _max_endpoint: Endpoint, the maximum value interval endpoint. _constraint_kind: string, the interval value type name. _convert_endpoint: f(str)=>x, converts an endpoint string to a value. _convert_interval: f(str)=>x, converts an interval value to a value. _display_endpoint: f(value)=>str, displays an interval endpoint. c ntt| |fi|||_||_|xsd|_|xs |j |_|xs |j|_ |xsd|_ |jr|j|jd|jr|j|jdyy)Nr@c|SrZr9)xs rz5TypeWithIntervalConstraint.__init__..Qsarz min endpointz max endpoint) r1rr2 _min_endpoint _max_endpoint_kindrt_convert_endpointrw_display_endpoint_convert_value_ConvertEndpoint) r3r4 min_endpoint max_endpointconstraint_kindconvert_endpoint convert_valuedisplay_endpointr5r6s rr2z#TypeWithIntervalConstraint.__init__Hs $d4TDVD%D%D +GDJ-=D-=D'8KD  D..?  D..?rcd} |j|j|_y#tj$rA}t j |jdddjd}Yd}~n*d}~wttf$r}t|}Yd}~nd}~wwxYwtj|j||j|dz)z+Declaration time endpoint conversion check.Nz. rr)rrsr@r ParseErrorrrsplitrAttributeError ValueErrorrConstraintErrorrE)r3endpointkindrrs rrz+TypeWithIntervalConstraint._ConvertEndpointWsG!--hoo>hn  ? a &&tQ/299#>g J '!a g!  $ $   "D(//7S= JJs %B7A44B BBcg}|jra|jj}|jjrd}nd}|jdj ||j ||j ra|j j}|j jrd}nd}|jdj ||j ||sydj |jdj|S) 1Returns the type constraints message text if any.greater than or equal to greater thanz{} {}less than or equal to less thanrzThe {} must be {}.z and ) rr@rr]formatrrrjoin)r3 boundariesrboundarys rr>z&TypeWithIntervalConstraint.ConstraintsdsJ ##))h   " "-! D**8467 ##))h   " "* D**8467    & &tzz7<< 3K LLrc H|j|}d}|jr;|jj}|jjr||kr d}n||krd}|sG|jr;|jj}|jjr||kDr d}n||k\rd}|r}t j |jdj|jdj|jdd|j|||jy)Nrrrrz{}{} [{}] must be {} [{}].rr) rrr@rrr ValidationErrorrErrrr)r3r@invalidrs rr{z#TypeWithIntervalConstraint.Validate{s    &EG ##))h   " " 8 .' H   t))##))h   " " 8 +' H   & &  " " $ & - -jjm!!#jjn$$U+$$X.  0 11r)NNNNNN) rMrNrOrPr2rr>r{rQrRs@rrr8s+ <@JN $ @ JM.1rrcFeZdZdZdZdZedZ dfd ZdZ xZ S)TypeWithSizeConstraintzConcept type with size interval constraints. Validates that a ConceptType size is within the interval defined by min and max endpoints. A missing min or max endpoint indicates that there is no min or max size, respectively. ,^c |r t|SdS)Nr)len)clsr@s r_GetIntervalValuez(TypeWithSizeConstraint._GetIntervalValues3u:%A%rc |tt| |f|xsd|xst|xs |j|xst d|y)Nsize)rrrr)r1rr2intrstr)r3r4rrrrr5r6s rr2zTypeWithSizeConstraint.__init__sK $0 '16)0S#=t'='=)0S   rc.|sy|j}|j|jrY|j|ddvrH|ddj|jd\}}|s$t j |j d|j||fS)aOSplits string on _DEFAULT_DELIM or the alternate delimiter expression. By default, splits on commas: 'a,b,c' -> ['a', 'b', 'c'] Alternate delimiter syntax: '^:^a,b:c' -> ['a,b', 'c'] '^::^a:b::c' -> ['a:b', 'c'] '^,^^a^,b,c' -> ['^a^', ',b', 'c'] See `gcloud topic escaping` for details. Args: string: The string with optional alternate delimiter expression. Raises: exceptions.ParseError: on invalid delimiter expression. Returns: (string, delimiter) string with the delimiter expression stripped, if any. NNrNzqInvalid delimiter. Please see $ gcloud topic escaping for information on escaping list or dictionary flag values.)_DEFAULT_DELIM startswith _ALT_DELIMrr rrE)r3rsdelims r_SplitzTypeWithSizeConstraint._Splits,     E )doo.KQRj&&t:meV ##  $ $ & FG G <<  %%r)NNNN) rMrNrOrPrr classmethodrr2rrQrRs@rrrs:.*&&CG48 &rrc0eZdZdZdfd ZdZdZxZS)TypeWithRegexConstraintzConcept type with regex constraint. Attributes: _regex: string, an unanchored regular expression pattern that must match valid values. _constraint_details: string, optional prose that describes the regex constraint. c Jtt| |fi|||_||_yrZ)r1rr2_regex_constraint_details)r3r4regexconstraint_detailsr5r6s rr2z TypeWithRegexConstraint.__init__s' !41$A&ADK1Drc|jsy|jr |jSdj|jS)rrz5The value must match the regular expression ```{}```.)rrrr<s rr>z#TypeWithRegexConstraint.Constraintss; ;;    % %% B I I  rc|jr}tj|j|j|sMt j |j dj|j||jyy)NzValue [{}] does not match [{}].)rrematchrwr rrErrvs rr{z TypeWithRegexConstraint.Validatesk {{288DKKe1DE  & &  " " $ + 2 2ll5!kk  F{rr)rMrNrOrPr2r>r{rQrRs@rrrs2 rrc0eZdZdZdfd ZdZdZxZS)BooleanzBoolean value concept.c |rdnd}|jdd}|r8|j}|jdr|dj|ddz }||d<t t ||f||d|y) N store_false store_true help_textzA Boolean value.z--z' On by default, use --no-{} to disable.)r.r0)getrErrr1rr2)r3r4r.r5r0r presentationr6s rr2zBoolean.__init__s%]EE    #F; '4!$,,$*,rc|y|dk(s|jdk(ry|dk(s|jdk(rytj|jdj |)NF1trueT0falsezInvalid Boolean value [{}].)lowerr rrErrrs rrtzBoolean.Convertse ~  } &0  } '1       "%,,V4 66rc|rdSdS)z/Returns the display string for a Boolean value.rrr9rvs rrwzBoolean.Displays6''rrZ)rMrNrOrPr2rtrwrQrRs@rrrs , 6(rrc4eZdZdZdfd ZdZfdZxZS)EnumzEnum value concept.c |stjd|r||vrtjd||_tt||f||d|y)Nz(Choices must be specified for Enum type.z*Enum default value must be a valid choice.)r/r.)r r)r/r1rr2)r3r4r/r.r5r6s rr2z Enum.__init__s^   * * 4 667')  * * 6 88DL $tPWgPPrc r |j}||jvr|j|jvrdtj|j dj |djt|jj|S#ttf$r|cYSwxYw)Nz)Invalid choice [{}], must be one of [{}].r) rr/rr rrErrsortedkeysrr)r3rschoices rrtz Enum.Convert!s ||~f t|| # dll(J##  $ $ & 7 > > (9(9(;!<= ?@ @m J ' msBB""B65B6cbtj}|jdtt j |j D]&\}}|jdj||(djttt|/|jS)z.Appends enum values to the original help text. + *{}*::: {} z({}Must be one of the following values:{}) ioStringIOwriterr iteritemsr/rr"r1r BuildHelpTextgetvalue)r3bufkeyrr6s rrzEnum.BuildHelpText-s ++-CIIg t||!<=Y ii%%c956> 399 E$35 6  HIrr)rMrNrOrPr2rtrrQrRs@rrrsQ IIrrc"eZdZdZfdZxZS)StringzString value concept.c @d|vrd|d<tt| |fi|y)NrzA string value.)r1rr2)r3r4r5r6s rr2zString.__init__;s)& -f[ &$ 00r)rMrNrOrPr2rQrRs@rrr8s11rrc4eZdZdZdfd ZfdZdZxZS)IntegerzInteger value concept. Attributes: _unlimited: bool, the value 'unlimited' specifies the largest valid value. Internally it's represented as None. c <||_tt||fi|yrZ) _unlimitedr1rr2r3r4 unlimitedr5r6s rr2zInteger.__init__IsDO '4!$1&1rcXdjttt|S)z1Appends integer syntax to the original help text.z+{}Must be a string representing an integer.)rr"r1rrr3r6s rrzInteger.BuildHelpTextMs* 6<< E'468 9 ; =  -'77rc |jrtj|} |tj|fS#t$r3}t j |j||t|dzd}~wwxYw)z3Returns the integer unit suffix and value for unit.rN) rr DeleteTypeAbbr GetUnitSizerr rr4r)r3runitrs rrzScaledInteger._GetUnitValuesn   * *4 0d9 >--d3 33 9  & & ))T4q!1C!7 999s: A6.A11A6c |jrdj|j}nd}|jrdj|j}nd}|jrdj|j}nd}djt t t ||j|||t |jS)zBAppends ISO Decimal/Binary scaled integer syntax to the help text.zThe default unit is `{}`. rzGThe output unit is `{}`. Integer values are divided by the unit value. z'The default type abbreviation is `{}`. zH{}{}{}{}{}{}See https://en.wikipedia.org/wiki/Binary_prefix for details.) rrrrr"r1rrrr>)r3rrrr6s rrzScaledInteger.BuildHelpTexts 1889K9KLll  F4,,-k ;BB //ii 6 E-<> ?       D$$& ' )*rc 8|sy tj||j|j}|jr||jz}|S#t $rB}t j|jdj|t|d}~wwxYw)N)rrz7Failed to parse binary/decimal scaled integer [{}]: {}.) r ParseIntegerrrrrr rrErr)r3rsr@rs rrtzScaledInteger.Converts   ))) t11T__Ne  $))) l )  ! !  " " $ C J JmA& ( )))sAA B=BBcz|jr||jz}tj||jS)z5Returns the display string for a binary scaled value.)r)rr FormatIntegerrrvs rrwzScaledInteger.Displays2  t&&&e  ' ' IIr)NNBN) rMrNrOrPr2rrrtrwrQrRs@rrr`s, KN 8&9*6 )Jrrc*eZdZdZdfd ZdZxZS)BinaryScaledIntegera%ISO Binary scaled Integer value with binary display concept. All ISO/IEC prefixes are powers of 2: 1k == 1ki == 1024. This is a concession to the inconsistent mix of binary/decimal scaled measures for memory capacity, disk capacity, cpu speed. Ideally ScaledInteger should be used. c :|d}tt| |fd|i|y)NzMust be a string representing binary scaled integer where all ISO/IEC prefixes are powers of 2. For example, 1k == 1ki == 1024. r)r1rr2)r3r4rr5r6s rr2zBinaryScaledInteger.__init__s9 O t- 3'3+13rc |sy tj||jS#t$rB}t j |j dj|t|d}~wwxYw)Nz/Failed to parse binary scaled integer [{}]: {}.) r ParseBinaryIntegerrrr rrErrrs rrtzBinaryScaledInteger.Convertsm  )  . .vt7I7I JJ )  ! !  " " $ ; B BmA& ( )))s% A0=A++A0rZ)rMrNrOrPr2rtrQrRs@rrrs3 )rrc4eZdZdZdfd ZfdZdZxZS)FloatzFloat value concept. Attributes: _unlimited: bool, the value 'unlimited' specifies the largest valid value. Internally it's represented as None. c <||_tt||fi|yrZ)rr1rr2rs rr2zFloat.__init__sDO %//rcdjttt|t |j S)z/Appends float syntax to the original help text.z:{}Must be a string representing a floating point number.{})rr"r1rrr$r>rs rrzFloat.BuildHelpTexts< EKK E%46 7 D$$& ' )*rc |sy t|S#t$rX}|jr |dk(rYd}~ytj|j dj |t|d}~wwxYw)Nrz/Failed to parse floating point number [{}]: {}.)floatrrr rrErrrs rrtz Float.Convertso  ) 6] ) V{2  ! !  " " $ ; B BmA& ( )))s  A1A,=A,,A1rrrRs@rrrs0* )rrc0eZdZdZgdZfdZdZxZS) DayOfWeekzDay of the week concept.)SUNMONTUEWEDTHUFRISATcdjttt|t |j S)z5Appends day of week syntax to the original help text.z{}Must be a string representing a day of the week in English, such as 'MON' or 'FRI'. Case is ignored, and any characters after the first three are ignored.{})rr"r1rrr$r>rs rrzDayOfWeek.BuildHelpTexts: ))/ E)T8: ; D$$& '*)*rc |sy|jdd}||jvrMtj|j dj |dj |j|S)z.Converts a day of week from string returns it.Nz.A day of week value [{}] must be one of: [{}].z, )r_DAYSr rrErr)r3rsr@s rrtzDayOfWeek.Convertsl   LLN2A E DJJ  ! !  " " $ : A Adii + - .. Lr)rMrNrOrPr'rrtrQrRs@rrrs ;%* rrc:eZdZdZdfd ZfdZdZdZxZS)DurationzDuration concept. Attributes: _default_suffix: string, the time unit suffix if none is specified. _subsecond: bool, return floating point values if True. c J||_||_tt||fi|yrZ)_default_suffix _subsecondr1r)r2)r3r4default_suffix subsecondr5r6s rr2zDuration.__init__s&)DDO (D"4262rc|jrdj|j}nd}djttt||t|j S)z2Appends duration syntax to the original help text.zThe default suffix is `{}`. ra{}Must be a string representing an ISO 8601 duration. Syntax is relaxed to ignore case, the leading P and date/time separator T if there is no ambiguity. {}For example, `PT1H` and `1h` are equivalent representations of one hour. {}See $ gcloud topic datetimes for more information.)r+rr"r1r)rr>)r3r-r6s rrzDuration.BuildHelpText"sg 5<<    nn v E(D79 :N D$$& ') *rc B|sy tj||jj}|jr|St |S#tj $rB}tj|jdj|t|d}~wwxYw)z+Converts a duration from string returns it.N)r-"Failed to parse duration [{}]: {}.) r ParseDurationr+ total_secondsr,rErrorr rrErr)r3rsdrs rrtzDuration.Convert2s  )    !5!5 77D}//Q-s1v- ;;)  ! !  " " $ . 5 5mA& ( )))s8A A B=BBctjdj|}tj|}|j dr|ddj }|S)zDReturns the display string for a duration value, leading PT dropped.z{}sPTrN)r r2rFormatDurationrr)r3r@r5ss rrwzDuration.Display@sM ELL/0A QA||D AB%++-a Hr)r9F) rMrNrOrPr2rrtrwrQrRs@rr)r)s3 * ) rr)c@eZdZdZdfd ZfdZdZdZdZxZ S) TimeStampzTimeStamp concept. Attributes: _fmt: string, a times.FormatDateTime() format specification. _string: bool, normalize value to a string if True _tzinfo: datetime.tzinfo, a time zone object, typically times.UTC or times.LOCAL. c |||_|xstj|_||_t t ||fi|yrZ)_fmtr UTC_tzinfo_stringr1r;r2)r3r4fmttzrsr5r6s rr2zTimeStamp.__init__Ss4DI?DLDL )T#D3F3rcdjttt|t|j S)z3Appends timestamp syntax to the original help text.z{}Must be a string representing an ISO 8601 date/time. Relative durations (prefixed by - or +) may be used to specify offsets from the current time. {}See $ gcloud topic datetimes for more information.)rr"r1r;rr>rs rrzTimeStamp.BuildHelpTextYs< v E)T8: ; D$$& ') *rc |sy tj||jS#tj$rB}t j |j dj|t|d}~wwxYw)z1Converts a datetime value from string returns it.N)tzinfor1) r ParseDateTimer?r4r rrErrrs rrtzTimeStamp.Convertcso  )   == ;;)  ! !  " " $ . 5 5mA& ( )))s &A;=A66A;cZtj||j|jS)z0Returns the display string for a datetime value.)rArE)r FormatDateTimer=r?rvs rrwzTimeStamp.Displayos   499T\\ JJrc@|jr|j|S|SrZ)r@rwrvs rryzTimeStamp.Normalizess"&,,4<< 9E9r)NNF) rMrNrOrPr2rrtrwryrQrRs@rr;r;Is"4 * )K:rr;c.eZdZdZfdZdZdZxZS)SemVerzSemVer concept.cdjttt|t|j S)z0Appends SemVer syntax to the original help text.z{}Must be a string representing a SemVer number of the form _MAJOR_._MINOR_._PATCH_, where omitted trailing parts default to 0. {}See https://semver.org/ for more information.)rr"r1rKrr>rs rrzSemVer.BuildHelpTextzs: ::@& E&$57 8 D$$& ';)*rcd|sy |jd}t|dkr |jdt|dkr dj|}t j |S#tj $r2}tj |jt|d}~wwxYw)z0Converts a SemVer object from string returns it.Nrr&r) rrr]rr rKrr rEr)r3rspartsrs rrtzSemVer.Converts  Pll3e JN S JNxxf ]]6 ""   P  ! !$":":"N OOPs>A*%A**B/=-B**B/cddj|j|j|jS)z5Returns the display string for a SemVer object value.z{}.{}.{})rmajorminorpatchrvs rrwzSemVer.Displays#   U[[%++u{{ CCr)rMrNrOrPrrtrwrQrRs@rrKrKws* PDrrKc@eZdZdZdfd ZfdZdZdZdZxZ S)ListzA list attribute concept. Attributes: _delim: string, the user specified lit item delimiter character. _element: string, the list element type object. c |tt| |fddi||j|_|xs t ||_y)Nrz list length)r1rTr2r_delimr_element)r3r4elementr5r6s rr2z List.__init__s9 $tM]MfM%%DK+vd|DMrc|jj}|jdrdj|dd}n%|jdrdj|dd}djt t t ||jjt |jt |S)z.Appends list syntax to the original help text.Must z Each item m{}rNA zEach item is a{}z{}Must be a string representing a list of `,` separated {} values. {}{}See $ gcloud topic escaping for details on using alternate delimiters.) rWrrrr"r1rTr4r>)r3item_help_textr6s rrzList.BuildHelpTexts]]002N  )&--nQR.@An  " "4 ()001CDn f E$35 6 MM   D$$& ' N # %&rc|jj|Dcgc]}|jj|c}Scc}w)z.Returns the display string for the list value.)rVrrWrw)r3r@items rrwz List.Displays8 ;;  UKUTT]]2248UK LLKs"Ac|jgSz8Returns the list of concepts that this concept marshals.)rWr<s rMarshalz List.Marshals MM?rcg} |j}|j|\}|_|D]A}tj|}|j|jj|C|j|}|j||j!|S#tj$r:}|jsYd}~yt j |j |d}~wwxYw)z1Parses the list from dependencies and returns it.N)r@rArBrCr rDrErrVrDependencyViewFromValuer]rWrGrtr{ry)r3rF list_valuer@ritemsr^item_dependenciess rrGz List.ParsesJ)  e U+E4;-EEdK ++,=>?j)JMM* >>* %%  * *) ]]  3 3  " " $a )))s B""C/5 C*$C**C/rZ rMrNrOrPr2rrwrarGrQrRs@rrTrTs", & M&rrTc@eZdZdZdfd ZfdZdZdZdZxZ S)DictaRA dict attribute concept. Attributes: _delim: string, the user specified lit item delimiter character. _entries: {string: ConceptType}, the map of concept type names to concept type objects. _additional: ConceptType, uninstantiated type used for unknown keys. If not specified then unknown keys are an error. c tt| |fddi||j|_i|_|r |D]}||j |j <|j s|st}||_y)Nrznumber of entries) r1rir2rrV_entriesr4r _additional)r3r4entries additionalr5entryr6s rr2z Dict.__init__sn $ =1=5;=%%DKDM%$) ejj! ==j!Drc tj}|jdtt j |j D]4\}}|jdj||j6|jrd}|j rd}nd}|jdj}|jdrdj|d d }n%|jd rd j|d d }|jd j||nd}djttt|#t|j||jS)z.Appends dict syntax to the original help text.rrmayz#Additional _key_ names are allowed.zAny _key_ name is accepted.*rZzEach _value_ m{}rNr[zEach _value_ is a{}z```*```::: {} {} mustzd{}Must be a string representing a list of `,` separated _key_=_value_ pairs. {}_key_ {} be one of:{})rrrrrrrkrrrlrr"r1rir>r)r3rrromay_mustr!value_help_textr6s rrzDict.BuildHelpTexts@ ++-CIIgS]]4==9: U ii%%c5+>+>+@AB; h 4,((-;;=o  # #G ,,33OAB4GH  % %d +/66qr7JK ii$++D/BCh 77=v E$35 6 D$$& '  LLN 8rc|jjttj|Dcgc]0\}}dj ||j j|2c}}Scc}}w)z.Returns the display string for the dict value.z{}={})rVrrrrrrWrw)r3r@kvs rrwz Dict.Displaysm ;;  F03 e0D$F0D1%,NN1dmm6K6KA6N$O0D$FG HH$Fs5A4c6|jjSr`)rkvaluesr<s rraz Dict.Marshals ==   !!rcFi} |j}|j|\}|_|D]}|jdd\}}|jj|} | sP|js3t j|j dj||j|} tj|j j|} || _| j)| ||<|j+|}|j-||j/|S#tj$r:}|jsYd}~yt j |j |d}~wwxYw#t"$rt%j&|} YwxYw)z1Parses the dict from dependencies and returns it.N=rzUnknown dictionary key [{}].)r@rArBrCr rDrErrVrrkrrlrrr[marshalled_dependenciesrrrcrGrtr{ry) r3rF dict_valuer@rrer^rvalrorfs rrGz Dict.Parse sJ)  e U+E4;C#hc3mm$e %%&&(,33C8: :  %))L$H$H$L$L %M"% $56jo j)JMM* >>* %%1  * *) ]]  3 3  " " $a )))&M/GGLMs/ D/E?/E< E7$E77E<?F F rrgrRs@rriris" "8H "&rri).rP __future__rrrr[rr googlecloudsdk.calliope.conceptsrrA#googlecloudsdk.command_lib.conceptsrrr r googlecloudsdk.core.utilr r r rrr"r$Conceptr&rTrpobjectr~rrrrrrrrrrrr)r;rKrTrir9rrrsj &'' =4C:53+* * Z3 Z3z3Lt||3LlE )E P v \1\1~9&79&xkB(k(@!I;!IH1 $1*(*>YJ.YJx)-):) &)B'61 )1 h+:*+:\D 'D<6& !6&rY& !Y&r