##// END OF EJS Templates
Integrate new prompt machinery with intelli-newlining
Thomas Kluyver -
Show More
@@ -1,293 +1,295 b''
1 # -*- coding: utf-8 -*-
1 # -*- coding: utf-8 -*-
2 """Displayhook for IPython.
2 """Displayhook for IPython.
3
3
4 This defines a callable class that IPython uses for `sys.displayhook`.
4 This defines a callable class that IPython uses for `sys.displayhook`.
5 """
5 """
6
6
7 # Copyright (c) IPython Development Team.
7 # Copyright (c) IPython Development Team.
8 # Distributed under the terms of the Modified BSD License.
8 # Distributed under the terms of the Modified BSD License.
9
9
10 from __future__ import print_function
10 from __future__ import print_function
11
11
12 import sys
12 import sys
13 import io as _io
13 import io as _io
14 import tokenize
14 import tokenize
15
15
16 from traitlets.config.configurable import Configurable
16 from traitlets.config.configurable import Configurable
17 from IPython.utils.py3compat import builtin_mod, cast_unicode_py2
17 from IPython.utils.py3compat import builtin_mod, cast_unicode_py2
18 from traitlets import Instance, Float
18 from traitlets import Instance, Float
19 from warnings import warn
19 from warnings import warn
20
20
21 # TODO: Move the various attributes (cache_size, [others now moved]). Some
21 # TODO: Move the various attributes (cache_size, [others now moved]). Some
22 # of these are also attributes of InteractiveShell. They should be on ONE object
22 # of these are also attributes of InteractiveShell. They should be on ONE object
23 # only and the other objects should ask that one object for their values.
23 # only and the other objects should ask that one object for their values.
24
24
25 class DisplayHook(Configurable):
25 class DisplayHook(Configurable):
26 """The custom IPython displayhook to replace sys.displayhook.
26 """The custom IPython displayhook to replace sys.displayhook.
27
27
28 This class does many things, but the basic idea is that it is a callable
28 This class does many things, but the basic idea is that it is a callable
29 that gets called anytime user code returns a value.
29 that gets called anytime user code returns a value.
30 """
30 """
31
31
32 shell = Instance('IPython.core.interactiveshell.InteractiveShellABC',
32 shell = Instance('IPython.core.interactiveshell.InteractiveShellABC',
33 allow_none=True)
33 allow_none=True)
34 exec_result = Instance('IPython.core.interactiveshell.ExecutionResult',
34 exec_result = Instance('IPython.core.interactiveshell.ExecutionResult',
35 allow_none=True)
35 allow_none=True)
36 cull_fraction = Float(0.2)
36 cull_fraction = Float(0.2)
37
37
38 def __init__(self, shell=None, cache_size=1000, **kwargs):
38 def __init__(self, shell=None, cache_size=1000, **kwargs):
39 super(DisplayHook, self).__init__(shell=shell, **kwargs)
39 super(DisplayHook, self).__init__(shell=shell, **kwargs)
40 cache_size_min = 3
40 cache_size_min = 3
41 if cache_size <= 0:
41 if cache_size <= 0:
42 self.do_full_cache = 0
42 self.do_full_cache = 0
43 cache_size = 0
43 cache_size = 0
44 elif cache_size < cache_size_min:
44 elif cache_size < cache_size_min:
45 self.do_full_cache = 0
45 self.do_full_cache = 0
46 cache_size = 0
46 cache_size = 0
47 warn('caching was disabled (min value for cache size is %s).' %
47 warn('caching was disabled (min value for cache size is %s).' %
48 cache_size_min,level=3)
48 cache_size_min,level=3)
49 else:
49 else:
50 self.do_full_cache = 1
50 self.do_full_cache = 1
51
51
52 self.cache_size = cache_size
52 self.cache_size = cache_size
53
53
54 # we need a reference to the user-level namespace
54 # we need a reference to the user-level namespace
55 self.shell = shell
55 self.shell = shell
56
56
57 self._,self.__,self.___ = '','',''
57 self._,self.__,self.___ = '','',''
58
58
59 # these are deliberately global:
59 # these are deliberately global:
60 to_user_ns = {'_':self._,'__':self.__,'___':self.___}
60 to_user_ns = {'_':self._,'__':self.__,'___':self.___}
61 self.shell.user_ns.update(to_user_ns)
61 self.shell.user_ns.update(to_user_ns)
62
62
63 @property
63 @property
64 def prompt_count(self):
64 def prompt_count(self):
65 return self.shell.execution_count
65 return self.shell.execution_count
66
66
67 #-------------------------------------------------------------------------
67 #-------------------------------------------------------------------------
68 # Methods used in __call__. Override these methods to modify the behavior
68 # Methods used in __call__. Override these methods to modify the behavior
69 # of the displayhook.
69 # of the displayhook.
70 #-------------------------------------------------------------------------
70 #-------------------------------------------------------------------------
71
71
72 def check_for_underscore(self):
72 def check_for_underscore(self):
73 """Check if the user has set the '_' variable by hand."""
73 """Check if the user has set the '_' variable by hand."""
74 # If something injected a '_' variable in __builtin__, delete
74 # If something injected a '_' variable in __builtin__, delete
75 # ipython's automatic one so we don't clobber that. gettext() in
75 # ipython's automatic one so we don't clobber that. gettext() in
76 # particular uses _, so we need to stay away from it.
76 # particular uses _, so we need to stay away from it.
77 if '_' in builtin_mod.__dict__:
77 if '_' in builtin_mod.__dict__:
78 try:
78 try:
79 del self.shell.user_ns['_']
79 del self.shell.user_ns['_']
80 except KeyError:
80 except KeyError:
81 pass
81 pass
82
82
83 def quiet(self):
83 def quiet(self):
84 """Should we silence the display hook because of ';'?"""
84 """Should we silence the display hook because of ';'?"""
85 # do not print output if input ends in ';'
85 # do not print output if input ends in ';'
86
86
87 try:
87 try:
88 cell = cast_unicode_py2(self.shell.history_manager.input_hist_parsed[-1])
88 cell = cast_unicode_py2(self.shell.history_manager.input_hist_parsed[-1])
89 except IndexError:
89 except IndexError:
90 # some uses of ipshellembed may fail here
90 # some uses of ipshellembed may fail here
91 return False
91 return False
92
92
93 sio = _io.StringIO(cell)
93 sio = _io.StringIO(cell)
94 tokens = list(tokenize.generate_tokens(sio.readline))
94 tokens = list(tokenize.generate_tokens(sio.readline))
95
95
96 for token in reversed(tokens):
96 for token in reversed(tokens):
97 if token[0] in (tokenize.ENDMARKER, tokenize.NL, tokenize.NEWLINE, tokenize.COMMENT):
97 if token[0] in (tokenize.ENDMARKER, tokenize.NL, tokenize.NEWLINE, tokenize.COMMENT):
98 continue
98 continue
99 if (token[0] == tokenize.OP) and (token[1] == ';'):
99 if (token[0] == tokenize.OP) and (token[1] == ';'):
100 return True
100 return True
101 else:
101 else:
102 return False
102 return False
103
103
104 def start_displayhook(self):
104 def start_displayhook(self):
105 """Start the displayhook, initializing resources."""
105 """Start the displayhook, initializing resources."""
106 pass
106 pass
107
107
108 def write_output_prompt(self):
108 def write_output_prompt(self):
109 """Write the output prompt.
109 """Write the output prompt.
110
110
111 The default implementation simply writes the prompt to
111 The default implementation simply writes the prompt to
112 ``io.stdout``.
112 ``io.stdout``.
113 """
113 """
114 # Use write, not print which adds an extra space.
114 # Use write, not print which adds an extra space.
115 sys.stdout.write(self.shell.separate_out)
115 sys.stdout.write(self.shell.separate_out)
116 outprompt = 'Out[{}]: '.format(self.shell.execution_count)
116 outprompt = 'Out[{}]: '.format(self.shell.execution_count)
117 if self.do_full_cache:
117 if self.do_full_cache:
118 sys.stdout.write(outprompt)
118 sys.stdout.write(outprompt)
119
119
120 def compute_format_data(self, result):
120 def compute_format_data(self, result):
121 """Compute format data of the object to be displayed.
121 """Compute format data of the object to be displayed.
122
122
123 The format data is a generalization of the :func:`repr` of an object.
123 The format data is a generalization of the :func:`repr` of an object.
124 In the default implementation the format data is a :class:`dict` of
124 In the default implementation the format data is a :class:`dict` of
125 key value pair where the keys are valid MIME types and the values
125 key value pair where the keys are valid MIME types and the values
126 are JSON'able data structure containing the raw data for that MIME
126 are JSON'able data structure containing the raw data for that MIME
127 type. It is up to frontends to determine pick a MIME to to use and
127 type. It is up to frontends to determine pick a MIME to to use and
128 display that data in an appropriate manner.
128 display that data in an appropriate manner.
129
129
130 This method only computes the format data for the object and should
130 This method only computes the format data for the object and should
131 NOT actually print or write that to a stream.
131 NOT actually print or write that to a stream.
132
132
133 Parameters
133 Parameters
134 ----------
134 ----------
135 result : object
135 result : object
136 The Python object passed to the display hook, whose format will be
136 The Python object passed to the display hook, whose format will be
137 computed.
137 computed.
138
138
139 Returns
139 Returns
140 -------
140 -------
141 (format_dict, md_dict) : dict
141 (format_dict, md_dict) : dict
142 format_dict is a :class:`dict` whose keys are valid MIME types and values are
142 format_dict is a :class:`dict` whose keys are valid MIME types and values are
143 JSON'able raw data for that MIME type. It is recommended that
143 JSON'able raw data for that MIME type. It is recommended that
144 all return values of this should always include the "text/plain"
144 all return values of this should always include the "text/plain"
145 MIME type representation of the object.
145 MIME type representation of the object.
146 md_dict is a :class:`dict` with the same MIME type keys
146 md_dict is a :class:`dict` with the same MIME type keys
147 of metadata associated with each output.
147 of metadata associated with each output.
148
148
149 """
149 """
150 return self.shell.display_formatter.format(result)
150 return self.shell.display_formatter.format(result)
151
151
152 # This can be set to True by the write_output_prompt method in a subclass
153 prompt_end_newline = False
154
152 def write_format_data(self, format_dict, md_dict=None):
155 def write_format_data(self, format_dict, md_dict=None):
153 """Write the format data dict to the frontend.
156 """Write the format data dict to the frontend.
154
157
155 This default version of this method simply writes the plain text
158 This default version of this method simply writes the plain text
156 representation of the object to ``io.stdout``. Subclasses should
159 representation of the object to ``io.stdout``. Subclasses should
157 override this method to send the entire `format_dict` to the
160 override this method to send the entire `format_dict` to the
158 frontends.
161 frontends.
159
162
160 Parameters
163 Parameters
161 ----------
164 ----------
162 format_dict : dict
165 format_dict : dict
163 The format dict for the object passed to `sys.displayhook`.
166 The format dict for the object passed to `sys.displayhook`.
164 md_dict : dict (optional)
167 md_dict : dict (optional)
165 The metadata dict to be associated with the display data.
168 The metadata dict to be associated with the display data.
166 """
169 """
167 if 'text/plain' not in format_dict:
170 if 'text/plain' not in format_dict:
168 # nothing to do
171 # nothing to do
169 return
172 return
170 # We want to print because we want to always make sure we have a
173 # We want to print because we want to always make sure we have a
171 # newline, even if all the prompt separators are ''. This is the
174 # newline, even if all the prompt separators are ''. This is the
172 # standard IPython behavior.
175 # standard IPython behavior.
173 result_repr = format_dict['text/plain']
176 result_repr = format_dict['text/plain']
174 if '\n' in result_repr:
177 if '\n' in result_repr:
175 # So that multi-line strings line up with the left column of
178 # So that multi-line strings line up with the left column of
176 # the screen, instead of having the output prompt mess up
179 # the screen, instead of having the output prompt mess up
177 # their first line.
180 # their first line.
178 # We use the prompt template instead of the expanded prompt
181 # We use the prompt template instead of the expanded prompt
179 # because the expansion may add ANSI escapes that will interfere
182 # because the expansion may add ANSI escapes that will interfere
180 # with our ability to determine whether or not we should add
183 # with our ability to determine whether or not we should add
181 # a newline.
184 # a newline.
182 prompt_template = self.shell.prompt_manager.out_template
185 if not self.prompt_end_newline:
183 if prompt_template and not prompt_template.endswith('\n'):
184 # But avoid extraneous empty lines.
186 # But avoid extraneous empty lines.
185 result_repr = '\n' + result_repr
187 result_repr = '\n' + result_repr
186
188
187 print(result_repr)
189 print(result_repr)
188
190
189 def update_user_ns(self, result):
191 def update_user_ns(self, result):
190 """Update user_ns with various things like _, __, _1, etc."""
192 """Update user_ns with various things like _, __, _1, etc."""
191
193
192 # Avoid recursive reference when displaying _oh/Out
194 # Avoid recursive reference when displaying _oh/Out
193 if result is not self.shell.user_ns['_oh']:
195 if result is not self.shell.user_ns['_oh']:
194 if len(self.shell.user_ns['_oh']) >= self.cache_size and self.do_full_cache:
196 if len(self.shell.user_ns['_oh']) >= self.cache_size and self.do_full_cache:
195 self.cull_cache()
197 self.cull_cache()
196 # Don't overwrite '_' and friends if '_' is in __builtin__ (otherwise
198 # Don't overwrite '_' and friends if '_' is in __builtin__ (otherwise
197 # we cause buggy behavior for things like gettext).
199 # we cause buggy behavior for things like gettext).
198
200
199 if '_' not in builtin_mod.__dict__:
201 if '_' not in builtin_mod.__dict__:
200 self.___ = self.__
202 self.___ = self.__
201 self.__ = self._
203 self.__ = self._
202 self._ = result
204 self._ = result
203 self.shell.push({'_':self._,
205 self.shell.push({'_':self._,
204 '__':self.__,
206 '__':self.__,
205 '___':self.___}, interactive=False)
207 '___':self.___}, interactive=False)
206
208
207 # hackish access to top-level namespace to create _1,_2... dynamically
209 # hackish access to top-level namespace to create _1,_2... dynamically
208 to_main = {}
210 to_main = {}
209 if self.do_full_cache:
211 if self.do_full_cache:
210 new_result = '_'+repr(self.prompt_count)
212 new_result = '_'+repr(self.prompt_count)
211 to_main[new_result] = result
213 to_main[new_result] = result
212 self.shell.push(to_main, interactive=False)
214 self.shell.push(to_main, interactive=False)
213 self.shell.user_ns['_oh'][self.prompt_count] = result
215 self.shell.user_ns['_oh'][self.prompt_count] = result
214
216
215 def fill_exec_result(self, result):
217 def fill_exec_result(self, result):
216 if self.exec_result is not None:
218 if self.exec_result is not None:
217 self.exec_result.result = result
219 self.exec_result.result = result
218
220
219 def log_output(self, format_dict):
221 def log_output(self, format_dict):
220 """Log the output."""
222 """Log the output."""
221 if 'text/plain' not in format_dict:
223 if 'text/plain' not in format_dict:
222 # nothing to do
224 # nothing to do
223 return
225 return
224 if self.shell.logger.log_output:
226 if self.shell.logger.log_output:
225 self.shell.logger.log_write(format_dict['text/plain'], 'output')
227 self.shell.logger.log_write(format_dict['text/plain'], 'output')
226 self.shell.history_manager.output_hist_reprs[self.prompt_count] = \
228 self.shell.history_manager.output_hist_reprs[self.prompt_count] = \
227 format_dict['text/plain']
229 format_dict['text/plain']
228
230
229 def finish_displayhook(self):
231 def finish_displayhook(self):
230 """Finish up all displayhook activities."""
232 """Finish up all displayhook activities."""
231 sys.stdout.write(self.shell.separate_out2)
233 sys.stdout.write(self.shell.separate_out2)
232 sys.stdout.flush()
234 sys.stdout.flush()
233
235
234 def __call__(self, result=None):
236 def __call__(self, result=None):
235 """Printing with history cache management.
237 """Printing with history cache management.
236
238
237 This is invoked everytime the interpreter needs to print, and is
239 This is invoked everytime the interpreter needs to print, and is
238 activated by setting the variable sys.displayhook to it.
240 activated by setting the variable sys.displayhook to it.
239 """
241 """
240 self.check_for_underscore()
242 self.check_for_underscore()
241 if result is not None and not self.quiet():
243 if result is not None and not self.quiet():
242 self.start_displayhook()
244 self.start_displayhook()
243 self.write_output_prompt()
245 self.write_output_prompt()
244 format_dict, md_dict = self.compute_format_data(result)
246 format_dict, md_dict = self.compute_format_data(result)
245 self.update_user_ns(result)
247 self.update_user_ns(result)
246 self.fill_exec_result(result)
248 self.fill_exec_result(result)
247 if format_dict:
249 if format_dict:
248 self.write_format_data(format_dict, md_dict)
250 self.write_format_data(format_dict, md_dict)
249 self.log_output(format_dict)
251 self.log_output(format_dict)
250 self.finish_displayhook()
252 self.finish_displayhook()
251
253
252 def cull_cache(self):
254 def cull_cache(self):
253 """Output cache is full, cull the oldest entries"""
255 """Output cache is full, cull the oldest entries"""
254 oh = self.shell.user_ns.get('_oh', {})
256 oh = self.shell.user_ns.get('_oh', {})
255 sz = len(oh)
257 sz = len(oh)
256 cull_count = max(int(sz * self.cull_fraction), 2)
258 cull_count = max(int(sz * self.cull_fraction), 2)
257 warn('Output cache limit (currently {sz} entries) hit.\n'
259 warn('Output cache limit (currently {sz} entries) hit.\n'
258 'Flushing oldest {cull_count} entries.'.format(sz=sz, cull_count=cull_count))
260 'Flushing oldest {cull_count} entries.'.format(sz=sz, cull_count=cull_count))
259
261
260 for i, n in enumerate(sorted(oh)):
262 for i, n in enumerate(sorted(oh)):
261 if i >= cull_count:
263 if i >= cull_count:
262 break
264 break
263 self.shell.user_ns.pop('_%i' % n, None)
265 self.shell.user_ns.pop('_%i' % n, None)
264 oh.pop(n, None)
266 oh.pop(n, None)
265
267
266
268
267 def flush(self):
269 def flush(self):
268 if not self.do_full_cache:
270 if not self.do_full_cache:
269 raise ValueError("You shouldn't have reached the cache flush "
271 raise ValueError("You shouldn't have reached the cache flush "
270 "if full caching is not enabled!")
272 "if full caching is not enabled!")
271 # delete auto-generated vars from global namespace
273 # delete auto-generated vars from global namespace
272
274
273 for n in range(1,self.prompt_count + 1):
275 for n in range(1,self.prompt_count + 1):
274 key = '_'+repr(n)
276 key = '_'+repr(n)
275 try:
277 try:
276 del self.shell.user_ns[key]
278 del self.shell.user_ns[key]
277 except: pass
279 except: pass
278 # In some embedded circumstances, the user_ns doesn't have the
280 # In some embedded circumstances, the user_ns doesn't have the
279 # '_oh' key set up.
281 # '_oh' key set up.
280 oh = self.shell.user_ns.get('_oh', None)
282 oh = self.shell.user_ns.get('_oh', None)
281 if oh is not None:
283 if oh is not None:
282 oh.clear()
284 oh.clear()
283
285
284 # Release our own references to objects:
286 # Release our own references to objects:
285 self._, self.__, self.___ = '', '', ''
287 self._, self.__, self.___ = '', '', ''
286
288
287 if '_' not in builtin_mod.__dict__:
289 if '_' not in builtin_mod.__dict__:
288 self.shell.user_ns.update({'_':None,'__':None, '___':None})
290 self.shell.user_ns.update({'_':None,'__':None, '___':None})
289 import gc
291 import gc
290 # TODO: Is this really needed?
292 # TODO: Is this really needed?
291 # IronPython blocks here forever
293 # IronPython blocks here forever
292 if sys.platform != "cli":
294 if sys.platform != "cli":
293 gc.collect()
295 gc.collect()
@@ -1,50 +1,53 b''
1 from pygments.token import Token
1 from pygments.token import Token
2 import sys
2 import sys
3
3
4 from IPython.core.displayhook import DisplayHook
4 from IPython.core.displayhook import DisplayHook
5
5
6 class Prompts(object):
6 class Prompts(object):
7 def __init__(self, shell):
7 def __init__(self, shell):
8 self.shell = shell
8 self.shell = shell
9
9
10 def in_prompt_tokens(self, cli=None):
10 def in_prompt_tokens(self, cli=None):
11 return [
11 return [
12 (Token.Prompt, 'In ['),
12 (Token.Prompt, 'In ['),
13 (Token.PromptNum, str(self.shell.execution_count)),
13 (Token.PromptNum, str(self.shell.execution_count)),
14 (Token.Prompt, ']: '),
14 (Token.Prompt, ']: '),
15 ]
15 ]
16
16
17 def _width(self):
17 def _width(self):
18 in_tokens = self.in_prompt_tokens()
18 in_tokens = self.in_prompt_tokens()
19 return sum(len(s) for (t, s) in in_tokens)
19 return sum(len(s) for (t, s) in in_tokens)
20
20
21 def continuation_prompt_tokens(self, cli=None, width=None):
21 def continuation_prompt_tokens(self, cli=None, width=None):
22 if width is None:
22 if width is None:
23 width = self._width()
23 width = self._width()
24 return [
24 return [
25 (Token.Prompt, (' ' * (width - 5)) + '...: '),
25 (Token.Prompt, (' ' * (width - 5)) + '...: '),
26 ]
26 ]
27
27
28 def rewrite_prompt_tokens(self):
28 def rewrite_prompt_tokens(self):
29 width = self._width()
29 width = self._width()
30 return [
30 return [
31 (Token.Prompt, ('-' * (width - 2)) + '> '),
31 (Token.Prompt, ('-' * (width - 2)) + '> '),
32 ]
32 ]
33
33
34 def out_prompt_tokens(self):
34 def out_prompt_tokens(self):
35 return [
35 return [
36 (Token.OutPrompt, 'Out['),
36 (Token.OutPrompt, 'Out['),
37 (Token.OutPromptNum, str(self.shell.execution_count)),
37 (Token.OutPromptNum, str(self.shell.execution_count)),
38 (Token.OutPrompt, ']: '),
38 (Token.OutPrompt, ']: '),
39 ]
39 ]
40
40
41 class RichPromptDisplayHook(DisplayHook):
41 class RichPromptDisplayHook(DisplayHook):
42 """Subclass of base display hook using coloured prompt"""
42 """Subclass of base display hook using coloured prompt"""
43 def write_output_prompt(self):
43 def write_output_prompt(self):
44 sys.stdout.write(self.shell.separate_out)
44 sys.stdout.write(self.shell.separate_out)
45 self.prompt_end_newline = False
45 if self.do_full_cache:
46 if self.do_full_cache:
46 tokens = self.shell.prompts.out_prompt_tokens()
47 tokens = self.shell.prompts.out_prompt_tokens()
48 if tokens and tokens[-1][1].endswith('\n'):
49 self.prompt_end_newline = True
47 if self.shell.pt_cli:
50 if self.shell.pt_cli:
48 self.shell.pt_cli.print_tokens(tokens)
51 self.shell.pt_cli.print_tokens(tokens)
49 else:
52 else:
50 print(*(s for t, s in tokens), sep='')
53 print(*(s for t, s in tokens), sep='')
General Comments 0
You need to be logged in to leave comments. Login now