U
    -eP                     @   sT   d Z ddlZddlmZ ddlmZ ddlmZ G dd deZG d	d
 d
eZ	dS )a  An 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_datac                       sN   e Zd ZdZd fdd	ZdddZdddddd	d
dZdddZ  Z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                    s   || _ t j|| d S N)shellsuper__init__)selfr   argskwargs	__class__ X/var/www/html/Darija-Ai-Train/env/lib/python3.8/site-packages/IPython/core/displaypub.pyr
   '   s    zDisplayPublisher.__init__c                 C   s8   t |tstd| |dk	r4t |ts4td| dS )zValidate the display data.

        Parameters
        ----------
        data : dict
            The formata data dictionary.
        metadata : dict
            Any metadata for the data.
        zdata must be a dict, got: %rNz metadata must be a dict, got: %r)
isinstancedict	TypeError)r   datametadatar   r   r   _validate_data+   s
    

zDisplayPublisher._validate_dataF	transientupdate)returnc          
      K   sj   i }| j dk	rt| j di }| D ],\}}	||kr$|	|| ||d  dS q$d|krft|d  dS )a  Publish 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.
        NZmime_renderersz
text/plain)r   getattritemsgetprint)
r   r   r   sourcer   r   r   handlersmimehandlerr   r   r   publish=   s    -
zDisplayPublisher.publishc                 C   s0   t ddd tj  t ddd tj  dS )z.Clear the output of the cell receiving output.z[2K )endN)r   sysstdoutflushstderrr   waitr   r   r   clear_outputv   s    
zDisplayPublisher.clear_output)N)N)NN)F)	__name__
__module____qualname____doc__r
   r   r$   r-   __classcell__r   r   r   r   r       s
   
9r   c                       s:   e Zd ZdZe Zd	dddddZd
 fdd	Z  ZS )CapturingDisplayPublisherzA DisplayPublisher that storesNFr   c                C   s   | j ||||d d S )N)r   r   r   r   )outputsappend)r   r   r   r    r   r   r   r   r   r$      s    
 z!CapturingDisplayPublisher.publishc                    s   t t| | | j  d S r   )r	   r3   r-   r4   clearr+   r   r   r   r-      s    z&CapturingDisplayPublisher.clear_output)NN)F)	r.   r/   r0   r1   r   r4   r$   r-   r2   r   r   r   r   r3   ~   s   r3   )
r1   r'   Ztraitlets.config.configurabler   Z	traitletsr   Zdisplay_functionsr   r   r3   r   r   r   r   <module>   s   ^