)dZddlmZddlmZddlmZddlmZddlZddlmZ ddlm Z dd l m Z dd l mZd ZGd d e j ZGddeZGddeZGddeZGddeZdZGddeZy)aResource printer base class. Each printer has three main attributes, all accessible as strings in the --format='NAME[ATTRIBUTES](PROJECTION)' option: NAME: str, The printer name. [ATTRIBUTES]: str, An optional [no-]name[=value] list of attributes. Unknown attributes are silently ignored. Attributes are added to a printer local dict indexed by name. (PROJECTION): str, List of resource names to be included in the output resource. Unknown names are silently ignored. Resource names are '.'-separated key identifiers with an implicit top level resource name. Example: gcloud compute instances list --format='table[box](name, networkInterfaces[0].networkIP)' )absolute_import)division)print_function)unicode_literalsN) exceptions)log) console_io)resource_propertyceZdZdZy)ErrorzExceptions for this module.N__name__ __module__ __qualname____doc__9lib/googlecloudsdk/core/resource/resource_printer_base.pyr r 6s#rr ceZdZdZy)ProjectionRequiredErrorz-Format missing required projection exception.Nrrrrrr:s5rrceZdZdZdZy)_ResourceMarkerz2A marker that can be injected into resource lists.cy)zYCalled by ResourcePrinter.Addrecord(). Args: printer: The printer object. Nrselfprinters rActz_ResourceMarker.ActAs  rNrrrrrrrrrr>s : rrceZdZdZdZy) FinishMarkerzA resource list Finish marker.c$|jyN)Finishrs rrzFinishMarker.ActMs  NNrNrrrrr!r!Js &rr!ceZdZdZdZy) PageMarkerzA resource list Page marker.c$|jyr#)Pagers rrzPageMarker.ActTs  LLNrNrrrrr&r&Qs $rr&c"t|tS)z.Returns True if resource is a _ResourceMarker.) isinstancer)resources rIsResourceMarkerr,Xs Ho ..rcheZdZdZ ddZdZdZdZddZddZ d Z d Z d Z d Z dd ZdZy)ResourcePrinteraeBase class for printing JSON-serializable Python objects. Attributes: attributes: Optional printer attribute dict indexed by attribute name. column_attributes: Projection column attributes. _console_attr: The console attributes. May be ignored by some printers. _empty: True if there are no records. _heading: The list of column heading label strings. _name: Format name. _non_empty_projection_required: True if the printer requires a non-empty projection. _out: Output stream. _process_record: The function called to process each record passed to AddRecord() before calling _AddRecord(). It is called like this: record = process_record(record) _printer: The resource_printer.Printer method for nested formats. _is_column_visible: List of Boolean values indicating if indexed column is visible Nc ddlm} | |_d|_d|_||_||_|xstj|_ ||_ d|_ d|_ |s| j}|xs |j|_|j!||j#||j%} | r| j'xsi|_| |_d|j(vrjtj,j/dj1| j3| j/tj,ni|_d|_d|j(vrd} |j5| d |j(vr |jj7|_ d |j(vr3|1|j|_ t;j<|_ d|_ |j?y#t8$rY]wxYw) a6Constructor. Args: out: The output stream, log.out if None. If the 'private' attribute is set and the output stream is a log._ConsoleWriter then the underlying stream is used instead to disable output to the log file. name: The format name. projector: Optional resource Projector. by_columns: True if AddRecord() expects a list of columns. ignore_default_transforms: Ignore default projection transforms if True. process_record: The function called to process each record passed to AddRecord() before calling _AddRecord(). It is called like this: record = process_record(record) non_empty_projection_required: True if the printer requires a non-empty projection. printer: The resource_printer.Printer method for nested formats. console_attr: The console attributes for the output stream. Ignored by some printers. If None then printers that require it will initialize it to match out. retain_none_values: Retain resurce dict entries with None values. r)resource_projectorTNFdebugz{0} format projection:z no-undefinedprivatepager) googlecloudsdk.core.resourcer0 _console_attr_empty_heading_name_non_empty_projection_requiredrout_out_printer_pager _pager_outCompileEvaluate_process_record SetByColumnsSetIgnoreDefaultTransforms Projection Attributes attributescolumn_attributesstatusPrintformatNameSetRetainNoneValuesGetConsoleWriterStreamAttributeErrorioStringIO_SetVisibleColumns) rr:name projector by_columnsignore_default_transformsprocess_recordnon_empty_projection_requiredr console_attrretain_none_valuesr0 projections r__init__zResourcePrinter.__init__rs4@&DDKDMDJ*GD'swwDIDMDKDO $,,.i)?Y-?-?D :& (()BC%%'J"--/52do)d DOO # 1889JKL$do#d(  !!"45DOO# II446 $//!ck do++-didk   s;G,, G87G8c|jrC|jjDcgc]}|jj c}|_yd|_ycc}w)z@Sets visible columns list if column attributes have been loaded.N)rGColumns attributehidden_is_column_visible)rcolumns rrQz"ResourcePrinter._SetVisibleColumnssZ ..668!8f%% %8!d !%d !sAc|js|j|jr.t|Dcgc]\}}|j|s|c}}S|Scc}}w)z.Returns a list of visible columns given a row.)r`rQ enumerate)rrowicols rRemoveHiddenColumnsz#ResourcePrinter.RemoveHiddenColumnssU  " "   )# Mfa$2I2I!2Lc MM jNs AAc||_y)zOverrides the default heading. If the printer does not support headings then this is a no-op. Args: heading: List of column heading strings that overrides the default heading. N)r7)rheadings r AddHeadingzResourcePrinter.AddHeadings DMrcy)zFormat specific AddRecord(). Args: record: A JSON-serializable object. delimit: Prints resource delimiters if True. Nrrrecorddelimits r _AddRecordzResourcePrinter._AddRecords rct|r|j|yd|_|j|j ||y)a_Adds a record for printing. Streaming formats (e.g., YAML) can print results at each AddRecord() call. Non-streaming formats (e.g., JSON, table(...)) may cache data at each AddRecord() call and not print until Finish() is called. Args: record: A JSON-serializable object. delimit: Prints resource delimiters if True. FN)r,rr6rorArls r AddRecordzResourcePrinter.AddRecords8 jjdk ood**62GrNrs rr$zResourcePrinter.FinishsP  {{tyy  **,$//B!{   s9A A"!A"c|j S)zEReturns True if some resource items were printed or printer disabled.)r6rus rResourcesWerePrintedz$ResourcePrinter.ResourcesWerePrinteds{{?rcy)z3Flushes intermediate results for streaming formats.Nrrus rr(zResourcePrinter.PagesrcJ|j|d|jy)zUPrint one record by itself. Args: record: A JSON-serializable object. FrnN)rqr$)rrms rPrintSingleRecordz!ResourcePrinter.PrintSingleRecords  NN65N)KKMrcd|jvrd|_y|jrJ|jr|jj s$t dj |j |rC|stj|s|j||n|D]}|j||s|jyy#|s|jwwxYw)aPrints resources using printer.AddRecord() and printer.Finish(). Args: resources: A singleton or list of JSON-serializable Python objects. single: If True then resources is a single item and not a list. For example, use this to print a single object as JSON. intermediate: This is an intermediate call, do not call Finish(). Raises: ProjectionRequiredError: If the projection is empty and the format requires a non-empty projection. disableFNztFormat [{0}] requires a non-empty projection. Use key parameters to specify a projection like so `{0}(foo, bar.baz)`rz) rFr6r9rGr]rrJr8r IsListLikerqr$)r resourcessingle intermediater+s rrIzResourcePrinter.PrintsDOO#dk  **  " "$*@*@*H*H*J # A 6$**     *55i@ ..L. 9#h NN8 $$ \ s .ACCc&|j|i|S)zBCalls the resource_printer.Printer() method (for nested printers).)r<)rargskwargss rPrinterzResourcePrinter.Printer3s 4==$ )& ))r) NNNFFNFNNF)T)FF)rrrrr[rQrgrjrorqr$rwr(r{rIrrrrr.r.]sV(FK?C<@5:EN%  ="   #J*rr.)r __future__rrrrrOgooglecloudsdk.corercore_exceptionsrgooglecloudsdk.core.consoler r4r STRUCTURED_INDENTATIONr robjectrr!r&r,r.rrrrs *'%' =#2:$O ! !$6e6  f  ?/ X*fX*r