,vSrSSKJr SSKJr SSKJr SSKrSSKrSrSrSr S S S S .r S r "SS\ 5r g)z7A class that creates resource projection specification.)absolute_import)division)unicode_literalsNzglobal.restrictionz' projection: The parent ProjectionSpec.leftc$URU5$N)ljustsws r"s 1771:c$URU5$r)centerr s r rr#s QXXa[rc$URU5$r)rjustr s r rr$s AGGAJr)rrrightc0n0nUHfnU(dM UR(aURUR5 UR(dMKURUR5 Mh [X!S9$)a8Combines a list of defaults into a new defaults object. Args: defaults: An ordered list of ProjectionSpec objects to combine. alias and symbol names from higher index objects in the list take precedence. Returns: A new ProjectionSpec object that is a combination of the objects in the defaults list. )symbolsaliases)rupdaterProjectionSpec)defaultsrrdefaults r CombineDefaultsr's[ ' 'g  nnW__% nnW__%   99rc\rSrSrSrSrSrSr"SS\5r S#S jr \ S 5r \ S 5r S rS rSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSr Sr!\"RF4S jr$S!r%S"r&g)$r>aCreates a resource projection specification. A resource projection is an expression string that contains a list of resource keys with optional attributes. A projector is a method that takes a projection specification and a resource object as input and produces a new JSON-serializable object containing only the values corresponding to the keys in the projection specification. Optional projection key attributes may transform the values in the output JSON-serializable object. Cloud SDK projection attributes are used for output formatting. A default or empty projection expression still produces a projector that converts a resource to a JSON-serializable object. This class is used by the resource projection expression parser to create a resource projection specification from a projection expression string. Attributes: aliases: Resource key alias dictionary. _active: The transform active level. Incremented each time Defaults() is called. Used to determine active transforms. attributes: Projection attributes dict indexed by attribute name. _columns: A list of (key,_Attribute) tuples used to project a resource to a list of columns. _compiler: The projection compiler method for nested projections. _empty: An empty projection _Tree used by Projector(). _name: The projection name from the expression string. _tree: The projection _Tree root, used by resource_projector.Evaluate() to efficiently project each resource. symbols: Default and caller-defined transform function dict indexed by function name. rc\rSrSrSrSrSrg)ProjectionSpec._ColumnezColumn key and transform attribute for self._columns. Attributes: key: The column key. attribute: The column key _Attribute. cXlX lgr)key attributeselfr%r&s r __init__ProjectionSpec._Column.__init__ms h nr)r&r%N)__name__ __module__ __qualname____firstlineno____doc__r)__static_attributes__rr _Columnr"es !rr2NcU=(d 0Ul0Ul/UlX@lSUlSUl0UlSUlU(aURUl [R"UR55Ul UR5 U(a[R"U5O0UlUR(a%URR!UR5 UR(a&URR!UR5 ggSUl SUl U=(d 0Ulg)a Initializes a projection. Args: defaults: A list of resource_projection_spec.ProjectionSpec defaults. symbols: Transform function symbol table dict indexed by function name. aliases: Resource key alias dictionary. compiler: The projection compiler method for nested projections. Nr)r attributes_columns _compiler_empty_name_snake_headings _snake_reactive_activecopydeepcopyGetRoot_treeDefaultsrr)r(rrrcompilers r r)ProjectionSpec.__init__qs=bDLDODMNDKDJDDN__dl==!1!1!34dj mmo/6T]]7+Bdl    H,,-    H,,- dldj]dlrcUR$)z Gets the transform active level.)r<r(s r r;ProjectionSpec.actives <<rcUR$)z>Returns the projection compiler method for nested projections.)r6rEs r rBProjectionSpec.compilers >>rcURURlURR 5HnUR U5 M g)zDefaults() helper -- converts a projection to a default projection. Args: projection: A node in the original projection _Tree. N)DEFAULTr&flagtreevalues _Defaults)r( projectionnodes r rNProjectionSpec._Defaultss9 !% J&&( nnT)rc [UR5H_nURSRSU-UURURS95 UR URUX#S-5 Ma g)aPrint() helper -- prints projection node p and its children. Sorted by projection tree level for diff stability. Args: projection: A _Tree node in the original projection. out: The output stream. level: The nesting level counting from 1 at the root. z{indent} {key} : {attribute} z )indentr%r&rN)sortedrLwriteformatr&_Print)r(rOoutlevelr%s r rWProjectionSpec._Printsojoo& ii077OOC(22845 kk*//#&QY7 'rc X RU'g)zcAdds name=value to the attributes. Args: name: The attribute name. value: The attribute value Nr4)r(namevalues r AddAttributeProjectionSpec.AddAttributes"OODrc>XR;aURU gg)z`Deletes name from the attributes if it is in the attributes. Args: name: The attribute name. Nr\r(r]s r DelAttributeProjectionSpec.DelAttributes   //$ rc$X#4URU'g)zAdds name as an alias for key and attribute to the projection. Args: name: The short (no dots) alias name for key. key: The parsed key to add. attribute: The attribute for key. Nr)r(r]r%r&s r AddAliasProjectionSpec.AddAliass)DLLrcXURRURX55 g)zvAdds key and attribute to the projection. Args: key: The parsed key to add. attribute: Parsed _Attribute to add. N)r5appendr2r's r AddKeyProjectionSpec.AddKeys MMc56rc@UR(a0UlXlg)zSets the projection name. The projection name is the rightmost of the names in the expression. Args: name: The projection name. N)r8r4rbs r SetNameProjectionSpec.SetNames zzdoJrcUR$)z]Returns the projection root node. Returns: The resource_projector_parser._Tree root node. r@rEs r r?ProjectionSpec.GetRoot ::rcXlg)z]Sets the projection root node. Args: root: The resource_projector_parser._Tree root node. Nrq)r(roots r SetRootProjectionSpec.SetRoots JrcUR$)zReturns the projector resource_projector_parser._Tree empty node. Returns: The projector resource_projector_parser._Tree empty node. r7rEs r GetEmptyProjectionSpec.GetEmptys ;;rcXlg)zSets the projector resource_projector_parser._Tree empty node. The empty node is used by to apply [] empty slice projections. Args: node: The projector resource_projector_parser._Tree empty node. Nry)r(rPs r SetEmptyProjectionSpec.SetEmptys KrcUR$)zuReturns the projection columns. Returns: The columns in the projection, None if the entire resource is projected. )r5rEs r ColumnsProjectionSpec.Columns s ==rc,[UR5$)zReturns the number of columns in the projection. Returns: The number of columns in the projection, 0 if the entire resource is projected. )lenr5rEs r ColumnCountProjectionSpec.ColumnCounts t}} rcUR(aURUR5 /UlU=RS- slg)zConverts the projection to a default projection. A default projection provides defaults for attribute values and function symbols. An explicit non-default projection value always overrides the corresponding default value. rN)r@rNr5r<rEs r rAProjectionSpec.Defaultss0 zz nnTZZ DMLLALrcUR$)zReturns the short key name alias dictionary. This dictionary maps short (no dots) names to parsed keys. Returns: The short key name alias dictionary. rfrEs r AliasesProjectionSpec.Aliases&s <<rcUR$)z`Returns the projection _Attribute dictionary. Returns: The projection _Attribute dictionary. r\rEs r AttributesProjectionSpec.Attributes0s ??rc|URVs/sH n[URRPM" sn$s snf)zReturns the projection column justfication list. Returns: The ordered list of alignment functions, where each function is one of ljust [default], center, or rjust. )r5 ALIGNMENTSr&align)r(cols r AlignmentsProjectionSpec.Alignments8s/8<}} E}Js}}** +} EE Es'9cURVs/sH!oRR=(d SPM# nn[U5(aU$S$s snf)zReturns the ordered list of projection labels. Returns: The ordered list of projection label strings, None if all labels are empty. N)r5r&labelany)r(rlabelss r LabelsProjectionSpec.LabelsAsE48== A=Cmm!!'R'=F A[[6*d*Bs(A cUR$)zReturns the projection name. The projection name is the rightmost of the names in the expression. Returns: The projection name, None if none was specified. )r8rEs r NameProjectionSpec.NameKs ::rc/n[UR5Hup#URR(dURR(dM=UR URR=(d [ RX#RR45 M [U5VVVs/sH upBoRU4PM snnn$s snnnf)akReturns the projection sort key order suitable for use by sorted(). Example: projection = resource_projector.Compile('...') order = projection.Order() if order: rows = sorted(rows, key=itemgetter(*order)) Returns: The list of (sort-key-index, reverse), [] if projection is None or if all sort order indices in the projection are None (unordered). ) enumerater5r&orderreverserjsysmaxsizerT)r(orderingir_rs r OrderProjectionSpec.OrderUsHDMM*    5 5 5 ]] /CKKMM4I4I J L+/5X.> ?.>]Q7L.> ?? ?s:CcbUR(aURURUS5 gg)zbPrints the projection with indented nesting. Args: out: The output stream, sys.stdout if None. rN)r@rW)r(rXs r PrintProjectionSpec.Printis$  zz kk$**c1%rcUR$)zHReturns the projection tree root. Returns: The projection tree root. rqrEs r TreeProjectionSpec.Treerrsr) r<r5r6r7r8r9r:r@rr4r)NNNN)'r+r,r-r.r/rJINNERPROJECTobjectr2r)propertyr;rBrNrWr_rcrgrkrnr?rvrzr}rrrArrrrrrrstdoutrrr0r1rr rr>s D ' % ' ! !#>    8"" *7  F+@(jj&rr)r/ __future__rrrr=rGLOBAL_RESTRICTION_NAMEPROJECTION_ARG_DOC ALIGN_DEFAULTrrrrr1rr rsO >&' /> -0.0 :.zVzr