&ePndZddlZddlmZddlmZddlmZGddeZGd d eZ dS) aAn interface for publishing rich data to frontends. There are two components of the display system: * Display formatters, which take a Python object and compute the representation of the object in various formats (text, HTML, SVG, etc.). * The display publisher that is used to send the representation data to the various frontends. This module defines the logic display publishing. The display publisher uses the ``display_data`` message type that is defined in the IPython messaging spec. N) Configurable)List)publish_display_datacFeZdZdZd fd Zd dZd dddd dZd d ZxZS)DisplayPublisherzA traited class that publishes display data to frontends. Instances of this class are created by the main IPython object and should be accessed there. NcH||_tj|i|dSN)shellsuper__init__)selfr argskwargs __class__s 7lib/python3.11/site-packages/IPython/core/displaypub.pyr zDisplayPublisher.__init__'s, $)&)))))ct|tstd|z|'t|tstd|zdSdS)zValidate the display data. Parameters ---------- data : dict The formata data dictionary. metadata : dict Any metadata for the data. zdata must be a dict, got: %rNz metadata must be a dict, got: %r) isinstancedict TypeError)rdatametadatas r_validate_datazDisplayPublisher._validate_data+sl$%% C:TABB B  h-- K BT IJJJ  K KrF transientupdatereturnc i}|jt|jdi}|D]2\}} ||vr)| ||||ddS3d|vrt |ddSdS)aPublish data and metadata to all frontends. See the ``display_data`` message in the messaging documentation for more details about this message type. The following MIME types are currently implemented: * text/plain * text/html * text/markdown * text/latex * application/json * application/javascript * image/png * image/jpeg * image/svg+xml Parameters ---------- data : dict A dictionary having keys that are valid MIME types (like 'text/plain' or 'image/svg+xml') and values that are the data for that MIME type. The data itself must be a JSON'able data structure. Minimally all data should have the 'text/plain' data, which can be displayed by all frontends. If more than the plain text is given, it is up to the frontend to decide which representation to use. metadata : dict A dictionary for metadata related to the data. This can contain arbitrary key, value pairs that frontends can use to interpret the data. Metadata specific to each mime-type can be specified in the metadata dict with the same mime-type keys as the data itself. source : str, deprecated Unused. transient : dict, keyword-only A dictionary for transient data. Data in this dictionary should not be persisted as part of saving this output. Examples include 'display_id'. update : bool, keyword-only, default: False If True, only update existing outputs with the same display_id, rather than creating a new output. Nmime_renderersz text/plain)r getattritemsgetprint) rrrsourcerrrhandlersmimehandlers rpublishzDisplayPublisher.publish=sZ : !tz+;R@@H%^^--  MD't||T HLLt$<$<=== 4   $|$ % % % % % rctddtjtddtjdS)z.Clear the output of the cell receiving output.z )endN)r$sysstdoutflushstderr)rwaits r clear_outputzDisplayPublisher.clear_outputvsV kr""""  kr"""" rr NN)rNF) __name__ __module__ __qualname____doc__r rr)r2 __classcell__rs@rrr s ******KKKK$7&TRW7&7&7&7&7&7&rrrcHeZdZdZeZdddddZdfd ZxZS) CapturingDisplayPublisherzA DisplayPublisher that storesNFrcD|j||||ddS)N)rrrr)outputsappend)rrrr%rrs rr)z!CapturingDisplayPublisher.publishs@ DX)2VEE F F F F Frctt|||jdSr )r r<r2r>clear)rr1rs rr2z&CapturingDisplayPublisher.clear_outputs> '..;;DAAA rr3r4) r5r6r7r8rr>r)r2r9r:s@rr<r<~sw((dffGFTRWFFFFFrr<) r8r-traitlets.config.configurabler traitletsrdisplay_functionsrrr<rrrFs  $ 666666433333[[[[[|[[[|      0     r