|SrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSKJ r SSKJ r SS KJ r SSK r SS K Jr SS K Jr S r\S -r"SS\5r"SS\5rSSjr"SS\5rSrSSjrg)aResource expression lexer. This class is used to parse resource keys, quoted tokens, and operator strings and characters from resource filter and projection expression strings. Tokens are defined by isspace() and caller specified per-token terminator characters. " or ' quotes are supported, with these literal escapes: \\ => \, \' => ', \" => ", and \ => \. Typical resource usage: # Initialize a lexer with the expression string. lex = resource_lex.Lexer(expression_string) # isspace() separated tokens. lex.SkipSpace() returns False at end of input. while lex.SkipSpace(): # Save the expression string position for syntax error annotation. here = lex.GetPosition() # The next token must be a key. key = lex.Key() if not key: if lex.EndOfInput(): # End of input is OK here. break # There were some characters in the input that did not form a valid key. raise resource_exceptions.ExpressionSyntaxError( 'key expected [{0}].'.format(lex.Annotate(here))) # Check if the key is a function call. if lex.IsCharacter('('): # Collect the actual args and convert numeric args to float or int. args = lex.Args(convert=True) else: args = None # Skip an isspace() characters. End of input will fail with an # 'Operator expected [...]' resource_exceptions.ExpressionSyntaxError. lex.SkipSpace(token='Operator') # The next token must be one of these operators ... operator = lex.IsCharacter('+-*/&|') if not operator: # ... one of the operator names. if lex.IsString('AND'): operator = '&' elif lex.IsString('OR'): operator = '|' else: raise resource_exceptions.ExpressionSyntaxError( 'Operator expected [{0}].'.format(lex.Annotate())) # The next token must be an operand. Convert to float or int if possible. # lex.Token() by default eats leading isspace(). operand = lex.Token(convert=True) if not operand: raise resource_exceptions.ExpressionSyntaxErrorSyntaxError( 'Operand expected [{0}].'.format(lex.Annotate())) # Process the key, args, operator and operand. Process(key, args, operator, operand) )absolute_import)division)unicode_literalsN)resource_exceptions)resource_projection_spec)resource_property)resource_transform)map)rangez:=!<>~()z[].{},+*/%&|^#;?c2\rSrSrSrSSjrSrSrSrg) _TransformCall`a A key transform function call with actual args. Attributes: name: The transform function name. func: The transform function. active: The parent projection active level. A transform is active if transform.active is None or equal to the caller active level. map_transform: If r is a list then apply the transform to each list item up to map_transform times. map_transform>1 handles nested lists. args: List of function call actual arg strings. kwargs: List of function call actual keyword arg strings. NctXlX lX0lX@lU=(d /UlU=(d 0UlgN)namefuncactive map_transformargskwargs)selfrrrrrrs 0lib/googlecloudsdk/core/resource/resource_lex.py__init___TransformCall.__init__ns-IIK& DI,BDKc^URVs/sH&n[U[R5(aSOUPM( nnURS:aSR UR5nOURS:XaSnOSnSR X0R SRU55$s snf)Nz z map({0}).zmap().z {0}{1}({2}),)r isinstancerProjectionSpecrformatrjoin)rargrprefixs r__str___TransformCall.__str__wsyy " ( % 4 466M;> ?   " A!!$"4"45f  q ff    388D> BB "s-B*c.[R"U5$r)copy)rmemos r __deepcopy___TransformCall.__deepcopy__s 99T?r)rrrrrr)rrNN) __name__ __module__ __qualname____firstlineno____doc__rr&r+__static_attributes__rrr r `s! BF Crr c\rSrSrSrSrSr\S5r\S5r \S5r \S5r \S 5r S r S rS rSSjrSrg ) _TransformzAn object that contains an ordered list of _TransformCall objects. Attributes: _conditional: The resource_filter expression string for the if() transform. _transforms: The list of _TransformCall objects. c SUl/Ulgr _conditional _transformsrs rr_Transform.__init__sDDrcrSRSR[[UR555$)Nz[{0}].)r"r#r strr:r;s rr&_Transform.__str__s' >>#((3sD,<,<#=> ??rcZUR(aURSR$S$)z4The transform active level or None if always active.rNr:rr;s rr_Transform.actives(*.)9)94  A  % %CtCrcUR$)z1The if() transform conditional expression string.r9r;s r conditional_Transform.conditionals   rc[UR5S:wd+URSR[R:wagURSR S$)aWThe global restriction string or None if not a global restriction. Terms in a fiter expression are sometimes called "restrictions" because they restrict or constrain values. A regular restriction is of the form "attributeoperand". A "global restriction" is a term that has no attribute or . It is a bare string that is matched against every attribute value in the resource object being filtered. The global restriction matches if any of those values contains the string using case insensitive string match. Returns: The global restriction string or None if not a global restriction. rrN)lenr:rrGLOBAL_RESTRICTION_NAMErr;s rglobal_restriction_Transform.global_restrictionsX D  "  !  ! ! ! 9 9 :    A  # #A &&rcZUR(aURSR$S$)zThe name of the last transform.r)r:rr;s rr_Transform.names()-(8(84  B  $ $@b@rc`UR(aURSRS$S$)z"The first global restriction term.rr)r:rr;s rterm_Transform.terms-+/*:*:4  A  # #A &BBrcJUR=(a URSU4;$)z=Returns True if the Transform active level is None or active.NrB)rrs rIsActive_Transform.IsActives    = f~ ==rc:URRU5 g)zAdds a transform to the list.N)r:append)r transforms rAdd_Transform.AddsI&rcXlg)z'Sets the conditional expression string.NrE)rexprs rSetConditional_Transform.SetConditionalsrNc jURGHnURS:XaUbUnUR(a[R"U5(aUn[ URS- 5H"n/nUHnUR U5 M UnM$ /nUH<nURUR"U/URQ70URD65 M> MU(dUR(aMUR"U/URQ70URD6nGM U$![a  Mf=f)zEApply the list of transforms to obj and return the transformed value.urir) r:rrr IsListLiker extend TypeErrorrWrrr)robjoriginal_objectrXitems_nesteditems rEvaluate_Transform.Evaluates%%  5 _%@  %6%A%A#%F%F y..23A& mmD!%4D **Y^^DN9>>NY=M=MN O i---nnSF9>>FY5E5EF1&2 J   s2D## D21D2r8r)r-r.r/r0r1rr&propertyrrFrKrrQrTrYr]rjr2r3rrr5r5s@ D D   ' '( A A C C>'rr5c L[5nUR[XX#S95 U$)aReturns a transform call object for func(*args, **kwargs). Args: func_name: The function name. func: The function object. args: The actual call args. kwargs: The actual call kwargs. Returns: A transform call object for func(obj, *args, **kwargs). )rr)r5rYr ) func_namerrrcallss r MakeTransformrps# ,%))N9 EF ,rc\rSrSrSrSrSrSSjrSSjrSr S r SS jr SS jr SS jr SS jrSSjrSSjrSrSrSrSrSSjrSSjrSrg)LexeraEResource expression lexer. This lexer handles simple and compound tokens. Compound tokens returned by Key() and Args() below are not strictly lexical items (i.e., they are parsed against simple grammars), but treating them as tokens here simplifies the resource expression parsers that use this class and avoids code replication. Attributes: _ESCAPE: The quote escape character. _QUOTES: The quote characters. _defaults: ProjectionSpec object for aliases and symbols defaults. _expr: The expression string. _position: The index of the next character in _expr to parse. \z'"NcxU=(d SUlSUlU=(d [R"5Ulg)zInitializes a resource lexer. Args: expression: The expression string. defaults: ProjectionSpec object for aliases and symbols defaults. rrN)_expr _positionrr! _defaults)r expressiondefaultss rrLexer.__init__s-!rDJDNJ!9!H!H!JDNrcPUc URnU[UR5:$)zChecks if the current expression string position is at the end of input. Args: position: Checks position instead of the current expression position. Returns: True if the expression string position is at the end of input. )rwrIrvrpositions r EndOfInputLexer.EndOfInputs&h s4:: &&rcUR$)zVReturns the current expression position. Returns: The current expression position. rwr;s r GetPositionLexer.GetPosition&s >>rcXlg)zSets the current expression position. Args: position: Sets the current position to position. Position should be 0 or a previous value returned by GetPosition(). Nrr}s r SetPositionLexer.SetPosition.s Nrc`UbUO URnSnUS:a*URUS- R5(dSU-nU[UR5:a'URUR5(dUS- nSR URSUX0RUS5$)aReturns the expression string annotated for syntax error messages. The current position is marked by '*HERE*' for visual effect. Args: position: Uses position instead of the current expression position. Returns: The expression string with current position annotated. Nz*HERE*rr z {0}{1}{2})rwrvisspacerIr")rr~herecursors rAnnotateLexer.Annotate7s +8D F ax 4!8,4466V|f c$**odjj&6&>&>&@&@ mf   djj40&**TU:K LLrcbUR5(d`URURnUR5(aX2;agU=RS- slUR5(dM`U(a3[R "SR XR555eg)aSkips spaces in the expression string. Args: token: The expected next token description string, None if end of input is OK. This string is used in the exception message. It is not used to validate the type of the next token. terminators: Space characters in this string will not be skipped. Raises: ExpressionSyntaxError: End of input reached after skipping and a token is expected. Returns: True if the expression is not at end of input. Trz{0} expected [{1}].F)rrvrwrrExpressionSyntaxErrorr"r)rtoken terminatorscs r SkipSpaceLexer.SkipSpaceJs oo **T^^ $a YY[[A, nnn oo   5 5  & &ummo > @@ rc*UR5(aBU(dU(ag[R"SRUR 555eUR UR nXA;agU(dU=R S- slU$)aChecks if the next character is in characters and consumes it if it is. Args: characters: A set of characters to check for. It may be a string, tuple, list or set. peek: Does not consume a matching character if True. eoi_ok: True if end of input is OK. Returns None if at end of input. Raises: ExpressionSyntaxError: End of input reached and peek and eoi_ok are False. Returns: The matching character or None if no match. NzMore tokens expected [{0}].r)rrrr"rrvrw)r characterspeekeoi_okrs r IsCharacterLexer.IsCharacterdss    5 5 ' . .t}} ? AA 4>>"A   nnn Hrc|UR5(dgUR5nURUSRU5(dgU[ U5- nUR U5(d5URUR 5(dURUS:XaU(dURU5 gg)aSkips leading space and checks if the next token is name. One of space, '(', or end of input terminates the next token. Args: name: The token name to check. peek: Does not consume the string on match if True. Returns: True if the next space or ( separated token is name. FN(T)rrrv startswithrIrrr)rrris rIsStringLexer.IsStrings >>    A ::ab> $ $T * * TNA qTZZ]2244 1 8L    rcHSnSnSnSnUR5n URU 5(GdURU n XR:XaURU S-5(dsURU S-n Uc/nXR:wa6X:wa1U(dXR;aUR UR5 UR U 5 U S- n OX:XaSnOU(dXR;a U nSnUc/nOU(dU R 5(aUcOU(dBU(a;U S;a5U S:XaUS- nOX;aU(dOUS-nUc/nUR U 5 OUU(d U(dX;aO_U(dU R 5(a UbU(aUc/nUR U 5 OUbOU S- n URU 5(dGMU(a3[R"SRXPR555eURU 5 U(aURUS 9 UbS RU5nU(aU(aU(d [U5$U$![a! [!U5s$![a U$f=ff=f) afParses a possibly quoted token from the current expression position. The quote characters are in _QUOTES. The _ESCAPE character can prefix an _ESCAPE or _QUOTE character to treat it as a normal character. If _ESCAPE is at end of input, or is followed by any other character, then it is treated as a normal character. Quotes may be adjacent ("foo"" & ""bar" => "foo & bar") and they may appear mid token (foo" & "bar => "foo & bar"). Args: terminators: A set of characters that terminate the token. isspace() characters always terminate the token. It may be a string, tuple, list or set. Terminator characters are not consumed. balance_parens: True if (...) must be balanced. space: True if space characters should be skipped after the token. Space characters are always skipped before the token. convert: Converts unquoted numeric string tokens to numbers if True. Raises: ExpressionSyntaxError: The expression has a syntax error. Returns: None if there is no token, the token string if convert is False or the token is quoted, otherwise the converted float / int / string value of the token. NFrrTz()rzUnterminated [{0}] quote [{1}].)rr)rrrv_ESCAPE_QUOTESrWrrrr"rrrr#int ValueErrorfloat) rrbalance_parensspaceconvertquotequotedr paren_countrrs rToken Lexer.TokensL: E F EK Aooa  **Q-a ll 4??1q5#9#9 JJq1u  =%  !* a||+ ,,t|| $ Q Q :ll* =% AI 8  +  k   + =% Q[Q-=  u'8^ =% Q   1fa[ooa  \  5 5 + 2 25--/ J LLQ  nnn- ggene55z L  u    L s0) I66 J! J J! JJ!JJ!cnSn/nUS-nUR5nURUSUS9nURS5nU(aUn O[URUSS9n U (dDUR5n[R"SR UR U555eUb.U(dU R5(dURU5 OBU(dU(d4[R"SR UR U555eU(aU$U R5(+nGM,)aParses a separators-separated, )-terminated arg list. The initial '(' has already been consumed by the caller. The arg list may be empty. Otherwise the first ',' must be preceded by a non-empty argument, and every ',' must be followed by a non-empty argument. Args: convert: Converts unquoted numeric string args to numbers if True. separators: A string of argument separator characters. Raises: ExpressionSyntaxError: The expression has a syntax error. Returns: [...]: The arg list. F)T)rrrz*Closing ) expected in argument list [{0}].zArgument expected [{0}].) rrrrrr"rrrW) rr separatorsrequiredrrrr$endseps rArgs Lexer.Argss"H Ds"K     d JJ{4J Ic   S !c z$7!!#$#99:AA--%'( (  ckkmm ++c  3!77 & - -dmmD.A BD D  K[[]"h3 rc:SnURS5(aUS- nURS5(aMU(dgSRURSURU- UURURS5UlU=RU-slg)z-Checks for N '*' chars shorthand for .map(N).r*rNz {}map({}).{})rr"rvrw)r map_levels r_CheckMapShorthandLexer._CheckMapShorthand+sI   3  1ni   3     && .DNNY./ 4>>?#%DJ  NNiNrcr/nSnUR5(GdUR5 UR5nUR[SS9nU(awUR SSSS9nU(dMU(dFX@R R;a-UR RUupbURU5 OURU5 OUR SSS9(dU(d_UR S 5(aIUR S SSS9(d3UR5(dUR [SSS9(aX4$[R"S RURU555eUR5(aX4$UR S 5(a4[R"S RURU555eUR SSS 9(aIURS SS9nUR S 5 URU5 UR SSS 9(aMIUR S SS 9(dX4$UR5(a3[R"S RUR555eUR5(dGMX4$)aParses a resource key from the expression. A resource key is a '.' separated list of names with optional [] slice or [NUMBER] array indices. Names containing _RESERVED_OPERATOR_CHARS must be quoted. For example, "k.e.y".value has two name components, 'k.e.y' and 'value'. A parsed key is encoded as an ordered list of tokens, where each token may be: KEY VALUE PARSED VALUE DESCRIPTION --------- ------------ ----------- name string A dotted name list element. [NUMBER] NUMBER An array index. [] None An array slice. For example, the key 'abc.def[123].ghi[].jkl' parses to this encoded list: ['abc', 'def', 123, 'ghi', None, 'jkl'] Raises: ExpressionKeyError: The expression has a key syntax error. Returns: (key, attribute) The parsed key and attribute. attribute is the alias attribute if there was an alias expansion, None otherwise. NF)rrT)rr[)rr>z"Non-empty key name expected [{0}].]zUnmatched ] in key [{0}].r)r)rrrr_RESERVED_OPERATOR_CHARSrrxaliasesrbrWrrr"r)rkey attributerr is_functionkindexs rKeyWithAttributeLexer.KeyWithAttribute;sf6 CIoo     d ZZ0Z >d &&sd&C ;4>>3I3I+I//5,! **Q- **T $/   S ! !  4 =!!T%5%5,4&6&F & >%"77 0 7 7 d8K LN N     >   #  !77 ' . .t}}T/B CE E   S  . 3 -  5   S  . .   c$  / >   !77 0 7 7  HJ JGooJ >rc*UR5upU$)zEParses a resource key from the expression and returns the parsed key.)r)rrrgs rKey Lexer.Keys  " " $FC Jrc^ /m UHn[U5nURS5(d[R"S5e/nUR 5HnSU;aUR SS5upgSnOSSU;a0UR SS5upi[U 5R 5nSnO[U5R 5nSnSnURXhU45 M T RU5 M U 4Sjn U $)aParses the synthesize() transform args and returns a new transform. The args are a list of tuples. Each tuple is a schema that defines the synthesis of one resource list item. Each schema item is an attribute that defines the synthesis of one synthesized_resource attribute from an original_resource attribute. There are three kinds of attributes: name:literal The value for the name attribute in the synthesized resource is the literal value. name=key The value for the name attribute in the synthesized_resource is the value of key in the original_resource. key: All the attributes of the value of key in the original_resource are added to the attributes in the synthesized_resource. Args: args: The original synthesize transform args. Returns: A synthesize transform function that uses the schema from the parsed args. Example: This returns a list of two resource items: synthesize((name:up, upInfo), (name:down, downInfo)) If upInfo and downInfo serialize to {"foo": 1, "bar": "yes"} and {"foo": 0, "bar": "no"} then the synthesized resource list is [{"name": "up", "foo": 1, "bar": "yes"}, {"name": "down", "foo": 0, "bar": "no"}] which could be displayed by a nested table using synthesize(...):format="table(name, foo, bar)" rz-(...) args expected in synthesize() transform:rN=c >/nT Hyn0nUH]nUupVnU(a[R"XS5OUnU(aXU'M5[U[5(dMLUR U5 M_ UR U5 M{ U$)zSynthesize a new resource list from the original resource r. Args: r: The original resource. Returns: The synthesized resource list. N)rGetr dictupdaterW) rsynthesized_resource_listschemasynthesized_resourceattrrrliteralvalueschemass r _Synthesize+Lexer._ParseSynthesize.._Synthesizes#%&!D# $W9<#''5'% ). &%&& ' ' .  "(()=>'&r)rrrrrrsplitrrW) rrr$lexrrrrrrrrs @r_ParseSynthesizeLexer._ParseSynthesizesPG #Jc __S ! !!77 ;= =f((*$ $;**S!,-$# D[ 3*+$e   "#'d !#$' t'*+nnV'*', rc dUR5nURRRU5nU(d4[R "SR XRU555e/n0n[USS5nU(a/[RU;aURUR5 [USS5(aJUR5H5n U RS5upn U (aXU 'M$URU 5 M7 OX`R5- n[XUX6US9$)aParses a transform function call. The initial '(' has already been consumed by the caller. Args: func_name: The transform function name. active: The transform active level or None if always active. map_transform: Apply the transform to each resource list item this many times. Returns: A _TransformCall object. The caller appends these to a list that is used to apply the transform functions. Raises: ExpressionSyntaxError: The expression has a syntax error. %Unknown transform function {0} [{1}].r1N __defaults__r)rrrr)rrxsymbolsgetrUnknownTransformErrorr"rgetattrrPROJECTION_ARG_DOCrWr partitionr ) rrnrrrrrrdocr$rrvals r_ParseTransformLexer._ParseTransforms$    D >> ! ! % %i 0D   5 5 1 8 8t, . // D F $ 4 (C '::cA kk$..!t^T**#s+3 , ++c   iikd )&(5 QQrcUR5n[5nSnURXUS9nUR[R :XaSnSnGOGUR[R :Xa.UR(a[URS5OSnSnOUR[R:Xal[UR5S:wa4[R"SRURU555eURURS5 OqUR[R :Xa@UR#UR5Ul/Ul0UlUR'U5 OSnUR'U5 UR)SSS9(dU$UR+5nUR5nUR)S 5(d4[R"S RURU555e[U5S:waD[R,"S RSR/U5URU555eUR15nGMc) aQParses one or more transform calls and returns a _Transform call object. The initial '(' has already been consumed by the caller. Args: func_name: The name of the first transform function. active: The transform active level, None for always active. Returns: The _Transform object containing the ordered list of transform calls. rT)rrNrz-Conditional filter expression expected [{0}].r>rrz"Transform function expected [{0}].r)rr5rrr TransformAlways TransformMaprr TransformIfrIrrr"rr]TransformSynthesizerrrYrrrr#pop)rrnrrrorrXcalls r TransformLexer.Transforms    D LEM &&y5B'Di -== = >>/<< <2;..INN1-.a  >>/;; ; y~~ ! ##99=DD--%'( ( Y^^A./ >>/CC C..y~~>    )  )   c$  /  LXXZd    d   c " "!77 0 7 7 d# %& & Ta!77 3 : : d 3 56 6((*iK r)rxrvrwr)Nr)FF)F)rFTF)Fr)rN)r)r-r.r/r0r1rrrrrrrrrrrrrrrrrrr2r3rrrrrrsw  ' ' K 'M&4 60?CbH.` BH Tl*QX5rrrc[U5nUR5nUR5(d3[R"SR UR 555eU$)aReturns a parsed key for the dotted resource name string. This is an encapsulation of Lexer.Key(). That docstring has the input/output details for this function. Args: name: A resource name string that may contain dotted components and multi-value indices. Raises: ExpressionSyntaxError: If there are unexpected tokens after the key name. Returns: A parsed key for he dotted resource name string. zUnexpected tokens [{0}] in key.)rrrrrrr"r)rrrs rParseKeyr>sS d #  #     3 3)00@ BB *rc/nUHnUc"U(aMSnU(aUS==U- ss'M'O[U[R5(a/U(aMPSRUS9nU(aUS==U- ss'MuOVU(aO[R "SU5(a3UR SS5nUR SS 5nS RUS9nURU5 M U(aS RU5$S $) aReturns the string representation for a parsed key. This is the inverse of Lexer.Key(). That docstring has the input/output details for this function. Args: key: A parsed key, which is an ordered list of key names/indices. Each element in the list may be one of: str - A resource property name. This could be a class attribute name or a dict index. int - A list index. Selects one member is the list. Negative indices count from the end of the list, starting with -1 for the last element in the list. An out of bounds index is not an error; it produces the value None. None - A list slice. Selects all members of a list or dict like object. A slice of an empty dict or list is an empty dict or list. quote: "..." the key name if it contains non-alphanum characters. omit_indices: Omit [...] indices if True. Returns: The string representation of the parsed key. z[]rNz[{part}])partz[^-@\w]rtz\\"z\"z"{part}"r>) r six integer_typesr"researchreplacerWr#)rr omit_indicespartsrs r GetKeyNamerVs. %d |  d  b T   D#++ , ,    D  )d  b T   299Z.. \\$ 'd \\#u %d   D  )d LL'("%*s*r)NN)TF)r1 __future__rrrr)rgooglecloudsdk.core.resourcerrrr r six.movesr r OPERATOR_CHARSrobjectr r5rprrrrr3rrr s 5n'' <A:; *,>>%V%P``F"FD 0,+r