;;idZddlZddlmZddlmZddlmZddlm 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) HistoryOutputcneZdZdZd fd Zd dZdZdZdZde fddd  dd Z e d Z dd Z xZS)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|_d|_|jr|jt ||i|y)NF)shell_is_publishing_in_post_execute_setup_execution_trackingsuper__init__)selfr argskwargs __class__s T/home/rose/Desktop/poly/venv/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_data3sJ$%:TAB B  h- BT IJJ. rc|jjjd|j|jjjd|jy)z%Set up hooks to track execution state post_execute pre_executeN)r eventsregister_on_post_execute_on_pre_executers rrz*DisplayPublisher._setup_execution_trackingDsB "">43H3HI ""=$2F2FGrcd|_y)z%Called at start of post_execute phaseTNr r%s rr#z!DisplayPublisher._on_post_executeIs $rcd|_y)z$Called at start of pre_execute phaseFNr'r%s rr$z DisplayPublisher._on_pre_executeMs %rF transientupdatec D|turddl}|jdtdi}|jt |jdi}|jj j} |jjdz } |jr|jjdz } | | jtd| |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_renderersr display_data) output_typebundleTz text/plainF) _sentinelwarningswarnDeprecationWarningr getattrhistory_manageroutputsexecution_countr appendritemsgetr print) rrrsourcer*r+rr4handlersr9target_execution_countmimehandlers rpublishzDisplayPublisher.publishRsl  "  MMi"   :: !tzz+;R@H**,,44!%!;!;a!?  &*ZZ%?%?!%C "&'.. nT B &^^-MD't|T HLLt$<=. # 4  $|$ %#rc|jSN)r r%s r is_publishingzDisplayPublisher.is_publishings"""rctddtjjtddtjjy)z.Clear the output of the cell receiving output.z )endN)r>sysstdoutflushstderr)rwaits r clear_outputzDisplayPublisher.clear_outputs6 kr"  kr" rrF)returnNF)__name__ __module__ __qualname____doc__rrrr#r$r3rDpropertyrGrP __classcell__rs@rr r $sd *K"H %& X$ X$ X$t##rr cPeZdZUdZeZeed< dddddZd fd ZxZ S) CapturingDisplayPublisherzA DisplayPublisher that storesr9NFr)cD|jj||||dy)N)rrr*r+)r9r;)rrrr?r*r+s rrDz!CapturingDisplayPublisher.publishs' $&   rc`tt| ||jj yrF)rr[rPr9clear)rrOrs rrPz&CapturingDisplayPublisher.clear_outputs% ';DA r)NNrR) rSrTrUrVrr9__annotations__rDrPrXrYs@rr[r[s0(FGT+/  =A%  rr[)rVrKtraitlets.config.configurabler traitletsrdisplay_functionsrhistoryrtypingtobjectr3r r[rrrhsE " 64" H Q|Qh 0r