o (@sndZddlmZddlmZddlmZddlmZddlmZddlm Z ddl m Z dd l m Z dd l mZdd l mZdd l mZdd l mZddl mZddl mZddl mZddl mZddl mZddl mZddl mZddl mZddl mZGdddejZGdddeZGdddeZGdddejZ Gdd d ej!Z"Gd!d"d"ej!Z#Gd#d$d$ej$Z%Gd%d&d&ej!Z&Gd'd(d(ej!Z'iej(e j)ej*e j+ej,e ej-ej.ej/e"ej0ej$ej1e j2ej3ej4ej5ej6ej7e&ej8e#ej9ej:ej;ej<ej=e%ej>e j?ej@ejZAiZBd)d*ZCd5d,d-ZDd.d/ZEd6d1d2ZFd7d3d4ZGd0S)8aMethods for formatting and printing Python objects. 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)unicode_literals) exceptions)log) properties)config_printer) csv_printer) diff_printer)flattened_printer) json_printer) list_printer)object_printer) resource_lex)resource_printer_base)resource_printer_types)resource_projection_spec)resource_property)resource_transform) table_printer) yaml_printerc@eZdZdZdS)ErrorzExceptions for this module.N__name__ __module__ __qualname____doc__rrJ/tmp/google-cloud-sdk/lib/googlecloudsdk/core/resource/resource_printer.pyr=rc@r)UnknownFormatErrorzUnknown format name exception.Nrrrrrr!Ar r!c@r)ProjectionFormatRequiredErrorz1Projection key missing required format attribute.Nrrrrrr"Er r"c@r)DefaultPrinterzAn alias for YamlPrinter. An alias for the *yaml* format. To override use *gcloud config set core/default_format* property. Nrrrrrr#Ir r#cs eZdZdZfddZZS)DisablePrinterzDisables formatted output and does not consume the resources. Disables formatted output and does not consume the resources. Equivalent to the *none* format, but also short-circuits early for commands that return pageable lists. cs$tt|j|i|ddi|_dS)Ndisable)superr$__init__ attributes)selfargskwargs __class__rrr(YszDisablePrinter.__init__)rrrrr( __classcell__rrr-rr$Qsr$c@r) NonePrinterzqDisables formatted output and consumes the resources. Disables formatted output and consumes the resources. Nrrrrrr0^r r0c@r) TextPrinterzIAn alias for FlattenedPrinter. An alias for the *flattened* format. Nrrrrrr1er r1cs*eZdZdZfddZdddZZS) MultiPrinteraA printer that prints different formats for each projection key. Each projection key must have a subformat defined by the :format=FORMAT-STRING attribute. For example, `--format="multi(data:format=json, info:format='table[box](a, b, c)')"` formats the *data* field as JSON and the *info* field as a boxed table. Printer attributes: separator: Separator string to print between each format. If multiple resources are provided, the separator is also printed between each resource. csntt|j|i|g|_|jD]!}|jjs%tdj t |j d|j |t|jj|jdfqdS)Nz {key} requires format attribute.)key)out)r'r2r(columnscolumn_attributesColumns attribute subformatr"formatr GetKeyNamer3appendPrinter_out)r*r+r,colr-rrr(|s zMultiPrinter.__init__TcCsx|jdd}t|jD]\}\}}|dks|r|j||t||j q |jdd}|r:|j|dSdS)N separatorr terminator) r)get enumerater5r>writePrintrGetr3)r*recorddelimitr@ir?printerrBrrr _AddRecords  zMultiPrinter._AddRecord)T)rrrrr(rLr/rrr-rr2ls  r2c@r)PrinterAttributesa$Attributes for all printers. This docstring is used to generate topic docs. All formats have these attributes. Printer attributes: disable: Disables formatted output and does not consume the resources. json-decode: Decodes string values that are JSON compact encodings of list and dictionary objects. This may become the default. pager: If True, sends output to a pager. private: Disables log file output. Use this for sensitive resource data that should not be displayed in log files. Explicit command line IO redirection overrides this attribute. transforms: Apply projection transforms to the resource values. The default is format specific; table-like formats may define default transforms to certain columns. Use *no-transforms* to disable. NrrrrrrMr rMcCs|t|<dt|<dS)NT) _FORMATTERS_HIDDEN_FORMATTERS) format_namerKrrrRegisterFormatters rQFcsfddtDS)zReturns the (format-name => Printer) format registry dictionary. Args: hidden: bool, if True, include the hidden formatters. Returns: The (format-name => Printer) format registry dictionary. cs"i|] }s |tvr|t|qSr)rOrN).0rPhiddenrr s z%GetFormatRegistry..)rNrSrrSrGetFormatRegistrys rVcCsttS)z0Returns a sorted list of supported format names.)sortedrNrrrrSupportedFormatssrXNc Csddlm}tjjj}|tj r|r|}n|}t d ||j |tj|tdd}|}|s:dSzt|} WntyStd dt|w| ||t||d } | S) aBReturns a resource printer given a format string. Args: print_format: The _FORMATTERS name with optional attributes and projection. out: Output stream, log.out if None. defaults: Optional resource_projection_spec.ProjectionSpec defaults. 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. Raises: UnknownFormatError: The print_format is invalid. Returns: An initialized ResourcePrinter class or None if printing is disabled. r)resource_projectorzChosen display Format:{})defaultssymbols) expressionrZNzhFormat must be one of {0}; received [{1}]. For information on output formats: $ gcloud topic formats z, )r4namerK projector console_attr)googlecloudsdk.core.resourcerYcore_propertiesVALUEScoredefault_formatrGendswithformatsDEFAULTrdebugr:CompilerProjectionSpecr GetTransforms ProjectionNamerNKeyErrorr!joinrXr=) print_formatr4rZr_rYdefault_format_propertychosen_print_formatr^ printer_name printer_classrKrrrr=s:    r=cCs&t|||d}|r|||dSdS)aPrints the given resources. Args: resources: A singleton or list of JSON-serializable Python objects. print_format: The _FORMATTER name with optional projection expression. out: Output stream, log.out if None. defaults: Optional resource_projection_spec.ProjectionSpec defaults. single: If True then resources is a single item and not a list. For example, use this to print a single object as JSON. )r4rZN)r=rF) resourcesrpr4rZsinglerKrrrrFs rF)F)NNN)NNF)Hr __future__rrrgooglecloudsdk.corercore_exceptionsrrrar`rr r r r r rrrrrfrrrrrrr!r" YamlPrinterr#ResourcePrinterr$r0FlattenedPrinterr1r2rMCONFIG ConfigPrinterCSV CsvPrinterrgDIFF DiffPrinterDISABLE FLATTENEDGET GetPrinterJSON JsonPrinterLIST ListPrinterMULTINONEOBJECT ObjectPrinterTABLE TablePrinterTEXTVALUE ValuePrinterYAMLrNrOrQrVrXr=rFrrrrs                      (       9