&9_[c@sudZddlmZyddlmZWn!ek rMddlmZnXddlm Z m Z ddl Z ddl Z ddl Z ddlZddlZddlZddlmZmZmZmZddlmZd d d d d ddddddddddddddddddd d!d"d#d$d%gZd&Zd'Zedd(Zddd)Zd*Zd+Z d,Z!d%e"fd-YZ#d.Z$d/Z%d0Z&d1Z'd2Z(d3Z)d4Z*d5Z+d6Z,d7Z-de"fd8YZ.de.fd9YZ/de/fd:YZ0de/fd;YZ1de/fd<YZ2de/fd=YZ3de/fd>YZ4de.fd?YZ5de.fd@YZ6de.fdAYZ7dBZ8dCZ9dDZ:de/fdEYZ;dFZ<dGZ=dHZ>dIZ?de.fdJYZ@dKe.fdLYZAedMZBedNZCeeDdOZEdS(PsGTop-level display functions for displaying object in different formats.i(tprint_function(t encodebytes(t encodestring(tb2a_hexthexlifyN(t string_typestcast_bytes_py2t cast_unicodet unicode_type(t skip_doctesttdisplaytdisplay_prettyt display_htmltdisplay_markdownt display_svgt display_pngt display_jpegt display_latext display_jsontdisplay_javascriptt display_pdft DisplayObjecttTextDisplayObjecttPrettytHTMLtMarkdowntMathtLatextSVGt ProgressBartJSONt JavascripttImaget clear_outputtset_matplotlib_formatstset_matplotlib_closetpublish_display_datatupdate_displayt DisplayHandlecCs-ytjj|SWntk r(tSXdS(s*Check path, but don't let exceptions raiseN(tostpathtexistst ExceptiontFalse(R(((s3lib/python2.7/site-packages/IPython/core/display.pyt _safe_exists%s cCsat|t s t|t r$|Sx6|jD](\}}t|j||||R7tsourcetkwargsR=RA((s3lib/python2.7/site-packages/IPython/core/display.pyR$Ss & cCsttjdjdS(s*Generate a new random text id with urandomitascii(RR'turandomtdecode(((s3lib/python2.7/site-packages/IPython/core/display.pyt_new_idsc Osddlm}|js*t|dS|jdt}|jdd}|jdd}|jdd}|jdd}|jd d}|dkri}n|r|tkrt}n||d >> class Json(object): ... def __init__(self, json): ... self.json = json ... def _repr_pretty_(self, pp, cycle): ... import json ... pp.text(json.dumps(self.json, indent=2)) ... def __repr__(self): ... return str(self.json) ... >>> d = Json({1:2, 3: {4:5}}) >>> print(d) {1: 2, 3: {4: 5}} >>> display(d) { "1": 2, "3": { "4": 5 } } >>> def int_formatter(integer, pp, cycle): ... pp.text('I'*integer) >>> plain = get_ipython().display_formatter.formatters['text/plain'] >>> plain.for_type(int, int_formatter) >>> display(7-5) II >>> del plain.type_printers[int] >>> display(7-5) 2 See Also -------- :func:`update_display` Notes ----- In Python, objects can declare their textual representation using the `__repr__` method. IPython expands on this idea and allows objects to declare other, rich representations including: - HTML - JSON - PNG - JPEG - SVG - LaTeX A single object can declare some or all of these representations; all are handled by IPython's display system. The main idea of the first approach is that you have to implement special display methods when you define your class, one for each representation you want to use. Here is a list of the names of the special methods and the values they must return: - `_repr_html_`: return raw HTML as a string - `_repr_json_`: return a JSONable dict - `_repr_jpeg_`: return raw JPEG data - `_repr_png_`: return raw PNG data - `_repr_svg_`: return raw SVG data as a string - `_repr_latex_`: return LaTeX commands in a string surrounded by "$". - `_repr_mimebundle_`: return a full mimebundle containing the mapping from all mimetypes to data When you are directly writing your own classes, you can adapt them for display in IPython by following the above approach. But in practice, you often need to work with existing classes that you can't easily modify. You can refer to the documentation on IPython display formatters in order to register custom formatters for already existing types. .. versionadded:: 5.4 display available without import .. versionadded:: 6.1 display available without import Since IPython 5.4 and 6.1 :func:`display` is automatically made available to the user without import. If you are using display in a document that might be used in a pure python context or with older version of IPython, use the following import at the top of your file:: from IPython.display import display i(R=NR6R8texcludeR7t transientt display_idtupdates&display_id required for update_displayR>(R?R=t initializedtprinttpopR+tNonetTrueRHR1t TypeErrorR@tdisplay_formattertformatR$R0R&( R:RDR=R6R8RIR7RJRKRTR;t format_dicttmd_dict((s3lib/python2.7/site-packages/IPython/core/display.pyR sB         cKsWt}|jd|}||kr6tdnt|d(t __class__t__name__RK(RY((s3lib/python2.7/site-packages/IPython/core/display.pyt__repr__pscKst|d|j|dS(sMake a new display with my id, updating existing instances. Parameters ---------- obj: object to display **kwargs: additional keyword arguments passed to display RKN(R RK(RYR;RD((s3lib/python2.7/site-packages/IPython/core/display.pyR ss cKst|d|j|dS(sUpdate existing displays with my id Parameters ---------- obj: object to display **kwargs: additional keyword arguments passed to update_display RKN(R%RK(RYR;RD((s3lib/python2.7/site-packages/IPython/core/display.pyRLs N(R\t __module__t__doc__RPRZR]R RL(((s3lib/python2.7/site-packages/IPython/core/display.pyR&\s     cOstd||dS(sDisplay the pretty (default) representation of an object. Parameters ---------- objs : tuple of objects The Python objects to display, or if raw=True raw text data to display. raw : bool Are the data objects raw data or Python objects that need to be formatted before display? [default: False] metadata : dict (optional) Metadata to be associated with the specific mimetype output. s text/plainN(R<(R:RD((s3lib/python2.7/site-packages/IPython/core/display.pyR scOstd||dS(sDisplay the HTML representation of an object. Note: If raw=False and the object does not have a HTML representation, no HTML will be shown. Parameters ---------- objs : tuple of objects The Python objects to display, or if raw=True raw HTML data to display. raw : bool Are the data objects raw data or Python objects that need to be formatted before display? [default: False] metadata : dict (optional) Metadata to be associated with the specific mimetype output. s text/htmlN(R<(R:RD((s3lib/python2.7/site-packages/IPython/core/display.pyR scOstd||dS(sDisplays the Markdown representation of an object. Parameters ---------- objs : tuple of objects The Python objects to display, or if raw=True raw markdown data to display. raw : bool Are the data objects raw data or Python objects that need to be formatted before display? [default: False] metadata : dict (optional) Metadata to be associated with the specific mimetype output. s text/markdownN(R<(R:RD((s3lib/python2.7/site-packages/IPython/core/display.pyR scOstd||dS(sDisplay the SVG representation of an object. Parameters ---------- objs : tuple of objects The Python objects to display, or if raw=True raw svg data to display. raw : bool Are the data objects raw data or Python objects that need to be formatted before display? [default: False] metadata : dict (optional) Metadata to be associated with the specific mimetype output. s image/svg+xmlN(R<(R:RD((s3lib/python2.7/site-packages/IPython/core/display.pyRscOstd||dS(sDisplay the PNG representation of an object. Parameters ---------- objs : tuple of objects The Python objects to display, or if raw=True raw png data to display. raw : bool Are the data objects raw data or Python objects that need to be formatted before display? [default: False] metadata : dict (optional) Metadata to be associated with the specific mimetype output. s image/pngN(R<(R:RD((s3lib/python2.7/site-packages/IPython/core/display.pyRscOstd||dS(sDisplay the JPEG representation of an object. Parameters ---------- objs : tuple of objects The Python objects to display, or if raw=True raw JPEG data to display. raw : bool Are the data objects raw data or Python objects that need to be formatted before display? [default: False] metadata : dict (optional) Metadata to be associated with the specific mimetype output. s image/jpegN(R<(R:RD((s3lib/python2.7/site-packages/IPython/core/display.pyRscOstd||dS(sDisplay the LaTeX representation of an object. Parameters ---------- objs : tuple of objects The Python objects to display, or if raw=True raw latex data to display. raw : bool Are the data objects raw data or Python objects that need to be formatted before display? [default: False] metadata : dict (optional) Metadata to be associated with the specific mimetype output. s text/latexN(R<(R:RD((s3lib/python2.7/site-packages/IPython/core/display.pyRscOstd||dS(sDisplay the JSON representation of an object. Note that not many frontends support displaying JSON. Parameters ---------- objs : tuple of objects The Python objects to display, or if raw=True raw json data to display. raw : bool Are the data objects raw data or Python objects that need to be formatted before display? [default: False] metadata : dict (optional) Metadata to be associated with the specific mimetype output. sapplication/jsonN(R<(R:RD((s3lib/python2.7/site-packages/IPython/core/display.pyR scOstd||dS(sDisplay the Javascript representation of an object. Parameters ---------- objs : tuple of objects The Python objects to display, or if raw=True raw javascript data to display. raw : bool Are the data objects raw data or Python objects that need to be formatted before display? [default: False] metadata : dict (optional) Metadata to be associated with the specific mimetype output. sapplication/javascriptN(R<(R:RD((s3lib/python2.7/site-packages/IPython/core/display.pyRscOstd||dS(sDisplay the PDF representation of an object. Parameters ---------- objs : tuple of objects The Python objects to display, or if raw=True raw javascript data to display. raw : bool Are the data objects raw data or Python objects that need to be formatted before display? [default: False] metadata : dict (optional) Metadata to be associated with the specific mimetype output. sapplication/pdfN(R<(R:RD((s3lib/python2.7/site-packages/IPython/core/display.pyR-scBsGeZdZdZeZddddZdZdZ dZ RS(s*An object that wraps data to be displayed.trcCs|dk r{t|tr{|jdrK|dkrK|}d}d}q{t|r{|dkr{d}|}d}q{n||_||_|dkrdn t||_|j |j dS(sCreate a display object given raw data. When this object is returned by an expression or passed to the display function, it will result in the data being displayed in the frontend. The MIME type of the data should match the subclasses used, so the Png subclass should be used for 'image/png' data. If the data is a URL, the data will first be downloaded and then displayed. If Parameters ---------- data : unicode, str or bytes The raw data or a URL or file to load the data from url : unicode A URL to download the data from. filename : unicode Path to a local file to load the data from. thttpN( RPR-Rt startswithR,R>turlRtfilenametreloadt _check_data(RYR>RcRd((s3lib/python2.7/site-packages/IPython/core/display.pyRZIs    ! cCsD|js+|j}d|j|jf}ntt|j}|S(Ns<%s.%s object>(t_show_mem_addrR[R^R\tsuperRR](RYtclsR`((s3lib/python2.7/site-packages/IPython/core/display.pyR]ms   cCsdS(s5Override in subclasses if there's something to check.N((RY((s3lib/python2.7/site-packages/IPython/core/display.pyRfuscCsB|jdk r?t|j|j}|j|_WdQXn|jdk r>yyddlm}Wn!t k rddl m}nX||j}|j|_d}xV|j dj dD]>}|j }|jdr|j ddj }PqqW|r'|jj|d|_nWq>d|_q>XndS( s%Reload the raw data from file or URL.Ni(turlopens content-typet;tcharsett=treplace(RdRPtopent _read_flagstreadR>Rcturllib.requestRjt ImportErrorturllib2theaderstsplittstripRbRG(RYtfRjtresponsetencodingtsub((s3lib/python2.7/site-packages/IPython/core/display.pyReys*  N( R\R^R_RpR+RgRPRZR]RfRe(((s3lib/python2.7/site-packages/IPython/core/display.pyRCs$  cBseZdZdZRS(s"Validate that display data is textcCsH|jdk rDt|jt rDtd|jj|jfndS(Ns%s expects text, not %r(R>RPR-RRRR[R\(RY((s3lib/python2.7/site-packages/IPython/core/display.pyRfs"(R\R^R_Rf(((s3lib/python2.7/site-packages/IPython/core/display.pyRscBseZdZRS(cCs|j|jS(N(ttextR>(RYtpptcycle((s3lib/python2.7/site-packages/IPython/core/display.pyt _repr_pretty_s(R\R^R(((s3lib/python2.7/site-packages/IPython/core/display.pyRscBseZdZdZRS(cCs|jS(N(R>(RY((s3lib/python2.7/site-packages/IPython/core/display.pyt _repr_html_scCs |jS(s This method exists to inform other HTML-using modules (e.g. Markupsafe, htmltag, etc) that this object is HTML and does not need things like special characters (<>&) escaped. (R(RY((s3lib/python2.7/site-packages/IPython/core/display.pyt__html__s(R\R^RR(((s3lib/python2.7/site-packages/IPython/core/display.pyRs cBseZdZRS(cCs|jS(N(R>(RY((s3lib/python2.7/site-packages/IPython/core/display.pyt_repr_markdown_s(R\R^R(((s3lib/python2.7/site-packages/IPython/core/display.pyRscBseZdZRS(cCs|jjd}d|S(Nt$s$$%s$$(R>Rw(RYts((s3lib/python2.7/site-packages/IPython/core/display.pyt _repr_latex_s(R\R^R(((s3lib/python2.7/site-packages/IPython/core/display.pyRscBseZdZRS(cCs|jS(N(R>(RY((s3lib/python2.7/site-packages/IPython/core/display.pyRs(R\R^R(((s3lib/python2.7/site-packages/IPython/core/display.pyRscBs>eZdZdZedZejdZdZRS(trbcCs|jS(N(t_data(RY((s3lib/python2.7/site-packages/IPython/core/display.pyR>scCs|dkrd|_dSddlm}t|}|j|}|jd}|rl|dj}nt|}||_dS(Ni(tminidomtsvgi( RPRtxml.domRRt parseStringtgetElementsByTagNamettoxmlR(RYRRtxt found_svg((s3lib/python2.7/site-packages/IPython/core/display.pyR>s    cCs|jS(N(R>(RY((s3lib/python2.7/site-packages/IPython/core/display.pyt _repr_svg_sN( R\R^RpRPRtpropertyR>tsetterR(((s3lib/python2.7/site-packages/IPython/core/display.pyRs cBsweZdZdZdZdZdZdZedZ e j dZ dZ d Z d Z RS( s@Progressbar supports displaying a progressbar like element cCsI||_d|_d|_d|_ttjdjd|_dS(sCreates a new progressbar Parameters ---------- total : int maximum size of the progressbar it60exi<iREN( ttotalt _progresst html_widtht text_widthRR'RFRGt _display_id(RYR((s3lib/python2.7/site-packages/IPython/core/display.pyRZs     cCsZ|j|j}dt||j}d|jt|}dj|||j|jS(NRmt s [{}{}] {}/{}(tprogressRtintRtlenRT(RYtfractiontfilledtrest((s3lib/python2.7/site-packages/IPython/core/display.pyR]s cCsdj|j|j|jS(Ns:(RTRRR(RY((s3lib/python2.7/site-packages/IPython/core/display.pyRscCst|d|jdS(NRK(R R(RY((s3lib/python2.7/site-packages/IPython/core/display.pyR scCst|d|jdtdS(NRKRL(R RRQ(RY((s3lib/python2.7/site-packages/IPython/core/display.pyRLscCs|jS(N(R(RY((s3lib/python2.7/site-packages/IPython/core/display.pyRscCs||_|jdS(N(RRL(RYR5((s3lib/python2.7/site-packages/IPython/core/display.pyR s cCs|jd|_|S(Ni(R R(RY((s3lib/python2.7/site-packages/IPython/core/display.pyt__iter__s  cCs5|jd7_|j|jkr(|jStdS(s4Returns current value and increments display by one.iN(RRt StopIteration(RY((s3lib/python2.7/site-packages/IPython/core/display.pyt__next__scCs |jS(sPython 2 compatibility(R(RY((s3lib/python2.7/site-packages/IPython/core/display.pytnexts(R\R^R_RZR]RR RLRRRRRR(((s3lib/python2.7/site-packages/IPython/core/display.pyRs      cBsGeZdZdZdZedZejdZdZ RS(sJSON expects a JSON-able dict or list not an already-serialized JSON string. Scalar types (None, number, string) are not allowed, only dict or list containers. cCsN|jdk rJt|jttf rJtd|jj|jfndS(Ns(%s expects JSONable dict or list, not %r(R>RPR-R.tlistRRR[R\(RY((s3lib/python2.7/site-packages/IPython/core/display.pyRf)s(cCs|jS(N(R(RY((s3lib/python2.7/site-packages/IPython/core/display.pyR>-scCs;t|tr.tjdtj|}n||_dS(Ns4JSON expects JSONable dict or list, not JSON strings(R-RtwarningstwarntjsontloadsR(RYR>((s3lib/python2.7/site-packages/IPython/core/display.pyR>1s cCs|jS(N(R>(RY((s3lib/python2.7/site-packages/IPython/core/display.pyt _repr_json_8sN( R\R^R_RPRRfRR>RR(((s3lib/python2.7/site-packages/IPython/core/display.pyR s  sa$("head").append($("").attr({ rel: "stylesheet", type: "text/css", href: "%s" })); s $.getScript("%s", function () { s}); cBs)eZddddddZdZRS(cCst|tr|g}n|dkr0g}nt|trK|g}n|dkr`g}nt|ttfstd|nt|ttfstd|n||_||_tt |j d|d|d|dS(sCreate a Javascript display object given raw data. When this object is returned by an expression or passed to the display function, it will result in the data being displayed in the frontend. If the data is a URL, the data will first be downloaded and then displayed. In the Notebook, the containing element will be available as `element`, and jQuery will be available. Content appended to `element` will be visible in the output area. Parameters ---------- data : unicode, str or bytes The Javascript source code or a URL to download it from. url : unicode A URL to download the data from. filename : unicode Path to a local file to load the data from. lib : list or str A sequence of Javascript library URLs to load asynchronously before running the source code. The full URLs of the libraries should be given. A single Javascript library URL can also be given as a string. css: : list or str A sequence of css files to load before running the source code. The full URLs of the css files should be given. A single css URL can also be given as a string. sexpected sequence, got: %rR>RcRdN( R-RRPRttupleRRtlibtcssRhRRZ(RYR>RcRdRR((s3lib/python2.7/site-packages/IPython/core/display.pyRZIs        cCsrd}x|jD]}|t|7}qWx|jD]}|t|7}q2W||j7}|tt|j7}|S(Nt(Rtcss_tRtlib_t1R>tlib_t2R(RYR`tctl((s3lib/python2.7/site-packages/IPython/core/display.pyt_repr_javascript_ws N(R\R^RPRZR(((s3lib/python2.7/site-packages/IPython/core/display.pyRGs.sPNG  scCs4|jd}||d|d!}tjd|S(s*read the (width, height) from a PNG headertIHDRii s>ii(tindextstructtunpack(R>tihdrtw4h4((s3lib/python2.7/site-packages/IPython/core/display.pyt_pngxyscCsd}x`trhtjd|||d!d}||}|||d!dkr[|}Pq |d7}q Wtjd||d|d!\}}||fS( s+read the (width, height) from a JPEG headeris>Hiiss>HHii (RQRR(R>tidxt block_sizetiSOFthtw((s3lib/python2.7/site-packages/IPython/core/display.pyt_jpegxys ! 'c BseZdZdZdZeegZd d d d d d d eed d ZdZ dZ dZ dZ dZ d Zd ZRS( Rujpegupngc Cs0|d k r|j|} n{|d k r<|j|} n]|d krWtdnBt|tr|jdst|r|j|} nd } |d kr-| d k r| dks| dkr|j}q*| dkr|j}q*| j }q-t|t r-|d t kr*|j}q*q-n|d krBd}n|j dkr`|j}nt |j |_ |d k r|n |d k|_|jr|j |jkrtd |j n||_||_||_| |_| |_tt|jd |d |d ||r,|jnd S(s Create a PNG/JPEG image object given raw data. When this object is returned by an input cell or passed to the display function, it will result in the image being displayed in the frontend. Parameters ---------- data : unicode, str or bytes The raw image data or a URL or filename to load the data from. This always results in embedded image data. url : unicode A URL to download the data from. If you specify `url=`, the image data will not be embedded unless you also specify `embed=True`. filename : unicode Path to a local file to load the data from. Images from a file are always embedded. format : unicode The format of the image data (png/jpeg/jpg). If a filename or URL is given for format will be inferred from the filename extension. embed : bool Should the image data be embedded using a data URI (True) or be loaded using an tag. Set this to True if you want the image to be viewable later with no internet connection in the notebook. Default is `True`, unless the keyword argument `url` is set, then default value is `False`. Note that QtConsole is not able to display images if `embed` is set to `False` width : int Width in pixels to which to constrain the image in html height : int Height in pixels to which to constrain the image in html retina : bool Automatically set the width and height to half of the measured width and height. This only works for embedded images because it reads the width/height from image data. For non-embedded images, you can just set the desired display width and height directly. unconfined: bool Set unconfined=True to disable max-width confinement of the image. metadata: dict Specify extra metadata to attach to the image. Examples -------- # embedded image data, works in qtconsole and notebook # when passed positionally, the first arg can be any of raw image data, # a URL, or a filename from which to load image data. # The result is always embedding image data for inline images. Image('http://www.google.fr/images/srpr/logo3w.png') Image('/path/to/image.jpg') Image(b'RAW_PNG_DATA...') # Specifying Image(url=...) does not embed the image data, # it only generates `` tag with a link to the source. # This will not work in the qtconsole or offline. Image(url='http://www.google.fr/images/srpr/logo3w.png') s6No image data found. Expecting filename, url, or data.Raujpgujpegupngitpngtjpgs"Cannot embed the '%s' image formatR>RcRdN(RPt _find_extt ValueErrorR-RRbR,t _FMT_JPEGt_FMT_PNGtlowertbytest_JPEGRRTtembedt_ACCEPTABLE_EMBEDDINGStwidththeighttretinat unconfinedR7RhR RZt _retina_shape( RYR>RcRdRTRRRRRR7text((s3lib/python2.7/site-packages/IPython/core/display.pyRZsH@           !     %cCs}|js dS|jdkr4t|j\}}n+|jdkr[t|j\}}ndS|d|_|d|_dS(s3load pixel-doubled width and height from image dataNRtjpegi(RRTRR>RRR(RYRR((s3lib/python2.7/site-packages/IPython/core/display.pyRs  cCs9|jr5tt|j|jr5|jq5ndS(s%Reload the raw data from file or URL.N(RRhR ReRR(RY((s3lib/python2.7/site-packages/IPython/core/display.pyRe&s  c Cs|jsd}}}|jr0d|j}n|jrId|j}n|jr[d}ndjd|jd|d|d |SdS( NRs width="%d"s height="%d"s class="unconfined"u(RcRRtklass(RRRRRTRc(RYRRR((s3lib/python2.7/site-packages/IPython/core/display.pyR-s       cCsi}|jr|j|d(RYtmd((s3lib/python2.7/site-packages/IPython/core/display.pyt_data_and_metadata=s     cCs&|jr"|jdkr"|jSdS(Nupng(RRTR(RY((s3lib/python2.7/site-packages/IPython/core/display.pyt _repr_png_MscCs5|jr1|jdks'|jdkr1|jSdS(Nujpegujpg(RRTR(RY((s3lib/python2.7/site-packages/IPython/core/display.pyt _repr_jpeg_Qs'cCst|jddjS(Nt.i(RRvR(RYR((s3lib/python2.7/site-packages/IPython/core/display.pyRUsN(R\R^RpRRRRPR+RZRReRRRRR(((s3lib/python2.7/site-packages/IPython/core/display.pyR s   p      tVideocBsDeZdddeddZdZdZdZdZRS(cCs|d kr9t|tr9|jd r9|}d }n!tjj|rZ|}d }n|r| rdjdddg}t|n||_ ||_ t t |j d|d|d |d S( sCreate a video object given raw data or an URL. When this object is returned by an input cell or passed to the display function, it will result in the video being displayed in the frontend. Parameters ---------- data : unicode, str or bytes The raw video data or a URL or filename to load the data from. Raw data will require passing `embed=True`. url : unicode A URL for the video. If you specify `url=`, the image data will not be embedded. filename : unicode Path to a local file containing the video. Will be interpreted as a local URL unless `embed=True`. embed : bool Should the video be embedded using a data URI (True) or be loaded using a