Xh:dZddlZddlmZddlmZddlmZddlm Z ddl Z e Z Gdd eZGd d eZy) 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_data) HistoryOutputc\eZdZdZd fd Zd dZdefddd d dZedZ d d Z xZ S) 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. Nc@||_d|_t| |i|y)NF)shell_is_publishingsuper__init__)selfr argskwargs __class__s K/var/www/html/myenv/lib/python3.12/site-packages/IPython/core/displaypub.pyrzDisplayPublisher.__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_data0sJ$%:TAB B  h- BT IJJ. rF transientupdatec |turddl}|jdtdi}|jt |jdi}|jj j} | |jjjtd||jD]'\} } | |vs | || |j| dyd |_ d |vrt|d d |_ y) 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. rNzThe 'source' parameter is deprecated since IPython 3.0 and will be ignored (this warning is present since 9.0). `source` parameter will be removed in the future.) stacklevelmime_renderers display_data) output_typebundleTz text/plainF) _sentinelwarningswarnDeprecationWarningr getattrhistory_manageroutputsexecution_countappendritemsgetr print) rrrsourcerrrr'handlersr,mimehandlers rpublishzDisplayPublisher.publishBsl  "  MMi"   :: !tzz+;R@H**,,44 **+22 nT B &^^- MD't|T HLLt$<=  # 4  $|$ %#rc|jSN)r )rs r is_publishingzDisplayPublisher.is_publishings"""rctddtjjtddtjjy)z.Clear the output of the cell receiving output.z )endN)r1sysstdoutflushstderr)rwaits r clear_outputzDisplayPublisher.clear_outputs6 kr"  kr" rr8)returnNF) __name__ __module__ __qualname____doc__rrr&r6propertyr9rB __classcell__rs@rr r $sT * K* R$ R$ R$h##rr cPeZdZUdZeZeed< dddddZd fd ZxZ S) CapturingDisplayPublisherzA DisplayPublisher that storesr,NFrcD|jj||||dy)N)rrrr)r,r.)rrrr2rrs rr6z!CapturingDisplayPublisher.publishs' $&   rc`tt| ||jj yr8)r rMrBr,clear)rrArs rrBz&CapturingDisplayPublisher.clear_outputs% ';DA r)NNrD) rErFrGrHrr,__annotations__r6rBrJrKs@rrMrMs0(FGT+/  =A%  rrM)rHr=traitlets.config.configurabler traitletsrdisplay_functionsrhistoryrtypingtobjectr&r rMrrrZsE " 64" H {|{| 0r