##// END OF EJS Templates
don't display profile in banner if default
MinRK -
Show More
@@ -1,590 +1,590 b''
1 1 # -*- coding: utf-8 -*-
2 2 """Subclass of InteractiveShell for terminal based frontends."""
3 3
4 4 #-----------------------------------------------------------------------------
5 5 # Copyright (C) 2001 Janko Hauser <jhauser@zscout.de>
6 6 # Copyright (C) 2001-2007 Fernando Perez. <fperez@colorado.edu>
7 7 # Copyright (C) 2008-2010 The IPython Development Team
8 8 #
9 9 # Distributed under the terms of the BSD License. The full license is in
10 10 # the file COPYING, distributed as part of this software.
11 11 #-----------------------------------------------------------------------------
12 12
13 13 #-----------------------------------------------------------------------------
14 14 # Imports
15 15 #-----------------------------------------------------------------------------
16 16
17 17 import __builtin__
18 18 import bdb
19 19 from contextlib import nested
20 20 import os
21 21 import re
22 22 import sys
23 23
24 24 from IPython.core.error import TryNext
25 25 from IPython.core.usage import interactive_usage, default_banner
26 26 from IPython.core.interactiveshell import InteractiveShell, InteractiveShellABC
27 27 from IPython.lib.inputhook import enable_gui
28 28 from IPython.lib.pylabtools import pylab_activate
29 29 from IPython.testing.skipdoctest import skip_doctest
30 30 from IPython.utils.terminal import toggle_set_term_title, set_term_title
31 31 from IPython.utils.process import abbrev_cwd
32 32 from IPython.utils.warn import warn
33 33 from IPython.utils.text import num_ini_spaces
34 34 from IPython.utils.traitlets import Int, Str, CBool, Unicode
35 35
36 36 #-----------------------------------------------------------------------------
37 37 # Utilities
38 38 #-----------------------------------------------------------------------------
39 39
40 40 def get_default_editor():
41 41 try:
42 42 ed = os.environ['EDITOR']
43 43 except KeyError:
44 44 if os.name == 'posix':
45 45 ed = 'vi' # the only one guaranteed to be there!
46 46 else:
47 47 ed = 'notepad' # same in Windows!
48 48 return ed
49 49
50 50
51 51 # store the builtin raw_input globally, and use this always, in case user code
52 52 # overwrites it (like wx.py.PyShell does)
53 53 raw_input_original = raw_input
54 54
55 55 #-----------------------------------------------------------------------------
56 56 # Main class
57 57 #-----------------------------------------------------------------------------
58 58
59 59 class TerminalInteractiveShell(InteractiveShell):
60 60
61 61 autoedit_syntax = CBool(False, config=True,
62 62 help="auto editing of files with syntax errors.")
63 63 banner = Unicode('')
64 64 banner1 = Unicode(default_banner, config=True,
65 65 help="""The part of the banner to be printed before the profile"""
66 66 )
67 67 banner2 = Unicode('', config=True,
68 68 help="""The part of the banner to be printed after the profile"""
69 69 )
70 70 confirm_exit = CBool(True, config=True,
71 71 help="""
72 72 Set to confirm when you try to exit IPython with an EOF (Control-D
73 73 in Unix, Control-Z/Enter in Windows). By typing 'exit' or 'quit',
74 74 you can force a direct exit without any confirmation.""",
75 75 )
76 76 # This display_banner only controls whether or not self.show_banner()
77 77 # is called when mainloop/interact are called. The default is False
78 78 # because for the terminal based application, the banner behavior
79 79 # is controlled by Global.display_banner, which IPythonApp looks at
80 80 # to determine if *it* should call show_banner() by hand or not.
81 81 display_banner = CBool(False) # This isn't configurable!
82 82 embedded = CBool(False)
83 83 embedded_active = CBool(False)
84 84 editor = Unicode(get_default_editor(), config=True,
85 85 help="Set the editor used by IPython (default to $EDITOR/vi/notepad)."
86 86 )
87 87 pager = Unicode('less', config=True,
88 88 help="The shell program to be used for paging.")
89 89
90 90 screen_length = Int(0, config=True,
91 91 help=
92 92 """Number of lines of your screen, used to control printing of very
93 93 long strings. Strings longer than this number of lines will be sent
94 94 through a pager instead of directly printed. The default value for
95 95 this is 0, which means IPython will auto-detect your screen size every
96 96 time it needs to print certain potentially long strings (this doesn't
97 97 change the behavior of the 'print' keyword, it's only triggered
98 98 internally). If for some reason this isn't working well (it needs
99 99 curses support), specify it yourself. Otherwise don't change the
100 100 default.""",
101 101 )
102 102 term_title = CBool(False, config=True,
103 103 help="Enable auto setting the terminal title."
104 104 )
105 105
106 106 def __init__(self, config=None, ipython_dir=None, profile_dir=None, user_ns=None,
107 107 user_global_ns=None, custom_exceptions=((),None),
108 108 usage=None, banner1=None, banner2=None,
109 109 display_banner=None):
110 110
111 111 super(TerminalInteractiveShell, self).__init__(
112 112 config=config, profile_dir=profile_dir, user_ns=user_ns,
113 113 user_global_ns=user_global_ns, custom_exceptions=custom_exceptions
114 114 )
115 115 # use os.system instead of utils.process.system by default, except on Windows
116 116 if os.name == 'nt':
117 117 self.system = self.system_piped
118 118 else:
119 119 self.system = self.system_raw
120 120
121 121 self.init_term_title()
122 122 self.init_usage(usage)
123 123 self.init_banner(banner1, banner2, display_banner)
124 124
125 125 #-------------------------------------------------------------------------
126 126 # Things related to the terminal
127 127 #-------------------------------------------------------------------------
128 128
129 129 @property
130 130 def usable_screen_length(self):
131 131 if self.screen_length == 0:
132 132 return 0
133 133 else:
134 134 num_lines_bot = self.separate_in.count('\n')+1
135 135 return self.screen_length - num_lines_bot
136 136
137 137 def init_term_title(self):
138 138 # Enable or disable the terminal title.
139 139 if self.term_title:
140 140 toggle_set_term_title(True)
141 141 set_term_title('IPython: ' + abbrev_cwd())
142 142 else:
143 143 toggle_set_term_title(False)
144 144
145 145 #-------------------------------------------------------------------------
146 146 # Things related to aliases
147 147 #-------------------------------------------------------------------------
148 148
149 149 def init_alias(self):
150 150 # The parent class defines aliases that can be safely used with any
151 151 # frontend.
152 152 super(TerminalInteractiveShell, self).init_alias()
153 153
154 154 # Now define aliases that only make sense on the terminal, because they
155 155 # need direct access to the console in a way that we can't emulate in
156 156 # GUI or web frontend
157 157 if os.name == 'posix':
158 158 aliases = [('clear', 'clear'), ('more', 'more'), ('less', 'less'),
159 159 ('man', 'man')]
160 160 elif os.name == 'nt':
161 161 aliases = [('cls', 'cls')]
162 162
163 163
164 164 for name, cmd in aliases:
165 165 self.alias_manager.define_alias(name, cmd)
166 166
167 167 #-------------------------------------------------------------------------
168 168 # Things related to the banner and usage
169 169 #-------------------------------------------------------------------------
170 170
171 171 def _banner1_changed(self):
172 172 self.compute_banner()
173 173
174 174 def _banner2_changed(self):
175 175 self.compute_banner()
176 176
177 177 def _term_title_changed(self, name, new_value):
178 178 self.init_term_title()
179 179
180 180 def init_banner(self, banner1, banner2, display_banner):
181 181 if banner1 is not None:
182 182 self.banner1 = banner1
183 183 if banner2 is not None:
184 184 self.banner2 = banner2
185 185 if display_banner is not None:
186 186 self.display_banner = display_banner
187 187 self.compute_banner()
188 188
189 189 def show_banner(self, banner=None):
190 190 if banner is None:
191 191 banner = self.banner
192 192 self.write(banner)
193 193
194 194 def compute_banner(self):
195 195 self.banner = self.banner1
196 if self.profile:
196 if self.profile and self.profile != 'default':
197 197 self.banner += '\nIPython profile: %s\n' % self.profile
198 198 if self.banner2:
199 199 self.banner += '\n' + self.banner2
200 200
201 201 def init_usage(self, usage=None):
202 202 if usage is None:
203 203 self.usage = interactive_usage
204 204 else:
205 205 self.usage = usage
206 206
207 207 #-------------------------------------------------------------------------
208 208 # Mainloop and code execution logic
209 209 #-------------------------------------------------------------------------
210 210
211 211 def mainloop(self, display_banner=None):
212 212 """Start the mainloop.
213 213
214 214 If an optional banner argument is given, it will override the
215 215 internally created default banner.
216 216 """
217 217
218 218 with nested(self.builtin_trap, self.display_trap):
219 219
220 220 while 1:
221 221 try:
222 222 self.interact(display_banner=display_banner)
223 223 #self.interact_with_readline()
224 224 # XXX for testing of a readline-decoupled repl loop, call
225 225 # interact_with_readline above
226 226 break
227 227 except KeyboardInterrupt:
228 228 # this should not be necessary, but KeyboardInterrupt
229 229 # handling seems rather unpredictable...
230 230 self.write("\nKeyboardInterrupt in interact()\n")
231 231
232 232 def interact(self, display_banner=None):
233 233 """Closely emulate the interactive Python console."""
234 234
235 235 # batch run -> do not interact
236 236 if self.exit_now:
237 237 return
238 238
239 239 if display_banner is None:
240 240 display_banner = self.display_banner
241 241 if display_banner:
242 242 self.show_banner()
243 243
244 244 more = False
245 245
246 246 # Mark activity in the builtins
247 247 __builtin__.__dict__['__IPYTHON__active'] += 1
248 248
249 249 if self.has_readline:
250 250 self.readline_startup_hook(self.pre_readline)
251 251 # exit_now is set by a call to %Exit or %Quit, through the
252 252 # ask_exit callback.
253 253
254 254 while not self.exit_now:
255 255 self.hooks.pre_prompt_hook()
256 256 if more:
257 257 try:
258 258 prompt = self.hooks.generate_prompt(True)
259 259 except:
260 260 self.showtraceback()
261 261 if self.autoindent:
262 262 self.rl_do_indent = True
263 263
264 264 else:
265 265 try:
266 266 prompt = self.hooks.generate_prompt(False)
267 267 except:
268 268 self.showtraceback()
269 269 try:
270 270 line = self.raw_input(prompt)
271 271 if self.exit_now:
272 272 # quick exit on sys.std[in|out] close
273 273 break
274 274 if self.autoindent:
275 275 self.rl_do_indent = False
276 276
277 277 except KeyboardInterrupt:
278 278 #double-guard against keyboardinterrupts during kbdint handling
279 279 try:
280 280 self.write('\nKeyboardInterrupt\n')
281 281 self.input_splitter.reset()
282 282 more = False
283 283 except KeyboardInterrupt:
284 284 pass
285 285 except EOFError:
286 286 if self.autoindent:
287 287 self.rl_do_indent = False
288 288 if self.has_readline:
289 289 self.readline_startup_hook(None)
290 290 self.write('\n')
291 291 self.exit()
292 292 except bdb.BdbQuit:
293 293 warn('The Python debugger has exited with a BdbQuit exception.\n'
294 294 'Because of how pdb handles the stack, it is impossible\n'
295 295 'for IPython to properly format this particular exception.\n'
296 296 'IPython will resume normal operation.')
297 297 except:
298 298 # exceptions here are VERY RARE, but they can be triggered
299 299 # asynchronously by signal handlers, for example.
300 300 self.showtraceback()
301 301 else:
302 302 self.input_splitter.push(line)
303 303 more = self.input_splitter.push_accepts_more()
304 304 if (self.SyntaxTB.last_syntax_error and
305 305 self.autoedit_syntax):
306 306 self.edit_syntax_error()
307 307 if not more:
308 308 source_raw = self.input_splitter.source_raw_reset()[1]
309 309 self.run_cell(source_raw)
310 310
311 311 # We are off again...
312 312 __builtin__.__dict__['__IPYTHON__active'] -= 1
313 313
314 314 # Turn off the exit flag, so the mainloop can be restarted if desired
315 315 self.exit_now = False
316 316
317 317 def raw_input(self, prompt=''):
318 318 """Write a prompt and read a line.
319 319
320 320 The returned line does not include the trailing newline.
321 321 When the user enters the EOF key sequence, EOFError is raised.
322 322
323 323 Optional inputs:
324 324
325 325 - prompt(''): a string to be printed to prompt the user.
326 326
327 327 - continue_prompt(False): whether this line is the first one or a
328 328 continuation in a sequence of inputs.
329 329 """
330 330 # Code run by the user may have modified the readline completer state.
331 331 # We must ensure that our completer is back in place.
332 332
333 333 if self.has_readline:
334 334 self.set_readline_completer()
335 335
336 336 try:
337 337 line = raw_input_original(prompt).decode(self.stdin_encoding)
338 338 except ValueError:
339 339 warn("\n********\nYou or a %run:ed script called sys.stdin.close()"
340 340 " or sys.stdout.close()!\nExiting IPython!")
341 341 self.ask_exit()
342 342 return ""
343 343
344 344 # Try to be reasonably smart about not re-indenting pasted input more
345 345 # than necessary. We do this by trimming out the auto-indent initial
346 346 # spaces, if the user's actual input started itself with whitespace.
347 347 if self.autoindent:
348 348 if num_ini_spaces(line) > self.indent_current_nsp:
349 349 line = line[self.indent_current_nsp:]
350 350 self.indent_current_nsp = 0
351 351
352 352 return line
353 353
354 354 #-------------------------------------------------------------------------
355 355 # Methods to support auto-editing of SyntaxErrors.
356 356 #-------------------------------------------------------------------------
357 357
358 358 def edit_syntax_error(self):
359 359 """The bottom half of the syntax error handler called in the main loop.
360 360
361 361 Loop until syntax error is fixed or user cancels.
362 362 """
363 363
364 364 while self.SyntaxTB.last_syntax_error:
365 365 # copy and clear last_syntax_error
366 366 err = self.SyntaxTB.clear_err_state()
367 367 if not self._should_recompile(err):
368 368 return
369 369 try:
370 370 # may set last_syntax_error again if a SyntaxError is raised
371 371 self.safe_execfile(err.filename,self.user_ns)
372 372 except:
373 373 self.showtraceback()
374 374 else:
375 375 try:
376 376 f = file(err.filename)
377 377 try:
378 378 # This should be inside a display_trap block and I
379 379 # think it is.
380 380 sys.displayhook(f.read())
381 381 finally:
382 382 f.close()
383 383 except:
384 384 self.showtraceback()
385 385
386 386 def _should_recompile(self,e):
387 387 """Utility routine for edit_syntax_error"""
388 388
389 389 if e.filename in ('<ipython console>','<input>','<string>',
390 390 '<console>','<BackgroundJob compilation>',
391 391 None):
392 392
393 393 return False
394 394 try:
395 395 if (self.autoedit_syntax and
396 396 not self.ask_yes_no('Return to editor to correct syntax error? '
397 397 '[Y/n] ','y')):
398 398 return False
399 399 except EOFError:
400 400 return False
401 401
402 402 def int0(x):
403 403 try:
404 404 return int(x)
405 405 except TypeError:
406 406 return 0
407 407 # always pass integer line and offset values to editor hook
408 408 try:
409 409 self.hooks.fix_error_editor(e.filename,
410 410 int0(e.lineno),int0(e.offset),e.msg)
411 411 except TryNext:
412 412 warn('Could not open editor')
413 413 return False
414 414 return True
415 415
416 416 #-------------------------------------------------------------------------
417 417 # Things related to GUI support and pylab
418 418 #-------------------------------------------------------------------------
419 419
420 420 def enable_pylab(self, gui=None):
421 421 """Activate pylab support at runtime.
422 422
423 423 This turns on support for matplotlib, preloads into the interactive
424 424 namespace all of numpy and pylab, and configures IPython to correcdtly
425 425 interact with the GUI event loop. The GUI backend to be used can be
426 426 optionally selected with the optional :param:`gui` argument.
427 427
428 428 Parameters
429 429 ----------
430 430 gui : optional, string
431 431
432 432 If given, dictates the choice of matplotlib GUI backend to use
433 433 (should be one of IPython's supported backends, 'tk', 'qt', 'wx' or
434 434 'gtk'), otherwise we use the default chosen by matplotlib (as
435 435 dictated by the matplotlib build-time options plus the user's
436 436 matplotlibrc configuration file).
437 437 """
438 438 # We want to prevent the loading of pylab to pollute the user's
439 439 # namespace as shown by the %who* magics, so we execute the activation
440 440 # code in an empty namespace, and we update *both* user_ns and
441 441 # user_ns_hidden with this information.
442 442 ns = {}
443 443 gui = pylab_activate(ns, gui)
444 444 self.user_ns.update(ns)
445 445 self.user_ns_hidden.update(ns)
446 446 # Now we must activate the gui pylab wants to use, and fix %run to take
447 447 # plot updates into account
448 448 enable_gui(gui)
449 449 self.magic_run = self._pylab_magic_run
450 450
451 451 #-------------------------------------------------------------------------
452 452 # Things related to exiting
453 453 #-------------------------------------------------------------------------
454 454
455 455 def ask_exit(self):
456 456 """ Ask the shell to exit. Can be overiden and used as a callback. """
457 457 self.exit_now = True
458 458
459 459 def exit(self):
460 460 """Handle interactive exit.
461 461
462 462 This method calls the ask_exit callback."""
463 463 if self.confirm_exit:
464 464 if self.ask_yes_no('Do you really want to exit ([y]/n)?','y'):
465 465 self.ask_exit()
466 466 else:
467 467 self.ask_exit()
468 468
469 469 #------------------------------------------------------------------------
470 470 # Magic overrides
471 471 #------------------------------------------------------------------------
472 472 # Once the base class stops inheriting from magic, this code needs to be
473 473 # moved into a separate machinery as well. For now, at least isolate here
474 474 # the magics which this class needs to implement differently from the base
475 475 # class, or that are unique to it.
476 476
477 477 def magic_autoindent(self, parameter_s = ''):
478 478 """Toggle autoindent on/off (if available)."""
479 479
480 480 self.shell.set_autoindent()
481 481 print "Automatic indentation is:",['OFF','ON'][self.shell.autoindent]
482 482
483 483 @skip_doctest
484 484 def magic_cpaste(self, parameter_s=''):
485 485 """Paste & execute a pre-formatted code block from clipboard.
486 486
487 487 You must terminate the block with '--' (two minus-signs) alone on the
488 488 line. You can also provide your own sentinel with '%paste -s %%' ('%%'
489 489 is the new sentinel for this operation)
490 490
491 491 The block is dedented prior to execution to enable execution of method
492 492 definitions. '>' and '+' characters at the beginning of a line are
493 493 ignored, to allow pasting directly from e-mails, diff files and
494 494 doctests (the '...' continuation prompt is also stripped). The
495 495 executed block is also assigned to variable named 'pasted_block' for
496 496 later editing with '%edit pasted_block'.
497 497
498 498 You can also pass a variable name as an argument, e.g. '%cpaste foo'.
499 499 This assigns the pasted block to variable 'foo' as string, without
500 500 dedenting or executing it (preceding >>> and + is still stripped)
501 501
502 502 '%cpaste -r' re-executes the block previously entered by cpaste.
503 503
504 504 Do not be alarmed by garbled output on Windows (it's a readline bug).
505 505 Just press enter and type -- (and press enter again) and the block
506 506 will be what was just pasted.
507 507
508 508 IPython statements (magics, shell escapes) are not supported (yet).
509 509
510 510 See also
511 511 --------
512 512 paste: automatically pull code from clipboard.
513 513
514 514 Examples
515 515 --------
516 516 ::
517 517
518 518 In [8]: %cpaste
519 519 Pasting code; enter '--' alone on the line to stop.
520 520 :>>> a = ["world!", "Hello"]
521 521 :>>> print " ".join(sorted(a))
522 522 :--
523 523 Hello world!
524 524 """
525 525
526 526 opts,args = self.parse_options(parameter_s,'rs:',mode='string')
527 527 par = args.strip()
528 528 if opts.has_key('r'):
529 529 self._rerun_pasted()
530 530 return
531 531
532 532 sentinel = opts.get('s','--')
533 533
534 534 block = self._strip_pasted_lines_for_code(
535 535 self._get_pasted_lines(sentinel))
536 536
537 537 self._execute_block(block, par)
538 538
539 539 def magic_paste(self, parameter_s=''):
540 540 """Paste & execute a pre-formatted code block from clipboard.
541 541
542 542 The text is pulled directly from the clipboard without user
543 543 intervention and printed back on the screen before execution (unless
544 544 the -q flag is given to force quiet mode).
545 545
546 546 The block is dedented prior to execution to enable execution of method
547 547 definitions. '>' and '+' characters at the beginning of a line are
548 548 ignored, to allow pasting directly from e-mails, diff files and
549 549 doctests (the '...' continuation prompt is also stripped). The
550 550 executed block is also assigned to variable named 'pasted_block' for
551 551 later editing with '%edit pasted_block'.
552 552
553 553 You can also pass a variable name as an argument, e.g. '%paste foo'.
554 554 This assigns the pasted block to variable 'foo' as string, without
555 555 dedenting or executing it (preceding >>> and + is still stripped)
556 556
557 557 Options
558 558 -------
559 559
560 560 -r: re-executes the block previously entered by cpaste.
561 561
562 562 -q: quiet mode: do not echo the pasted text back to the terminal.
563 563
564 564 IPython statements (magics, shell escapes) are not supported (yet).
565 565
566 566 See also
567 567 --------
568 568 cpaste: manually paste code into terminal until you mark its end.
569 569 """
570 570 opts,args = self.parse_options(parameter_s,'rq',mode='string')
571 571 par = args.strip()
572 572 if opts.has_key('r'):
573 573 self._rerun_pasted()
574 574 return
575 575
576 576 text = self.shell.hooks.clipboard_get()
577 577 block = self._strip_pasted_lines_for_code(text.splitlines())
578 578
579 579 # By default, echo back to terminal unless quiet mode is requested
580 580 if not opts.has_key('q'):
581 581 write = self.shell.write
582 582 write(self.shell.pycolorize(block))
583 583 if not block.endswith('\n'):
584 584 write('\n')
585 585 write("## -- End pasted text --\n")
586 586
587 587 self._execute_block(block, par)
588 588
589 589
590 590 InteractiveShellABC.register(TerminalInteractiveShell)
General Comments 0
You need to be logged in to leave comments. Login now