##// END OF EJS Templates
Embed image as default...
Matthias BUSSONNIER -
Show More
@@ -1,518 +1,532 b''
1 # -*- coding: utf-8 -*-
1 # -*- coding: utf-8 -*-
2 """Top-level display functions for displaying object in different formats.
2 """Top-level display functions for displaying object in different formats.
3
3
4 Authors:
4 Authors:
5
5
6 * Brian Granger
6 * Brian Granger
7 """
7 """
8
8
9 #-----------------------------------------------------------------------------
9 #-----------------------------------------------------------------------------
10 # Copyright (C) 2008-2011 The IPython Development Team
10 # Copyright (C) 2008-2011 The IPython Development Team
11 #
11 #
12 # Distributed under the terms of the BSD License. The full license is in
12 # Distributed under the terms of the BSD License. The full license is in
13 # the file COPYING, distributed as part of this software.
13 # the file COPYING, distributed as part of this software.
14 #-----------------------------------------------------------------------------
14 #-----------------------------------------------------------------------------
15
15
16 #-----------------------------------------------------------------------------
16 #-----------------------------------------------------------------------------
17 # Imports
17 # Imports
18 #-----------------------------------------------------------------------------
18 #-----------------------------------------------------------------------------
19
19
20 from __future__ import print_function
20 from __future__ import print_function
21
21
22 from xml.dom import minidom
22 from xml.dom import minidom
23
23
24 from .displaypub import (
24 from .displaypub import (
25 publish_pretty, publish_html,
25 publish_pretty, publish_html,
26 publish_latex, publish_svg,
26 publish_latex, publish_svg,
27 publish_png, publish_json,
27 publish_png, publish_json,
28 publish_javascript, publish_jpeg
28 publish_javascript, publish_jpeg
29 )
29 )
30
30
31 #-----------------------------------------------------------------------------
31 #-----------------------------------------------------------------------------
32 # Main functions
32 # Main functions
33 #-----------------------------------------------------------------------------
33 #-----------------------------------------------------------------------------
34
34
35 def display(*objs, **kwargs):
35 def display(*objs, **kwargs):
36 """Display a Python object in all frontends.
36 """Display a Python object in all frontends.
37
37
38 By default all representations will be computed and sent to the frontends.
38 By default all representations will be computed and sent to the frontends.
39 Frontends can decide which representation is used and how.
39 Frontends can decide which representation is used and how.
40
40
41 Parameters
41 Parameters
42 ----------
42 ----------
43 objs : tuple of objects
43 objs : tuple of objects
44 The Python objects to display.
44 The Python objects to display.
45 include : list or tuple, optional
45 include : list or tuple, optional
46 A list of format type strings (MIME types) to include in the
46 A list of format type strings (MIME types) to include in the
47 format data dict. If this is set *only* the format types included
47 format data dict. If this is set *only* the format types included
48 in this list will be computed.
48 in this list will be computed.
49 exclude : list or tuple, optional
49 exclude : list or tuple, optional
50 A list of format type string (MIME types) to exclue in the format
50 A list of format type string (MIME types) to exclue in the format
51 data dict. If this is set all format types will be computed,
51 data dict. If this is set all format types will be computed,
52 except for those included in this argument.
52 except for those included in this argument.
53 """
53 """
54 include = kwargs.get('include')
54 include = kwargs.get('include')
55 exclude = kwargs.get('exclude')
55 exclude = kwargs.get('exclude')
56
56
57 from IPython.core.interactiveshell import InteractiveShell
57 from IPython.core.interactiveshell import InteractiveShell
58 inst = InteractiveShell.instance()
58 inst = InteractiveShell.instance()
59 format = inst.display_formatter.format
59 format = inst.display_formatter.format
60 publish = inst.display_pub.publish
60 publish = inst.display_pub.publish
61
61
62 for obj in objs:
62 for obj in objs:
63 format_dict = format(obj, include=include, exclude=exclude)
63 format_dict = format(obj, include=include, exclude=exclude)
64 publish('IPython.core.display.display', format_dict)
64 publish('IPython.core.display.display', format_dict)
65
65
66
66
67 def display_pretty(*objs, **kwargs):
67 def display_pretty(*objs, **kwargs):
68 """Display the pretty (default) representation of an object.
68 """Display the pretty (default) representation of an object.
69
69
70 Parameters
70 Parameters
71 ----------
71 ----------
72 objs : tuple of objects
72 objs : tuple of objects
73 The Python objects to display, or if raw=True raw text data to
73 The Python objects to display, or if raw=True raw text data to
74 display.
74 display.
75 raw : bool
75 raw : bool
76 Are the data objects raw data or Python objects that need to be
76 Are the data objects raw data or Python objects that need to be
77 formatted before display? [default: False]
77 formatted before display? [default: False]
78 """
78 """
79 raw = kwargs.pop('raw',False)
79 raw = kwargs.pop('raw',False)
80 if raw:
80 if raw:
81 for obj in objs:
81 for obj in objs:
82 publish_pretty(obj)
82 publish_pretty(obj)
83 else:
83 else:
84 display(*objs, include=['text/plain'])
84 display(*objs, include=['text/plain'])
85
85
86
86
87 def display_html(*objs, **kwargs):
87 def display_html(*objs, **kwargs):
88 """Display the HTML representation of an object.
88 """Display the HTML representation of an object.
89
89
90 Parameters
90 Parameters
91 ----------
91 ----------
92 objs : tuple of objects
92 objs : tuple of objects
93 The Python objects to display, or if raw=True raw HTML data to
93 The Python objects to display, or if raw=True raw HTML data to
94 display.
94 display.
95 raw : bool
95 raw : bool
96 Are the data objects raw data or Python objects that need to be
96 Are the data objects raw data or Python objects that need to be
97 formatted before display? [default: False]
97 formatted before display? [default: False]
98 """
98 """
99 raw = kwargs.pop('raw',False)
99 raw = kwargs.pop('raw',False)
100 if raw:
100 if raw:
101 for obj in objs:
101 for obj in objs:
102 publish_html(obj)
102 publish_html(obj)
103 else:
103 else:
104 display(*objs, include=['text/plain','text/html'])
104 display(*objs, include=['text/plain','text/html'])
105
105
106
106
107 def display_svg(*objs, **kwargs):
107 def display_svg(*objs, **kwargs):
108 """Display the SVG representation of an object.
108 """Display the SVG representation of an object.
109
109
110 Parameters
110 Parameters
111 ----------
111 ----------
112 objs : tuple of objects
112 objs : tuple of objects
113 The Python objects to display, or if raw=True raw svg data to
113 The Python objects to display, or if raw=True raw svg data to
114 display.
114 display.
115 raw : bool
115 raw : bool
116 Are the data objects raw data or Python objects that need to be
116 Are the data objects raw data or Python objects that need to be
117 formatted before display? [default: False]
117 formatted before display? [default: False]
118 """
118 """
119 raw = kwargs.pop('raw',False)
119 raw = kwargs.pop('raw',False)
120 if raw:
120 if raw:
121 for obj in objs:
121 for obj in objs:
122 publish_svg(obj)
122 publish_svg(obj)
123 else:
123 else:
124 display(*objs, include=['text/plain','image/svg+xml'])
124 display(*objs, include=['text/plain','image/svg+xml'])
125
125
126
126
127 def display_png(*objs, **kwargs):
127 def display_png(*objs, **kwargs):
128 """Display the PNG representation of an object.
128 """Display the PNG representation of an object.
129
129
130 Parameters
130 Parameters
131 ----------
131 ----------
132 objs : tuple of objects
132 objs : tuple of objects
133 The Python objects to display, or if raw=True raw png data to
133 The Python objects to display, or if raw=True raw png data to
134 display.
134 display.
135 raw : bool
135 raw : bool
136 Are the data objects raw data or Python objects that need to be
136 Are the data objects raw data or Python objects that need to be
137 formatted before display? [default: False]
137 formatted before display? [default: False]
138 """
138 """
139 raw = kwargs.pop('raw',False)
139 raw = kwargs.pop('raw',False)
140 if raw:
140 if raw:
141 for obj in objs:
141 for obj in objs:
142 publish_png(obj)
142 publish_png(obj)
143 else:
143 else:
144 display(*objs, include=['text/plain','image/png'])
144 display(*objs, include=['text/plain','image/png'])
145
145
146
146
147 def display_jpeg(*objs, **kwargs):
147 def display_jpeg(*objs, **kwargs):
148 """Display the JPEG representation of an object.
148 """Display the JPEG representation of an object.
149
149
150 Parameters
150 Parameters
151 ----------
151 ----------
152 objs : tuple of objects
152 objs : tuple of objects
153 The Python objects to display, or if raw=True raw JPEG data to
153 The Python objects to display, or if raw=True raw JPEG data to
154 display.
154 display.
155 raw : bool
155 raw : bool
156 Are the data objects raw data or Python objects that need to be
156 Are the data objects raw data or Python objects that need to be
157 formatted before display? [default: False]
157 formatted before display? [default: False]
158 """
158 """
159 raw = kwargs.pop('raw',False)
159 raw = kwargs.pop('raw',False)
160 if raw:
160 if raw:
161 for obj in objs:
161 for obj in objs:
162 publish_jpeg(obj)
162 publish_jpeg(obj)
163 else:
163 else:
164 display(*objs, include=['text/plain','image/jpeg'])
164 display(*objs, include=['text/plain','image/jpeg'])
165
165
166
166
167 def display_latex(*objs, **kwargs):
167 def display_latex(*objs, **kwargs):
168 """Display the LaTeX representation of an object.
168 """Display the LaTeX representation of an object.
169
169
170 Parameters
170 Parameters
171 ----------
171 ----------
172 objs : tuple of objects
172 objs : tuple of objects
173 The Python objects to display, or if raw=True raw latex data to
173 The Python objects to display, or if raw=True raw latex data to
174 display.
174 display.
175 raw : bool
175 raw : bool
176 Are the data objects raw data or Python objects that need to be
176 Are the data objects raw data or Python objects that need to be
177 formatted before display? [default: False]
177 formatted before display? [default: False]
178 """
178 """
179 raw = kwargs.pop('raw',False)
179 raw = kwargs.pop('raw',False)
180 if raw:
180 if raw:
181 for obj in objs:
181 for obj in objs:
182 publish_latex(obj)
182 publish_latex(obj)
183 else:
183 else:
184 display(*objs, include=['text/plain','text/latex'])
184 display(*objs, include=['text/plain','text/latex'])
185
185
186
186
187 def display_json(*objs, **kwargs):
187 def display_json(*objs, **kwargs):
188 """Display the JSON representation of an object.
188 """Display the JSON representation of an object.
189
189
190 Parameters
190 Parameters
191 ----------
191 ----------
192 objs : tuple of objects
192 objs : tuple of objects
193 The Python objects to display, or if raw=True raw json data to
193 The Python objects to display, or if raw=True raw json data to
194 display.
194 display.
195 raw : bool
195 raw : bool
196 Are the data objects raw data or Python objects that need to be
196 Are the data objects raw data or Python objects that need to be
197 formatted before display? [default: False]
197 formatted before display? [default: False]
198 """
198 """
199 raw = kwargs.pop('raw',False)
199 raw = kwargs.pop('raw',False)
200 if raw:
200 if raw:
201 for obj in objs:
201 for obj in objs:
202 publish_json(obj)
202 publish_json(obj)
203 else:
203 else:
204 display(*objs, include=['text/plain','application/json'])
204 display(*objs, include=['text/plain','application/json'])
205
205
206
206
207 def display_javascript(*objs, **kwargs):
207 def display_javascript(*objs, **kwargs):
208 """Display the Javascript representation of an object.
208 """Display the Javascript representation of an object.
209
209
210 Parameters
210 Parameters
211 ----------
211 ----------
212 objs : tuple of objects
212 objs : tuple of objects
213 The Python objects to display, or if raw=True raw javascript data to
213 The Python objects to display, or if raw=True raw javascript data to
214 display.
214 display.
215 raw : bool
215 raw : bool
216 Are the data objects raw data or Python objects that need to be
216 Are the data objects raw data or Python objects that need to be
217 formatted before display? [default: False]
217 formatted before display? [default: False]
218 """
218 """
219 raw = kwargs.pop('raw',False)
219 raw = kwargs.pop('raw',False)
220 if raw:
220 if raw:
221 for obj in objs:
221 for obj in objs:
222 publish_javascript(obj)
222 publish_javascript(obj)
223 else:
223 else:
224 display(*objs, include=['text/plain','application/javascript'])
224 display(*objs, include=['text/plain','application/javascript'])
225
225
226 #-----------------------------------------------------------------------------
226 #-----------------------------------------------------------------------------
227 # Smart classes
227 # Smart classes
228 #-----------------------------------------------------------------------------
228 #-----------------------------------------------------------------------------
229
229
230
230
231 class DisplayObject(object):
231 class DisplayObject(object):
232 """An object that wraps data to be displayed."""
232 """An object that wraps data to be displayed."""
233
233
234 _read_flags = 'r'
234 _read_flags = 'r'
235
235
236 def __init__(self, data=None, url=None, filename=None):
236 def __init__(self, data=None, url=None, filename=None):
237 """Create a display object given raw data.
237 """Create a display object given raw data.
238
238
239 When this object is returned by an expression or passed to the
239 When this object is returned by an expression or passed to the
240 display function, it will result in the data being displayed
240 display function, it will result in the data being displayed
241 in the frontend. The MIME type of the data should match the
241 in the frontend. The MIME type of the data should match the
242 subclasses used, so the Png subclass should be used for 'image/png'
242 subclasses used, so the Png subclass should be used for 'image/png'
243 data. If the data is a URL, the data will first be downloaded
243 data. If the data is a URL, the data will first be downloaded
244 and then displayed. If
244 and then displayed. If
245
245
246 Parameters
246 Parameters
247 ----------
247 ----------
248 data : unicode, str or bytes
248 data : unicode, str or bytes
249 The raw data or a URL to download the data from.
249 The raw data or a URL to download the data from.
250 url : unicode
250 url : unicode
251 A URL to download the data from.
251 A URL to download the data from.
252 filename : unicode
252 filename : unicode
253 Path to a local file to load the data from.
253 Path to a local file to load the data from.
254 """
254 """
255 if data is not None and data.startswith('http'):
255 if data is not None and data.startswith('http'):
256 self.url = data
256 self.url = data
257 self.filename = None
257 self.filename = None
258 self.data = None
258 self.data = None
259 else:
259 else:
260 self.data = data
260 self.data = data
261 self.url = url
261 self.url = url
262 self.filename = None if filename is None else unicode(filename)
262 self.filename = None if filename is None else unicode(filename)
263 self.reload()
263 self.reload()
264
264
265 def reload(self):
265 def reload(self):
266 """Reload the raw data from file or URL."""
266 """Reload the raw data from file or URL."""
267 if self.filename is not None:
267 if self.filename is not None:
268 with open(self.filename, self._read_flags) as f:
268 with open(self.filename, self._read_flags) as f:
269 self.data = f.read()
269 self.data = f.read()
270 elif self.url is not None:
270 elif self.url is not None:
271 try:
271 try:
272 import urllib2
272 import urllib2
273 response = urllib2.urlopen(self.url)
273 response = urllib2.urlopen(self.url)
274 self.data = response.read()
274 self.data = response.read()
275 # extract encoding from header, if there is one:
275 # extract encoding from header, if there is one:
276 encoding = None
276 encoding = None
277 for sub in response.headers['content-type'].split(';'):
277 for sub in response.headers['content-type'].split(';'):
278 sub = sub.strip()
278 sub = sub.strip()
279 if sub.startswith('charset'):
279 if sub.startswith('charset'):
280 encoding = sub.split('=')[-1].strip()
280 encoding = sub.split('=')[-1].strip()
281 break
281 break
282 # decode data, if an encoding was specified
282 # decode data, if an encoding was specified
283 if encoding:
283 if encoding:
284 self.data = self.data.decode(encoding, 'replace')
284 self.data = self.data.decode(encoding, 'replace')
285 except:
285 except:
286 self.data = None
286 self.data = None
287
287
288 class Pretty(DisplayObject):
288 class Pretty(DisplayObject):
289
289
290 def _repr_pretty_(self):
290 def _repr_pretty_(self):
291 return self.data
291 return self.data
292
292
293
293
294 class HTML(DisplayObject):
294 class HTML(DisplayObject):
295
295
296 def _repr_html_(self):
296 def _repr_html_(self):
297 return self.data
297 return self.data
298
298
299
299
300 class Math(DisplayObject):
300 class Math(DisplayObject):
301
301
302 def _repr_latex_(self):
302 def _repr_latex_(self):
303 s = self.data.strip('$')
303 s = self.data.strip('$')
304 return "$$%s$$" % s
304 return "$$%s$$" % s
305
305
306
306
307 class Latex(DisplayObject):
307 class Latex(DisplayObject):
308
308
309 def _repr_latex_(self):
309 def _repr_latex_(self):
310 return self.data
310 return self.data
311
311
312
312
313 class SVG(DisplayObject):
313 class SVG(DisplayObject):
314
314
315 # wrap data in a property, which extracts the <svg> tag, discarding
315 # wrap data in a property, which extracts the <svg> tag, discarding
316 # document headers
316 # document headers
317 _data = None
317 _data = None
318
318
319 @property
319 @property
320 def data(self):
320 def data(self):
321 return self._data
321 return self._data
322
322
323 @data.setter
323 @data.setter
324 def data(self, svg):
324 def data(self, svg):
325 if svg is None:
325 if svg is None:
326 self._data = None
326 self._data = None
327 return
327 return
328 # parse into dom object
328 # parse into dom object
329 x = minidom.parseString(svg)
329 x = minidom.parseString(svg)
330 # get svg tag (should be 1)
330 # get svg tag (should be 1)
331 found_svg = x.getElementsByTagName('svg')
331 found_svg = x.getElementsByTagName('svg')
332 if found_svg:
332 if found_svg:
333 svg = found_svg[0].toxml()
333 svg = found_svg[0].toxml()
334 else:
334 else:
335 # fallback on the input, trust the user
335 # fallback on the input, trust the user
336 # but this is probably an error.
336 # but this is probably an error.
337 pass
337 pass
338 self._data = svg
338 self._data = svg
339
339
340 def _repr_svg_(self):
340 def _repr_svg_(self):
341 return self.data
341 return self.data
342
342
343
343
344 class JSON(DisplayObject):
344 class JSON(DisplayObject):
345
345
346 def _repr_json_(self):
346 def _repr_json_(self):
347 return self.data
347 return self.data
348
348
349 css_t = """$("head").append($("<link/>").attr({
349 css_t = """$("head").append($("<link/>").attr({
350 rel: "stylesheet",
350 rel: "stylesheet",
351 type: "text/css",
351 type: "text/css",
352 href: "%s"
352 href: "%s"
353 }));
353 }));
354 """
354 """
355
355
356 lib_t1 = """$.getScript("%s", function () {
356 lib_t1 = """$.getScript("%s", function () {
357 """
357 """
358 lib_t2 = """});
358 lib_t2 = """});
359 """
359 """
360
360
361 class Javascript(DisplayObject):
361 class Javascript(DisplayObject):
362
362
363 def __init__(self, data=None, url=None, filename=None, lib=None, css=None):
363 def __init__(self, data=None, url=None, filename=None, lib=None, css=None):
364 """Create a Javascript display object given raw data.
364 """Create a Javascript display object given raw data.
365
365
366 When this object is returned by an expression or passed to the
366 When this object is returned by an expression or passed to the
367 display function, it will result in the data being displayed
367 display function, it will result in the data being displayed
368 in the frontend. If the data is a URL, the data will first be
368 in the frontend. If the data is a URL, the data will first be
369 downloaded and then displayed.
369 downloaded and then displayed.
370
370
371 In the Notebook, the containing element will be available as `element`,
371 In the Notebook, the containing element will be available as `element`,
372 and jQuery will be available. The output area starts hidden, so if
372 and jQuery will be available. The output area starts hidden, so if
373 the js appends content to `element` that should be visible, then
373 the js appends content to `element` that should be visible, then
374 it must call `container.show()` to unhide the area.
374 it must call `container.show()` to unhide the area.
375
375
376 Parameters
376 Parameters
377 ----------
377 ----------
378 data : unicode, str or bytes
378 data : unicode, str or bytes
379 The Javascript source code or a URL to download it from.
379 The Javascript source code or a URL to download it from.
380 url : unicode
380 url : unicode
381 A URL to download the data from.
381 A URL to download the data from.
382 filename : unicode
382 filename : unicode
383 Path to a local file to load the data from.
383 Path to a local file to load the data from.
384 lib : list or str
384 lib : list or str
385 A sequence of Javascript library URLs to load asynchronously before
385 A sequence of Javascript library URLs to load asynchronously before
386 running the source code. The full URLs of the libraries should
386 running the source code. The full URLs of the libraries should
387 be given. A single Javascript library URL can also be given as a
387 be given. A single Javascript library URL can also be given as a
388 string.
388 string.
389 css: : list or str
389 css: : list or str
390 A sequence of css files to load before running the source code.
390 A sequence of css files to load before running the source code.
391 The full URLs of the css files should be give. A single css URL
391 The full URLs of the css files should be give. A single css URL
392 can also be given as a string.
392 can also be given as a string.
393 """
393 """
394 if isinstance(lib, basestring):
394 if isinstance(lib, basestring):
395 lib = [lib]
395 lib = [lib]
396 elif lib is None:
396 elif lib is None:
397 lib = []
397 lib = []
398 if isinstance(css, basestring):
398 if isinstance(css, basestring):
399 css = [css]
399 css = [css]
400 elif css is None:
400 elif css is None:
401 css = []
401 css = []
402 if not isinstance(lib, (list,tuple)):
402 if not isinstance(lib, (list,tuple)):
403 raise TypeError('expected sequence, got: %r' % lib)
403 raise TypeError('expected sequence, got: %r' % lib)
404 if not isinstance(css, (list,tuple)):
404 if not isinstance(css, (list,tuple)):
405 raise TypeError('expected sequence, got: %r' % css)
405 raise TypeError('expected sequence, got: %r' % css)
406 self.lib = lib
406 self.lib = lib
407 self.css = css
407 self.css = css
408 super(Javascript, self).__init__(data=data, url=url, filename=filename)
408 super(Javascript, self).__init__(data=data, url=url, filename=filename)
409
409
410 def _repr_javascript_(self):
410 def _repr_javascript_(self):
411 r = ''
411 r = ''
412 for c in self.css:
412 for c in self.css:
413 r += css_t % c
413 r += css_t % c
414 for l in self.lib:
414 for l in self.lib:
415 r += lib_t1 % l
415 r += lib_t1 % l
416 r += self.data
416 r += self.data
417 r += lib_t2*len(self.lib)
417 r += lib_t2*len(self.lib)
418 return r
418 return r
419
419
420
420
421 class Image(DisplayObject):
421 class Image(DisplayObject):
422
422
423 _read_flags = 'rb'
423 _read_flags = 'rb'
424
424
425 def __init__(self, data=None, url=None, filename=None, format=u'png', embed=False):
425 def __init__(self, data=None, url=None, filename=None, format=u'png', embed=None):
426 """Create a display an PNG/JPEG image given raw data.
426 """Create a display an PNG/JPEG image given raw data.
427
427
428 When this object is returned by an expression or passed to the
428 When this object is returned by an expression or passed to the
429 display function, it will result in the image being displayed
429 display function, it will result in the image being displayed
430 in the frontend.
430 in the frontend.
431
431
432 Parameters
432 Parameters
433 ----------
433 ----------
434 data : unicode, str or bytes
434 data : unicode, str or bytes
435 The raw data or a URL to download the data from.
435 The raw data or a URL to download the data from.
436 url : unicode
436 url : unicode
437 A URL to download the data from.
437 A URL to download the data from.
438 filename : unicode
438 filename : unicode
439 Path to a local file to load the data from.
439 Path to a local file to load the data from.
440 format : unicode
440 format : unicode
441 The format of the image data (png/jpeg/jpg). If a filename or URL is given
441 The format of the image data (png/jpeg/jpg). If a filename or URL is given
442 for format will be inferred from the filename extension.
442 for format will be inferred from the filename extension.
443 embed : bool
443 embed : bool
444 Should the image data be embedded in the notebook using a data URI (True)
444 Should the image data be embedded using a data URI (True) or be
445 or be loaded using an <img> tag. Set this to True if you want the image
445 loaded using an <img> tag. Set this to True if you want the image
446 to be viewable later with no internet connection. If a filename is given
446 to be viewable later with no internet connection in the notebook.
447 embed is always set to True.
447
448 Default is `True`, unless the keyword argument `url` is set, then
449 default value is `False`.
450
451 Note that QtConsole is not able to display images if `embed` is set to `False`
452
453 Examples
454 --------
455 # embed implicitely True, works in qtconsole and notebook
456 Image('http://www.google.fr/images/srpr/logo3w.png')
457
458 # embed implicitely False, does not works in qtconsole but works in notebook if
459 # internet connexion availlable
460 Image(url='http://www.google.fr/images/srpr/logo3w.png')
461
448 """
462 """
449 if filename is not None:
463 if filename is not None:
450 ext = self._find_ext(filename)
464 ext = self._find_ext(filename)
451 elif url is not None:
465 elif url is not None:
452 ext = self._find_ext(url)
466 ext = self._find_ext(url)
453 elif data.startswith('http'):
467 elif data.startswith('http'):
454 ext = self._find_ext(data)
468 ext = self._find_ext(data)
455 else:
469 else:
456 ext = None
470 ext = None
457 if ext is not None:
471 if ext is not None:
458 if ext == u'jpg' or ext == u'jpeg':
472 if ext == u'jpg' or ext == u'jpeg':
459 format = u'jpeg'
473 format = u'jpeg'
460 if ext == u'png':
474 if ext == u'png':
461 format = u'png'
475 format = u'png'
462 self.format = unicode(format).lower()
476 self.format = unicode(format).lower()
463 self.embed = True if filename is not None else embed
477 self.embed = embed if embed is not None else (url is None)
464 super(Image, self).__init__(data=data, url=url, filename=filename)
478 super(Image, self).__init__(data=data, url=url, filename=filename)
465
479
466 def reload(self):
480 def reload(self):
467 """Reload the raw data from file or URL."""
481 """Reload the raw data from file or URL."""
468 if self.embed:
482 if self.embed:
469 super(Image,self).reload()
483 super(Image,self).reload()
470
484
471 def _repr_html_(self):
485 def _repr_html_(self):
472 if not self.embed:
486 if not self.embed:
473 return u'<img src="%s" />' % self.url
487 return u'<img src="%s" />' % self.url
474
488
475 def _repr_png_(self):
489 def _repr_png_(self):
476 if self.embed and self.format == u'png':
490 if self.embed and self.format == u'png':
477 return self.data
491 return self.data
478
492
479 def _repr_jpeg_(self):
493 def _repr_jpeg_(self):
480 if self.embed and (self.format == u'jpeg' or self.format == u'jpg'):
494 if self.embed and (self.format == u'jpeg' or self.format == u'jpg'):
481 return self.data
495 return self.data
482
496
483 def _find_ext(self, s):
497 def _find_ext(self, s):
484 return unicode(s.split('.')[-1].lower())
498 return unicode(s.split('.')[-1].lower())
485
499
486
500
487 def clear_output(stdout=True, stderr=True, other=True):
501 def clear_output(stdout=True, stderr=True, other=True):
488 """Clear the output of the current cell receiving output.
502 """Clear the output of the current cell receiving output.
489
503
490 Optionally, each of stdout/stderr or other non-stream data (e.g. anything
504 Optionally, each of stdout/stderr or other non-stream data (e.g. anything
491 produced by display()) can be excluded from the clear event.
505 produced by display()) can be excluded from the clear event.
492
506
493 By default, everything is cleared.
507 By default, everything is cleared.
494
508
495 Parameters
509 Parameters
496 ----------
510 ----------
497 stdout : bool [default: True]
511 stdout : bool [default: True]
498 Whether to clear stdout.
512 Whether to clear stdout.
499 stderr : bool [default: True]
513 stderr : bool [default: True]
500 Whether to clear stderr.
514 Whether to clear stderr.
501 other : bool [default: True]
515 other : bool [default: True]
502 Whether to clear everything else that is not stdout/stderr
516 Whether to clear everything else that is not stdout/stderr
503 (e.g. figures,images,HTML, any result of display()).
517 (e.g. figures,images,HTML, any result of display()).
504 """
518 """
505 from IPython.core.interactiveshell import InteractiveShell
519 from IPython.core.interactiveshell import InteractiveShell
506 if InteractiveShell.initialized():
520 if InteractiveShell.initialized():
507 InteractiveShell.instance().display_pub.clear_output(
521 InteractiveShell.instance().display_pub.clear_output(
508 stdout=stdout, stderr=stderr, other=other,
522 stdout=stdout, stderr=stderr, other=other,
509 )
523 )
510 else:
524 else:
511 from IPython.utils import io
525 from IPython.utils import io
512 if stdout:
526 if stdout:
513 print('\033[2K\r', file=io.stdout, end='')
527 print('\033[2K\r', file=io.stdout, end='')
514 io.stdout.flush()
528 io.stdout.flush()
515 if stderr:
529 if stderr:
516 print('\033[2K\r', file=io.stderr, end='')
530 print('\033[2K\r', file=io.stderr, end='')
517 io.stderr.flush()
531 io.stderr.flush()
518
532
General Comments 0
You need to be logged in to leave comments. Login now