fP`dZddlZddlmZddlmZddlmZGddeZGd d eZ y) 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 dZxZS) 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. Nc2||_t||i|yN)shellsuper__init__)selfr argskwargs __class__s R/var/www/cvtools/html/venv/lib/python3.12/site-packages/IPython/core/displaypub.pyr zDisplayPublisher.__init__'s  $)&)ct|tstd|z|t|tstd|zyy)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+sJ$%:TAB B  h- BT IJJ. rF transientupdatec i}|jt|jdi}|jD]'\}} ||vs | |||j|dyd|vrt |dyy)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 :: !tzz+;R@H%^^- MD't|T HLLt$<=  4  $|$ % rctddtjjtddtjjy)z.Clear the output of the cell receiving output.z )endN)r#sysstdoutflushstderr)rwaits r clear_outputzDisplayPublisher.clear_outputvs6 kr"  kr" rr NN)returnNF) __name__ __module__ __qualname____doc__r rr(r1 __classcell__rs@rrr s( *K$7&TRW7&rrrcBeZdZdZeZdddddZdfd ZxZS) CapturingDisplayPublisherzA DisplayPublisher that storesNFrcD|jj||||dy)N)rrrr)outputsappend)rrrr$rrs rr(z!CapturingDisplayPublisher.publishs$ DX)2VE Frc`tt| ||jj yr )r r<r1r>clear)rr0rs rr1z&CapturingDisplayPublisher.clear_outputs% ';DA rr2r4) r5r6r7r8rr>r(r1r9r:s@rr<r<~s((fGFTRWFrr<) r8r,traitlets.config.configurabler traitletsrdisplay_functionsrrr<rrrFs6 $ 64[|[|  0 r