##// END OF EJS Templates
Be more lenient when bytes are sent to stdout/stderr on Py2+Windows...
Thomas Kluyver -
Show More
@@ -1,452 +1,474 b''
1 1 """IPython terminal interface using prompt_toolkit"""
2 2 from __future__ import print_function
3 3
4 4 import os
5 5 import sys
6 6 from warnings import warn
7 7
8 8 from IPython.core.interactiveshell import InteractiveShell, InteractiveShellABC
9 9 from IPython.utils.py3compat import PY3, cast_unicode_py2, input
10 10 from IPython.utils.terminal import toggle_set_term_title, set_term_title
11 11 from IPython.utils.process import abbrev_cwd
12 12 from traitlets import Bool, Unicode, Dict, Integer, observe, Instance, Type, default, Enum
13 13
14 14 from prompt_toolkit.enums import DEFAULT_BUFFER, EditingMode
15 15 from prompt_toolkit.filters import (HasFocus, Condition, IsDone)
16 16 from prompt_toolkit.history import InMemoryHistory
17 17 from prompt_toolkit.shortcuts import create_prompt_application, create_eventloop, create_prompt_layout, create_output
18 18 from prompt_toolkit.interface import CommandLineInterface
19 19 from prompt_toolkit.key_binding.manager import KeyBindingManager
20 20 from prompt_toolkit.layout.processors import ConditionalProcessor, HighlightMatchingBracketProcessor
21 21 from prompt_toolkit.styles import PygmentsStyle, DynamicStyle
22 22
23 23 from pygments.styles import get_style_by_name, get_all_styles
24 24 from pygments.token import Token
25 25
26 26 from .debugger import TerminalPdb, Pdb
27 27 from .magics import TerminalMagics
28 28 from .pt_inputhooks import get_inputhook_func
29 29 from .prompts import Prompts, ClassicPrompts, RichPromptDisplayHook
30 30 from .ptutils import IPythonPTCompleter, IPythonPTLexer
31 31 from .shortcuts import register_ipython_shortcuts
32 32
33 33 DISPLAY_BANNER_DEPRECATED = object()
34 34
35 35
36 36 from pygments.style import Style
37 37
38 38 class _NoStyle(Style): pass
39 39
40 40
41 41
42 42 _style_overrides_light_bg = {
43 43 Token.Prompt: '#0000ff',
44 44 Token.PromptNum: '#0000ee bold',
45 45 Token.OutPrompt: '#cc0000',
46 46 Token.OutPromptNum: '#bb0000 bold',
47 47 }
48 48
49 49 _style_overrides_linux = {
50 50 Token.Prompt: '#00cc00',
51 51 Token.PromptNum: '#00bb00 bold',
52 52 Token.OutPrompt: '#cc0000',
53 53 Token.OutPromptNum: '#bb0000 bold',
54 54 }
55 55
56 56
57 57
58 58 def get_default_editor():
59 59 try:
60 60 ed = os.environ['EDITOR']
61 61 if not PY3:
62 62 ed = ed.decode()
63 63 return ed
64 64 except KeyError:
65 65 pass
66 66 except UnicodeError:
67 67 warn("$EDITOR environment variable is not pure ASCII. Using platform "
68 68 "default editor.")
69 69
70 70 if os.name == 'posix':
71 71 return 'vi' # the only one guaranteed to be there!
72 72 else:
73 73 return 'notepad' # same in Windows!
74 74
75 75
76 76 if sys.stdin and sys.stdout and sys.stderr:
77 77 _is_tty = (sys.stdin.isatty()) and (sys.stdout.isatty()) and (sys.stderr.isatty())
78 78 else:
79 79 _is_tty = False
80 80
81 81
82 82 _use_simple_prompt = ('IPY_TEST_SIMPLE_PROMPT' in os.environ) or (not _is_tty)
83 83
84 84 class TerminalInteractiveShell(InteractiveShell):
85 85 space_for_menu = Integer(6, help='Number of line at the bottom of the screen '
86 86 'to reserve for the completion menu'
87 87 ).tag(config=True)
88 88
89 89 def _space_for_menu_changed(self, old, new):
90 90 self._update_layout()
91 91
92 92 pt_cli = None
93 93 debugger_history = None
94 94 _pt_app = None
95 95
96 96 simple_prompt = Bool(_use_simple_prompt,
97 97 help="""Use `raw_input` for the REPL, without completion, multiline input, and prompt colors.
98 98
99 99 Useful when controlling IPython as a subprocess, and piping STDIN/OUT/ERR. Known usage are:
100 100 IPython own testing machinery, and emacs inferior-shell integration through elpy.
101 101
102 102 This mode default to `True` if the `IPY_TEST_SIMPLE_PROMPT`
103 103 environment variable is set, or the current terminal is not a tty.
104 104
105 105 """
106 106 ).tag(config=True)
107 107
108 108 @property
109 109 def debugger_cls(self):
110 110 return Pdb if self.simple_prompt else TerminalPdb
111 111
112 112 confirm_exit = Bool(True,
113 113 help="""
114 114 Set to confirm when you try to exit IPython with an EOF (Control-D
115 115 in Unix, Control-Z/Enter in Windows). By typing 'exit' or 'quit',
116 116 you can force a direct exit without any confirmation.""",
117 117 ).tag(config=True)
118 118
119 119 editing_mode = Unicode('emacs',
120 120 help="Shortcut style to use at the prompt. 'vi' or 'emacs'.",
121 121 ).tag(config=True)
122 122
123 123 mouse_support = Bool(False,
124 124 help="Enable mouse support in the prompt"
125 125 ).tag(config=True)
126 126
127 127 highlighting_style = Unicode('legacy',
128 128 help="The name of a Pygments style to use for syntax highlighting: \n %s" % ', '.join(get_all_styles())
129 129 ).tag(config=True)
130 130
131 131
132 132 @observe('highlighting_style')
133 133 @observe('colors')
134 134 def _highlighting_style_changed(self, change):
135 135 self.refresh_style()
136 136
137 137 def refresh_style(self):
138 138 self._style = self._make_style_from_name(self.highlighting_style)
139 139
140 140
141 141 highlighting_style_overrides = Dict(
142 142 help="Override highlighting format for specific tokens"
143 143 ).tag(config=True)
144 144
145 145 true_color = Bool(False,
146 146 help=("Use 24bit colors instead of 256 colors in prompt highlighting. "
147 147 "If your terminal supports true color, the following command "
148 148 "should print 'TRUECOLOR' in orange: "
149 149 "printf \"\\x1b[38;2;255;100;0mTRUECOLOR\\x1b[0m\\n\"")
150 150 ).tag(config=True)
151 151
152 152 editor = Unicode(get_default_editor(),
153 153 help="Set the editor used by IPython (default to $EDITOR/vi/notepad)."
154 154 ).tag(config=True)
155 155
156 156 prompts_class = Type(Prompts, help='Class used to generate Prompt token for prompt_toolkit').tag(config=True)
157 157
158 158 prompts = Instance(Prompts)
159 159
160 160 @default('prompts')
161 161 def _prompts_default(self):
162 162 return self.prompts_class(self)
163 163
164 164 @observe('prompts')
165 165 def _(self, change):
166 166 self._update_layout()
167 167
168 168 @default('displayhook_class')
169 169 def _displayhook_class_default(self):
170 170 return RichPromptDisplayHook
171 171
172 172 term_title = Bool(True,
173 173 help="Automatically set the terminal title"
174 174 ).tag(config=True)
175 175
176 176 display_completions = Enum(('column', 'multicolumn','readlinelike'), default_value='multicolumn').tag(config=True)
177 177
178 178 highlight_matching_brackets = Bool(True,
179 179 help="Highlight matching brackets .",
180 180 ).tag(config=True)
181 181
182 182 @observe('term_title')
183 183 def init_term_title(self, change=None):
184 184 # Enable or disable the terminal title.
185 185 if self.term_title:
186 186 toggle_set_term_title(True)
187 187 set_term_title('IPython: ' + abbrev_cwd())
188 188 else:
189 189 toggle_set_term_title(False)
190 190
191 191 def init_display_formatter(self):
192 192 super(TerminalInteractiveShell, self).init_display_formatter()
193 193 # terminal only supports plain text
194 194 self.display_formatter.active_types = ['text/plain']
195 195
196 196 def init_prompt_toolkit_cli(self):
197 197 if self.simple_prompt:
198 198 # Fall back to plain non-interactive output for tests.
199 199 # This is very limited, and only accepts a single line.
200 200 def prompt():
201 201 return cast_unicode_py2(input('In [%d]: ' % self.execution_count))
202 202 self.prompt_for_code = prompt
203 203 return
204 204
205 205 # Set up keyboard shortcuts
206 206 kbmanager = KeyBindingManager.for_prompt()
207 207 register_ipython_shortcuts(kbmanager.registry, self)
208 208
209 209 # Pre-populate history from IPython's history database
210 210 history = InMemoryHistory()
211 211 last_cell = u""
212 212 for __, ___, cell in self.history_manager.get_tail(self.history_load_length,
213 213 include_latest=True):
214 214 # Ignore blank lines and consecutive duplicates
215 215 cell = cell.rstrip()
216 216 if cell and (cell != last_cell):
217 217 history.append(cell)
218 218
219 219 self._style = self._make_style_from_name(self.highlighting_style)
220 220 style = DynamicStyle(lambda: self._style)
221 221
222 222 editing_mode = getattr(EditingMode, self.editing_mode.upper())
223 223
224 224 self._pt_app = create_prompt_application(
225 225 editing_mode=editing_mode,
226 226 key_bindings_registry=kbmanager.registry,
227 227 history=history,
228 228 completer=IPythonPTCompleter(self.Completer),
229 229 enable_history_search=True,
230 230 style=style,
231 231 mouse_support=self.mouse_support,
232 232 **self._layout_options()
233 233 )
234 234 self._eventloop = create_eventloop(self.inputhook)
235 235 self.pt_cli = CommandLineInterface(
236 236 self._pt_app, eventloop=self._eventloop,
237 237 output=create_output(true_color=self.true_color))
238 238
239 239 def _make_style_from_name(self, name):
240 240 """
241 241 Small wrapper that make an IPython compatible style from a style name
242 242
243 243 We need that to add style for prompt ... etc.
244 244 """
245 245 style_overrides = {}
246 246 if name == 'legacy':
247 247 legacy = self.colors.lower()
248 248 if legacy == 'linux':
249 249 style_cls = get_style_by_name('monokai')
250 250 style_overrides = _style_overrides_linux
251 251 elif legacy == 'lightbg':
252 252 style_overrides = _style_overrides_light_bg
253 253 style_cls = get_style_by_name('pastie')
254 254 elif legacy == 'neutral':
255 255 # The default theme needs to be visible on both a dark background
256 256 # and a light background, because we can't tell what the terminal
257 257 # looks like. These tweaks to the default theme help with that.
258 258 style_cls = get_style_by_name('default')
259 259 style_overrides.update({
260 260 Token.Number: '#007700',
261 261 Token.Operator: 'noinherit',
262 262 Token.String: '#BB6622',
263 263 Token.Name.Function: '#2080D0',
264 264 Token.Name.Class: 'bold #2080D0',
265 265 Token.Name.Namespace: 'bold #2080D0',
266 266 Token.Prompt: '#009900',
267 267 Token.PromptNum: '#00ff00 bold',
268 268 Token.OutPrompt: '#990000',
269 269 Token.OutPromptNum: '#ff0000 bold',
270 270 })
271 271 elif legacy =='nocolor':
272 272 style_cls=_NoStyle
273 273 style_overrides = {}
274 274 else :
275 275 raise ValueError('Got unknown colors: ', legacy)
276 276 else :
277 277 style_cls = get_style_by_name(name)
278 278 style_overrides = {
279 279 Token.Prompt: '#009900',
280 280 Token.PromptNum: '#00ff00 bold',
281 281 Token.OutPrompt: '#990000',
282 282 Token.OutPromptNum: '#ff0000 bold',
283 283 }
284 284 style_overrides.update(self.highlighting_style_overrides)
285 285 style = PygmentsStyle.from_defaults(pygments_style_cls=style_cls,
286 286 style_dict=style_overrides)
287 287
288 288 return style
289 289
290 290 def _layout_options(self):
291 291 """
292 292 Return the current layout option for the current Terminal InteractiveShell
293 293 """
294 294 return {
295 295 'lexer':IPythonPTLexer(),
296 296 'reserve_space_for_menu':self.space_for_menu,
297 297 'get_prompt_tokens':self.prompts.in_prompt_tokens,
298 298 'get_continuation_tokens':self.prompts.continuation_prompt_tokens,
299 299 'multiline':True,
300 300 'display_completions_in_columns': (self.display_completions == 'multicolumn'),
301 301
302 302 # Highlight matching brackets, but only when this setting is
303 303 # enabled, and only when the DEFAULT_BUFFER has the focus.
304 304 'extra_input_processors': [ConditionalProcessor(
305 305 processor=HighlightMatchingBracketProcessor(chars='[](){}'),
306 306 filter=HasFocus(DEFAULT_BUFFER) & ~IsDone() &
307 307 Condition(lambda cli: self.highlight_matching_brackets))],
308 308 }
309 309
310 310 def _update_layout(self):
311 311 """
312 312 Ask for a re computation of the application layout, if for example ,
313 313 some configuration options have changed.
314 314 """
315 315 if self._pt_app:
316 316 self._pt_app.layout = create_prompt_layout(**self._layout_options())
317 317
318 318 def prompt_for_code(self):
319 319 document = self.pt_cli.run(
320 320 pre_run=self.pre_prompt, reset_current_buffer=True)
321 321 return document.text
322 322
323 def enable_win_unicode_console(self):
324 import win_unicode_console
325
326 if PY3:
327 win_unicode_console.enable()
328 else:
329 # https://github.com/ipython/ipython/issues/9768
330 from win_unicode_console.streams import (TextStreamWrapper,
331 stdout_text_transcoded, stderr_text_transcoded)
332
333 class LenientStrStreamWrapper(TextStreamWrapper):
334 def write(self, s):
335 if isinstance(s, bytes):
336 s = s.decode(self.encoding, 'replace')
337
338 self.base.write(s)
339
340 stdout_text_str = LenientStrStreamWrapper(stdout_text_transcoded)
341 stderr_text_str = LenientStrStreamWrapper(stderr_text_transcoded)
342
343 win_unicode_console.enable(stdout=stdout_text_str,
344 stderr=stderr_text_str)
345
323 346 def init_io(self):
324 347 if sys.platform not in {'win32', 'cli'}:
325 348 return
326 349
327 import win_unicode_console
328 import colorama
350 self.enable_win_unicode_console()
329 351
330 win_unicode_console.enable()
352 import colorama
331 353 colorama.init()
332 354
333 355 # For some reason we make these wrappers around stdout/stderr.
334 356 # For now, we need to reset them so all output gets coloured.
335 357 # https://github.com/ipython/ipython/issues/8669
336 358 from IPython.utils import io
337 359 io.stdout = io.IOStream(sys.stdout)
338 360 io.stderr = io.IOStream(sys.stderr)
339 361
340 362 def init_magics(self):
341 363 super(TerminalInteractiveShell, self).init_magics()
342 364 self.register_magics(TerminalMagics)
343 365
344 366 def init_alias(self):
345 367 # The parent class defines aliases that can be safely used with any
346 368 # frontend.
347 369 super(TerminalInteractiveShell, self).init_alias()
348 370
349 371 # Now define aliases that only make sense on the terminal, because they
350 372 # need direct access to the console in a way that we can't emulate in
351 373 # GUI or web frontend
352 374 if os.name == 'posix':
353 375 for cmd in ['clear', 'more', 'less', 'man']:
354 376 self.alias_manager.soft_define_alias(cmd, cmd)
355 377
356 378
357 379 def __init__(self, *args, **kwargs):
358 380 super(TerminalInteractiveShell, self).__init__(*args, **kwargs)
359 381 self.init_prompt_toolkit_cli()
360 382 self.init_term_title()
361 383 self.keep_running = True
362 384
363 385 self.debugger_history = InMemoryHistory()
364 386
365 387 def ask_exit(self):
366 388 self.keep_running = False
367 389
368 390 rl_next_input = None
369 391
370 392 def pre_prompt(self):
371 393 if self.rl_next_input:
372 394 self.pt_cli.application.buffer.text = cast_unicode_py2(self.rl_next_input)
373 395 self.rl_next_input = None
374 396
375 397 def interact(self, display_banner=DISPLAY_BANNER_DEPRECATED):
376 398
377 399 if display_banner is not DISPLAY_BANNER_DEPRECATED:
378 400 warn('interact `display_banner` argument is deprecated since IPython 5.0. Call `show_banner()` if needed.', DeprecationWarning, stacklevel=2)
379 401
380 402 while self.keep_running:
381 403 print(self.separate_in, end='')
382 404
383 405 try:
384 406 code = self.prompt_for_code()
385 407 except EOFError:
386 408 if (not self.confirm_exit) \
387 409 or self.ask_yes_no('Do you really want to exit ([y]/n)?','y','n'):
388 410 self.ask_exit()
389 411
390 412 else:
391 413 if code:
392 414 self.run_cell(code, store_history=True)
393 415
394 416 def mainloop(self, display_banner=DISPLAY_BANNER_DEPRECATED):
395 417 # An extra layer of protection in case someone mashing Ctrl-C breaks
396 418 # out of our internal code.
397 419 if display_banner is not DISPLAY_BANNER_DEPRECATED:
398 420 warn('mainloop `display_banner` argument is deprecated since IPython 5.0. Call `show_banner()` if needed.', DeprecationWarning, stacklevel=2)
399 421 while True:
400 422 try:
401 423 self.interact()
402 424 break
403 425 except KeyboardInterrupt:
404 426 print("\nKeyboardInterrupt escaped interact()\n")
405 427
406 428 if hasattr(self, '_eventloop'):
407 429 self._eventloop.close()
408 430
409 431 _inputhook = None
410 432 def inputhook(self, context):
411 433 if self._inputhook is not None:
412 434 self._inputhook(context)
413 435
414 436 def enable_gui(self, gui=None):
415 437 if gui:
416 438 self._inputhook = get_inputhook_func(gui)
417 439 else:
418 440 self._inputhook = None
419 441
420 442 # Run !system commands directly, not through pipes, so terminal programs
421 443 # work correctly.
422 444 system = InteractiveShell.system_raw
423 445
424 446 def auto_rewrite_input(self, cmd):
425 447 """Overridden from the parent class to use fancy rewriting prompt"""
426 448 if not self.show_rewritten_input:
427 449 return
428 450
429 451 tokens = self.prompts.rewrite_prompt_tokens()
430 452 if self.pt_cli:
431 453 self.pt_cli.print_tokens(tokens)
432 454 print(cmd)
433 455 else:
434 456 prompt = ''.join(s for t, s in tokens)
435 457 print(prompt, cmd, sep='')
436 458
437 459 _prompts_before = None
438 460 def switch_doctest_mode(self, mode):
439 461 """Switch prompts to classic for %doctest_mode"""
440 462 if mode:
441 463 self._prompts_before = self.prompts
442 464 self.prompts = ClassicPrompts(self)
443 465 elif self._prompts_before:
444 466 self.prompts = self._prompts_before
445 467 self._prompts_before = None
446 468 self._update_layout()
447 469
448 470
449 471 InteractiveShellABC.register(TerminalInteractiveShell)
450 472
451 473 if __name__ == '__main__':
452 474 TerminalInteractiveShell.instance().interact()
General Comments 0
You need to be logged in to leave comments. Login now