lQSrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSK J r SSK Jr SS K Jr SSKJ r SSKrSS KJr S r"S S \5rSSjr"SS\5rg)aA class for projecting and transforming JSON-serializable objects. From the Cloud SDK doc "DD: gcloud resource projection algorithm": Algorithm The algorithm represents a resource R and projection P as trees. P is used to color the nodes of R (with the colors {0, 1, 2, 3}) as follows: 1. Initialize the nodes in R to (id, 0, identity). 2. Do a DFS on P. Let p be the projection subtree and r be the resource subtree at each level. Let f be a flag value at each level, and initialize f to the flag value of the root node of P. 2.1. For each id i in p that is also in r, set r[i].flag |= p[i].flag | f, and r[i].transform = p[i].transform if r[i].transform != identity and p[i].transform != identity. 2.2. If p contains a slice then repeat step 2.1 with i = slice. 2.3. If r[i].flag is 0 then prune the search at this node, otherwise 2.4. descend to the next level with r = r[i], p = p[i], and f = r[i].flag. 3. At the end of the search the nodes of R will be colored with the values {0, 1, 2, 3}. The projected keys are the set of the longest paths from the root of R ending with a flag value >= 2. Remarks If the initial value of f is PROJECT or PROJECT* (2 or 3) then all keys in R are projected. Non-leaf keys may be projected in this model, resulting in dict or list values instead of scalars. Example usage: projector = resource_projector.Compile(expression) for resource in resources: obj = projector.Evaluate(resource) OperateOnProjectedResource(obj) )absolute_import)division)unicode_literalsN)messages)encoding)resource_projection_parser)resource_property)rangec4[5RU5$)zReturns resource or a JSON-serializable copy of resource. Args: resource: The resource object. Returns: The original resource if it is a primitive type object, otherwise a JSON-serializable copy of resource. )CompileEvaluate)resources 6lib/googlecloudsdk/core/resource/resource_projector.pyMakeSerializablerGs   H %%cl\rSrSrSrSSjrSrSrSrSr Sr SS jr S r S r S rS rSrSrg) ProjectorTaProjects a resource using a ProjectionSpec. A projector is a method that takes an object and a projection as input and produces a new JSON-serializable object containing only the values corresponding to the keys in the projection. Optional projection key attributes may transform the values in the resulting JSON-serializable object. Attributes: _projection: The projection object. _been_here_done_that: A set of the current object id()'s being projected. Used to catch recursive objects like datetime.datetime.max. _by_columns: True if Projector projects to a list of columns. _columns: self._projection.Columns() column attributes. _ignore_default_transforms: Ignore default projection transforms if True. _retain_none_values: Retain dict entries with None values. _transforms_enabled_attribute: The projection.Attributes() transforms_enabled setting. _transforms_enabled: Projection attribute transforms enabled if True, disabled if False, or set by each Evaluate(). c XlX lURR5UlX0lX@l[ 5UlUR5nSU;aSUl OSU;aSUl OSUl SU;Ul g)aConstructor. Args: projection: A ProjectionSpec (parsed resource projection expression). by_columns: Project to a list of columns if True. ignore_default_transforms: Ignore default projection transforms if True. retain_none_values: project dict entries with None values. transformsTz no-transformsFNz json-decode) _projection _by_columnsColumns_columns_ignore_default_transforms_retain_none_valuesset_been_here_done_that Attributes_transforms_enabled_attribute _json_decode)self projection by_columnsignore_default_transformsretain_none_values attributess r__init__Projector.__init__js"!$$,,.DM&?#1 #D&&(Jz!+/d( J &+0d(+/d(%3Drc~URb UR$URSURR4;$)zReturns True if transform is enabled. Args: transform: The resource_projection_parser._Transform object. Returns: True if the transform is enabled, False if not. N)_transforms_enabledactiver)r" transforms r_TransformIsEnabledProjector._TransformIsEnableds> +  % %%   d&6&6&=&=> >>rc\X0RR:agU(a{UR(ajURR(aOUR URR5(a%URRR U5$UR XUSS9$)aApplies projection.attribute.transform in projection if any to obj. Args: obj: An object. projection: Projection _Tree node. flag: A bitmask of DEFAULT, INNER, PROJECT. Returns: The transformed obj if there was a transform, otherwise the original obj. NTleaf)rPROJECT attributer-r.r _Project)r"objr#flags r_ProjectAttributeProjector._ProjectAttributes &&& z++ 0D0D0N0N  $ $Z%9%9%C%C D D  ! ! + + 4 4S 99 ==$T= ::rcN0n[5n[U[R5(a+[R"U5US'UR S5 OLUR [ UR5Vs/sHofR5(dMUPM sn5 [ U5HnURS5(aMXu;aM"[X5n[US5(aMAUn XrR;aXURUn XRR-n XR R":aMUR%XU 5XG'MUR'XR R)5U 5XG'M U$s snf![a Nf=f! M=f)a Converts class object to a dict. Private and callable attributes are omitted in the dict. Args: obj: The class object to convert. projection: Projection _Tree node. flag: A bitmask of DEFAULT, INNER, PROJECT. Returns: The dict representing the class object. datetime)maxmin resolutiontzinfo___call__)r isinstancer;six text_typeupdatedir __class__isupperAttributeError startswithgetattrhasattrtreer4r7rINNERr5r8GetEmpty) r"r6r#r7rexcludeaattrvaluefchild_projections r _ProjectClassProjector._ProjectClasssh AeG#x(())mmC(a mnn;< 3s}}#5E#5a#5EFC    "  # # a  %??40 ' ' , ,, %% % --;((0@0@0I0I0KQO34 H;F    s6"F:F F F F F FFF$cU(dU$0n[R"U5 [R"U5HupVUnXRR;aUURUnXxRR -nXpR R:aMXURXhU5nO*URX`R R5U5nUc?UR(d.XpR R:dMUR(dMXd[R"U5'M U=(d S$![a gf=f![ a XdU'GM!f=f)zProjects a dictionary object. Args: obj: A dict. projection: Projection _Tree node. flag: A bitmask of DEFAULT, INNER, PROJECT. Returns: The projected obj. N)rC iteritems ValueErrorrMr4r7rrNr5r8rOrr3rrDecode UnicodeError) r"r6r#r7reskeyvalrUrVs r _ProjectDictProjector._ProjectDicts'  j C mmCMM#& a  %??3/ ' ' , ,, %% % mmC15$$S*:*:*C*C*EqI /T55 '' 'DMMM &)hooc" ##'( ;$-  ( c( s#D8E8 EEEEc^TcgT(d/$[T5nTSn[ /5nSnUR (dX0R R:agOUR HnUcTX0R R:d(UR URR(aUR UnMXMZ[U[R5(dM{U[[T5*[T55;dMURU5 M X0R R:a!U(dUR R5nU(dU(dgSnU(aS/[T5-n OS/[!U4SjU55S--n U(a[[T55OUHnTUn U cM Un XrR ;a/UR Un U(aXRR-n OUn U (aFXRR-n XR R":aUR%XU 5n OSn U cMUS:aU[T5- nX:aUnXU'M US:agU(aU SUS-$U $![a [T5mGNf=f![a! [T5mGN![a gf=ff=f)zProjects a list, tuple or set object. Args: obj: A list, tuple or set. projection: Projection _Tree node. flag: A bitmask of DEFAULT, INNER, PROJECT. Returns: The projected obj. Nrc3N># UHoS:aU[T5-OUv M g7f)rN)len).0xr6s r )Projector._ProjectList..Fs"H1a%!c#h,Q6s"%)rf TypeErrorsortedlistrrMrr3r4r7rBrC integer_typesr addrOr<rNr5) r"r6r#r7r@indicesslicedindexmaxindexr^r`rUrVs ` r _ProjectListProjector._ProjectLists {   i  c(a F"gG F ??   (( ( )??% =&&...ooe$..33__U+F4 1 122uc#hYC11 ++e # '''((*f 6 H Fc#h cFcHHH1L Mc$*s3x7 Jc  a // !%??51  $$ $!"  ' ' , ,,   && & cQ7##   S  %jK8P!| #)3qA 1c1qSk 3i sF J.JJ+'J.*J++J.. K9 K KKKKcj[U5nXPR;agUcGO[U[R5(d[U[R 5(a[U[R 5(a[ R"U5nUR(a~URS5(aURS5(d,URS5(a<URS5(a&UR[R"U5X#US9$GO[U[[ ["45(d[U[R$5(aGOt[U[&5(a![ R"[)U55nGO>[U[*R,5(aUR.nGOURR1U5 SSKJn SSKn[U[*R85(a[:R<"U5nO[XR85(aSS KJn UR=U5nOj[XR85(aUR@RCU5nO4[EUS 5(a[EUS 5(aURGXU5nU(a|URH(akURHRJ(aPURMURHRJ5(a&URHRJROU5nOzX0RPRR:dU(aZURT(aI[EUS 5(a8[EUS 5(aURWXU5nOUR]XU5nURR_U5 U$U(aU$URaXU5$![a N'f=f![X[Z4a SnN\f=f![X[Z4a SnNtf=f) a|Evaluate() helper function. This function takes a resource obj and a preprocessed projection. obj is a dense subtree of the resource schema (some keys values may be missing) and projection is a sparse, possibly improper, subtree of the resource schema. Improper in that it may contain paths that do not exist in the resource schema or object. _Project() traverses both trees simultaneously, guided by the projection tree. When a projection tree path reaches an non-existent obj tree path the projection tree traversal is pruned. When a projection tree path terminates with an existing obj tree path, that obj tree value is projected and the obj tree traversal is pruned. Since resources can be sparse a projection can reference values not present in a particular resource. Because of this the code is lenient on out of bound conditions that would normally be errors. Args: obj: An object. projection: Projection _Tree node. flag: A bitmask of DEFAULT, INNER, PROJECT. leaf: Do not call _ProjectAttribute() if True. Returns: An object containing only the key:values selected by projection, or obj if the projection is None or empty. Nz{"}[]r1r)message) json_format__iter___fieldsitems)1idrrBrCrD binary_typerr\r!rJendswithr5jsonloadsr[boolfloatcomplexro bytearraybytesprotorpc_messageEnumnamerpcloudsdk.google.protobufr{protoMessageprotorpc_encoding MessageToDictr|rGto_dictrLrWr4r-r.r rr3rMraIOErrorrlrudiscardr8) r"r6r#r7r2objidprotobuf_messagerprotobuf_encodings rr5Projector._Projectus6 sGE )))   C ' ':c3??+K+K C ) )ooc"    ..  3<<#4#4 ..  #,,s"3"3 tzz# tL L S40 1 1 S#++ , , C # # OOE#J 'c C).. / / HHc ##E*F C)11 2 2--c2 c33 4 4M--c2 c== ) )mm##C(sJ''73 +B+B  $7 --    ( (  " ":#7#7#A#A B B"",,55c: %%-- - Z(( 3  ##CT:C ##CT:C ''. j3ID223DIIg   P9% C  9% C s6>$O5P+P5 PPPPP21P2cXlg)zoSets the projection to list-of-columns mode. Args: enable: Enables projection to a list-of-columns if True. N)rr"enables r SetByColumnsProjector.SetByColumnss rcXlg)ziSets the ignore default transforms mode. Args: enable: Disable default projection transforms if True. N)rrs rSetIgnoreDefaultTransforms$Projector.SetIgnoreDefaultTransformss '-#rcXlg)zuSets the projection to retain-none-values mode. Args: enable: Enables projection to a retain-none-values if True. N)rrs rSetRetainNoneValuesProjector.SetRetainNoneValuess &rcURUlUR(aUR(dUR(aSUlUR R nOUR Rn[US5(aUR5nURXR R5U5$URXR R5UR R5nURcUR(+Ul/nURHnUR(a [R "X5R5OUnUR"R$(aOUR'UR"R$5(a%UR"R$R)Xa5nUR+U5 M U$)aSerializes/projects/transforms obj. A default or empty projection expression simply converts a resource object to a JSON-serializable copy of the object. Args: obj: An object. Returns: A JSON-serializeable object containing only the key values selected by the projection. The return value is a deep copy of the object: changes to the input object do not affect the JSON-serializable copy. Fr)r r+rrrrDEFAULTr3rLrr5TreerOrr_r Getr4r-r.r append)r"r6r7obj_serializedcolumnscolumnr`s rr Projector.Evaluatesv $AAD   4== #( '''' ( ) )""$ ]]3 0 0 5 5 7 >>]]   & & ($*:*:*B*BN ))1%)%D%D!DdG--ZZ    ;    # #(@(@    $ $))((11#; nnS  NrcUR$)znReturns the ProjectionSpec object for the projector. Returns: The ProjectionSpec object for the projector. )r)r"s r ProjectionProjector.Projections   r) rrrrr!rrr+r N)FFF)F)__name__ __module__ __qualname____firstlineno____doc__r(r.r8rWrarur5rrrr r__static_attributes__rrrrTsS*-2CH42 ?;*7 r&Pm2^_JB-&*XrrcJ[R"XU[S9n[XSUS9$)aCompiles a resource projection expression. Args: expression: The resource projection string. defaults: resource_projection_spec.ProjectionSpec defaults. symbols: Transform function symbol table dict indexed by function name. by_columns: Project to a list of columns if True. retain_none_values: Retain dict entries with None values. Returns: A Projector containing the compiled expression ready for Evaluate(). )defaultssymbolscompiler)r$r&)rParser r) expressionrrr$r&r#s rr r #s.*//WwH* :&8 ::rc2^\rSrSrSrU4SjrSrSrU=r$)IdentityProjectori7z>A no-op resource projector that preserves the original object.cR>[[U] [R"55 gN)superrr(rr)r"rGs rr(IdentityProjector.__init__:s T+,F,L,L,NOrcU$rr)r"r6s rr IdentityProjector.Evaluate=s Jrr) rrrrrr(r r __classcell__)rGs@rrr7sFPrr)NNFF)r __future__rrrr;rapitools.base.protorpcliterrapitools.base.pyrrgooglecloudsdk.core.resourcerr googlecloudsdk.core.utilrC six.movesr robjectrr rrrrrs` #J'' C:C:-  &LL^DI$:( r