o )@sdZddlmZddlmZddlmZddlmZddlZddlmZ ddlm Z dd l m Z dd l mZd ZGd d d e jZGdddeZGdddeZGdddeZGdddeZddZGdddeZdS)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_propertyc@eZdZdZdS)ErrorzExceptions for this module.N__name__ __module__ __qualname____doc__rrO/tmp/google-cloud-sdk/lib/googlecloudsdk/core/resource/resource_printer_base.pyr 6r c@r )ProjectionRequiredErrorz-Format missing required projection exception.Nr rrrrr:rrc@eZdZdZddZdS)_ResourceMarkerz2A marker that can be injected into resource lists.cCdS)zYCalled by ResourcePrinter.Addrecord(). Args: printer: The printer object. NrselfprinterrrrActAsz_ResourceMarker.ActNrrrrrrrrrr> rc@r) FinishMarkerzA resource list Finish marker.cC |dSN)FinishrrrrrM zFinishMarker.ActNrrrrrrJrrc@r) PageMarkerzA resource list Page marker.cCr r!)PagerrrrrTr#zPageMarker.ActNrrrrrr$Qrr$cCs t|tS)z.Returns True if resource is a _ResourceMarker.) isinstancer)resourcerrrIsResourceMarkerXs r(c@seZdZdZ    dddZddZdd Zd d Zdd dZdddZ ddZ ddZ ddZ ddZ dddZddZdS) 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 NFc CsJddlm} | |_d|_d|_||_||_|ptj|_ ||_ d|_ d|_ |s*| }|p.|j|_|||||} | ra| pEi|_| |_d|jvr`tjd| | tjni|_d|_d|jvrnd} || d |jvrz|j |_ Wn tyYnwd |jvr|dur|j |_ t|_ d|_ |dS) 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.resourcer* _console_attr_empty_heading_name_non_empty_projection_requiredrout_out_printer_pager _pager_outCompileEvaluate_process_record SetByColumnsSetIgnoreDefaultTransforms Projection Attributes attributescolumn_attributesstatusPrintformatNameSetRetainNoneValuesGetConsoleWriterStreamAttributeErrorioStringIO_SetVisibleColumns) rr4name projector by_columnsignore_default_transformsprocess_recordnon_empty_projection_requiredr console_attrretain_none_valuesr* projectionrrr__init__rsN             zResourcePrinter.__init__cCs*|jrdd|jD|_dSd|_dS)z@Sets visible columns list if column attributes have been loaded.cSsg|]}|jj qSr) attributehidden).0columnrrr sz6ResourcePrinter._SetVisibleColumns..N)rAColumns_is_column_visiblerrrrrKs  z"ResourcePrinter._SetVisibleColumnscs.jsjrfddt|DS|S)z.Returns a list of visible columns given a row.csg|] \}}j|r|qSr)r\)rXicolr]rrrZsz7ResourcePrinter.RemoveHiddenColumns..)r\rK enumerate)rrowrr]rRemoveHiddenColumnss z#ResourcePrinter.RemoveHiddenColumnscCs ||_dS)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)r1)rheadingrrr AddHeadings zResourcePrinter.AddHeadingTcCr)zFormat specific AddRecord(). Args: record: A JSON-serializable object. delimit: Prints resource delimiters if True. Nrrrecorddelimitrrr _AddRecordszResourcePrinter._AddRecordcCs2t|r ||dSd|_||||dS)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(rr0rhr;rerrr AddRecords zResourcePrinter.AddRecordcCsF|jr|jr!ztj|j|jdWdStyYdSwdSdS)z_Prints the results for non-streaming formats. Must be called via super if overridden. )r4N)r7r5rMoregetvaluer8rHr]rrrr"s  zResourcePrinter.FinishcCs|j S)zEReturns True if some resource items were printed or printer disabled.)r0r]rrrResourcesWerePrintedsz$ResourcePrinter.ResourcesWerePrintedcCr)z3Flushes intermediate results for streaming formats.Nrr]rrrr%szResourcePrinter.PagecCs|j|dd|dS)zUPrint one record by itself. Args: record: A JSON-serializable object. FrgN)rir")rrfrrrPrintSingleRecords z!ResourcePrinter.PrintSingleRecordcCsd|jvr d|_dS|jr|jr|jstd|jz&|r9|s't |s/|j ||dn |D]}| |q1W|sB| dSdS|sK| ww)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)`rm) r@r0r3rAr[rrDr2r IsListLikerir")r resourcessingle intermediater'rrrrCs0    zResourcePrinter.PrintcOs|j|i|S)zBCalls the resource_printer.Printer() method (for nested printers).)r6)rargskwargsrrrPrinter3szResourcePrinter.Printer) NNNFFNFNNF)T)FF)rrrrrUrKrbrdrhrir"rlr%rnrCrvrrrrr)]s$ G    %r))r __future__rrrrrIgooglecloudsdk.corercore_exceptionsrgooglecloudsdk.core.consolerr.r STRUCTURED_INDENTATIONr robjectrrr$r(r)rrrrs$