##// END OF EJS Templates
Fix indentation not multiple of 4 and double import
Matthias Bussonnier -
Show More
@@ -1,3210 +1,3210 b''
1 # -*- coding: utf-8 -*-
1 # -*- coding: utf-8 -*-
2 """Main IPython class."""
2 """Main IPython class."""
3
3
4 #-----------------------------------------------------------------------------
4 #-----------------------------------------------------------------------------
5 # Copyright (C) 2001 Janko Hauser <jhauser@zscout.de>
5 # Copyright (C) 2001 Janko Hauser <jhauser@zscout.de>
6 # Copyright (C) 2001-2007 Fernando Perez. <fperez@colorado.edu>
6 # Copyright (C) 2001-2007 Fernando Perez. <fperez@colorado.edu>
7 # Copyright (C) 2008-2011 The IPython Development Team
7 # Copyright (C) 2008-2011 The IPython Development Team
8 #
8 #
9 # Distributed under the terms of the BSD License. The full license is in
9 # Distributed under the terms of the BSD License. The full license is in
10 # the file COPYING, distributed as part of this software.
10 # the file COPYING, distributed as part of this software.
11 #-----------------------------------------------------------------------------
11 #-----------------------------------------------------------------------------
12
12
13
13
14 import abc
14 import abc
15 import ast
15 import ast
16 import atexit
16 import atexit
17 import builtins as builtin_mod
17 import builtins as builtin_mod
18 import functools
18 import functools
19 import os
19 import os
20 import re
20 import re
21 import runpy
21 import runpy
22 import sys
22 import sys
23 import tempfile
23 import tempfile
24 import traceback
24 import traceback
25 import types
25 import types
26 import subprocess
26 import subprocess
27 import warnings
27 import warnings
28 from io import open as io_open
28 from io import open as io_open
29
29
30 from pickleshare import PickleShareDB
30 from pickleshare import PickleShareDB
31
31
32 from traitlets.config.configurable import SingletonConfigurable
32 from traitlets.config.configurable import SingletonConfigurable
33 from IPython.core import oinspect
33 from IPython.core import oinspect
34 from IPython.core import magic
34 from IPython.core import magic
35 from IPython.core import page
35 from IPython.core import page
36 from IPython.core import prefilter
36 from IPython.core import prefilter
37 from IPython.core import shadowns
37 from IPython.core import shadowns
38 from IPython.core import ultratb
38 from IPython.core import ultratb
39 from IPython.core.alias import Alias, AliasManager
39 from IPython.core.alias import Alias, AliasManager
40 from IPython.core.autocall import ExitAutocall
40 from IPython.core.autocall import ExitAutocall
41 from IPython.core.builtin_trap import BuiltinTrap
41 from IPython.core.builtin_trap import BuiltinTrap
42 from IPython.core.events import EventManager, available_events
42 from IPython.core.events import EventManager, available_events
43 from IPython.core.compilerop import CachingCompiler, check_linecache_ipython
43 from IPython.core.compilerop import CachingCompiler, check_linecache_ipython
44 from IPython.core.debugger import Pdb
44 from IPython.core.debugger import Pdb
45 from IPython.core.display_trap import DisplayTrap
45 from IPython.core.display_trap import DisplayTrap
46 from IPython.core.displayhook import DisplayHook
46 from IPython.core.displayhook import DisplayHook
47 from IPython.core.displaypub import DisplayPublisher
47 from IPython.core.displaypub import DisplayPublisher
48 from IPython.core.error import InputRejected, UsageError
48 from IPython.core.error import InputRejected, UsageError
49 from IPython.core.extensions import ExtensionManager
49 from IPython.core.extensions import ExtensionManager
50 from IPython.core.formatters import DisplayFormatter
50 from IPython.core.formatters import DisplayFormatter
51 from IPython.core.history import HistoryManager
51 from IPython.core.history import HistoryManager
52 from IPython.core.inputsplitter import ESC_MAGIC, ESC_MAGIC2
52 from IPython.core.inputsplitter import ESC_MAGIC, ESC_MAGIC2
53 from IPython.core.logger import Logger
53 from IPython.core.logger import Logger
54 from IPython.core.macro import Macro
54 from IPython.core.macro import Macro
55 from IPython.core.payload import PayloadManager
55 from IPython.core.payload import PayloadManager
56 from IPython.core.prefilter import PrefilterManager
56 from IPython.core.prefilter import PrefilterManager
57 from IPython.core.profiledir import ProfileDir
57 from IPython.core.profiledir import ProfileDir
58 from IPython.core.usage import default_banner
58 from IPython.core.usage import default_banner
59 from IPython.testing.skipdoctest import skip_doctest
59 from IPython.testing.skipdoctest import skip_doctest
60 from IPython.utils import PyColorize
60 from IPython.utils import PyColorize
61 from IPython.utils import io
61 from IPython.utils import io
62 from IPython.utils import py3compat
62 from IPython.utils import py3compat
63 from IPython.utils import openpy
63 from IPython.utils import openpy
64 from IPython.utils.decorators import undoc
64 from IPython.utils.decorators import undoc
65 from IPython.utils.io import ask_yes_no
65 from IPython.utils.io import ask_yes_no
66 from IPython.utils.ipstruct import Struct
66 from IPython.utils.ipstruct import Struct
67 from IPython.paths import get_ipython_dir
67 from IPython.paths import get_ipython_dir
68 from IPython.utils.path import get_home_dir, get_py_filename, ensure_dir_exists
68 from IPython.utils.path import get_home_dir, get_py_filename, ensure_dir_exists
69 from IPython.utils.process import system, getoutput
69 from IPython.utils.process import system, getoutput
70 from IPython.utils.strdispatch import StrDispatch
70 from IPython.utils.strdispatch import StrDispatch
71 from IPython.utils.syspathcontext import prepended_to_syspath
71 from IPython.utils.syspathcontext import prepended_to_syspath
72 from IPython.utils.text import format_screen, LSString, SList, DollarFormatter
72 from IPython.utils.text import format_screen, LSString, SList, DollarFormatter
73 from IPython.utils.tempdir import TemporaryDirectory
73 from IPython.utils.tempdir import TemporaryDirectory
74 from traitlets import (
74 from traitlets import (
75 Integer, Bool, CaselessStrEnum, Enum, List, Dict, Unicode, Instance, Type,
75 Integer, Bool, CaselessStrEnum, Enum, List, Dict, Unicode, Instance, Type,
76 observe, default,
76 observe, default,
77 )
77 )
78 from warnings import warn
78 from warnings import warn
79 from logging import error
79 from logging import error
80 import IPython.core.hooks
80 import IPython.core.hooks
81
81
82 # NoOpContext is deprecated, but ipykernel imports it from here.
82 # NoOpContext is deprecated, but ipykernel imports it from here.
83 # See https://github.com/ipython/ipykernel/issues/157
83 # See https://github.com/ipython/ipykernel/issues/157
84 from IPython.utils.contexts import NoOpContext
84 from IPython.utils.contexts import NoOpContext
85
85
86 try:
86 try:
87 import docrepr.sphinxify as sphx
87 import docrepr.sphinxify as sphx
88
88
89 def sphinxify(doc):
89 def sphinxify(doc):
90 with TemporaryDirectory() as dirname:
90 with TemporaryDirectory() as dirname:
91 return {
91 return {
92 'text/html': sphx.sphinxify(doc, dirname),
92 'text/html': sphx.sphinxify(doc, dirname),
93 'text/plain': doc
93 'text/plain': doc
94 }
94 }
95 except ImportError:
95 except ImportError:
96 sphinxify = None
96 sphinxify = None
97
97
98
98
99 class ProvisionalWarning(DeprecationWarning):
99 class ProvisionalWarning(DeprecationWarning):
100 """
100 """
101 Warning class for unstable features
101 Warning class for unstable features
102 """
102 """
103 pass
103 pass
104
104
105 #-----------------------------------------------------------------------------
105 #-----------------------------------------------------------------------------
106 # Globals
106 # Globals
107 #-----------------------------------------------------------------------------
107 #-----------------------------------------------------------------------------
108
108
109 # compiled regexps for autoindent management
109 # compiled regexps for autoindent management
110 dedent_re = re.compile(r'^\s+raise|^\s+return|^\s+pass')
110 dedent_re = re.compile(r'^\s+raise|^\s+return|^\s+pass')
111
111
112 #-----------------------------------------------------------------------------
112 #-----------------------------------------------------------------------------
113 # Utilities
113 # Utilities
114 #-----------------------------------------------------------------------------
114 #-----------------------------------------------------------------------------
115
115
116 @undoc
116 @undoc
117 def softspace(file, newvalue):
117 def softspace(file, newvalue):
118 """Copied from code.py, to remove the dependency"""
118 """Copied from code.py, to remove the dependency"""
119
119
120 oldvalue = 0
120 oldvalue = 0
121 try:
121 try:
122 oldvalue = file.softspace
122 oldvalue = file.softspace
123 except AttributeError:
123 except AttributeError:
124 pass
124 pass
125 try:
125 try:
126 file.softspace = newvalue
126 file.softspace = newvalue
127 except (AttributeError, TypeError):
127 except (AttributeError, TypeError):
128 # "attribute-less object" or "read-only attributes"
128 # "attribute-less object" or "read-only attributes"
129 pass
129 pass
130 return oldvalue
130 return oldvalue
131
131
132 @undoc
132 @undoc
133 def no_op(*a, **kw):
133 def no_op(*a, **kw):
134 pass
134 pass
135
135
136
136
137 class SpaceInInput(Exception): pass
137 class SpaceInInput(Exception): pass
138
138
139
139
140 def get_default_colors():
140 def get_default_colors():
141 "DEPRECATED"
141 "DEPRECATED"
142 warn('get_default_color is deprecated since IPython 5.0, and returns `Neutral` on all platforms.',
142 warn('get_default_color is deprecated since IPython 5.0, and returns `Neutral` on all platforms.',
143 DeprecationWarning, stacklevel=2)
143 DeprecationWarning, stacklevel=2)
144 return 'Neutral'
144 return 'Neutral'
145
145
146
146
147 class SeparateUnicode(Unicode):
147 class SeparateUnicode(Unicode):
148 r"""A Unicode subclass to validate separate_in, separate_out, etc.
148 r"""A Unicode subclass to validate separate_in, separate_out, etc.
149
149
150 This is a Unicode based trait that converts '0'->'' and ``'\\n'->'\n'``.
150 This is a Unicode based trait that converts '0'->'' and ``'\\n'->'\n'``.
151 """
151 """
152
152
153 def validate(self, obj, value):
153 def validate(self, obj, value):
154 if value == '0': value = ''
154 if value == '0': value = ''
155 value = value.replace('\\n','\n')
155 value = value.replace('\\n','\n')
156 return super(SeparateUnicode, self).validate(obj, value)
156 return super(SeparateUnicode, self).validate(obj, value)
157
157
158
158
159 @undoc
159 @undoc
160 class DummyMod(object):
160 class DummyMod(object):
161 """A dummy module used for IPython's interactive module when
161 """A dummy module used for IPython's interactive module when
162 a namespace must be assigned to the module's __dict__."""
162 a namespace must be assigned to the module's __dict__."""
163 pass
163 pass
164
164
165
165
166 class ExecutionResult(object):
166 class ExecutionResult(object):
167 """The result of a call to :meth:`InteractiveShell.run_cell`
167 """The result of a call to :meth:`InteractiveShell.run_cell`
168
168
169 Stores information about what took place.
169 Stores information about what took place.
170 """
170 """
171 execution_count = None
171 execution_count = None
172 error_before_exec = None
172 error_before_exec = None
173 error_in_exec = None
173 error_in_exec = None
174 result = None
174 result = None
175
175
176 @property
176 @property
177 def success(self):
177 def success(self):
178 return (self.error_before_exec is None) and (self.error_in_exec is None)
178 return (self.error_before_exec is None) and (self.error_in_exec is None)
179
179
180 def raise_error(self):
180 def raise_error(self):
181 """Reraises error if `success` is `False`, otherwise does nothing"""
181 """Reraises error if `success` is `False`, otherwise does nothing"""
182 if self.error_before_exec is not None:
182 if self.error_before_exec is not None:
183 raise self.error_before_exec
183 raise self.error_before_exec
184 if self.error_in_exec is not None:
184 if self.error_in_exec is not None:
185 raise self.error_in_exec
185 raise self.error_in_exec
186
186
187 def __repr__(self):
187 def __repr__(self):
188 name = self.__class__.__qualname__
188 name = self.__class__.__qualname__
189 return '<%s object at %x, execution_count=%s error_before_exec=%s error_in_exec=%s result=%s>' %\
189 return '<%s object at %x, execution_count=%s error_before_exec=%s error_in_exec=%s result=%s>' %\
190 (name, id(self), self.execution_count, self.error_before_exec, self.error_in_exec, repr(self.result))
190 (name, id(self), self.execution_count, self.error_before_exec, self.error_in_exec, repr(self.result))
191
191
192
192
193 class InteractiveShell(SingletonConfigurable):
193 class InteractiveShell(SingletonConfigurable):
194 """An enhanced, interactive shell for Python."""
194 """An enhanced, interactive shell for Python."""
195
195
196 _instance = None
196 _instance = None
197
197
198 ast_transformers = List([], help=
198 ast_transformers = List([], help=
199 """
199 """
200 A list of ast.NodeTransformer subclass instances, which will be applied
200 A list of ast.NodeTransformer subclass instances, which will be applied
201 to user input before code is run.
201 to user input before code is run.
202 """
202 """
203 ).tag(config=True)
203 ).tag(config=True)
204
204
205 autocall = Enum((0,1,2), default_value=0, help=
205 autocall = Enum((0,1,2), default_value=0, help=
206 """
206 """
207 Make IPython automatically call any callable object even if you didn't
207 Make IPython automatically call any callable object even if you didn't
208 type explicit parentheses. For example, 'str 43' becomes 'str(43)'
208 type explicit parentheses. For example, 'str 43' becomes 'str(43)'
209 automatically. The value can be '0' to disable the feature, '1' for
209 automatically. The value can be '0' to disable the feature, '1' for
210 'smart' autocall, where it is not applied if there are no more
210 'smart' autocall, where it is not applied if there are no more
211 arguments on the line, and '2' for 'full' autocall, where all callable
211 arguments on the line, and '2' for 'full' autocall, where all callable
212 objects are automatically called (even if no arguments are present).
212 objects are automatically called (even if no arguments are present).
213 """
213 """
214 ).tag(config=True)
214 ).tag(config=True)
215 # TODO: remove all autoindent logic and put into frontends.
215 # TODO: remove all autoindent logic and put into frontends.
216 # We can't do this yet because even runlines uses the autoindent.
216 # We can't do this yet because even runlines uses the autoindent.
217 autoindent = Bool(True, help=
217 autoindent = Bool(True, help=
218 """
218 """
219 Autoindent IPython code entered interactively.
219 Autoindent IPython code entered interactively.
220 """
220 """
221 ).tag(config=True)
221 ).tag(config=True)
222
222
223 automagic = Bool(True, help=
223 automagic = Bool(True, help=
224 """
224 """
225 Enable magic commands to be called without the leading %.
225 Enable magic commands to be called without the leading %.
226 """
226 """
227 ).tag(config=True)
227 ).tag(config=True)
228
228
229 banner1 = Unicode(default_banner,
229 banner1 = Unicode(default_banner,
230 help="""The part of the banner to be printed before the profile"""
230 help="""The part of the banner to be printed before the profile"""
231 ).tag(config=True)
231 ).tag(config=True)
232 banner2 = Unicode('',
232 banner2 = Unicode('',
233 help="""The part of the banner to be printed after the profile"""
233 help="""The part of the banner to be printed after the profile"""
234 ).tag(config=True)
234 ).tag(config=True)
235
235
236 cache_size = Integer(1000, help=
236 cache_size = Integer(1000, help=
237 """
237 """
238 Set the size of the output cache. The default is 1000, you can
238 Set the size of the output cache. The default is 1000, you can
239 change it permanently in your config file. Setting it to 0 completely
239 change it permanently in your config file. Setting it to 0 completely
240 disables the caching system, and the minimum value accepted is 20 (if
240 disables the caching system, and the minimum value accepted is 20 (if
241 you provide a value less than 20, it is reset to 0 and a warning is
241 you provide a value less than 20, it is reset to 0 and a warning is
242 issued). This limit is defined because otherwise you'll spend more
242 issued). This limit is defined because otherwise you'll spend more
243 time re-flushing a too small cache than working
243 time re-flushing a too small cache than working
244 """
244 """
245 ).tag(config=True)
245 ).tag(config=True)
246 color_info = Bool(True, help=
246 color_info = Bool(True, help=
247 """
247 """
248 Use colors for displaying information about objects. Because this
248 Use colors for displaying information about objects. Because this
249 information is passed through a pager (like 'less'), and some pagers
249 information is passed through a pager (like 'less'), and some pagers
250 get confused with color codes, this capability can be turned off.
250 get confused with color codes, this capability can be turned off.
251 """
251 """
252 ).tag(config=True)
252 ).tag(config=True)
253 colors = CaselessStrEnum(('Neutral', 'NoColor','LightBG','Linux'),
253 colors = CaselessStrEnum(('Neutral', 'NoColor','LightBG','Linux'),
254 default_value='Neutral',
254 default_value='Neutral',
255 help="Set the color scheme (NoColor, Neutral, Linux, or LightBG)."
255 help="Set the color scheme (NoColor, Neutral, Linux, or LightBG)."
256 ).tag(config=True)
256 ).tag(config=True)
257 debug = Bool(False).tag(config=True)
257 debug = Bool(False).tag(config=True)
258 disable_failing_post_execute = Bool(False,
258 disable_failing_post_execute = Bool(False,
259 help="Don't call post-execute functions that have failed in the past."
259 help="Don't call post-execute functions that have failed in the past."
260 ).tag(config=True)
260 ).tag(config=True)
261 display_formatter = Instance(DisplayFormatter, allow_none=True)
261 display_formatter = Instance(DisplayFormatter, allow_none=True)
262 displayhook_class = Type(DisplayHook)
262 displayhook_class = Type(DisplayHook)
263 display_pub_class = Type(DisplayPublisher)
263 display_pub_class = Type(DisplayPublisher)
264
264
265 sphinxify_docstring = Bool(False, help=
265 sphinxify_docstring = Bool(False, help=
266 """
266 """
267 Enables rich html representation of docstrings. (This requires the
267 Enables rich html representation of docstrings. (This requires the
268 docrepr module).
268 docrepr module).
269 """).tag(config=True)
269 """).tag(config=True)
270
270
271 @observe("sphinxify_docstring")
271 @observe("sphinxify_docstring")
272 def _sphinxify_docstring_changed(self, change):
272 def _sphinxify_docstring_changed(self, change):
273 if change['new']:
273 if change['new']:
274 warn("`sphinxify_docstring` is provisional since IPython 5.0 and might change in future versions." , ProvisionalWarning)
274 warn("`sphinxify_docstring` is provisional since IPython 5.0 and might change in future versions." , ProvisionalWarning)
275
275
276 enable_html_pager = Bool(False, help=
276 enable_html_pager = Bool(False, help=
277 """
277 """
278 (Provisional API) enables html representation in mime bundles sent
278 (Provisional API) enables html representation in mime bundles sent
279 to pagers.
279 to pagers.
280 """).tag(config=True)
280 """).tag(config=True)
281
281
282 @observe("enable_html_pager")
282 @observe("enable_html_pager")
283 def _enable_html_pager_changed(self, change):
283 def _enable_html_pager_changed(self, change):
284 if change['new']:
284 if change['new']:
285 warn("`enable_html_pager` is provisional since IPython 5.0 and might change in future versions.", ProvisionalWarning)
285 warn("`enable_html_pager` is provisional since IPython 5.0 and might change in future versions.", ProvisionalWarning)
286
286
287 data_pub_class = None
287 data_pub_class = None
288
288
289 exit_now = Bool(False)
289 exit_now = Bool(False)
290 exiter = Instance(ExitAutocall)
290 exiter = Instance(ExitAutocall)
291 @default('exiter')
291 @default('exiter')
292 def _exiter_default(self):
292 def _exiter_default(self):
293 return ExitAutocall(self)
293 return ExitAutocall(self)
294 # Monotonically increasing execution counter
294 # Monotonically increasing execution counter
295 execution_count = Integer(1)
295 execution_count = Integer(1)
296 filename = Unicode("<ipython console>")
296 filename = Unicode("<ipython console>")
297 ipython_dir= Unicode('').tag(config=True) # Set to get_ipython_dir() in __init__
297 ipython_dir= Unicode('').tag(config=True) # Set to get_ipython_dir() in __init__
298
298
299 # Input splitter, to transform input line by line and detect when a block
299 # Input splitter, to transform input line by line and detect when a block
300 # is ready to be executed.
300 # is ready to be executed.
301 input_splitter = Instance('IPython.core.inputsplitter.IPythonInputSplitter',
301 input_splitter = Instance('IPython.core.inputsplitter.IPythonInputSplitter',
302 (), {'line_input_checker': True})
302 (), {'line_input_checker': True})
303
303
304 # This InputSplitter instance is used to transform completed cells before
304 # This InputSplitter instance is used to transform completed cells before
305 # running them. It allows cell magics to contain blank lines.
305 # running them. It allows cell magics to contain blank lines.
306 input_transformer_manager = Instance('IPython.core.inputsplitter.IPythonInputSplitter',
306 input_transformer_manager = Instance('IPython.core.inputsplitter.IPythonInputSplitter',
307 (), {'line_input_checker': False})
307 (), {'line_input_checker': False})
308
308
309 logstart = Bool(False, help=
309 logstart = Bool(False, help=
310 """
310 """
311 Start logging to the default log file in overwrite mode.
311 Start logging to the default log file in overwrite mode.
312 Use `logappend` to specify a log file to **append** logs to.
312 Use `logappend` to specify a log file to **append** logs to.
313 """
313 """
314 ).tag(config=True)
314 ).tag(config=True)
315 logfile = Unicode('', help=
315 logfile = Unicode('', help=
316 """
316 """
317 The name of the logfile to use.
317 The name of the logfile to use.
318 """
318 """
319 ).tag(config=True)
319 ).tag(config=True)
320 logappend = Unicode('', help=
320 logappend = Unicode('', help=
321 """
321 """
322 Start logging to the given file in append mode.
322 Start logging to the given file in append mode.
323 Use `logfile` to specify a log file to **overwrite** logs to.
323 Use `logfile` to specify a log file to **overwrite** logs to.
324 """
324 """
325 ).tag(config=True)
325 ).tag(config=True)
326 object_info_string_level = Enum((0,1,2), default_value=0,
326 object_info_string_level = Enum((0,1,2), default_value=0,
327 ).tag(config=True)
327 ).tag(config=True)
328 pdb = Bool(False, help=
328 pdb = Bool(False, help=
329 """
329 """
330 Automatically call the pdb debugger after every exception.
330 Automatically call the pdb debugger after every exception.
331 """
331 """
332 ).tag(config=True)
332 ).tag(config=True)
333 display_page = Bool(False,
333 display_page = Bool(False,
334 help="""If True, anything that would be passed to the pager
334 help="""If True, anything that would be passed to the pager
335 will be displayed as regular output instead."""
335 will be displayed as regular output instead."""
336 ).tag(config=True)
336 ).tag(config=True)
337
337
338 # deprecated prompt traits:
338 # deprecated prompt traits:
339
339
340 prompt_in1 = Unicode('In [\\#]: ',
340 prompt_in1 = Unicode('In [\\#]: ',
341 help="Deprecated since IPython 4.0 and ignored since 5.0, set TerminalInteractiveShell.prompts object directly."
341 help="Deprecated since IPython 4.0 and ignored since 5.0, set TerminalInteractiveShell.prompts object directly."
342 ).tag(config=True)
342 ).tag(config=True)
343 prompt_in2 = Unicode(' .\\D.: ',
343 prompt_in2 = Unicode(' .\\D.: ',
344 help="Deprecated since IPython 4.0 and ignored since 5.0, set TerminalInteractiveShell.prompts object directly."
344 help="Deprecated since IPython 4.0 and ignored since 5.0, set TerminalInteractiveShell.prompts object directly."
345 ).tag(config=True)
345 ).tag(config=True)
346 prompt_out = Unicode('Out[\\#]: ',
346 prompt_out = Unicode('Out[\\#]: ',
347 help="Deprecated since IPython 4.0 and ignored since 5.0, set TerminalInteractiveShell.prompts object directly."
347 help="Deprecated since IPython 4.0 and ignored since 5.0, set TerminalInteractiveShell.prompts object directly."
348 ).tag(config=True)
348 ).tag(config=True)
349 prompts_pad_left = Bool(True,
349 prompts_pad_left = Bool(True,
350 help="Deprecated since IPython 4.0 and ignored since 5.0, set TerminalInteractiveShell.prompts object directly."
350 help="Deprecated since IPython 4.0 and ignored since 5.0, set TerminalInteractiveShell.prompts object directly."
351 ).tag(config=True)
351 ).tag(config=True)
352
352
353 @observe('prompt_in1', 'prompt_in2', 'prompt_out', 'prompt_pad_left')
353 @observe('prompt_in1', 'prompt_in2', 'prompt_out', 'prompt_pad_left')
354 def _prompt_trait_changed(self, change):
354 def _prompt_trait_changed(self, change):
355 name = change['name']
355 name = change['name']
356 warn("InteractiveShell.{name} is deprecated since IPython 4.0"
356 warn("InteractiveShell.{name} is deprecated since IPython 4.0"
357 " and ignored since 5.0, set TerminalInteractiveShell.prompts"
357 " and ignored since 5.0, set TerminalInteractiveShell.prompts"
358 " object directly.".format(name=name))
358 " object directly.".format(name=name))
359
359
360 # protect against weird cases where self.config may not exist:
360 # protect against weird cases where self.config may not exist:
361
361
362 show_rewritten_input = Bool(True,
362 show_rewritten_input = Bool(True,
363 help="Show rewritten input, e.g. for autocall."
363 help="Show rewritten input, e.g. for autocall."
364 ).tag(config=True)
364 ).tag(config=True)
365
365
366 quiet = Bool(False).tag(config=True)
366 quiet = Bool(False).tag(config=True)
367
367
368 history_length = Integer(10000,
368 history_length = Integer(10000,
369 help='Total length of command history'
369 help='Total length of command history'
370 ).tag(config=True)
370 ).tag(config=True)
371
371
372 history_load_length = Integer(1000, help=
372 history_load_length = Integer(1000, help=
373 """
373 """
374 The number of saved history entries to be loaded
374 The number of saved history entries to be loaded
375 into the history buffer at startup.
375 into the history buffer at startup.
376 """
376 """
377 ).tag(config=True)
377 ).tag(config=True)
378
378
379 ast_node_interactivity = Enum(['all', 'last', 'last_expr', 'none'],
379 ast_node_interactivity = Enum(['all', 'last', 'last_expr', 'none'],
380 default_value='last_expr',
380 default_value='last_expr',
381 help="""
381 help="""
382 'all', 'last', 'last_expr' or 'none', specifying which nodes should be
382 'all', 'last', 'last_expr' or 'none', specifying which nodes should be
383 run interactively (displaying output from expressions)."""
383 run interactively (displaying output from expressions)."""
384 ).tag(config=True)
384 ).tag(config=True)
385
385
386 # TODO: this part of prompt management should be moved to the frontends.
386 # TODO: this part of prompt management should be moved to the frontends.
387 # Use custom TraitTypes that convert '0'->'' and '\\n'->'\n'
387 # Use custom TraitTypes that convert '0'->'' and '\\n'->'\n'
388 separate_in = SeparateUnicode('\n').tag(config=True)
388 separate_in = SeparateUnicode('\n').tag(config=True)
389 separate_out = SeparateUnicode('').tag(config=True)
389 separate_out = SeparateUnicode('').tag(config=True)
390 separate_out2 = SeparateUnicode('').tag(config=True)
390 separate_out2 = SeparateUnicode('').tag(config=True)
391 wildcards_case_sensitive = Bool(True).tag(config=True)
391 wildcards_case_sensitive = Bool(True).tag(config=True)
392 xmode = CaselessStrEnum(('Context','Plain', 'Verbose'),
392 xmode = CaselessStrEnum(('Context','Plain', 'Verbose'),
393 default_value='Context',
393 default_value='Context',
394 help="Switch modes for the IPython exception handlers."
394 help="Switch modes for the IPython exception handlers."
395 ).tag(config=True)
395 ).tag(config=True)
396
396
397 # Subcomponents of InteractiveShell
397 # Subcomponents of InteractiveShell
398 alias_manager = Instance('IPython.core.alias.AliasManager', allow_none=True)
398 alias_manager = Instance('IPython.core.alias.AliasManager', allow_none=True)
399 prefilter_manager = Instance('IPython.core.prefilter.PrefilterManager', allow_none=True)
399 prefilter_manager = Instance('IPython.core.prefilter.PrefilterManager', allow_none=True)
400 builtin_trap = Instance('IPython.core.builtin_trap.BuiltinTrap', allow_none=True)
400 builtin_trap = Instance('IPython.core.builtin_trap.BuiltinTrap', allow_none=True)
401 display_trap = Instance('IPython.core.display_trap.DisplayTrap', allow_none=True)
401 display_trap = Instance('IPython.core.display_trap.DisplayTrap', allow_none=True)
402 extension_manager = Instance('IPython.core.extensions.ExtensionManager', allow_none=True)
402 extension_manager = Instance('IPython.core.extensions.ExtensionManager', allow_none=True)
403 payload_manager = Instance('IPython.core.payload.PayloadManager', allow_none=True)
403 payload_manager = Instance('IPython.core.payload.PayloadManager', allow_none=True)
404 history_manager = Instance('IPython.core.history.HistoryAccessorBase', allow_none=True)
404 history_manager = Instance('IPython.core.history.HistoryAccessorBase', allow_none=True)
405 magics_manager = Instance('IPython.core.magic.MagicsManager', allow_none=True)
405 magics_manager = Instance('IPython.core.magic.MagicsManager', allow_none=True)
406
406
407 profile_dir = Instance('IPython.core.application.ProfileDir', allow_none=True)
407 profile_dir = Instance('IPython.core.application.ProfileDir', allow_none=True)
408 @property
408 @property
409 def profile(self):
409 def profile(self):
410 if self.profile_dir is not None:
410 if self.profile_dir is not None:
411 name = os.path.basename(self.profile_dir.location)
411 name = os.path.basename(self.profile_dir.location)
412 return name.replace('profile_','')
412 return name.replace('profile_','')
413
413
414
414
415 # Private interface
415 # Private interface
416 _post_execute = Dict()
416 _post_execute = Dict()
417
417
418 # Tracks any GUI loop loaded for pylab
418 # Tracks any GUI loop loaded for pylab
419 pylab_gui_select = None
419 pylab_gui_select = None
420
420
421 last_execution_succeeded = Bool(True, help='Did last executed command succeeded')
421 last_execution_succeeded = Bool(True, help='Did last executed command succeeded')
422
422
423 def __init__(self, ipython_dir=None, profile_dir=None,
423 def __init__(self, ipython_dir=None, profile_dir=None,
424 user_module=None, user_ns=None,
424 user_module=None, user_ns=None,
425 custom_exceptions=((), None), **kwargs):
425 custom_exceptions=((), None), **kwargs):
426
426
427 # This is where traits with a config_key argument are updated
427 # This is where traits with a config_key argument are updated
428 # from the values on config.
428 # from the values on config.
429 super(InteractiveShell, self).__init__(**kwargs)
429 super(InteractiveShell, self).__init__(**kwargs)
430 if 'PromptManager' in self.config:
430 if 'PromptManager' in self.config:
431 warn('As of IPython 5.0 `PromptManager` config will have no effect'
431 warn('As of IPython 5.0 `PromptManager` config will have no effect'
432 ' and has been replaced by TerminalInteractiveShell.prompts_class')
432 ' and has been replaced by TerminalInteractiveShell.prompts_class')
433 self.configurables = [self]
433 self.configurables = [self]
434
434
435 # These are relatively independent and stateless
435 # These are relatively independent and stateless
436 self.init_ipython_dir(ipython_dir)
436 self.init_ipython_dir(ipython_dir)
437 self.init_profile_dir(profile_dir)
437 self.init_profile_dir(profile_dir)
438 self.init_instance_attrs()
438 self.init_instance_attrs()
439 self.init_environment()
439 self.init_environment()
440
440
441 # Check if we're in a virtualenv, and set up sys.path.
441 # Check if we're in a virtualenv, and set up sys.path.
442 self.init_virtualenv()
442 self.init_virtualenv()
443
443
444 # Create namespaces (user_ns, user_global_ns, etc.)
444 # Create namespaces (user_ns, user_global_ns, etc.)
445 self.init_create_namespaces(user_module, user_ns)
445 self.init_create_namespaces(user_module, user_ns)
446 # This has to be done after init_create_namespaces because it uses
446 # This has to be done after init_create_namespaces because it uses
447 # something in self.user_ns, but before init_sys_modules, which
447 # something in self.user_ns, but before init_sys_modules, which
448 # is the first thing to modify sys.
448 # is the first thing to modify sys.
449 # TODO: When we override sys.stdout and sys.stderr before this class
449 # TODO: When we override sys.stdout and sys.stderr before this class
450 # is created, we are saving the overridden ones here. Not sure if this
450 # is created, we are saving the overridden ones here. Not sure if this
451 # is what we want to do.
451 # is what we want to do.
452 self.save_sys_module_state()
452 self.save_sys_module_state()
453 self.init_sys_modules()
453 self.init_sys_modules()
454
454
455 # While we're trying to have each part of the code directly access what
455 # While we're trying to have each part of the code directly access what
456 # it needs without keeping redundant references to objects, we have too
456 # it needs without keeping redundant references to objects, we have too
457 # much legacy code that expects ip.db to exist.
457 # much legacy code that expects ip.db to exist.
458 self.db = PickleShareDB(os.path.join(self.profile_dir.location, 'db'))
458 self.db = PickleShareDB(os.path.join(self.profile_dir.location, 'db'))
459
459
460 self.init_history()
460 self.init_history()
461 self.init_encoding()
461 self.init_encoding()
462 self.init_prefilter()
462 self.init_prefilter()
463
463
464 self.init_syntax_highlighting()
464 self.init_syntax_highlighting()
465 self.init_hooks()
465 self.init_hooks()
466 self.init_events()
466 self.init_events()
467 self.init_pushd_popd_magic()
467 self.init_pushd_popd_magic()
468 self.init_user_ns()
468 self.init_user_ns()
469 self.init_logger()
469 self.init_logger()
470 self.init_builtins()
470 self.init_builtins()
471
471
472 # The following was in post_config_initialization
472 # The following was in post_config_initialization
473 self.init_inspector()
473 self.init_inspector()
474 self.raw_input_original = input
474 self.raw_input_original = input
475 self.init_completer()
475 self.init_completer()
476 # TODO: init_io() needs to happen before init_traceback handlers
476 # TODO: init_io() needs to happen before init_traceback handlers
477 # because the traceback handlers hardcode the stdout/stderr streams.
477 # because the traceback handlers hardcode the stdout/stderr streams.
478 # This logic in in debugger.Pdb and should eventually be changed.
478 # This logic in in debugger.Pdb and should eventually be changed.
479 self.init_io()
479 self.init_io()
480 self.init_traceback_handlers(custom_exceptions)
480 self.init_traceback_handlers(custom_exceptions)
481 self.init_prompts()
481 self.init_prompts()
482 self.init_display_formatter()
482 self.init_display_formatter()
483 self.init_display_pub()
483 self.init_display_pub()
484 self.init_data_pub()
484 self.init_data_pub()
485 self.init_displayhook()
485 self.init_displayhook()
486 self.init_magics()
486 self.init_magics()
487 self.init_alias()
487 self.init_alias()
488 self.init_logstart()
488 self.init_logstart()
489 self.init_pdb()
489 self.init_pdb()
490 self.init_extension_manager()
490 self.init_extension_manager()
491 self.init_payload()
491 self.init_payload()
492 self.init_deprecation_warnings()
492 self.init_deprecation_warnings()
493 self.hooks.late_startup_hook()
493 self.hooks.late_startup_hook()
494 self.events.trigger('shell_initialized', self)
494 self.events.trigger('shell_initialized', self)
495 atexit.register(self.atexit_operations)
495 atexit.register(self.atexit_operations)
496
496
497 def get_ipython(self):
497 def get_ipython(self):
498 """Return the currently running IPython instance."""
498 """Return the currently running IPython instance."""
499 return self
499 return self
500
500
501 #-------------------------------------------------------------------------
501 #-------------------------------------------------------------------------
502 # Trait changed handlers
502 # Trait changed handlers
503 #-------------------------------------------------------------------------
503 #-------------------------------------------------------------------------
504 @observe('ipython_dir')
504 @observe('ipython_dir')
505 def _ipython_dir_changed(self, change):
505 def _ipython_dir_changed(self, change):
506 ensure_dir_exists(change['new'])
506 ensure_dir_exists(change['new'])
507
507
508 def set_autoindent(self,value=None):
508 def set_autoindent(self,value=None):
509 """Set the autoindent flag.
509 """Set the autoindent flag.
510
510
511 If called with no arguments, it acts as a toggle."""
511 If called with no arguments, it acts as a toggle."""
512 if value is None:
512 if value is None:
513 self.autoindent = not self.autoindent
513 self.autoindent = not self.autoindent
514 else:
514 else:
515 self.autoindent = value
515 self.autoindent = value
516
516
517 #-------------------------------------------------------------------------
517 #-------------------------------------------------------------------------
518 # init_* methods called by __init__
518 # init_* methods called by __init__
519 #-------------------------------------------------------------------------
519 #-------------------------------------------------------------------------
520
520
521 def init_ipython_dir(self, ipython_dir):
521 def init_ipython_dir(self, ipython_dir):
522 if ipython_dir is not None:
522 if ipython_dir is not None:
523 self.ipython_dir = ipython_dir
523 self.ipython_dir = ipython_dir
524 return
524 return
525
525
526 self.ipython_dir = get_ipython_dir()
526 self.ipython_dir = get_ipython_dir()
527
527
528 def init_profile_dir(self, profile_dir):
528 def init_profile_dir(self, profile_dir):
529 if profile_dir is not None:
529 if profile_dir is not None:
530 self.profile_dir = profile_dir
530 self.profile_dir = profile_dir
531 return
531 return
532 self.profile_dir =\
532 self.profile_dir =\
533 ProfileDir.create_profile_dir_by_name(self.ipython_dir, 'default')
533 ProfileDir.create_profile_dir_by_name(self.ipython_dir, 'default')
534
534
535 def init_instance_attrs(self):
535 def init_instance_attrs(self):
536 self.more = False
536 self.more = False
537
537
538 # command compiler
538 # command compiler
539 self.compile = CachingCompiler()
539 self.compile = CachingCompiler()
540
540
541 # Make an empty namespace, which extension writers can rely on both
541 # Make an empty namespace, which extension writers can rely on both
542 # existing and NEVER being used by ipython itself. This gives them a
542 # existing and NEVER being used by ipython itself. This gives them a
543 # convenient location for storing additional information and state
543 # convenient location for storing additional information and state
544 # their extensions may require, without fear of collisions with other
544 # their extensions may require, without fear of collisions with other
545 # ipython names that may develop later.
545 # ipython names that may develop later.
546 self.meta = Struct()
546 self.meta = Struct()
547
547
548 # Temporary files used for various purposes. Deleted at exit.
548 # Temporary files used for various purposes. Deleted at exit.
549 self.tempfiles = []
549 self.tempfiles = []
550 self.tempdirs = []
550 self.tempdirs = []
551
551
552 # keep track of where we started running (mainly for crash post-mortem)
552 # keep track of where we started running (mainly for crash post-mortem)
553 # This is not being used anywhere currently.
553 # This is not being used anywhere currently.
554 self.starting_dir = os.getcwd()
554 self.starting_dir = os.getcwd()
555
555
556 # Indentation management
556 # Indentation management
557 self.indent_current_nsp = 0
557 self.indent_current_nsp = 0
558
558
559 # Dict to track post-execution functions that have been registered
559 # Dict to track post-execution functions that have been registered
560 self._post_execute = {}
560 self._post_execute = {}
561
561
562 def init_environment(self):
562 def init_environment(self):
563 """Any changes we need to make to the user's environment."""
563 """Any changes we need to make to the user's environment."""
564 pass
564 pass
565
565
566 def init_encoding(self):
566 def init_encoding(self):
567 # Get system encoding at startup time. Certain terminals (like Emacs
567 # Get system encoding at startup time. Certain terminals (like Emacs
568 # under Win32 have it set to None, and we need to have a known valid
568 # under Win32 have it set to None, and we need to have a known valid
569 # encoding to use in the raw_input() method
569 # encoding to use in the raw_input() method
570 try:
570 try:
571 self.stdin_encoding = sys.stdin.encoding or 'ascii'
571 self.stdin_encoding = sys.stdin.encoding or 'ascii'
572 except AttributeError:
572 except AttributeError:
573 self.stdin_encoding = 'ascii'
573 self.stdin_encoding = 'ascii'
574
574
575
575
576 @observe('colors')
576 @observe('colors')
577 def init_syntax_highlighting(self, changes=None):
577 def init_syntax_highlighting(self, changes=None):
578 # Python source parser/formatter for syntax highlighting
578 # Python source parser/formatter for syntax highlighting
579 pyformat = PyColorize.Parser(style=self.colors, parent=self).format
579 pyformat = PyColorize.Parser(style=self.colors, parent=self).format
580 self.pycolorize = lambda src: pyformat(src,'str')
580 self.pycolorize = lambda src: pyformat(src,'str')
581
581
582 def refresh_style(self):
582 def refresh_style(self):
583 # No-op here, used in subclass
583 # No-op here, used in subclass
584 pass
584 pass
585
585
586 def init_pushd_popd_magic(self):
586 def init_pushd_popd_magic(self):
587 # for pushd/popd management
587 # for pushd/popd management
588 self.home_dir = get_home_dir()
588 self.home_dir = get_home_dir()
589
589
590 self.dir_stack = []
590 self.dir_stack = []
591
591
592 def init_logger(self):
592 def init_logger(self):
593 self.logger = Logger(self.home_dir, logfname='ipython_log.py',
593 self.logger = Logger(self.home_dir, logfname='ipython_log.py',
594 logmode='rotate')
594 logmode='rotate')
595
595
596 def init_logstart(self):
596 def init_logstart(self):
597 """Initialize logging in case it was requested at the command line.
597 """Initialize logging in case it was requested at the command line.
598 """
598 """
599 if self.logappend:
599 if self.logappend:
600 self.magic('logstart %s append' % self.logappend)
600 self.magic('logstart %s append' % self.logappend)
601 elif self.logfile:
601 elif self.logfile:
602 self.magic('logstart %s' % self.logfile)
602 self.magic('logstart %s' % self.logfile)
603 elif self.logstart:
603 elif self.logstart:
604 self.magic('logstart')
604 self.magic('logstart')
605
605
606 def init_deprecation_warnings(self):
606 def init_deprecation_warnings(self):
607 """
607 """
608 register default filter for deprecation warning.
608 register default filter for deprecation warning.
609
609
610 This will allow deprecation warning of function used interactively to show
610 This will allow deprecation warning of function used interactively to show
611 warning to users, and still hide deprecation warning from libraries import.
611 warning to users, and still hide deprecation warning from libraries import.
612 """
612 """
613 warnings.filterwarnings("default", category=DeprecationWarning, module=self.user_ns.get("__name__"))
613 warnings.filterwarnings("default", category=DeprecationWarning, module=self.user_ns.get("__name__"))
614
614
615 def init_builtins(self):
615 def init_builtins(self):
616 # A single, static flag that we set to True. Its presence indicates
616 # A single, static flag that we set to True. Its presence indicates
617 # that an IPython shell has been created, and we make no attempts at
617 # that an IPython shell has been created, and we make no attempts at
618 # removing on exit or representing the existence of more than one
618 # removing on exit or representing the existence of more than one
619 # IPython at a time.
619 # IPython at a time.
620 builtin_mod.__dict__['__IPYTHON__'] = True
620 builtin_mod.__dict__['__IPYTHON__'] = True
621
621
622 self.builtin_trap = BuiltinTrap(shell=self)
622 self.builtin_trap = BuiltinTrap(shell=self)
623
623
624 def init_inspector(self):
624 def init_inspector(self):
625 # Object inspector
625 # Object inspector
626 self.inspector = oinspect.Inspector(oinspect.InspectColors,
626 self.inspector = oinspect.Inspector(oinspect.InspectColors,
627 PyColorize.ANSICodeColors,
627 PyColorize.ANSICodeColors,
628 self.colors,
628 self.colors,
629 self.object_info_string_level)
629 self.object_info_string_level)
630
630
631 def init_io(self):
631 def init_io(self):
632 # This will just use sys.stdout and sys.stderr. If you want to
632 # This will just use sys.stdout and sys.stderr. If you want to
633 # override sys.stdout and sys.stderr themselves, you need to do that
633 # override sys.stdout and sys.stderr themselves, you need to do that
634 # *before* instantiating this class, because io holds onto
634 # *before* instantiating this class, because io holds onto
635 # references to the underlying streams.
635 # references to the underlying streams.
636 # io.std* are deprecated, but don't show our own deprecation warnings
636 # io.std* are deprecated, but don't show our own deprecation warnings
637 # during initialization of the deprecated API.
637 # during initialization of the deprecated API.
638 with warnings.catch_warnings():
638 with warnings.catch_warnings():
639 warnings.simplefilter('ignore', DeprecationWarning)
639 warnings.simplefilter('ignore', DeprecationWarning)
640 io.stdout = io.IOStream(sys.stdout)
640 io.stdout = io.IOStream(sys.stdout)
641 io.stderr = io.IOStream(sys.stderr)
641 io.stderr = io.IOStream(sys.stderr)
642
642
643 def init_prompts(self):
643 def init_prompts(self):
644 # Set system prompts, so that scripts can decide if they are running
644 # Set system prompts, so that scripts can decide if they are running
645 # interactively.
645 # interactively.
646 sys.ps1 = 'In : '
646 sys.ps1 = 'In : '
647 sys.ps2 = '...: '
647 sys.ps2 = '...: '
648 sys.ps3 = 'Out: '
648 sys.ps3 = 'Out: '
649
649
650 def init_display_formatter(self):
650 def init_display_formatter(self):
651 self.display_formatter = DisplayFormatter(parent=self)
651 self.display_formatter = DisplayFormatter(parent=self)
652 self.configurables.append(self.display_formatter)
652 self.configurables.append(self.display_formatter)
653
653
654 def init_display_pub(self):
654 def init_display_pub(self):
655 self.display_pub = self.display_pub_class(parent=self)
655 self.display_pub = self.display_pub_class(parent=self)
656 self.configurables.append(self.display_pub)
656 self.configurables.append(self.display_pub)
657
657
658 def init_data_pub(self):
658 def init_data_pub(self):
659 if not self.data_pub_class:
659 if not self.data_pub_class:
660 self.data_pub = None
660 self.data_pub = None
661 return
661 return
662 self.data_pub = self.data_pub_class(parent=self)
662 self.data_pub = self.data_pub_class(parent=self)
663 self.configurables.append(self.data_pub)
663 self.configurables.append(self.data_pub)
664
664
665 def init_displayhook(self):
665 def init_displayhook(self):
666 # Initialize displayhook, set in/out prompts and printing system
666 # Initialize displayhook, set in/out prompts and printing system
667 self.displayhook = self.displayhook_class(
667 self.displayhook = self.displayhook_class(
668 parent=self,
668 parent=self,
669 shell=self,
669 shell=self,
670 cache_size=self.cache_size,
670 cache_size=self.cache_size,
671 )
671 )
672 self.configurables.append(self.displayhook)
672 self.configurables.append(self.displayhook)
673 # This is a context manager that installs/revmoes the displayhook at
673 # This is a context manager that installs/revmoes the displayhook at
674 # the appropriate time.
674 # the appropriate time.
675 self.display_trap = DisplayTrap(hook=self.displayhook)
675 self.display_trap = DisplayTrap(hook=self.displayhook)
676
676
677 def init_virtualenv(self):
677 def init_virtualenv(self):
678 """Add a virtualenv to sys.path so the user can import modules from it.
678 """Add a virtualenv to sys.path so the user can import modules from it.
679 This isn't perfect: it doesn't use the Python interpreter with which the
679 This isn't perfect: it doesn't use the Python interpreter with which the
680 virtualenv was built, and it ignores the --no-site-packages option. A
680 virtualenv was built, and it ignores the --no-site-packages option. A
681 warning will appear suggesting the user installs IPython in the
681 warning will appear suggesting the user installs IPython in the
682 virtualenv, but for many cases, it probably works well enough.
682 virtualenv, but for many cases, it probably works well enough.
683
683
684 Adapted from code snippets online.
684 Adapted from code snippets online.
685
685
686 http://blog.ufsoft.org/2009/1/29/ipython-and-virtualenv
686 http://blog.ufsoft.org/2009/1/29/ipython-and-virtualenv
687 """
687 """
688 if 'VIRTUAL_ENV' not in os.environ:
688 if 'VIRTUAL_ENV' not in os.environ:
689 # Not in a virtualenv
689 # Not in a virtualenv
690 return
690 return
691
691
692 # venv detection:
692 # venv detection:
693 # stdlib venv may symlink sys.executable, so we can't use realpath.
693 # stdlib venv may symlink sys.executable, so we can't use realpath.
694 # but others can symlink *to* the venv Python, so we can't just use sys.executable.
694 # but others can symlink *to* the venv Python, so we can't just use sys.executable.
695 # So we just check every item in the symlink tree (generally <= 3)
695 # So we just check every item in the symlink tree (generally <= 3)
696 p = os.path.normcase(sys.executable)
696 p = os.path.normcase(sys.executable)
697 paths = [p]
697 paths = [p]
698 while os.path.islink(p):
698 while os.path.islink(p):
699 p = os.path.normcase(os.path.join(os.path.dirname(p), os.readlink(p)))
699 p = os.path.normcase(os.path.join(os.path.dirname(p), os.readlink(p)))
700 paths.append(p)
700 paths.append(p)
701 p_venv = os.path.normcase(os.environ['VIRTUAL_ENV'])
701 p_venv = os.path.normcase(os.environ['VIRTUAL_ENV'])
702 if any(p.startswith(p_venv) for p in paths):
702 if any(p.startswith(p_venv) for p in paths):
703 # Running properly in the virtualenv, don't need to do anything
703 # Running properly in the virtualenv, don't need to do anything
704 return
704 return
705
705
706 warn("Attempting to work in a virtualenv. If you encounter problems, please "
706 warn("Attempting to work in a virtualenv. If you encounter problems, please "
707 "install IPython inside the virtualenv.")
707 "install IPython inside the virtualenv.")
708 if sys.platform == "win32":
708 if sys.platform == "win32":
709 virtual_env = os.path.join(os.environ['VIRTUAL_ENV'], 'Lib', 'site-packages')
709 virtual_env = os.path.join(os.environ['VIRTUAL_ENV'], 'Lib', 'site-packages')
710 else:
710 else:
711 virtual_env = os.path.join(os.environ['VIRTUAL_ENV'], 'lib',
711 virtual_env = os.path.join(os.environ['VIRTUAL_ENV'], 'lib',
712 'python%d.%d' % sys.version_info[:2], 'site-packages')
712 'python%d.%d' % sys.version_info[:2], 'site-packages')
713
713
714 import site
714 import site
715 sys.path.insert(0, virtual_env)
715 sys.path.insert(0, virtual_env)
716 site.addsitedir(virtual_env)
716 site.addsitedir(virtual_env)
717
717
718 #-------------------------------------------------------------------------
718 #-------------------------------------------------------------------------
719 # Things related to injections into the sys module
719 # Things related to injections into the sys module
720 #-------------------------------------------------------------------------
720 #-------------------------------------------------------------------------
721
721
722 def save_sys_module_state(self):
722 def save_sys_module_state(self):
723 """Save the state of hooks in the sys module.
723 """Save the state of hooks in the sys module.
724
724
725 This has to be called after self.user_module is created.
725 This has to be called after self.user_module is created.
726 """
726 """
727 self._orig_sys_module_state = {'stdin': sys.stdin,
727 self._orig_sys_module_state = {'stdin': sys.stdin,
728 'stdout': sys.stdout,
728 'stdout': sys.stdout,
729 'stderr': sys.stderr,
729 'stderr': sys.stderr,
730 'excepthook': sys.excepthook}
730 'excepthook': sys.excepthook}
731 self._orig_sys_modules_main_name = self.user_module.__name__
731 self._orig_sys_modules_main_name = self.user_module.__name__
732 self._orig_sys_modules_main_mod = sys.modules.get(self.user_module.__name__)
732 self._orig_sys_modules_main_mod = sys.modules.get(self.user_module.__name__)
733
733
734 def restore_sys_module_state(self):
734 def restore_sys_module_state(self):
735 """Restore the state of the sys module."""
735 """Restore the state of the sys module."""
736 try:
736 try:
737 for k, v in self._orig_sys_module_state.items():
737 for k, v in self._orig_sys_module_state.items():
738 setattr(sys, k, v)
738 setattr(sys, k, v)
739 except AttributeError:
739 except AttributeError:
740 pass
740 pass
741 # Reset what what done in self.init_sys_modules
741 # Reset what what done in self.init_sys_modules
742 if self._orig_sys_modules_main_mod is not None:
742 if self._orig_sys_modules_main_mod is not None:
743 sys.modules[self._orig_sys_modules_main_name] = self._orig_sys_modules_main_mod
743 sys.modules[self._orig_sys_modules_main_name] = self._orig_sys_modules_main_mod
744
744
745 #-------------------------------------------------------------------------
745 #-------------------------------------------------------------------------
746 # Things related to the banner
746 # Things related to the banner
747 #-------------------------------------------------------------------------
747 #-------------------------------------------------------------------------
748
748
749 @property
749 @property
750 def banner(self):
750 def banner(self):
751 banner = self.banner1
751 banner = self.banner1
752 if self.profile and self.profile != 'default':
752 if self.profile and self.profile != 'default':
753 banner += '\nIPython profile: %s\n' % self.profile
753 banner += '\nIPython profile: %s\n' % self.profile
754 if self.banner2:
754 if self.banner2:
755 banner += '\n' + self.banner2
755 banner += '\n' + self.banner2
756 return banner
756 return banner
757
757
758 def show_banner(self, banner=None):
758 def show_banner(self, banner=None):
759 if banner is None:
759 if banner is None:
760 banner = self.banner
760 banner = self.banner
761 sys.stdout.write(banner)
761 sys.stdout.write(banner)
762
762
763 #-------------------------------------------------------------------------
763 #-------------------------------------------------------------------------
764 # Things related to hooks
764 # Things related to hooks
765 #-------------------------------------------------------------------------
765 #-------------------------------------------------------------------------
766
766
767 def init_hooks(self):
767 def init_hooks(self):
768 # hooks holds pointers used for user-side customizations
768 # hooks holds pointers used for user-side customizations
769 self.hooks = Struct()
769 self.hooks = Struct()
770
770
771 self.strdispatchers = {}
771 self.strdispatchers = {}
772
772
773 # Set all default hooks, defined in the IPython.hooks module.
773 # Set all default hooks, defined in the IPython.hooks module.
774 hooks = IPython.core.hooks
774 hooks = IPython.core.hooks
775 for hook_name in hooks.__all__:
775 for hook_name in hooks.__all__:
776 # default hooks have priority 100, i.e. low; user hooks should have
776 # default hooks have priority 100, i.e. low; user hooks should have
777 # 0-100 priority
777 # 0-100 priority
778 self.set_hook(hook_name,getattr(hooks,hook_name), 100, _warn_deprecated=False)
778 self.set_hook(hook_name,getattr(hooks,hook_name), 100, _warn_deprecated=False)
779
779
780 if self.display_page:
780 if self.display_page:
781 self.set_hook('show_in_pager', page.as_hook(page.display_page), 90)
781 self.set_hook('show_in_pager', page.as_hook(page.display_page), 90)
782
782
783 def set_hook(self,name,hook, priority=50, str_key=None, re_key=None,
783 def set_hook(self,name,hook, priority=50, str_key=None, re_key=None,
784 _warn_deprecated=True):
784 _warn_deprecated=True):
785 """set_hook(name,hook) -> sets an internal IPython hook.
785 """set_hook(name,hook) -> sets an internal IPython hook.
786
786
787 IPython exposes some of its internal API as user-modifiable hooks. By
787 IPython exposes some of its internal API as user-modifiable hooks. By
788 adding your function to one of these hooks, you can modify IPython's
788 adding your function to one of these hooks, you can modify IPython's
789 behavior to call at runtime your own routines."""
789 behavior to call at runtime your own routines."""
790
790
791 # At some point in the future, this should validate the hook before it
791 # At some point in the future, this should validate the hook before it
792 # accepts it. Probably at least check that the hook takes the number
792 # accepts it. Probably at least check that the hook takes the number
793 # of args it's supposed to.
793 # of args it's supposed to.
794
794
795 f = types.MethodType(hook,self)
795 f = types.MethodType(hook,self)
796
796
797 # check if the hook is for strdispatcher first
797 # check if the hook is for strdispatcher first
798 if str_key is not None:
798 if str_key is not None:
799 sdp = self.strdispatchers.get(name, StrDispatch())
799 sdp = self.strdispatchers.get(name, StrDispatch())
800 sdp.add_s(str_key, f, priority )
800 sdp.add_s(str_key, f, priority )
801 self.strdispatchers[name] = sdp
801 self.strdispatchers[name] = sdp
802 return
802 return
803 if re_key is not None:
803 if re_key is not None:
804 sdp = self.strdispatchers.get(name, StrDispatch())
804 sdp = self.strdispatchers.get(name, StrDispatch())
805 sdp.add_re(re.compile(re_key), f, priority )
805 sdp.add_re(re.compile(re_key), f, priority )
806 self.strdispatchers[name] = sdp
806 self.strdispatchers[name] = sdp
807 return
807 return
808
808
809 dp = getattr(self.hooks, name, None)
809 dp = getattr(self.hooks, name, None)
810 if name not in IPython.core.hooks.__all__:
810 if name not in IPython.core.hooks.__all__:
811 print("Warning! Hook '%s' is not one of %s" % \
811 print("Warning! Hook '%s' is not one of %s" % \
812 (name, IPython.core.hooks.__all__ ))
812 (name, IPython.core.hooks.__all__ ))
813
813
814 if _warn_deprecated and (name in IPython.core.hooks.deprecated):
814 if _warn_deprecated and (name in IPython.core.hooks.deprecated):
815 alternative = IPython.core.hooks.deprecated[name]
815 alternative = IPython.core.hooks.deprecated[name]
816 warn("Hook {} is deprecated. Use {} instead.".format(name, alternative), stacklevel=2)
816 warn("Hook {} is deprecated. Use {} instead.".format(name, alternative), stacklevel=2)
817
817
818 if not dp:
818 if not dp:
819 dp = IPython.core.hooks.CommandChainDispatcher()
819 dp = IPython.core.hooks.CommandChainDispatcher()
820
820
821 try:
821 try:
822 dp.add(f,priority)
822 dp.add(f,priority)
823 except AttributeError:
823 except AttributeError:
824 # it was not commandchain, plain old func - replace
824 # it was not commandchain, plain old func - replace
825 dp = f
825 dp = f
826
826
827 setattr(self.hooks,name, dp)
827 setattr(self.hooks,name, dp)
828
828
829 #-------------------------------------------------------------------------
829 #-------------------------------------------------------------------------
830 # Things related to events
830 # Things related to events
831 #-------------------------------------------------------------------------
831 #-------------------------------------------------------------------------
832
832
833 def init_events(self):
833 def init_events(self):
834 self.events = EventManager(self, available_events)
834 self.events = EventManager(self, available_events)
835
835
836 self.events.register("pre_execute", self._clear_warning_registry)
836 self.events.register("pre_execute", self._clear_warning_registry)
837
837
838 def register_post_execute(self, func):
838 def register_post_execute(self, func):
839 """DEPRECATED: Use ip.events.register('post_run_cell', func)
839 """DEPRECATED: Use ip.events.register('post_run_cell', func)
840
840
841 Register a function for calling after code execution.
841 Register a function for calling after code execution.
842 """
842 """
843 warn("ip.register_post_execute is deprecated, use "
843 warn("ip.register_post_execute is deprecated, use "
844 "ip.events.register('post_run_cell', func) instead.", stacklevel=2)
844 "ip.events.register('post_run_cell', func) instead.", stacklevel=2)
845 self.events.register('post_run_cell', func)
845 self.events.register('post_run_cell', func)
846
846
847 def _clear_warning_registry(self):
847 def _clear_warning_registry(self):
848 # clear the warning registry, so that different code blocks with
848 # clear the warning registry, so that different code blocks with
849 # overlapping line number ranges don't cause spurious suppression of
849 # overlapping line number ranges don't cause spurious suppression of
850 # warnings (see gh-6611 for details)
850 # warnings (see gh-6611 for details)
851 if "__warningregistry__" in self.user_global_ns:
851 if "__warningregistry__" in self.user_global_ns:
852 del self.user_global_ns["__warningregistry__"]
852 del self.user_global_ns["__warningregistry__"]
853
853
854 #-------------------------------------------------------------------------
854 #-------------------------------------------------------------------------
855 # Things related to the "main" module
855 # Things related to the "main" module
856 #-------------------------------------------------------------------------
856 #-------------------------------------------------------------------------
857
857
858 def new_main_mod(self, filename, modname):
858 def new_main_mod(self, filename, modname):
859 """Return a new 'main' module object for user code execution.
859 """Return a new 'main' module object for user code execution.
860
860
861 ``filename`` should be the path of the script which will be run in the
861 ``filename`` should be the path of the script which will be run in the
862 module. Requests with the same filename will get the same module, with
862 module. Requests with the same filename will get the same module, with
863 its namespace cleared.
863 its namespace cleared.
864
864
865 ``modname`` should be the module name - normally either '__main__' or
865 ``modname`` should be the module name - normally either '__main__' or
866 the basename of the file without the extension.
866 the basename of the file without the extension.
867
867
868 When scripts are executed via %run, we must keep a reference to their
868 When scripts are executed via %run, we must keep a reference to their
869 __main__ module around so that Python doesn't
869 __main__ module around so that Python doesn't
870 clear it, rendering references to module globals useless.
870 clear it, rendering references to module globals useless.
871
871
872 This method keeps said reference in a private dict, keyed by the
872 This method keeps said reference in a private dict, keyed by the
873 absolute path of the script. This way, for multiple executions of the
873 absolute path of the script. This way, for multiple executions of the
874 same script we only keep one copy of the namespace (the last one),
874 same script we only keep one copy of the namespace (the last one),
875 thus preventing memory leaks from old references while allowing the
875 thus preventing memory leaks from old references while allowing the
876 objects from the last execution to be accessible.
876 objects from the last execution to be accessible.
877 """
877 """
878 filename = os.path.abspath(filename)
878 filename = os.path.abspath(filename)
879 try:
879 try:
880 main_mod = self._main_mod_cache[filename]
880 main_mod = self._main_mod_cache[filename]
881 except KeyError:
881 except KeyError:
882 main_mod = self._main_mod_cache[filename] = types.ModuleType(
882 main_mod = self._main_mod_cache[filename] = types.ModuleType(
883 py3compat.cast_bytes_py2(modname),
883 py3compat.cast_bytes_py2(modname),
884 doc="Module created for script run in IPython")
884 doc="Module created for script run in IPython")
885 else:
885 else:
886 main_mod.__dict__.clear()
886 main_mod.__dict__.clear()
887 main_mod.__name__ = modname
887 main_mod.__name__ = modname
888
888
889 main_mod.__file__ = filename
889 main_mod.__file__ = filename
890 # It seems pydoc (and perhaps others) needs any module instance to
890 # It seems pydoc (and perhaps others) needs any module instance to
891 # implement a __nonzero__ method
891 # implement a __nonzero__ method
892 main_mod.__nonzero__ = lambda : True
892 main_mod.__nonzero__ = lambda : True
893
893
894 return main_mod
894 return main_mod
895
895
896 def clear_main_mod_cache(self):
896 def clear_main_mod_cache(self):
897 """Clear the cache of main modules.
897 """Clear the cache of main modules.
898
898
899 Mainly for use by utilities like %reset.
899 Mainly for use by utilities like %reset.
900
900
901 Examples
901 Examples
902 --------
902 --------
903
903
904 In [15]: import IPython
904 In [15]: import IPython
905
905
906 In [16]: m = _ip.new_main_mod(IPython.__file__, 'IPython')
906 In [16]: m = _ip.new_main_mod(IPython.__file__, 'IPython')
907
907
908 In [17]: len(_ip._main_mod_cache) > 0
908 In [17]: len(_ip._main_mod_cache) > 0
909 Out[17]: True
909 Out[17]: True
910
910
911 In [18]: _ip.clear_main_mod_cache()
911 In [18]: _ip.clear_main_mod_cache()
912
912
913 In [19]: len(_ip._main_mod_cache) == 0
913 In [19]: len(_ip._main_mod_cache) == 0
914 Out[19]: True
914 Out[19]: True
915 """
915 """
916 self._main_mod_cache.clear()
916 self._main_mod_cache.clear()
917
917
918 #-------------------------------------------------------------------------
918 #-------------------------------------------------------------------------
919 # Things related to debugging
919 # Things related to debugging
920 #-------------------------------------------------------------------------
920 #-------------------------------------------------------------------------
921
921
922 def init_pdb(self):
922 def init_pdb(self):
923 # Set calling of pdb on exceptions
923 # Set calling of pdb on exceptions
924 # self.call_pdb is a property
924 # self.call_pdb is a property
925 self.call_pdb = self.pdb
925 self.call_pdb = self.pdb
926
926
927 def _get_call_pdb(self):
927 def _get_call_pdb(self):
928 return self._call_pdb
928 return self._call_pdb
929
929
930 def _set_call_pdb(self,val):
930 def _set_call_pdb(self,val):
931
931
932 if val not in (0,1,False,True):
932 if val not in (0,1,False,True):
933 raise ValueError('new call_pdb value must be boolean')
933 raise ValueError('new call_pdb value must be boolean')
934
934
935 # store value in instance
935 # store value in instance
936 self._call_pdb = val
936 self._call_pdb = val
937
937
938 # notify the actual exception handlers
938 # notify the actual exception handlers
939 self.InteractiveTB.call_pdb = val
939 self.InteractiveTB.call_pdb = val
940
940
941 call_pdb = property(_get_call_pdb,_set_call_pdb,None,
941 call_pdb = property(_get_call_pdb,_set_call_pdb,None,
942 'Control auto-activation of pdb at exceptions')
942 'Control auto-activation of pdb at exceptions')
943
943
944 def debugger(self,force=False):
944 def debugger(self,force=False):
945 """Call the pdb debugger.
945 """Call the pdb debugger.
946
946
947 Keywords:
947 Keywords:
948
948
949 - force(False): by default, this routine checks the instance call_pdb
949 - force(False): by default, this routine checks the instance call_pdb
950 flag and does not actually invoke the debugger if the flag is false.
950 flag and does not actually invoke the debugger if the flag is false.
951 The 'force' option forces the debugger to activate even if the flag
951 The 'force' option forces the debugger to activate even if the flag
952 is false.
952 is false.
953 """
953 """
954
954
955 if not (force or self.call_pdb):
955 if not (force or self.call_pdb):
956 return
956 return
957
957
958 if not hasattr(sys,'last_traceback'):
958 if not hasattr(sys,'last_traceback'):
959 error('No traceback has been produced, nothing to debug.')
959 error('No traceback has been produced, nothing to debug.')
960 return
960 return
961
961
962 self.InteractiveTB.debugger(force=True)
962 self.InteractiveTB.debugger(force=True)
963
963
964 #-------------------------------------------------------------------------
964 #-------------------------------------------------------------------------
965 # Things related to IPython's various namespaces
965 # Things related to IPython's various namespaces
966 #-------------------------------------------------------------------------
966 #-------------------------------------------------------------------------
967 default_user_namespaces = True
967 default_user_namespaces = True
968
968
969 def init_create_namespaces(self, user_module=None, user_ns=None):
969 def init_create_namespaces(self, user_module=None, user_ns=None):
970 # Create the namespace where the user will operate. user_ns is
970 # Create the namespace where the user will operate. user_ns is
971 # normally the only one used, and it is passed to the exec calls as
971 # normally the only one used, and it is passed to the exec calls as
972 # the locals argument. But we do carry a user_global_ns namespace
972 # the locals argument. But we do carry a user_global_ns namespace
973 # given as the exec 'globals' argument, This is useful in embedding
973 # given as the exec 'globals' argument, This is useful in embedding
974 # situations where the ipython shell opens in a context where the
974 # situations where the ipython shell opens in a context where the
975 # distinction between locals and globals is meaningful. For
975 # distinction between locals and globals is meaningful. For
976 # non-embedded contexts, it is just the same object as the user_ns dict.
976 # non-embedded contexts, it is just the same object as the user_ns dict.
977
977
978 # FIXME. For some strange reason, __builtins__ is showing up at user
978 # FIXME. For some strange reason, __builtins__ is showing up at user
979 # level as a dict instead of a module. This is a manual fix, but I
979 # level as a dict instead of a module. This is a manual fix, but I
980 # should really track down where the problem is coming from. Alex
980 # should really track down where the problem is coming from. Alex
981 # Schmolck reported this problem first.
981 # Schmolck reported this problem first.
982
982
983 # A useful post by Alex Martelli on this topic:
983 # A useful post by Alex Martelli on this topic:
984 # Re: inconsistent value from __builtins__
984 # Re: inconsistent value from __builtins__
985 # Von: Alex Martelli <aleaxit@yahoo.com>
985 # Von: Alex Martelli <aleaxit@yahoo.com>
986 # Datum: Freitag 01 Oktober 2004 04:45:34 nachmittags/abends
986 # Datum: Freitag 01 Oktober 2004 04:45:34 nachmittags/abends
987 # Gruppen: comp.lang.python
987 # Gruppen: comp.lang.python
988
988
989 # Michael Hohn <hohn@hooknose.lbl.gov> wrote:
989 # Michael Hohn <hohn@hooknose.lbl.gov> wrote:
990 # > >>> print type(builtin_check.get_global_binding('__builtins__'))
990 # > >>> print type(builtin_check.get_global_binding('__builtins__'))
991 # > <type 'dict'>
991 # > <type 'dict'>
992 # > >>> print type(__builtins__)
992 # > >>> print type(__builtins__)
993 # > <type 'module'>
993 # > <type 'module'>
994 # > Is this difference in return value intentional?
994 # > Is this difference in return value intentional?
995
995
996 # Well, it's documented that '__builtins__' can be either a dictionary
996 # Well, it's documented that '__builtins__' can be either a dictionary
997 # or a module, and it's been that way for a long time. Whether it's
997 # or a module, and it's been that way for a long time. Whether it's
998 # intentional (or sensible), I don't know. In any case, the idea is
998 # intentional (or sensible), I don't know. In any case, the idea is
999 # that if you need to access the built-in namespace directly, you
999 # that if you need to access the built-in namespace directly, you
1000 # should start with "import __builtin__" (note, no 's') which will
1000 # should start with "import __builtin__" (note, no 's') which will
1001 # definitely give you a module. Yeah, it's somewhat confusing:-(.
1001 # definitely give you a module. Yeah, it's somewhat confusing:-(.
1002
1002
1003 # These routines return a properly built module and dict as needed by
1003 # These routines return a properly built module and dict as needed by
1004 # the rest of the code, and can also be used by extension writers to
1004 # the rest of the code, and can also be used by extension writers to
1005 # generate properly initialized namespaces.
1005 # generate properly initialized namespaces.
1006 if (user_ns is not None) or (user_module is not None):
1006 if (user_ns is not None) or (user_module is not None):
1007 self.default_user_namespaces = False
1007 self.default_user_namespaces = False
1008 self.user_module, self.user_ns = self.prepare_user_module(user_module, user_ns)
1008 self.user_module, self.user_ns = self.prepare_user_module(user_module, user_ns)
1009
1009
1010 # A record of hidden variables we have added to the user namespace, so
1010 # A record of hidden variables we have added to the user namespace, so
1011 # we can list later only variables defined in actual interactive use.
1011 # we can list later only variables defined in actual interactive use.
1012 self.user_ns_hidden = {}
1012 self.user_ns_hidden = {}
1013
1013
1014 # Now that FakeModule produces a real module, we've run into a nasty
1014 # Now that FakeModule produces a real module, we've run into a nasty
1015 # problem: after script execution (via %run), the module where the user
1015 # problem: after script execution (via %run), the module where the user
1016 # code ran is deleted. Now that this object is a true module (needed
1016 # code ran is deleted. Now that this object is a true module (needed
1017 # so doctest and other tools work correctly), the Python module
1017 # so doctest and other tools work correctly), the Python module
1018 # teardown mechanism runs over it, and sets to None every variable
1018 # teardown mechanism runs over it, and sets to None every variable
1019 # present in that module. Top-level references to objects from the
1019 # present in that module. Top-level references to objects from the
1020 # script survive, because the user_ns is updated with them. However,
1020 # script survive, because the user_ns is updated with them. However,
1021 # calling functions defined in the script that use other things from
1021 # calling functions defined in the script that use other things from
1022 # the script will fail, because the function's closure had references
1022 # the script will fail, because the function's closure had references
1023 # to the original objects, which are now all None. So we must protect
1023 # to the original objects, which are now all None. So we must protect
1024 # these modules from deletion by keeping a cache.
1024 # these modules from deletion by keeping a cache.
1025 #
1025 #
1026 # To avoid keeping stale modules around (we only need the one from the
1026 # To avoid keeping stale modules around (we only need the one from the
1027 # last run), we use a dict keyed with the full path to the script, so
1027 # last run), we use a dict keyed with the full path to the script, so
1028 # only the last version of the module is held in the cache. Note,
1028 # only the last version of the module is held in the cache. Note,
1029 # however, that we must cache the module *namespace contents* (their
1029 # however, that we must cache the module *namespace contents* (their
1030 # __dict__). Because if we try to cache the actual modules, old ones
1030 # __dict__). Because if we try to cache the actual modules, old ones
1031 # (uncached) could be destroyed while still holding references (such as
1031 # (uncached) could be destroyed while still holding references (such as
1032 # those held by GUI objects that tend to be long-lived)>
1032 # those held by GUI objects that tend to be long-lived)>
1033 #
1033 #
1034 # The %reset command will flush this cache. See the cache_main_mod()
1034 # The %reset command will flush this cache. See the cache_main_mod()
1035 # and clear_main_mod_cache() methods for details on use.
1035 # and clear_main_mod_cache() methods for details on use.
1036
1036
1037 # This is the cache used for 'main' namespaces
1037 # This is the cache used for 'main' namespaces
1038 self._main_mod_cache = {}
1038 self._main_mod_cache = {}
1039
1039
1040 # A table holding all the namespaces IPython deals with, so that
1040 # A table holding all the namespaces IPython deals with, so that
1041 # introspection facilities can search easily.
1041 # introspection facilities can search easily.
1042 self.ns_table = {'user_global':self.user_module.__dict__,
1042 self.ns_table = {'user_global':self.user_module.__dict__,
1043 'user_local':self.user_ns,
1043 'user_local':self.user_ns,
1044 'builtin':builtin_mod.__dict__
1044 'builtin':builtin_mod.__dict__
1045 }
1045 }
1046
1046
1047 @property
1047 @property
1048 def user_global_ns(self):
1048 def user_global_ns(self):
1049 return self.user_module.__dict__
1049 return self.user_module.__dict__
1050
1050
1051 def prepare_user_module(self, user_module=None, user_ns=None):
1051 def prepare_user_module(self, user_module=None, user_ns=None):
1052 """Prepare the module and namespace in which user code will be run.
1052 """Prepare the module and namespace in which user code will be run.
1053
1053
1054 When IPython is started normally, both parameters are None: a new module
1054 When IPython is started normally, both parameters are None: a new module
1055 is created automatically, and its __dict__ used as the namespace.
1055 is created automatically, and its __dict__ used as the namespace.
1056
1056
1057 If only user_module is provided, its __dict__ is used as the namespace.
1057 If only user_module is provided, its __dict__ is used as the namespace.
1058 If only user_ns is provided, a dummy module is created, and user_ns
1058 If only user_ns is provided, a dummy module is created, and user_ns
1059 becomes the global namespace. If both are provided (as they may be
1059 becomes the global namespace. If both are provided (as they may be
1060 when embedding), user_ns is the local namespace, and user_module
1060 when embedding), user_ns is the local namespace, and user_module
1061 provides the global namespace.
1061 provides the global namespace.
1062
1062
1063 Parameters
1063 Parameters
1064 ----------
1064 ----------
1065 user_module : module, optional
1065 user_module : module, optional
1066 The current user module in which IPython is being run. If None,
1066 The current user module in which IPython is being run. If None,
1067 a clean module will be created.
1067 a clean module will be created.
1068 user_ns : dict, optional
1068 user_ns : dict, optional
1069 A namespace in which to run interactive commands.
1069 A namespace in which to run interactive commands.
1070
1070
1071 Returns
1071 Returns
1072 -------
1072 -------
1073 A tuple of user_module and user_ns, each properly initialised.
1073 A tuple of user_module and user_ns, each properly initialised.
1074 """
1074 """
1075 if user_module is None and user_ns is not None:
1075 if user_module is None and user_ns is not None:
1076 user_ns.setdefault("__name__", "__main__")
1076 user_ns.setdefault("__name__", "__main__")
1077 user_module = DummyMod()
1077 user_module = DummyMod()
1078 user_module.__dict__ = user_ns
1078 user_module.__dict__ = user_ns
1079
1079
1080 if user_module is None:
1080 if user_module is None:
1081 user_module = types.ModuleType("__main__",
1081 user_module = types.ModuleType("__main__",
1082 doc="Automatically created module for IPython interactive environment")
1082 doc="Automatically created module for IPython interactive environment")
1083
1083
1084 # We must ensure that __builtin__ (without the final 's') is always
1084 # We must ensure that __builtin__ (without the final 's') is always
1085 # available and pointing to the __builtin__ *module*. For more details:
1085 # available and pointing to the __builtin__ *module*. For more details:
1086 # http://mail.python.org/pipermail/python-dev/2001-April/014068.html
1086 # http://mail.python.org/pipermail/python-dev/2001-April/014068.html
1087 user_module.__dict__.setdefault('__builtin__', builtin_mod)
1087 user_module.__dict__.setdefault('__builtin__', builtin_mod)
1088 user_module.__dict__.setdefault('__builtins__', builtin_mod)
1088 user_module.__dict__.setdefault('__builtins__', builtin_mod)
1089
1089
1090 if user_ns is None:
1090 if user_ns is None:
1091 user_ns = user_module.__dict__
1091 user_ns = user_module.__dict__
1092
1092
1093 return user_module, user_ns
1093 return user_module, user_ns
1094
1094
1095 def init_sys_modules(self):
1095 def init_sys_modules(self):
1096 # We need to insert into sys.modules something that looks like a
1096 # We need to insert into sys.modules something that looks like a
1097 # module but which accesses the IPython namespace, for shelve and
1097 # module but which accesses the IPython namespace, for shelve and
1098 # pickle to work interactively. Normally they rely on getting
1098 # pickle to work interactively. Normally they rely on getting
1099 # everything out of __main__, but for embedding purposes each IPython
1099 # everything out of __main__, but for embedding purposes each IPython
1100 # instance has its own private namespace, so we can't go shoving
1100 # instance has its own private namespace, so we can't go shoving
1101 # everything into __main__.
1101 # everything into __main__.
1102
1102
1103 # note, however, that we should only do this for non-embedded
1103 # note, however, that we should only do this for non-embedded
1104 # ipythons, which really mimic the __main__.__dict__ with their own
1104 # ipythons, which really mimic the __main__.__dict__ with their own
1105 # namespace. Embedded instances, on the other hand, should not do
1105 # namespace. Embedded instances, on the other hand, should not do
1106 # this because they need to manage the user local/global namespaces
1106 # this because they need to manage the user local/global namespaces
1107 # only, but they live within a 'normal' __main__ (meaning, they
1107 # only, but they live within a 'normal' __main__ (meaning, they
1108 # shouldn't overtake the execution environment of the script they're
1108 # shouldn't overtake the execution environment of the script they're
1109 # embedded in).
1109 # embedded in).
1110
1110
1111 # This is overridden in the InteractiveShellEmbed subclass to a no-op.
1111 # This is overridden in the InteractiveShellEmbed subclass to a no-op.
1112 main_name = self.user_module.__name__
1112 main_name = self.user_module.__name__
1113 sys.modules[main_name] = self.user_module
1113 sys.modules[main_name] = self.user_module
1114
1114
1115 def init_user_ns(self):
1115 def init_user_ns(self):
1116 """Initialize all user-visible namespaces to their minimum defaults.
1116 """Initialize all user-visible namespaces to their minimum defaults.
1117
1117
1118 Certain history lists are also initialized here, as they effectively
1118 Certain history lists are also initialized here, as they effectively
1119 act as user namespaces.
1119 act as user namespaces.
1120
1120
1121 Notes
1121 Notes
1122 -----
1122 -----
1123 All data structures here are only filled in, they are NOT reset by this
1123 All data structures here are only filled in, they are NOT reset by this
1124 method. If they were not empty before, data will simply be added to
1124 method. If they were not empty before, data will simply be added to
1125 therm.
1125 therm.
1126 """
1126 """
1127 # This function works in two parts: first we put a few things in
1127 # This function works in two parts: first we put a few things in
1128 # user_ns, and we sync that contents into user_ns_hidden so that these
1128 # user_ns, and we sync that contents into user_ns_hidden so that these
1129 # initial variables aren't shown by %who. After the sync, we add the
1129 # initial variables aren't shown by %who. After the sync, we add the
1130 # rest of what we *do* want the user to see with %who even on a new
1130 # rest of what we *do* want the user to see with %who even on a new
1131 # session (probably nothing, so they really only see their own stuff)
1131 # session (probably nothing, so they really only see their own stuff)
1132
1132
1133 # The user dict must *always* have a __builtin__ reference to the
1133 # The user dict must *always* have a __builtin__ reference to the
1134 # Python standard __builtin__ namespace, which must be imported.
1134 # Python standard __builtin__ namespace, which must be imported.
1135 # This is so that certain operations in prompt evaluation can be
1135 # This is so that certain operations in prompt evaluation can be
1136 # reliably executed with builtins. Note that we can NOT use
1136 # reliably executed with builtins. Note that we can NOT use
1137 # __builtins__ (note the 's'), because that can either be a dict or a
1137 # __builtins__ (note the 's'), because that can either be a dict or a
1138 # module, and can even mutate at runtime, depending on the context
1138 # module, and can even mutate at runtime, depending on the context
1139 # (Python makes no guarantees on it). In contrast, __builtin__ is
1139 # (Python makes no guarantees on it). In contrast, __builtin__ is
1140 # always a module object, though it must be explicitly imported.
1140 # always a module object, though it must be explicitly imported.
1141
1141
1142 # For more details:
1142 # For more details:
1143 # http://mail.python.org/pipermail/python-dev/2001-April/014068.html
1143 # http://mail.python.org/pipermail/python-dev/2001-April/014068.html
1144 ns = {}
1144 ns = {}
1145
1145
1146 # make global variables for user access to the histories
1146 # make global variables for user access to the histories
1147 ns['_ih'] = self.history_manager.input_hist_parsed
1147 ns['_ih'] = self.history_manager.input_hist_parsed
1148 ns['_oh'] = self.history_manager.output_hist
1148 ns['_oh'] = self.history_manager.output_hist
1149 ns['_dh'] = self.history_manager.dir_hist
1149 ns['_dh'] = self.history_manager.dir_hist
1150
1150
1151 ns['_sh'] = shadowns
1151 ns['_sh'] = shadowns
1152
1152
1153 # user aliases to input and output histories. These shouldn't show up
1153 # user aliases to input and output histories. These shouldn't show up
1154 # in %who, as they can have very large reprs.
1154 # in %who, as they can have very large reprs.
1155 ns['In'] = self.history_manager.input_hist_parsed
1155 ns['In'] = self.history_manager.input_hist_parsed
1156 ns['Out'] = self.history_manager.output_hist
1156 ns['Out'] = self.history_manager.output_hist
1157
1157
1158 # Store myself as the public api!!!
1158 # Store myself as the public api!!!
1159 ns['get_ipython'] = self.get_ipython
1159 ns['get_ipython'] = self.get_ipython
1160
1160
1161 ns['exit'] = self.exiter
1161 ns['exit'] = self.exiter
1162 ns['quit'] = self.exiter
1162 ns['quit'] = self.exiter
1163
1163
1164 # Sync what we've added so far to user_ns_hidden so these aren't seen
1164 # Sync what we've added so far to user_ns_hidden so these aren't seen
1165 # by %who
1165 # by %who
1166 self.user_ns_hidden.update(ns)
1166 self.user_ns_hidden.update(ns)
1167
1167
1168 # Anything put into ns now would show up in %who. Think twice before
1168 # Anything put into ns now would show up in %who. Think twice before
1169 # putting anything here, as we really want %who to show the user their
1169 # putting anything here, as we really want %who to show the user their
1170 # stuff, not our variables.
1170 # stuff, not our variables.
1171
1171
1172 # Finally, update the real user's namespace
1172 # Finally, update the real user's namespace
1173 self.user_ns.update(ns)
1173 self.user_ns.update(ns)
1174
1174
1175 @property
1175 @property
1176 def all_ns_refs(self):
1176 def all_ns_refs(self):
1177 """Get a list of references to all the namespace dictionaries in which
1177 """Get a list of references to all the namespace dictionaries in which
1178 IPython might store a user-created object.
1178 IPython might store a user-created object.
1179
1179
1180 Note that this does not include the displayhook, which also caches
1180 Note that this does not include the displayhook, which also caches
1181 objects from the output."""
1181 objects from the output."""
1182 return [self.user_ns, self.user_global_ns, self.user_ns_hidden] + \
1182 return [self.user_ns, self.user_global_ns, self.user_ns_hidden] + \
1183 [m.__dict__ for m in self._main_mod_cache.values()]
1183 [m.__dict__ for m in self._main_mod_cache.values()]
1184
1184
1185 def reset(self, new_session=True):
1185 def reset(self, new_session=True):
1186 """Clear all internal namespaces, and attempt to release references to
1186 """Clear all internal namespaces, and attempt to release references to
1187 user objects.
1187 user objects.
1188
1188
1189 If new_session is True, a new history session will be opened.
1189 If new_session is True, a new history session will be opened.
1190 """
1190 """
1191 # Clear histories
1191 # Clear histories
1192 self.history_manager.reset(new_session)
1192 self.history_manager.reset(new_session)
1193 # Reset counter used to index all histories
1193 # Reset counter used to index all histories
1194 if new_session:
1194 if new_session:
1195 self.execution_count = 1
1195 self.execution_count = 1
1196
1196
1197 # Flush cached output items
1197 # Flush cached output items
1198 if self.displayhook.do_full_cache:
1198 if self.displayhook.do_full_cache:
1199 self.displayhook.flush()
1199 self.displayhook.flush()
1200
1200
1201 # The main execution namespaces must be cleared very carefully,
1201 # The main execution namespaces must be cleared very carefully,
1202 # skipping the deletion of the builtin-related keys, because doing so
1202 # skipping the deletion of the builtin-related keys, because doing so
1203 # would cause errors in many object's __del__ methods.
1203 # would cause errors in many object's __del__ methods.
1204 if self.user_ns is not self.user_global_ns:
1204 if self.user_ns is not self.user_global_ns:
1205 self.user_ns.clear()
1205 self.user_ns.clear()
1206 ns = self.user_global_ns
1206 ns = self.user_global_ns
1207 drop_keys = set(ns.keys())
1207 drop_keys = set(ns.keys())
1208 drop_keys.discard('__builtin__')
1208 drop_keys.discard('__builtin__')
1209 drop_keys.discard('__builtins__')
1209 drop_keys.discard('__builtins__')
1210 drop_keys.discard('__name__')
1210 drop_keys.discard('__name__')
1211 for k in drop_keys:
1211 for k in drop_keys:
1212 del ns[k]
1212 del ns[k]
1213
1213
1214 self.user_ns_hidden.clear()
1214 self.user_ns_hidden.clear()
1215
1215
1216 # Restore the user namespaces to minimal usability
1216 # Restore the user namespaces to minimal usability
1217 self.init_user_ns()
1217 self.init_user_ns()
1218
1218
1219 # Restore the default and user aliases
1219 # Restore the default and user aliases
1220 self.alias_manager.clear_aliases()
1220 self.alias_manager.clear_aliases()
1221 self.alias_manager.init_aliases()
1221 self.alias_manager.init_aliases()
1222
1222
1223 # Flush the private list of module references kept for script
1223 # Flush the private list of module references kept for script
1224 # execution protection
1224 # execution protection
1225 self.clear_main_mod_cache()
1225 self.clear_main_mod_cache()
1226
1226
1227 def del_var(self, varname, by_name=False):
1227 def del_var(self, varname, by_name=False):
1228 """Delete a variable from the various namespaces, so that, as
1228 """Delete a variable from the various namespaces, so that, as
1229 far as possible, we're not keeping any hidden references to it.
1229 far as possible, we're not keeping any hidden references to it.
1230
1230
1231 Parameters
1231 Parameters
1232 ----------
1232 ----------
1233 varname : str
1233 varname : str
1234 The name of the variable to delete.
1234 The name of the variable to delete.
1235 by_name : bool
1235 by_name : bool
1236 If True, delete variables with the given name in each
1236 If True, delete variables with the given name in each
1237 namespace. If False (default), find the variable in the user
1237 namespace. If False (default), find the variable in the user
1238 namespace, and delete references to it.
1238 namespace, and delete references to it.
1239 """
1239 """
1240 if varname in ('__builtin__', '__builtins__'):
1240 if varname in ('__builtin__', '__builtins__'):
1241 raise ValueError("Refusing to delete %s" % varname)
1241 raise ValueError("Refusing to delete %s" % varname)
1242
1242
1243 ns_refs = self.all_ns_refs
1243 ns_refs = self.all_ns_refs
1244
1244
1245 if by_name: # Delete by name
1245 if by_name: # Delete by name
1246 for ns in ns_refs:
1246 for ns in ns_refs:
1247 try:
1247 try:
1248 del ns[varname]
1248 del ns[varname]
1249 except KeyError:
1249 except KeyError:
1250 pass
1250 pass
1251 else: # Delete by object
1251 else: # Delete by object
1252 try:
1252 try:
1253 obj = self.user_ns[varname]
1253 obj = self.user_ns[varname]
1254 except KeyError:
1254 except KeyError:
1255 raise NameError("name '%s' is not defined" % varname)
1255 raise NameError("name '%s' is not defined" % varname)
1256 # Also check in output history
1256 # Also check in output history
1257 ns_refs.append(self.history_manager.output_hist)
1257 ns_refs.append(self.history_manager.output_hist)
1258 for ns in ns_refs:
1258 for ns in ns_refs:
1259 to_delete = [n for n, o in ns.items() if o is obj]
1259 to_delete = [n for n, o in ns.items() if o is obj]
1260 for name in to_delete:
1260 for name in to_delete:
1261 del ns[name]
1261 del ns[name]
1262
1262
1263 # displayhook keeps extra references, but not in a dictionary
1263 # displayhook keeps extra references, but not in a dictionary
1264 for name in ('_', '__', '___'):
1264 for name in ('_', '__', '___'):
1265 if getattr(self.displayhook, name) is obj:
1265 if getattr(self.displayhook, name) is obj:
1266 setattr(self.displayhook, name, None)
1266 setattr(self.displayhook, name, None)
1267
1267
1268 def reset_selective(self, regex=None):
1268 def reset_selective(self, regex=None):
1269 """Clear selective variables from internal namespaces based on a
1269 """Clear selective variables from internal namespaces based on a
1270 specified regular expression.
1270 specified regular expression.
1271
1271
1272 Parameters
1272 Parameters
1273 ----------
1273 ----------
1274 regex : string or compiled pattern, optional
1274 regex : string or compiled pattern, optional
1275 A regular expression pattern that will be used in searching
1275 A regular expression pattern that will be used in searching
1276 variable names in the users namespaces.
1276 variable names in the users namespaces.
1277 """
1277 """
1278 if regex is not None:
1278 if regex is not None:
1279 try:
1279 try:
1280 m = re.compile(regex)
1280 m = re.compile(regex)
1281 except TypeError:
1281 except TypeError:
1282 raise TypeError('regex must be a string or compiled pattern')
1282 raise TypeError('regex must be a string or compiled pattern')
1283 # Search for keys in each namespace that match the given regex
1283 # Search for keys in each namespace that match the given regex
1284 # If a match is found, delete the key/value pair.
1284 # If a match is found, delete the key/value pair.
1285 for ns in self.all_ns_refs:
1285 for ns in self.all_ns_refs:
1286 for var in ns:
1286 for var in ns:
1287 if m.search(var):
1287 if m.search(var):
1288 del ns[var]
1288 del ns[var]
1289
1289
1290 def push(self, variables, interactive=True):
1290 def push(self, variables, interactive=True):
1291 """Inject a group of variables into the IPython user namespace.
1291 """Inject a group of variables into the IPython user namespace.
1292
1292
1293 Parameters
1293 Parameters
1294 ----------
1294 ----------
1295 variables : dict, str or list/tuple of str
1295 variables : dict, str or list/tuple of str
1296 The variables to inject into the user's namespace. If a dict, a
1296 The variables to inject into the user's namespace. If a dict, a
1297 simple update is done. If a str, the string is assumed to have
1297 simple update is done. If a str, the string is assumed to have
1298 variable names separated by spaces. A list/tuple of str can also
1298 variable names separated by spaces. A list/tuple of str can also
1299 be used to give the variable names. If just the variable names are
1299 be used to give the variable names. If just the variable names are
1300 give (list/tuple/str) then the variable values looked up in the
1300 give (list/tuple/str) then the variable values looked up in the
1301 callers frame.
1301 callers frame.
1302 interactive : bool
1302 interactive : bool
1303 If True (default), the variables will be listed with the ``who``
1303 If True (default), the variables will be listed with the ``who``
1304 magic.
1304 magic.
1305 """
1305 """
1306 vdict = None
1306 vdict = None
1307
1307
1308 # We need a dict of name/value pairs to do namespace updates.
1308 # We need a dict of name/value pairs to do namespace updates.
1309 if isinstance(variables, dict):
1309 if isinstance(variables, dict):
1310 vdict = variables
1310 vdict = variables
1311 elif isinstance(variables, (str, list, tuple)):
1311 elif isinstance(variables, (str, list, tuple)):
1312 if isinstance(variables, str):
1312 if isinstance(variables, str):
1313 vlist = variables.split()
1313 vlist = variables.split()
1314 else:
1314 else:
1315 vlist = variables
1315 vlist = variables
1316 vdict = {}
1316 vdict = {}
1317 cf = sys._getframe(1)
1317 cf = sys._getframe(1)
1318 for name in vlist:
1318 for name in vlist:
1319 try:
1319 try:
1320 vdict[name] = eval(name, cf.f_globals, cf.f_locals)
1320 vdict[name] = eval(name, cf.f_globals, cf.f_locals)
1321 except:
1321 except:
1322 print('Could not get variable %s from %s' %
1322 print('Could not get variable %s from %s' %
1323 (name,cf.f_code.co_name))
1323 (name,cf.f_code.co_name))
1324 else:
1324 else:
1325 raise ValueError('variables must be a dict/str/list/tuple')
1325 raise ValueError('variables must be a dict/str/list/tuple')
1326
1326
1327 # Propagate variables to user namespace
1327 # Propagate variables to user namespace
1328 self.user_ns.update(vdict)
1328 self.user_ns.update(vdict)
1329
1329
1330 # And configure interactive visibility
1330 # And configure interactive visibility
1331 user_ns_hidden = self.user_ns_hidden
1331 user_ns_hidden = self.user_ns_hidden
1332 if interactive:
1332 if interactive:
1333 for name in vdict:
1333 for name in vdict:
1334 user_ns_hidden.pop(name, None)
1334 user_ns_hidden.pop(name, None)
1335 else:
1335 else:
1336 user_ns_hidden.update(vdict)
1336 user_ns_hidden.update(vdict)
1337
1337
1338 def drop_by_id(self, variables):
1338 def drop_by_id(self, variables):
1339 """Remove a dict of variables from the user namespace, if they are the
1339 """Remove a dict of variables from the user namespace, if they are the
1340 same as the values in the dictionary.
1340 same as the values in the dictionary.
1341
1341
1342 This is intended for use by extensions: variables that they've added can
1342 This is intended for use by extensions: variables that they've added can
1343 be taken back out if they are unloaded, without removing any that the
1343 be taken back out if they are unloaded, without removing any that the
1344 user has overwritten.
1344 user has overwritten.
1345
1345
1346 Parameters
1346 Parameters
1347 ----------
1347 ----------
1348 variables : dict
1348 variables : dict
1349 A dictionary mapping object names (as strings) to the objects.
1349 A dictionary mapping object names (as strings) to the objects.
1350 """
1350 """
1351 for name, obj in variables.items():
1351 for name, obj in variables.items():
1352 if name in self.user_ns and self.user_ns[name] is obj:
1352 if name in self.user_ns and self.user_ns[name] is obj:
1353 del self.user_ns[name]
1353 del self.user_ns[name]
1354 self.user_ns_hidden.pop(name, None)
1354 self.user_ns_hidden.pop(name, None)
1355
1355
1356 #-------------------------------------------------------------------------
1356 #-------------------------------------------------------------------------
1357 # Things related to object introspection
1357 # Things related to object introspection
1358 #-------------------------------------------------------------------------
1358 #-------------------------------------------------------------------------
1359
1359
1360 def _ofind(self, oname, namespaces=None):
1360 def _ofind(self, oname, namespaces=None):
1361 """Find an object in the available namespaces.
1361 """Find an object in the available namespaces.
1362
1362
1363 self._ofind(oname) -> dict with keys: found,obj,ospace,ismagic
1363 self._ofind(oname) -> dict with keys: found,obj,ospace,ismagic
1364
1364
1365 Has special code to detect magic functions.
1365 Has special code to detect magic functions.
1366 """
1366 """
1367 oname = oname.strip()
1367 oname = oname.strip()
1368 #print '1- oname: <%r>' % oname # dbg
1368 #print '1- oname: <%r>' % oname # dbg
1369 if not oname.startswith(ESC_MAGIC) and \
1369 if not oname.startswith(ESC_MAGIC) and \
1370 not oname.startswith(ESC_MAGIC2) and \
1370 not oname.startswith(ESC_MAGIC2) and \
1371 not py3compat.isidentifier(oname, dotted=True):
1371 not py3compat.isidentifier(oname, dotted=True):
1372 return {'found': False}
1372 return {'found': False}
1373
1373
1374 if namespaces is None:
1374 if namespaces is None:
1375 # Namespaces to search in:
1375 # Namespaces to search in:
1376 # Put them in a list. The order is important so that we
1376 # Put them in a list. The order is important so that we
1377 # find things in the same order that Python finds them.
1377 # find things in the same order that Python finds them.
1378 namespaces = [ ('Interactive', self.user_ns),
1378 namespaces = [ ('Interactive', self.user_ns),
1379 ('Interactive (global)', self.user_global_ns),
1379 ('Interactive (global)', self.user_global_ns),
1380 ('Python builtin', builtin_mod.__dict__),
1380 ('Python builtin', builtin_mod.__dict__),
1381 ]
1381 ]
1382
1382
1383 # initialize results to 'null'
1383 # initialize results to 'null'
1384 found = False; obj = None; ospace = None;
1384 found = False; obj = None; ospace = None;
1385 ismagic = False; isalias = False; parent = None
1385 ismagic = False; isalias = False; parent = None
1386
1386
1387 # Look for the given name by splitting it in parts. If the head is
1387 # Look for the given name by splitting it in parts. If the head is
1388 # found, then we look for all the remaining parts as members, and only
1388 # found, then we look for all the remaining parts as members, and only
1389 # declare success if we can find them all.
1389 # declare success if we can find them all.
1390 oname_parts = oname.split('.')
1390 oname_parts = oname.split('.')
1391 oname_head, oname_rest = oname_parts[0],oname_parts[1:]
1391 oname_head, oname_rest = oname_parts[0],oname_parts[1:]
1392 for nsname,ns in namespaces:
1392 for nsname,ns in namespaces:
1393 try:
1393 try:
1394 obj = ns[oname_head]
1394 obj = ns[oname_head]
1395 except KeyError:
1395 except KeyError:
1396 continue
1396 continue
1397 else:
1397 else:
1398 #print 'oname_rest:', oname_rest # dbg
1398 #print 'oname_rest:', oname_rest # dbg
1399 for idx, part in enumerate(oname_rest):
1399 for idx, part in enumerate(oname_rest):
1400 try:
1400 try:
1401 parent = obj
1401 parent = obj
1402 # The last part is looked up in a special way to avoid
1402 # The last part is looked up in a special way to avoid
1403 # descriptor invocation as it may raise or have side
1403 # descriptor invocation as it may raise or have side
1404 # effects.
1404 # effects.
1405 if idx == len(oname_rest) - 1:
1405 if idx == len(oname_rest) - 1:
1406 obj = self._getattr_property(obj, part)
1406 obj = self._getattr_property(obj, part)
1407 else:
1407 else:
1408 obj = getattr(obj, part)
1408 obj = getattr(obj, part)
1409 except:
1409 except:
1410 # Blanket except b/c some badly implemented objects
1410 # Blanket except b/c some badly implemented objects
1411 # allow __getattr__ to raise exceptions other than
1411 # allow __getattr__ to raise exceptions other than
1412 # AttributeError, which then crashes IPython.
1412 # AttributeError, which then crashes IPython.
1413 break
1413 break
1414 else:
1414 else:
1415 # If we finish the for loop (no break), we got all members
1415 # If we finish the for loop (no break), we got all members
1416 found = True
1416 found = True
1417 ospace = nsname
1417 ospace = nsname
1418 break # namespace loop
1418 break # namespace loop
1419
1419
1420 # Try to see if it's magic
1420 # Try to see if it's magic
1421 if not found:
1421 if not found:
1422 obj = None
1422 obj = None
1423 if oname.startswith(ESC_MAGIC2):
1423 if oname.startswith(ESC_MAGIC2):
1424 oname = oname.lstrip(ESC_MAGIC2)
1424 oname = oname.lstrip(ESC_MAGIC2)
1425 obj = self.find_cell_magic(oname)
1425 obj = self.find_cell_magic(oname)
1426 elif oname.startswith(ESC_MAGIC):
1426 elif oname.startswith(ESC_MAGIC):
1427 oname = oname.lstrip(ESC_MAGIC)
1427 oname = oname.lstrip(ESC_MAGIC)
1428 obj = self.find_line_magic(oname)
1428 obj = self.find_line_magic(oname)
1429 else:
1429 else:
1430 # search without prefix, so run? will find %run?
1430 # search without prefix, so run? will find %run?
1431 obj = self.find_line_magic(oname)
1431 obj = self.find_line_magic(oname)
1432 if obj is None:
1432 if obj is None:
1433 obj = self.find_cell_magic(oname)
1433 obj = self.find_cell_magic(oname)
1434 if obj is not None:
1434 if obj is not None:
1435 found = True
1435 found = True
1436 ospace = 'IPython internal'
1436 ospace = 'IPython internal'
1437 ismagic = True
1437 ismagic = True
1438 isalias = isinstance(obj, Alias)
1438 isalias = isinstance(obj, Alias)
1439
1439
1440 # Last try: special-case some literals like '', [], {}, etc:
1440 # Last try: special-case some literals like '', [], {}, etc:
1441 if not found and oname_head in ["''",'""','[]','{}','()']:
1441 if not found and oname_head in ["''",'""','[]','{}','()']:
1442 obj = eval(oname_head)
1442 obj = eval(oname_head)
1443 found = True
1443 found = True
1444 ospace = 'Interactive'
1444 ospace = 'Interactive'
1445
1445
1446 return {'found':found, 'obj':obj, 'namespace':ospace,
1446 return {'found':found, 'obj':obj, 'namespace':ospace,
1447 'ismagic':ismagic, 'isalias':isalias, 'parent':parent}
1447 'ismagic':ismagic, 'isalias':isalias, 'parent':parent}
1448
1448
1449 @staticmethod
1449 @staticmethod
1450 def _getattr_property(obj, attrname):
1450 def _getattr_property(obj, attrname):
1451 """Property-aware getattr to use in object finding.
1451 """Property-aware getattr to use in object finding.
1452
1452
1453 If attrname represents a property, return it unevaluated (in case it has
1453 If attrname represents a property, return it unevaluated (in case it has
1454 side effects or raises an error.
1454 side effects or raises an error.
1455
1455
1456 """
1456 """
1457 if not isinstance(obj, type):
1457 if not isinstance(obj, type):
1458 try:
1458 try:
1459 # `getattr(type(obj), attrname)` is not guaranteed to return
1459 # `getattr(type(obj), attrname)` is not guaranteed to return
1460 # `obj`, but does so for property:
1460 # `obj`, but does so for property:
1461 #
1461 #
1462 # property.__get__(self, None, cls) -> self
1462 # property.__get__(self, None, cls) -> self
1463 #
1463 #
1464 # The universal alternative is to traverse the mro manually
1464 # The universal alternative is to traverse the mro manually
1465 # searching for attrname in class dicts.
1465 # searching for attrname in class dicts.
1466 attr = getattr(type(obj), attrname)
1466 attr = getattr(type(obj), attrname)
1467 except AttributeError:
1467 except AttributeError:
1468 pass
1468 pass
1469 else:
1469 else:
1470 # This relies on the fact that data descriptors (with both
1470 # This relies on the fact that data descriptors (with both
1471 # __get__ & __set__ magic methods) take precedence over
1471 # __get__ & __set__ magic methods) take precedence over
1472 # instance-level attributes:
1472 # instance-level attributes:
1473 #
1473 #
1474 # class A(object):
1474 # class A(object):
1475 # @property
1475 # @property
1476 # def foobar(self): return 123
1476 # def foobar(self): return 123
1477 # a = A()
1477 # a = A()
1478 # a.__dict__['foobar'] = 345
1478 # a.__dict__['foobar'] = 345
1479 # a.foobar # == 123
1479 # a.foobar # == 123
1480 #
1480 #
1481 # So, a property may be returned right away.
1481 # So, a property may be returned right away.
1482 if isinstance(attr, property):
1482 if isinstance(attr, property):
1483 return attr
1483 return attr
1484
1484
1485 # Nothing helped, fall back.
1485 # Nothing helped, fall back.
1486 return getattr(obj, attrname)
1486 return getattr(obj, attrname)
1487
1487
1488 def _object_find(self, oname, namespaces=None):
1488 def _object_find(self, oname, namespaces=None):
1489 """Find an object and return a struct with info about it."""
1489 """Find an object and return a struct with info about it."""
1490 return Struct(self._ofind(oname, namespaces))
1490 return Struct(self._ofind(oname, namespaces))
1491
1491
1492 def _inspect(self, meth, oname, namespaces=None, **kw):
1492 def _inspect(self, meth, oname, namespaces=None, **kw):
1493 """Generic interface to the inspector system.
1493 """Generic interface to the inspector system.
1494
1494
1495 This function is meant to be called by pdef, pdoc & friends.
1495 This function is meant to be called by pdef, pdoc & friends.
1496 """
1496 """
1497 info = self._object_find(oname, namespaces)
1497 info = self._object_find(oname, namespaces)
1498 docformat = sphinxify if self.sphinxify_docstring else None
1498 docformat = sphinxify if self.sphinxify_docstring else None
1499 if info.found:
1499 if info.found:
1500 pmethod = getattr(self.inspector, meth)
1500 pmethod = getattr(self.inspector, meth)
1501 # TODO: only apply format_screen to the plain/text repr of the mime
1501 # TODO: only apply format_screen to the plain/text repr of the mime
1502 # bundle.
1502 # bundle.
1503 formatter = format_screen if info.ismagic else docformat
1503 formatter = format_screen if info.ismagic else docformat
1504 if meth == 'pdoc':
1504 if meth == 'pdoc':
1505 pmethod(info.obj, oname, formatter)
1505 pmethod(info.obj, oname, formatter)
1506 elif meth == 'pinfo':
1506 elif meth == 'pinfo':
1507 pmethod(info.obj, oname, formatter, info,
1507 pmethod(info.obj, oname, formatter, info,
1508 enable_html_pager=self.enable_html_pager, **kw)
1508 enable_html_pager=self.enable_html_pager, **kw)
1509 else:
1509 else:
1510 pmethod(info.obj, oname)
1510 pmethod(info.obj, oname)
1511 else:
1511 else:
1512 print('Object `%s` not found.' % oname)
1512 print('Object `%s` not found.' % oname)
1513 return 'not found' # so callers can take other action
1513 return 'not found' # so callers can take other action
1514
1514
1515 def object_inspect(self, oname, detail_level=0):
1515 def object_inspect(self, oname, detail_level=0):
1516 """Get object info about oname"""
1516 """Get object info about oname"""
1517 with self.builtin_trap:
1517 with self.builtin_trap:
1518 info = self._object_find(oname)
1518 info = self._object_find(oname)
1519 if info.found:
1519 if info.found:
1520 return self.inspector.info(info.obj, oname, info=info,
1520 return self.inspector.info(info.obj, oname, info=info,
1521 detail_level=detail_level
1521 detail_level=detail_level
1522 )
1522 )
1523 else:
1523 else:
1524 return oinspect.object_info(name=oname, found=False)
1524 return oinspect.object_info(name=oname, found=False)
1525
1525
1526 def object_inspect_text(self, oname, detail_level=0):
1526 def object_inspect_text(self, oname, detail_level=0):
1527 """Get object info as formatted text"""
1527 """Get object info as formatted text"""
1528 return self.object_inspect_mime(oname, detail_level)['text/plain']
1528 return self.object_inspect_mime(oname, detail_level)['text/plain']
1529
1529
1530 def object_inspect_mime(self, oname, detail_level=0):
1530 def object_inspect_mime(self, oname, detail_level=0):
1531 """Get object info as a mimebundle of formatted representations.
1531 """Get object info as a mimebundle of formatted representations.
1532
1532
1533 A mimebundle is a dictionary, keyed by mime-type.
1533 A mimebundle is a dictionary, keyed by mime-type.
1534 It must always have the key `'text/plain'`.
1534 It must always have the key `'text/plain'`.
1535 """
1535 """
1536 with self.builtin_trap:
1536 with self.builtin_trap:
1537 info = self._object_find(oname)
1537 info = self._object_find(oname)
1538 if info.found:
1538 if info.found:
1539 return self.inspector._get_info(info.obj, oname, info=info,
1539 return self.inspector._get_info(info.obj, oname, info=info,
1540 detail_level=detail_level
1540 detail_level=detail_level
1541 )
1541 )
1542 else:
1542 else:
1543 raise KeyError(oname)
1543 raise KeyError(oname)
1544
1544
1545 #-------------------------------------------------------------------------
1545 #-------------------------------------------------------------------------
1546 # Things related to history management
1546 # Things related to history management
1547 #-------------------------------------------------------------------------
1547 #-------------------------------------------------------------------------
1548
1548
1549 def init_history(self):
1549 def init_history(self):
1550 """Sets up the command history, and starts regular autosaves."""
1550 """Sets up the command history, and starts regular autosaves."""
1551 self.history_manager = HistoryManager(shell=self, parent=self)
1551 self.history_manager = HistoryManager(shell=self, parent=self)
1552 self.configurables.append(self.history_manager)
1552 self.configurables.append(self.history_manager)
1553
1553
1554 #-------------------------------------------------------------------------
1554 #-------------------------------------------------------------------------
1555 # Things related to exception handling and tracebacks (not debugging)
1555 # Things related to exception handling and tracebacks (not debugging)
1556 #-------------------------------------------------------------------------
1556 #-------------------------------------------------------------------------
1557
1557
1558 debugger_cls = Pdb
1558 debugger_cls = Pdb
1559
1559
1560 def init_traceback_handlers(self, custom_exceptions):
1560 def init_traceback_handlers(self, custom_exceptions):
1561 # Syntax error handler.
1561 # Syntax error handler.
1562 self.SyntaxTB = ultratb.SyntaxTB(color_scheme='NoColor', parent=self)
1562 self.SyntaxTB = ultratb.SyntaxTB(color_scheme='NoColor', parent=self)
1563
1563
1564 # The interactive one is initialized with an offset, meaning we always
1564 # The interactive one is initialized with an offset, meaning we always
1565 # want to remove the topmost item in the traceback, which is our own
1565 # want to remove the topmost item in the traceback, which is our own
1566 # internal code. Valid modes: ['Plain','Context','Verbose']
1566 # internal code. Valid modes: ['Plain','Context','Verbose']
1567 self.InteractiveTB = ultratb.AutoFormattedTB(mode = 'Plain',
1567 self.InteractiveTB = ultratb.AutoFormattedTB(mode = 'Plain',
1568 color_scheme='NoColor',
1568 color_scheme='NoColor',
1569 tb_offset = 1,
1569 tb_offset = 1,
1570 check_cache=check_linecache_ipython,
1570 check_cache=check_linecache_ipython,
1571 debugger_cls=self.debugger_cls, parent=self)
1571 debugger_cls=self.debugger_cls, parent=self)
1572
1572
1573 # The instance will store a pointer to the system-wide exception hook,
1573 # The instance will store a pointer to the system-wide exception hook,
1574 # so that runtime code (such as magics) can access it. This is because
1574 # so that runtime code (such as magics) can access it. This is because
1575 # during the read-eval loop, it may get temporarily overwritten.
1575 # during the read-eval loop, it may get temporarily overwritten.
1576 self.sys_excepthook = sys.excepthook
1576 self.sys_excepthook = sys.excepthook
1577
1577
1578 # and add any custom exception handlers the user may have specified
1578 # and add any custom exception handlers the user may have specified
1579 self.set_custom_exc(*custom_exceptions)
1579 self.set_custom_exc(*custom_exceptions)
1580
1580
1581 # Set the exception mode
1581 # Set the exception mode
1582 self.InteractiveTB.set_mode(mode=self.xmode)
1582 self.InteractiveTB.set_mode(mode=self.xmode)
1583
1583
1584 def set_custom_exc(self, exc_tuple, handler):
1584 def set_custom_exc(self, exc_tuple, handler):
1585 """set_custom_exc(exc_tuple, handler)
1585 """set_custom_exc(exc_tuple, handler)
1586
1586
1587 Set a custom exception handler, which will be called if any of the
1587 Set a custom exception handler, which will be called if any of the
1588 exceptions in exc_tuple occur in the mainloop (specifically, in the
1588 exceptions in exc_tuple occur in the mainloop (specifically, in the
1589 run_code() method).
1589 run_code() method).
1590
1590
1591 Parameters
1591 Parameters
1592 ----------
1592 ----------
1593
1593
1594 exc_tuple : tuple of exception classes
1594 exc_tuple : tuple of exception classes
1595 A *tuple* of exception classes, for which to call the defined
1595 A *tuple* of exception classes, for which to call the defined
1596 handler. It is very important that you use a tuple, and NOT A
1596 handler. It is very important that you use a tuple, and NOT A
1597 LIST here, because of the way Python's except statement works. If
1597 LIST here, because of the way Python's except statement works. If
1598 you only want to trap a single exception, use a singleton tuple::
1598 you only want to trap a single exception, use a singleton tuple::
1599
1599
1600 exc_tuple == (MyCustomException,)
1600 exc_tuple == (MyCustomException,)
1601
1601
1602 handler : callable
1602 handler : callable
1603 handler must have the following signature::
1603 handler must have the following signature::
1604
1604
1605 def my_handler(self, etype, value, tb, tb_offset=None):
1605 def my_handler(self, etype, value, tb, tb_offset=None):
1606 ...
1606 ...
1607 return structured_traceback
1607 return structured_traceback
1608
1608
1609 Your handler must return a structured traceback (a list of strings),
1609 Your handler must return a structured traceback (a list of strings),
1610 or None.
1610 or None.
1611
1611
1612 This will be made into an instance method (via types.MethodType)
1612 This will be made into an instance method (via types.MethodType)
1613 of IPython itself, and it will be called if any of the exceptions
1613 of IPython itself, and it will be called if any of the exceptions
1614 listed in the exc_tuple are caught. If the handler is None, an
1614 listed in the exc_tuple are caught. If the handler is None, an
1615 internal basic one is used, which just prints basic info.
1615 internal basic one is used, which just prints basic info.
1616
1616
1617 To protect IPython from crashes, if your handler ever raises an
1617 To protect IPython from crashes, if your handler ever raises an
1618 exception or returns an invalid result, it will be immediately
1618 exception or returns an invalid result, it will be immediately
1619 disabled.
1619 disabled.
1620
1620
1621 WARNING: by putting in your own exception handler into IPython's main
1621 WARNING: by putting in your own exception handler into IPython's main
1622 execution loop, you run a very good chance of nasty crashes. This
1622 execution loop, you run a very good chance of nasty crashes. This
1623 facility should only be used if you really know what you are doing."""
1623 facility should only be used if you really know what you are doing."""
1624
1624
1625 assert type(exc_tuple)==type(()) , \
1625 assert type(exc_tuple)==type(()) , \
1626 "The custom exceptions must be given AS A TUPLE."
1626 "The custom exceptions must be given AS A TUPLE."
1627
1627
1628 def dummy_handler(self, etype, value, tb, tb_offset=None):
1628 def dummy_handler(self, etype, value, tb, tb_offset=None):
1629 print('*** Simple custom exception handler ***')
1629 print('*** Simple custom exception handler ***')
1630 print('Exception type :',etype)
1630 print('Exception type :',etype)
1631 print('Exception value:',value)
1631 print('Exception value:',value)
1632 print('Traceback :',tb)
1632 print('Traceback :',tb)
1633 #print 'Source code :','\n'.join(self.buffer)
1633 #print 'Source code :','\n'.join(self.buffer)
1634
1634
1635 def validate_stb(stb):
1635 def validate_stb(stb):
1636 """validate structured traceback return type
1636 """validate structured traceback return type
1637
1637
1638 return type of CustomTB *should* be a list of strings, but allow
1638 return type of CustomTB *should* be a list of strings, but allow
1639 single strings or None, which are harmless.
1639 single strings or None, which are harmless.
1640
1640
1641 This function will *always* return a list of strings,
1641 This function will *always* return a list of strings,
1642 and will raise a TypeError if stb is inappropriate.
1642 and will raise a TypeError if stb is inappropriate.
1643 """
1643 """
1644 msg = "CustomTB must return list of strings, not %r" % stb
1644 msg = "CustomTB must return list of strings, not %r" % stb
1645 if stb is None:
1645 if stb is None:
1646 return []
1646 return []
1647 elif isinstance(stb, str):
1647 elif isinstance(stb, str):
1648 return [stb]
1648 return [stb]
1649 elif not isinstance(stb, list):
1649 elif not isinstance(stb, list):
1650 raise TypeError(msg)
1650 raise TypeError(msg)
1651 # it's a list
1651 # it's a list
1652 for line in stb:
1652 for line in stb:
1653 # check every element
1653 # check every element
1654 if not isinstance(line, str):
1654 if not isinstance(line, str):
1655 raise TypeError(msg)
1655 raise TypeError(msg)
1656 return stb
1656 return stb
1657
1657
1658 if handler is None:
1658 if handler is None:
1659 wrapped = dummy_handler
1659 wrapped = dummy_handler
1660 else:
1660 else:
1661 def wrapped(self,etype,value,tb,tb_offset=None):
1661 def wrapped(self,etype,value,tb,tb_offset=None):
1662 """wrap CustomTB handler, to protect IPython from user code
1662 """wrap CustomTB handler, to protect IPython from user code
1663
1663
1664 This makes it harder (but not impossible) for custom exception
1664 This makes it harder (but not impossible) for custom exception
1665 handlers to crash IPython.
1665 handlers to crash IPython.
1666 """
1666 """
1667 try:
1667 try:
1668 stb = handler(self,etype,value,tb,tb_offset=tb_offset)
1668 stb = handler(self,etype,value,tb,tb_offset=tb_offset)
1669 return validate_stb(stb)
1669 return validate_stb(stb)
1670 except:
1670 except:
1671 # clear custom handler immediately
1671 # clear custom handler immediately
1672 self.set_custom_exc((), None)
1672 self.set_custom_exc((), None)
1673 print("Custom TB Handler failed, unregistering", file=sys.stderr)
1673 print("Custom TB Handler failed, unregistering", file=sys.stderr)
1674 # show the exception in handler first
1674 # show the exception in handler first
1675 stb = self.InteractiveTB.structured_traceback(*sys.exc_info())
1675 stb = self.InteractiveTB.structured_traceback(*sys.exc_info())
1676 print(self.InteractiveTB.stb2text(stb))
1676 print(self.InteractiveTB.stb2text(stb))
1677 print("The original exception:")
1677 print("The original exception:")
1678 stb = self.InteractiveTB.structured_traceback(
1678 stb = self.InteractiveTB.structured_traceback(
1679 (etype,value,tb), tb_offset=tb_offset
1679 (etype,value,tb), tb_offset=tb_offset
1680 )
1680 )
1681 return stb
1681 return stb
1682
1682
1683 self.CustomTB = types.MethodType(wrapped,self)
1683 self.CustomTB = types.MethodType(wrapped,self)
1684 self.custom_exceptions = exc_tuple
1684 self.custom_exceptions = exc_tuple
1685
1685
1686 def excepthook(self, etype, value, tb):
1686 def excepthook(self, etype, value, tb):
1687 """One more defense for GUI apps that call sys.excepthook.
1687 """One more defense for GUI apps that call sys.excepthook.
1688
1688
1689 GUI frameworks like wxPython trap exceptions and call
1689 GUI frameworks like wxPython trap exceptions and call
1690 sys.excepthook themselves. I guess this is a feature that
1690 sys.excepthook themselves. I guess this is a feature that
1691 enables them to keep running after exceptions that would
1691 enables them to keep running after exceptions that would
1692 otherwise kill their mainloop. This is a bother for IPython
1692 otherwise kill their mainloop. This is a bother for IPython
1693 which excepts to catch all of the program exceptions with a try:
1693 which excepts to catch all of the program exceptions with a try:
1694 except: statement.
1694 except: statement.
1695
1695
1696 Normally, IPython sets sys.excepthook to a CrashHandler instance, so if
1696 Normally, IPython sets sys.excepthook to a CrashHandler instance, so if
1697 any app directly invokes sys.excepthook, it will look to the user like
1697 any app directly invokes sys.excepthook, it will look to the user like
1698 IPython crashed. In order to work around this, we can disable the
1698 IPython crashed. In order to work around this, we can disable the
1699 CrashHandler and replace it with this excepthook instead, which prints a
1699 CrashHandler and replace it with this excepthook instead, which prints a
1700 regular traceback using our InteractiveTB. In this fashion, apps which
1700 regular traceback using our InteractiveTB. In this fashion, apps which
1701 call sys.excepthook will generate a regular-looking exception from
1701 call sys.excepthook will generate a regular-looking exception from
1702 IPython, and the CrashHandler will only be triggered by real IPython
1702 IPython, and the CrashHandler will only be triggered by real IPython
1703 crashes.
1703 crashes.
1704
1704
1705 This hook should be used sparingly, only in places which are not likely
1705 This hook should be used sparingly, only in places which are not likely
1706 to be true IPython errors.
1706 to be true IPython errors.
1707 """
1707 """
1708 self.showtraceback((etype, value, tb), tb_offset=0)
1708 self.showtraceback((etype, value, tb), tb_offset=0)
1709
1709
1710 def _get_exc_info(self, exc_tuple=None):
1710 def _get_exc_info(self, exc_tuple=None):
1711 """get exc_info from a given tuple, sys.exc_info() or sys.last_type etc.
1711 """get exc_info from a given tuple, sys.exc_info() or sys.last_type etc.
1712
1712
1713 Ensures sys.last_type,value,traceback hold the exc_info we found,
1713 Ensures sys.last_type,value,traceback hold the exc_info we found,
1714 from whichever source.
1714 from whichever source.
1715
1715
1716 raises ValueError if none of these contain any information
1716 raises ValueError if none of these contain any information
1717 """
1717 """
1718 if exc_tuple is None:
1718 if exc_tuple is None:
1719 etype, value, tb = sys.exc_info()
1719 etype, value, tb = sys.exc_info()
1720 else:
1720 else:
1721 etype, value, tb = exc_tuple
1721 etype, value, tb = exc_tuple
1722
1722
1723 if etype is None:
1723 if etype is None:
1724 if hasattr(sys, 'last_type'):
1724 if hasattr(sys, 'last_type'):
1725 etype, value, tb = sys.last_type, sys.last_value, \
1725 etype, value, tb = sys.last_type, sys.last_value, \
1726 sys.last_traceback
1726 sys.last_traceback
1727
1727
1728 if etype is None:
1728 if etype is None:
1729 raise ValueError("No exception to find")
1729 raise ValueError("No exception to find")
1730
1730
1731 # Now store the exception info in sys.last_type etc.
1731 # Now store the exception info in sys.last_type etc.
1732 # WARNING: these variables are somewhat deprecated and not
1732 # WARNING: these variables are somewhat deprecated and not
1733 # necessarily safe to use in a threaded environment, but tools
1733 # necessarily safe to use in a threaded environment, but tools
1734 # like pdb depend on their existence, so let's set them. If we
1734 # like pdb depend on their existence, so let's set them. If we
1735 # find problems in the field, we'll need to revisit their use.
1735 # find problems in the field, we'll need to revisit their use.
1736 sys.last_type = etype
1736 sys.last_type = etype
1737 sys.last_value = value
1737 sys.last_value = value
1738 sys.last_traceback = tb
1738 sys.last_traceback = tb
1739
1739
1740 return etype, value, tb
1740 return etype, value, tb
1741
1741
1742 def show_usage_error(self, exc):
1742 def show_usage_error(self, exc):
1743 """Show a short message for UsageErrors
1743 """Show a short message for UsageErrors
1744
1744
1745 These are special exceptions that shouldn't show a traceback.
1745 These are special exceptions that shouldn't show a traceback.
1746 """
1746 """
1747 print("UsageError: %s" % exc, file=sys.stderr)
1747 print("UsageError: %s" % exc, file=sys.stderr)
1748
1748
1749 def get_exception_only(self, exc_tuple=None):
1749 def get_exception_only(self, exc_tuple=None):
1750 """
1750 """
1751 Return as a string (ending with a newline) the exception that
1751 Return as a string (ending with a newline) the exception that
1752 just occurred, without any traceback.
1752 just occurred, without any traceback.
1753 """
1753 """
1754 etype, value, tb = self._get_exc_info(exc_tuple)
1754 etype, value, tb = self._get_exc_info(exc_tuple)
1755 msg = traceback.format_exception_only(etype, value)
1755 msg = traceback.format_exception_only(etype, value)
1756 return ''.join(msg)
1756 return ''.join(msg)
1757
1757
1758 def showtraceback(self, exc_tuple=None, filename=None, tb_offset=None,
1758 def showtraceback(self, exc_tuple=None, filename=None, tb_offset=None,
1759 exception_only=False):
1759 exception_only=False):
1760 """Display the exception that just occurred.
1760 """Display the exception that just occurred.
1761
1761
1762 If nothing is known about the exception, this is the method which
1762 If nothing is known about the exception, this is the method which
1763 should be used throughout the code for presenting user tracebacks,
1763 should be used throughout the code for presenting user tracebacks,
1764 rather than directly invoking the InteractiveTB object.
1764 rather than directly invoking the InteractiveTB object.
1765
1765
1766 A specific showsyntaxerror() also exists, but this method can take
1766 A specific showsyntaxerror() also exists, but this method can take
1767 care of calling it if needed, so unless you are explicitly catching a
1767 care of calling it if needed, so unless you are explicitly catching a
1768 SyntaxError exception, don't try to analyze the stack manually and
1768 SyntaxError exception, don't try to analyze the stack manually and
1769 simply call this method."""
1769 simply call this method."""
1770
1770
1771 try:
1771 try:
1772 try:
1772 try:
1773 etype, value, tb = self._get_exc_info(exc_tuple)
1773 etype, value, tb = self._get_exc_info(exc_tuple)
1774 except ValueError:
1774 except ValueError:
1775 print('No traceback available to show.', file=sys.stderr)
1775 print('No traceback available to show.', file=sys.stderr)
1776 return
1776 return
1777
1777
1778 if issubclass(etype, SyntaxError):
1778 if issubclass(etype, SyntaxError):
1779 # Though this won't be called by syntax errors in the input
1779 # Though this won't be called by syntax errors in the input
1780 # line, there may be SyntaxError cases with imported code.
1780 # line, there may be SyntaxError cases with imported code.
1781 self.showsyntaxerror(filename)
1781 self.showsyntaxerror(filename)
1782 elif etype is UsageError:
1782 elif etype is UsageError:
1783 self.show_usage_error(value)
1783 self.show_usage_error(value)
1784 else:
1784 else:
1785 if exception_only:
1785 if exception_only:
1786 stb = ['An exception has occurred, use %tb to see '
1786 stb = ['An exception has occurred, use %tb to see '
1787 'the full traceback.\n']
1787 'the full traceback.\n']
1788 stb.extend(self.InteractiveTB.get_exception_only(etype,
1788 stb.extend(self.InteractiveTB.get_exception_only(etype,
1789 value))
1789 value))
1790 else:
1790 else:
1791 try:
1791 try:
1792 # Exception classes can customise their traceback - we
1792 # Exception classes can customise their traceback - we
1793 # use this in IPython.parallel for exceptions occurring
1793 # use this in IPython.parallel for exceptions occurring
1794 # in the engines. This should return a list of strings.
1794 # in the engines. This should return a list of strings.
1795 stb = value._render_traceback_()
1795 stb = value._render_traceback_()
1796 except Exception:
1796 except Exception:
1797 stb = self.InteractiveTB.structured_traceback(etype,
1797 stb = self.InteractiveTB.structured_traceback(etype,
1798 value, tb, tb_offset=tb_offset)
1798 value, tb, tb_offset=tb_offset)
1799
1799
1800 self._showtraceback(etype, value, stb)
1800 self._showtraceback(etype, value, stb)
1801 if self.call_pdb:
1801 if self.call_pdb:
1802 # drop into debugger
1802 # drop into debugger
1803 self.debugger(force=True)
1803 self.debugger(force=True)
1804 return
1804 return
1805
1805
1806 # Actually show the traceback
1806 # Actually show the traceback
1807 self._showtraceback(etype, value, stb)
1807 self._showtraceback(etype, value, stb)
1808
1808
1809 except KeyboardInterrupt:
1809 except KeyboardInterrupt:
1810 print('\n' + self.get_exception_only(), file=sys.stderr)
1810 print('\n' + self.get_exception_only(), file=sys.stderr)
1811
1811
1812 def _showtraceback(self, etype, evalue, stb):
1812 def _showtraceback(self, etype, evalue, stb):
1813 """Actually show a traceback.
1813 """Actually show a traceback.
1814
1814
1815 Subclasses may override this method to put the traceback on a different
1815 Subclasses may override this method to put the traceback on a different
1816 place, like a side channel.
1816 place, like a side channel.
1817 """
1817 """
1818 print(self.InteractiveTB.stb2text(stb))
1818 print(self.InteractiveTB.stb2text(stb))
1819
1819
1820 def showsyntaxerror(self, filename=None):
1820 def showsyntaxerror(self, filename=None):
1821 """Display the syntax error that just occurred.
1821 """Display the syntax error that just occurred.
1822
1822
1823 This doesn't display a stack trace because there isn't one.
1823 This doesn't display a stack trace because there isn't one.
1824
1824
1825 If a filename is given, it is stuffed in the exception instead
1825 If a filename is given, it is stuffed in the exception instead
1826 of what was there before (because Python's parser always uses
1826 of what was there before (because Python's parser always uses
1827 "<string>" when reading from a string).
1827 "<string>" when reading from a string).
1828 """
1828 """
1829 etype, value, last_traceback = self._get_exc_info()
1829 etype, value, last_traceback = self._get_exc_info()
1830
1830
1831 if filename and issubclass(etype, SyntaxError):
1831 if filename and issubclass(etype, SyntaxError):
1832 try:
1832 try:
1833 value.filename = filename
1833 value.filename = filename
1834 except:
1834 except:
1835 # Not the format we expect; leave it alone
1835 # Not the format we expect; leave it alone
1836 pass
1836 pass
1837
1837
1838 stb = self.SyntaxTB.structured_traceback(etype, value, [])
1838 stb = self.SyntaxTB.structured_traceback(etype, value, [])
1839 self._showtraceback(etype, value, stb)
1839 self._showtraceback(etype, value, stb)
1840
1840
1841 # This is overridden in TerminalInteractiveShell to show a message about
1841 # This is overridden in TerminalInteractiveShell to show a message about
1842 # the %paste magic.
1842 # the %paste magic.
1843 def showindentationerror(self):
1843 def showindentationerror(self):
1844 """Called by run_cell when there's an IndentationError in code entered
1844 """Called by run_cell when there's an IndentationError in code entered
1845 at the prompt.
1845 at the prompt.
1846
1846
1847 This is overridden in TerminalInteractiveShell to show a message about
1847 This is overridden in TerminalInteractiveShell to show a message about
1848 the %paste magic."""
1848 the %paste magic."""
1849 self.showsyntaxerror()
1849 self.showsyntaxerror()
1850
1850
1851 #-------------------------------------------------------------------------
1851 #-------------------------------------------------------------------------
1852 # Things related to readline
1852 # Things related to readline
1853 #-------------------------------------------------------------------------
1853 #-------------------------------------------------------------------------
1854
1854
1855 def init_readline(self):
1855 def init_readline(self):
1856 """DEPRECATED
1856 """DEPRECATED
1857
1857
1858 Moved to terminal subclass, here only to simplify the init logic."""
1858 Moved to terminal subclass, here only to simplify the init logic."""
1859 # Set a number of methods that depend on readline to be no-op
1859 # Set a number of methods that depend on readline to be no-op
1860 warnings.warn('`init_readline` is no-op since IPython 5.0 and is Deprecated',
1860 warnings.warn('`init_readline` is no-op since IPython 5.0 and is Deprecated',
1861 DeprecationWarning, stacklevel=2)
1861 DeprecationWarning, stacklevel=2)
1862 self.set_custom_completer = no_op
1862 self.set_custom_completer = no_op
1863
1863
1864 @skip_doctest
1864 @skip_doctest
1865 def set_next_input(self, s, replace=False):
1865 def set_next_input(self, s, replace=False):
1866 """ Sets the 'default' input string for the next command line.
1866 """ Sets the 'default' input string for the next command line.
1867
1867
1868 Example::
1868 Example::
1869
1869
1870 In [1]: _ip.set_next_input("Hello Word")
1870 In [1]: _ip.set_next_input("Hello Word")
1871 In [2]: Hello Word_ # cursor is here
1871 In [2]: Hello Word_ # cursor is here
1872 """
1872 """
1873 self.rl_next_input = py3compat.cast_bytes_py2(s)
1873 self.rl_next_input = py3compat.cast_bytes_py2(s)
1874
1874
1875 def _indent_current_str(self):
1875 def _indent_current_str(self):
1876 """return the current level of indentation as a string"""
1876 """return the current level of indentation as a string"""
1877 return self.input_splitter.indent_spaces * ' '
1877 return self.input_splitter.indent_spaces * ' '
1878
1878
1879 #-------------------------------------------------------------------------
1879 #-------------------------------------------------------------------------
1880 # Things related to text completion
1880 # Things related to text completion
1881 #-------------------------------------------------------------------------
1881 #-------------------------------------------------------------------------
1882
1882
1883 def init_completer(self):
1883 def init_completer(self):
1884 """Initialize the completion machinery.
1884 """Initialize the completion machinery.
1885
1885
1886 This creates completion machinery that can be used by client code,
1886 This creates completion machinery that can be used by client code,
1887 either interactively in-process (typically triggered by the readline
1887 either interactively in-process (typically triggered by the readline
1888 library), programmatically (such as in test suites) or out-of-process
1888 library), programmatically (such as in test suites) or out-of-process
1889 (typically over the network by remote frontends).
1889 (typically over the network by remote frontends).
1890 """
1890 """
1891 from IPython.core.completer import IPCompleter
1891 from IPython.core.completer import IPCompleter
1892 from IPython.core.completerlib import (module_completer,
1892 from IPython.core.completerlib import (module_completer,
1893 magic_run_completer, cd_completer, reset_completer)
1893 magic_run_completer, cd_completer, reset_completer)
1894
1894
1895 self.Completer = IPCompleter(shell=self,
1895 self.Completer = IPCompleter(shell=self,
1896 namespace=self.user_ns,
1896 namespace=self.user_ns,
1897 global_namespace=self.user_global_ns,
1897 global_namespace=self.user_global_ns,
1898 parent=self,
1898 parent=self,
1899 )
1899 )
1900 self.configurables.append(self.Completer)
1900 self.configurables.append(self.Completer)
1901
1901
1902 # Add custom completers to the basic ones built into IPCompleter
1902 # Add custom completers to the basic ones built into IPCompleter
1903 sdisp = self.strdispatchers.get('complete_command', StrDispatch())
1903 sdisp = self.strdispatchers.get('complete_command', StrDispatch())
1904 self.strdispatchers['complete_command'] = sdisp
1904 self.strdispatchers['complete_command'] = sdisp
1905 self.Completer.custom_completers = sdisp
1905 self.Completer.custom_completers = sdisp
1906
1906
1907 self.set_hook('complete_command', module_completer, str_key = 'import')
1907 self.set_hook('complete_command', module_completer, str_key = 'import')
1908 self.set_hook('complete_command', module_completer, str_key = 'from')
1908 self.set_hook('complete_command', module_completer, str_key = 'from')
1909 self.set_hook('complete_command', module_completer, str_key = '%aimport')
1909 self.set_hook('complete_command', module_completer, str_key = '%aimport')
1910 self.set_hook('complete_command', magic_run_completer, str_key = '%run')
1910 self.set_hook('complete_command', magic_run_completer, str_key = '%run')
1911 self.set_hook('complete_command', cd_completer, str_key = '%cd')
1911 self.set_hook('complete_command', cd_completer, str_key = '%cd')
1912 self.set_hook('complete_command', reset_completer, str_key = '%reset')
1912 self.set_hook('complete_command', reset_completer, str_key = '%reset')
1913
1913
1914
1914
1915 def complete(self, text, line=None, cursor_pos=None):
1915 def complete(self, text, line=None, cursor_pos=None):
1916 """Return the completed text and a list of completions.
1916 """Return the completed text and a list of completions.
1917
1917
1918 Parameters
1918 Parameters
1919 ----------
1919 ----------
1920
1920
1921 text : string
1921 text : string
1922 A string of text to be completed on. It can be given as empty and
1922 A string of text to be completed on. It can be given as empty and
1923 instead a line/position pair are given. In this case, the
1923 instead a line/position pair are given. In this case, the
1924 completer itself will split the line like readline does.
1924 completer itself will split the line like readline does.
1925
1925
1926 line : string, optional
1926 line : string, optional
1927 The complete line that text is part of.
1927 The complete line that text is part of.
1928
1928
1929 cursor_pos : int, optional
1929 cursor_pos : int, optional
1930 The position of the cursor on the input line.
1930 The position of the cursor on the input line.
1931
1931
1932 Returns
1932 Returns
1933 -------
1933 -------
1934 text : string
1934 text : string
1935 The actual text that was completed.
1935 The actual text that was completed.
1936
1936
1937 matches : list
1937 matches : list
1938 A sorted list with all possible completions.
1938 A sorted list with all possible completions.
1939
1939
1940 The optional arguments allow the completion to take more context into
1940 The optional arguments allow the completion to take more context into
1941 account, and are part of the low-level completion API.
1941 account, and are part of the low-level completion API.
1942
1942
1943 This is a wrapper around the completion mechanism, similar to what
1943 This is a wrapper around the completion mechanism, similar to what
1944 readline does at the command line when the TAB key is hit. By
1944 readline does at the command line when the TAB key is hit. By
1945 exposing it as a method, it can be used by other non-readline
1945 exposing it as a method, it can be used by other non-readline
1946 environments (such as GUIs) for text completion.
1946 environments (such as GUIs) for text completion.
1947
1947
1948 Simple usage example:
1948 Simple usage example:
1949
1949
1950 In [1]: x = 'hello'
1950 In [1]: x = 'hello'
1951
1951
1952 In [2]: _ip.complete('x.l')
1952 In [2]: _ip.complete('x.l')
1953 Out[2]: ('x.l', ['x.ljust', 'x.lower', 'x.lstrip'])
1953 Out[2]: ('x.l', ['x.ljust', 'x.lower', 'x.lstrip'])
1954 """
1954 """
1955
1955
1956 # Inject names into __builtin__ so we can complete on the added names.
1956 # Inject names into __builtin__ so we can complete on the added names.
1957 with self.builtin_trap:
1957 with self.builtin_trap:
1958 return self.Completer.complete(text, line, cursor_pos)
1958 return self.Completer.complete(text, line, cursor_pos)
1959
1959
1960 def set_custom_completer(self, completer, pos=0):
1960 def set_custom_completer(self, completer, pos=0):
1961 """Adds a new custom completer function.
1961 """Adds a new custom completer function.
1962
1962
1963 The position argument (defaults to 0) is the index in the completers
1963 The position argument (defaults to 0) is the index in the completers
1964 list where you want the completer to be inserted."""
1964 list where you want the completer to be inserted."""
1965
1965
1966 newcomp = types.MethodType(completer,self.Completer)
1966 newcomp = types.MethodType(completer,self.Completer)
1967 self.Completer.matchers.insert(pos,newcomp)
1967 self.Completer.matchers.insert(pos,newcomp)
1968
1968
1969 def set_completer_frame(self, frame=None):
1969 def set_completer_frame(self, frame=None):
1970 """Set the frame of the completer."""
1970 """Set the frame of the completer."""
1971 if frame:
1971 if frame:
1972 self.Completer.namespace = frame.f_locals
1972 self.Completer.namespace = frame.f_locals
1973 self.Completer.global_namespace = frame.f_globals
1973 self.Completer.global_namespace = frame.f_globals
1974 else:
1974 else:
1975 self.Completer.namespace = self.user_ns
1975 self.Completer.namespace = self.user_ns
1976 self.Completer.global_namespace = self.user_global_ns
1976 self.Completer.global_namespace = self.user_global_ns
1977
1977
1978 #-------------------------------------------------------------------------
1978 #-------------------------------------------------------------------------
1979 # Things related to magics
1979 # Things related to magics
1980 #-------------------------------------------------------------------------
1980 #-------------------------------------------------------------------------
1981
1981
1982 def init_magics(self):
1982 def init_magics(self):
1983 from IPython.core import magics as m
1983 from IPython.core import magics as m
1984 self.magics_manager = magic.MagicsManager(shell=self,
1984 self.magics_manager = magic.MagicsManager(shell=self,
1985 parent=self,
1985 parent=self,
1986 user_magics=m.UserMagics(self))
1986 user_magics=m.UserMagics(self))
1987 self.configurables.append(self.magics_manager)
1987 self.configurables.append(self.magics_manager)
1988
1988
1989 # Expose as public API from the magics manager
1989 # Expose as public API from the magics manager
1990 self.register_magics = self.magics_manager.register
1990 self.register_magics = self.magics_manager.register
1991
1991
1992 self.register_magics(m.AutoMagics, m.BasicMagics, m.CodeMagics,
1992 self.register_magics(m.AutoMagics, m.BasicMagics, m.CodeMagics,
1993 m.ConfigMagics, m.DisplayMagics, m.ExecutionMagics,
1993 m.ConfigMagics, m.DisplayMagics, m.ExecutionMagics,
1994 m.ExtensionMagics, m.HistoryMagics, m.LoggingMagics,
1994 m.ExtensionMagics, m.HistoryMagics, m.LoggingMagics,
1995 m.NamespaceMagics, m.OSMagics, m.PylabMagics, m.ScriptMagics,
1995 m.NamespaceMagics, m.OSMagics, m.PylabMagics, m.ScriptMagics,
1996 )
1996 )
1997
1997
1998 # Register Magic Aliases
1998 # Register Magic Aliases
1999 mman = self.magics_manager
1999 mman = self.magics_manager
2000 # FIXME: magic aliases should be defined by the Magics classes
2000 # FIXME: magic aliases should be defined by the Magics classes
2001 # or in MagicsManager, not here
2001 # or in MagicsManager, not here
2002 mman.register_alias('ed', 'edit')
2002 mman.register_alias('ed', 'edit')
2003 mman.register_alias('hist', 'history')
2003 mman.register_alias('hist', 'history')
2004 mman.register_alias('rep', 'recall')
2004 mman.register_alias('rep', 'recall')
2005 mman.register_alias('SVG', 'svg', 'cell')
2005 mman.register_alias('SVG', 'svg', 'cell')
2006 mman.register_alias('HTML', 'html', 'cell')
2006 mman.register_alias('HTML', 'html', 'cell')
2007 mman.register_alias('file', 'writefile', 'cell')
2007 mman.register_alias('file', 'writefile', 'cell')
2008
2008
2009 # FIXME: Move the color initialization to the DisplayHook, which
2009 # FIXME: Move the color initialization to the DisplayHook, which
2010 # should be split into a prompt manager and displayhook. We probably
2010 # should be split into a prompt manager and displayhook. We probably
2011 # even need a centralize colors management object.
2011 # even need a centralize colors management object.
2012 self.magic('colors %s' % self.colors)
2012 self.magic('colors %s' % self.colors)
2013
2013
2014 # Defined here so that it's included in the documentation
2014 # Defined here so that it's included in the documentation
2015 @functools.wraps(magic.MagicsManager.register_function)
2015 @functools.wraps(magic.MagicsManager.register_function)
2016 def register_magic_function(self, func, magic_kind='line', magic_name=None):
2016 def register_magic_function(self, func, magic_kind='line', magic_name=None):
2017 self.magics_manager.register_function(func,
2017 self.magics_manager.register_function(func,
2018 magic_kind=magic_kind, magic_name=magic_name)
2018 magic_kind=magic_kind, magic_name=magic_name)
2019
2019
2020 def run_line_magic(self, magic_name, line):
2020 def run_line_magic(self, magic_name, line):
2021 """Execute the given line magic.
2021 """Execute the given line magic.
2022
2022
2023 Parameters
2023 Parameters
2024 ----------
2024 ----------
2025 magic_name : str
2025 magic_name : str
2026 Name of the desired magic function, without '%' prefix.
2026 Name of the desired magic function, without '%' prefix.
2027
2027
2028 line : str
2028 line : str
2029 The rest of the input line as a single string.
2029 The rest of the input line as a single string.
2030 """
2030 """
2031 fn = self.find_line_magic(magic_name)
2031 fn = self.find_line_magic(magic_name)
2032 if fn is None:
2032 if fn is None:
2033 cm = self.find_cell_magic(magic_name)
2033 cm = self.find_cell_magic(magic_name)
2034 etpl = "Line magic function `%%%s` not found%s."
2034 etpl = "Line magic function `%%%s` not found%s."
2035 extra = '' if cm is None else (' (But cell magic `%%%%%s` exists, '
2035 extra = '' if cm is None else (' (But cell magic `%%%%%s` exists, '
2036 'did you mean that instead?)' % magic_name )
2036 'did you mean that instead?)' % magic_name )
2037 error(etpl % (magic_name, extra))
2037 error(etpl % (magic_name, extra))
2038 else:
2038 else:
2039 # Note: this is the distance in the stack to the user's frame.
2039 # Note: this is the distance in the stack to the user's frame.
2040 # This will need to be updated if the internal calling logic gets
2040 # This will need to be updated if the internal calling logic gets
2041 # refactored, or else we'll be expanding the wrong variables.
2041 # refactored, or else we'll be expanding the wrong variables.
2042 stack_depth = 2
2042 stack_depth = 2
2043 magic_arg_s = self.var_expand(line, stack_depth)
2043 magic_arg_s = self.var_expand(line, stack_depth)
2044 # Put magic args in a list so we can call with f(*a) syntax
2044 # Put magic args in a list so we can call with f(*a) syntax
2045 args = [magic_arg_s]
2045 args = [magic_arg_s]
2046 kwargs = {}
2046 kwargs = {}
2047 # Grab local namespace if we need it:
2047 # Grab local namespace if we need it:
2048 if getattr(fn, "needs_local_scope", False):
2048 if getattr(fn, "needs_local_scope", False):
2049 kwargs['local_ns'] = sys._getframe(stack_depth).f_locals
2049 kwargs['local_ns'] = sys._getframe(stack_depth).f_locals
2050 with self.builtin_trap:
2050 with self.builtin_trap:
2051 result = fn(*args,**kwargs)
2051 result = fn(*args,**kwargs)
2052 return result
2052 return result
2053
2053
2054 def run_cell_magic(self, magic_name, line, cell):
2054 def run_cell_magic(self, magic_name, line, cell):
2055 """Execute the given cell magic.
2055 """Execute the given cell magic.
2056
2056
2057 Parameters
2057 Parameters
2058 ----------
2058 ----------
2059 magic_name : str
2059 magic_name : str
2060 Name of the desired magic function, without '%' prefix.
2060 Name of the desired magic function, without '%' prefix.
2061
2061
2062 line : str
2062 line : str
2063 The rest of the first input line as a single string.
2063 The rest of the first input line as a single string.
2064
2064
2065 cell : str
2065 cell : str
2066 The body of the cell as a (possibly multiline) string.
2066 The body of the cell as a (possibly multiline) string.
2067 """
2067 """
2068 fn = self.find_cell_magic(magic_name)
2068 fn = self.find_cell_magic(magic_name)
2069 if fn is None:
2069 if fn is None:
2070 lm = self.find_line_magic(magic_name)
2070 lm = self.find_line_magic(magic_name)
2071 etpl = "Cell magic `%%{0}` not found{1}."
2071 etpl = "Cell magic `%%{0}` not found{1}."
2072 extra = '' if lm is None else (' (But line magic `%{0}` exists, '
2072 extra = '' if lm is None else (' (But line magic `%{0}` exists, '
2073 'did you mean that instead?)'.format(magic_name))
2073 'did you mean that instead?)'.format(magic_name))
2074 error(etpl.format(magic_name, extra))
2074 error(etpl.format(magic_name, extra))
2075 elif cell == '':
2075 elif cell == '':
2076 message = '%%{0} is a cell magic, but the cell body is empty.'.format(magic_name)
2076 message = '%%{0} is a cell magic, but the cell body is empty.'.format(magic_name)
2077 if self.find_line_magic(magic_name) is not None:
2077 if self.find_line_magic(magic_name) is not None:
2078 message += ' Did you mean the line magic %{0} (single %)?'.format(magic_name)
2078 message += ' Did you mean the line magic %{0} (single %)?'.format(magic_name)
2079 raise UsageError(message)
2079 raise UsageError(message)
2080 else:
2080 else:
2081 # Note: this is the distance in the stack to the user's frame.
2081 # Note: this is the distance in the stack to the user's frame.
2082 # This will need to be updated if the internal calling logic gets
2082 # This will need to be updated if the internal calling logic gets
2083 # refactored, or else we'll be expanding the wrong variables.
2083 # refactored, or else we'll be expanding the wrong variables.
2084 stack_depth = 2
2084 stack_depth = 2
2085 magic_arg_s = self.var_expand(line, stack_depth)
2085 magic_arg_s = self.var_expand(line, stack_depth)
2086 with self.builtin_trap:
2086 with self.builtin_trap:
2087 result = fn(magic_arg_s, cell)
2087 result = fn(magic_arg_s, cell)
2088 return result
2088 return result
2089
2089
2090 def find_line_magic(self, magic_name):
2090 def find_line_magic(self, magic_name):
2091 """Find and return a line magic by name.
2091 """Find and return a line magic by name.
2092
2092
2093 Returns None if the magic isn't found."""
2093 Returns None if the magic isn't found."""
2094 return self.magics_manager.magics['line'].get(magic_name)
2094 return self.magics_manager.magics['line'].get(magic_name)
2095
2095
2096 def find_cell_magic(self, magic_name):
2096 def find_cell_magic(self, magic_name):
2097 """Find and return a cell magic by name.
2097 """Find and return a cell magic by name.
2098
2098
2099 Returns None if the magic isn't found."""
2099 Returns None if the magic isn't found."""
2100 return self.magics_manager.magics['cell'].get(magic_name)
2100 return self.magics_manager.magics['cell'].get(magic_name)
2101
2101
2102 def find_magic(self, magic_name, magic_kind='line'):
2102 def find_magic(self, magic_name, magic_kind='line'):
2103 """Find and return a magic of the given type by name.
2103 """Find and return a magic of the given type by name.
2104
2104
2105 Returns None if the magic isn't found."""
2105 Returns None if the magic isn't found."""
2106 return self.magics_manager.magics[magic_kind].get(magic_name)
2106 return self.magics_manager.magics[magic_kind].get(magic_name)
2107
2107
2108 def magic(self, arg_s):
2108 def magic(self, arg_s):
2109 """DEPRECATED. Use run_line_magic() instead.
2109 """DEPRECATED. Use run_line_magic() instead.
2110
2110
2111 Call a magic function by name.
2111 Call a magic function by name.
2112
2112
2113 Input: a string containing the name of the magic function to call and
2113 Input: a string containing the name of the magic function to call and
2114 any additional arguments to be passed to the magic.
2114 any additional arguments to be passed to the magic.
2115
2115
2116 magic('name -opt foo bar') is equivalent to typing at the ipython
2116 magic('name -opt foo bar') is equivalent to typing at the ipython
2117 prompt:
2117 prompt:
2118
2118
2119 In[1]: %name -opt foo bar
2119 In[1]: %name -opt foo bar
2120
2120
2121 To call a magic without arguments, simply use magic('name').
2121 To call a magic without arguments, simply use magic('name').
2122
2122
2123 This provides a proper Python function to call IPython's magics in any
2123 This provides a proper Python function to call IPython's magics in any
2124 valid Python code you can type at the interpreter, including loops and
2124 valid Python code you can type at the interpreter, including loops and
2125 compound statements.
2125 compound statements.
2126 """
2126 """
2127 # TODO: should we issue a loud deprecation warning here?
2127 # TODO: should we issue a loud deprecation warning here?
2128 magic_name, _, magic_arg_s = arg_s.partition(' ')
2128 magic_name, _, magic_arg_s = arg_s.partition(' ')
2129 magic_name = magic_name.lstrip(prefilter.ESC_MAGIC)
2129 magic_name = magic_name.lstrip(prefilter.ESC_MAGIC)
2130 return self.run_line_magic(magic_name, magic_arg_s)
2130 return self.run_line_magic(magic_name, magic_arg_s)
2131
2131
2132 #-------------------------------------------------------------------------
2132 #-------------------------------------------------------------------------
2133 # Things related to macros
2133 # Things related to macros
2134 #-------------------------------------------------------------------------
2134 #-------------------------------------------------------------------------
2135
2135
2136 def define_macro(self, name, themacro):
2136 def define_macro(self, name, themacro):
2137 """Define a new macro
2137 """Define a new macro
2138
2138
2139 Parameters
2139 Parameters
2140 ----------
2140 ----------
2141 name : str
2141 name : str
2142 The name of the macro.
2142 The name of the macro.
2143 themacro : str or Macro
2143 themacro : str or Macro
2144 The action to do upon invoking the macro. If a string, a new
2144 The action to do upon invoking the macro. If a string, a new
2145 Macro object is created by passing the string to it.
2145 Macro object is created by passing the string to it.
2146 """
2146 """
2147
2147
2148 from IPython.core import macro
2148 from IPython.core import macro
2149
2149
2150 if isinstance(themacro, str):
2150 if isinstance(themacro, str):
2151 themacro = macro.Macro(themacro)
2151 themacro = macro.Macro(themacro)
2152 if not isinstance(themacro, macro.Macro):
2152 if not isinstance(themacro, macro.Macro):
2153 raise ValueError('A macro must be a string or a Macro instance.')
2153 raise ValueError('A macro must be a string or a Macro instance.')
2154 self.user_ns[name] = themacro
2154 self.user_ns[name] = themacro
2155
2155
2156 #-------------------------------------------------------------------------
2156 #-------------------------------------------------------------------------
2157 # Things related to the running of system commands
2157 # Things related to the running of system commands
2158 #-------------------------------------------------------------------------
2158 #-------------------------------------------------------------------------
2159
2159
2160 def system_piped(self, cmd):
2160 def system_piped(self, cmd):
2161 """Call the given cmd in a subprocess, piping stdout/err
2161 """Call the given cmd in a subprocess, piping stdout/err
2162
2162
2163 Parameters
2163 Parameters
2164 ----------
2164 ----------
2165 cmd : str
2165 cmd : str
2166 Command to execute (can not end in '&', as background processes are
2166 Command to execute (can not end in '&', as background processes are
2167 not supported. Should not be a command that expects input
2167 not supported. Should not be a command that expects input
2168 other than simple text.
2168 other than simple text.
2169 """
2169 """
2170 if cmd.rstrip().endswith('&'):
2170 if cmd.rstrip().endswith('&'):
2171 # this is *far* from a rigorous test
2171 # this is *far* from a rigorous test
2172 # We do not support backgrounding processes because we either use
2172 # We do not support backgrounding processes because we either use
2173 # pexpect or pipes to read from. Users can always just call
2173 # pexpect or pipes to read from. Users can always just call
2174 # os.system() or use ip.system=ip.system_raw
2174 # os.system() or use ip.system=ip.system_raw
2175 # if they really want a background process.
2175 # if they really want a background process.
2176 raise OSError("Background processes not supported.")
2176 raise OSError("Background processes not supported.")
2177
2177
2178 # we explicitly do NOT return the subprocess status code, because
2178 # we explicitly do NOT return the subprocess status code, because
2179 # a non-None value would trigger :func:`sys.displayhook` calls.
2179 # a non-None value would trigger :func:`sys.displayhook` calls.
2180 # Instead, we store the exit_code in user_ns.
2180 # Instead, we store the exit_code in user_ns.
2181 self.user_ns['_exit_code'] = system(self.var_expand(cmd, depth=1))
2181 self.user_ns['_exit_code'] = system(self.var_expand(cmd, depth=1))
2182
2182
2183 def system_raw(self, cmd):
2183 def system_raw(self, cmd):
2184 """Call the given cmd in a subprocess using os.system on Windows or
2184 """Call the given cmd in a subprocess using os.system on Windows or
2185 subprocess.call using the system shell on other platforms.
2185 subprocess.call using the system shell on other platforms.
2186
2186
2187 Parameters
2187 Parameters
2188 ----------
2188 ----------
2189 cmd : str
2189 cmd : str
2190 Command to execute.
2190 Command to execute.
2191 """
2191 """
2192 cmd = self.var_expand(cmd, depth=1)
2192 cmd = self.var_expand(cmd, depth=1)
2193 # protect os.system from UNC paths on Windows, which it can't handle:
2193 # protect os.system from UNC paths on Windows, which it can't handle:
2194 if sys.platform == 'win32':
2194 if sys.platform == 'win32':
2195 from IPython.utils._process_win32 import AvoidUNCPath
2195 from IPython.utils._process_win32 import AvoidUNCPath
2196 with AvoidUNCPath() as path:
2196 with AvoidUNCPath() as path:
2197 if path is not None:
2197 if path is not None:
2198 cmd = '"pushd %s &&"%s' % (path, cmd)
2198 cmd = '"pushd %s &&"%s' % (path, cmd)
2199 try:
2199 try:
2200 ec = os.system(cmd)
2200 ec = os.system(cmd)
2201 except KeyboardInterrupt:
2201 except KeyboardInterrupt:
2202 print('\n' + self.get_exception_only(), file=sys.stderr)
2202 print('\n' + self.get_exception_only(), file=sys.stderr)
2203 ec = -2
2203 ec = -2
2204 else:
2204 else:
2205 # For posix the result of the subprocess.call() below is an exit
2205 # For posix the result of the subprocess.call() below is an exit
2206 # code, which by convention is zero for success, positive for
2206 # code, which by convention is zero for success, positive for
2207 # program failure. Exit codes above 128 are reserved for signals,
2207 # program failure. Exit codes above 128 are reserved for signals,
2208 # and the formula for converting a signal to an exit code is usually
2208 # and the formula for converting a signal to an exit code is usually
2209 # signal_number+128. To more easily differentiate between exit
2209 # signal_number+128. To more easily differentiate between exit
2210 # codes and signals, ipython uses negative numbers. For instance
2210 # codes and signals, ipython uses negative numbers. For instance
2211 # since control-c is signal 2 but exit code 130, ipython's
2211 # since control-c is signal 2 but exit code 130, ipython's
2212 # _exit_code variable will read -2. Note that some shells like
2212 # _exit_code variable will read -2. Note that some shells like
2213 # csh and fish don't follow sh/bash conventions for exit codes.
2213 # csh and fish don't follow sh/bash conventions for exit codes.
2214 executable = os.environ.get('SHELL', None)
2214 executable = os.environ.get('SHELL', None)
2215 try:
2215 try:
2216 # Use env shell instead of default /bin/sh
2216 # Use env shell instead of default /bin/sh
2217 ec = subprocess.call(cmd, shell=True, executable=executable)
2217 ec = subprocess.call(cmd, shell=True, executable=executable)
2218 except KeyboardInterrupt:
2218 except KeyboardInterrupt:
2219 # intercept control-C; a long traceback is not useful here
2219 # intercept control-C; a long traceback is not useful here
2220 print('\n' + self.get_exception_only(), file=sys.stderr)
2220 print('\n' + self.get_exception_only(), file=sys.stderr)
2221 ec = 130
2221 ec = 130
2222 if ec > 128:
2222 if ec > 128:
2223 ec = -(ec - 128)
2223 ec = -(ec - 128)
2224
2224
2225 # We explicitly do NOT return the subprocess status code, because
2225 # We explicitly do NOT return the subprocess status code, because
2226 # a non-None value would trigger :func:`sys.displayhook` calls.
2226 # a non-None value would trigger :func:`sys.displayhook` calls.
2227 # Instead, we store the exit_code in user_ns. Note the semantics
2227 # Instead, we store the exit_code in user_ns. Note the semantics
2228 # of _exit_code: for control-c, _exit_code == -signal.SIGNIT,
2228 # of _exit_code: for control-c, _exit_code == -signal.SIGNIT,
2229 # but raising SystemExit(_exit_code) will give status 254!
2229 # but raising SystemExit(_exit_code) will give status 254!
2230 self.user_ns['_exit_code'] = ec
2230 self.user_ns['_exit_code'] = ec
2231
2231
2232 # use piped system by default, because it is better behaved
2232 # use piped system by default, because it is better behaved
2233 system = system_piped
2233 system = system_piped
2234
2234
2235 def getoutput(self, cmd, split=True, depth=0):
2235 def getoutput(self, cmd, split=True, depth=0):
2236 """Get output (possibly including stderr) from a subprocess.
2236 """Get output (possibly including stderr) from a subprocess.
2237
2237
2238 Parameters
2238 Parameters
2239 ----------
2239 ----------
2240 cmd : str
2240 cmd : str
2241 Command to execute (can not end in '&', as background processes are
2241 Command to execute (can not end in '&', as background processes are
2242 not supported.
2242 not supported.
2243 split : bool, optional
2243 split : bool, optional
2244 If True, split the output into an IPython SList. Otherwise, an
2244 If True, split the output into an IPython SList. Otherwise, an
2245 IPython LSString is returned. These are objects similar to normal
2245 IPython LSString is returned. These are objects similar to normal
2246 lists and strings, with a few convenience attributes for easier
2246 lists and strings, with a few convenience attributes for easier
2247 manipulation of line-based output. You can use '?' on them for
2247 manipulation of line-based output. You can use '?' on them for
2248 details.
2248 details.
2249 depth : int, optional
2249 depth : int, optional
2250 How many frames above the caller are the local variables which should
2250 How many frames above the caller are the local variables which should
2251 be expanded in the command string? The default (0) assumes that the
2251 be expanded in the command string? The default (0) assumes that the
2252 expansion variables are in the stack frame calling this function.
2252 expansion variables are in the stack frame calling this function.
2253 """
2253 """
2254 if cmd.rstrip().endswith('&'):
2254 if cmd.rstrip().endswith('&'):
2255 # this is *far* from a rigorous test
2255 # this is *far* from a rigorous test
2256 raise OSError("Background processes not supported.")
2256 raise OSError("Background processes not supported.")
2257 out = getoutput(self.var_expand(cmd, depth=depth+1))
2257 out = getoutput(self.var_expand(cmd, depth=depth+1))
2258 if split:
2258 if split:
2259 out = SList(out.splitlines())
2259 out = SList(out.splitlines())
2260 else:
2260 else:
2261 out = LSString(out)
2261 out = LSString(out)
2262 return out
2262 return out
2263
2263
2264 #-------------------------------------------------------------------------
2264 #-------------------------------------------------------------------------
2265 # Things related to aliases
2265 # Things related to aliases
2266 #-------------------------------------------------------------------------
2266 #-------------------------------------------------------------------------
2267
2267
2268 def init_alias(self):
2268 def init_alias(self):
2269 self.alias_manager = AliasManager(shell=self, parent=self)
2269 self.alias_manager = AliasManager(shell=self, parent=self)
2270 self.configurables.append(self.alias_manager)
2270 self.configurables.append(self.alias_manager)
2271
2271
2272 #-------------------------------------------------------------------------
2272 #-------------------------------------------------------------------------
2273 # Things related to extensions
2273 # Things related to extensions
2274 #-------------------------------------------------------------------------
2274 #-------------------------------------------------------------------------
2275
2275
2276 def init_extension_manager(self):
2276 def init_extension_manager(self):
2277 self.extension_manager = ExtensionManager(shell=self, parent=self)
2277 self.extension_manager = ExtensionManager(shell=self, parent=self)
2278 self.configurables.append(self.extension_manager)
2278 self.configurables.append(self.extension_manager)
2279
2279
2280 #-------------------------------------------------------------------------
2280 #-------------------------------------------------------------------------
2281 # Things related to payloads
2281 # Things related to payloads
2282 #-------------------------------------------------------------------------
2282 #-------------------------------------------------------------------------
2283
2283
2284 def init_payload(self):
2284 def init_payload(self):
2285 self.payload_manager = PayloadManager(parent=self)
2285 self.payload_manager = PayloadManager(parent=self)
2286 self.configurables.append(self.payload_manager)
2286 self.configurables.append(self.payload_manager)
2287
2287
2288 #-------------------------------------------------------------------------
2288 #-------------------------------------------------------------------------
2289 # Things related to the prefilter
2289 # Things related to the prefilter
2290 #-------------------------------------------------------------------------
2290 #-------------------------------------------------------------------------
2291
2291
2292 def init_prefilter(self):
2292 def init_prefilter(self):
2293 self.prefilter_manager = PrefilterManager(shell=self, parent=self)
2293 self.prefilter_manager = PrefilterManager(shell=self, parent=self)
2294 self.configurables.append(self.prefilter_manager)
2294 self.configurables.append(self.prefilter_manager)
2295 # Ultimately this will be refactored in the new interpreter code, but
2295 # Ultimately this will be refactored in the new interpreter code, but
2296 # for now, we should expose the main prefilter method (there's legacy
2296 # for now, we should expose the main prefilter method (there's legacy
2297 # code out there that may rely on this).
2297 # code out there that may rely on this).
2298 self.prefilter = self.prefilter_manager.prefilter_lines
2298 self.prefilter = self.prefilter_manager.prefilter_lines
2299
2299
2300 def auto_rewrite_input(self, cmd):
2300 def auto_rewrite_input(self, cmd):
2301 """Print to the screen the rewritten form of the user's command.
2301 """Print to the screen the rewritten form of the user's command.
2302
2302
2303 This shows visual feedback by rewriting input lines that cause
2303 This shows visual feedback by rewriting input lines that cause
2304 automatic calling to kick in, like::
2304 automatic calling to kick in, like::
2305
2305
2306 /f x
2306 /f x
2307
2307
2308 into::
2308 into::
2309
2309
2310 ------> f(x)
2310 ------> f(x)
2311
2311
2312 after the user's input prompt. This helps the user understand that the
2312 after the user's input prompt. This helps the user understand that the
2313 input line was transformed automatically by IPython.
2313 input line was transformed automatically by IPython.
2314 """
2314 """
2315 if not self.show_rewritten_input:
2315 if not self.show_rewritten_input:
2316 return
2316 return
2317
2317
2318 # This is overridden in TerminalInteractiveShell to use fancy prompts
2318 # This is overridden in TerminalInteractiveShell to use fancy prompts
2319 print("------> " + cmd)
2319 print("------> " + cmd)
2320
2320
2321 #-------------------------------------------------------------------------
2321 #-------------------------------------------------------------------------
2322 # Things related to extracting values/expressions from kernel and user_ns
2322 # Things related to extracting values/expressions from kernel and user_ns
2323 #-------------------------------------------------------------------------
2323 #-------------------------------------------------------------------------
2324
2324
2325 def _user_obj_error(self):
2325 def _user_obj_error(self):
2326 """return simple exception dict
2326 """return simple exception dict
2327
2327
2328 for use in user_expressions
2328 for use in user_expressions
2329 """
2329 """
2330
2330
2331 etype, evalue, tb = self._get_exc_info()
2331 etype, evalue, tb = self._get_exc_info()
2332 stb = self.InteractiveTB.get_exception_only(etype, evalue)
2332 stb = self.InteractiveTB.get_exception_only(etype, evalue)
2333
2333
2334 exc_info = {
2334 exc_info = {
2335 u'status' : 'error',
2335 u'status' : 'error',
2336 u'traceback' : stb,
2336 u'traceback' : stb,
2337 u'ename' : etype.__name__,
2337 u'ename' : etype.__name__,
2338 u'evalue' : py3compat.safe_unicode(evalue),
2338 u'evalue' : py3compat.safe_unicode(evalue),
2339 }
2339 }
2340
2340
2341 return exc_info
2341 return exc_info
2342
2342
2343 def _format_user_obj(self, obj):
2343 def _format_user_obj(self, obj):
2344 """format a user object to display dict
2344 """format a user object to display dict
2345
2345
2346 for use in user_expressions
2346 for use in user_expressions
2347 """
2347 """
2348
2348
2349 data, md = self.display_formatter.format(obj)
2349 data, md = self.display_formatter.format(obj)
2350 value = {
2350 value = {
2351 'status' : 'ok',
2351 'status' : 'ok',
2352 'data' : data,
2352 'data' : data,
2353 'metadata' : md,
2353 'metadata' : md,
2354 }
2354 }
2355 return value
2355 return value
2356
2356
2357 def user_expressions(self, expressions):
2357 def user_expressions(self, expressions):
2358 """Evaluate a dict of expressions in the user's namespace.
2358 """Evaluate a dict of expressions in the user's namespace.
2359
2359
2360 Parameters
2360 Parameters
2361 ----------
2361 ----------
2362 expressions : dict
2362 expressions : dict
2363 A dict with string keys and string values. The expression values
2363 A dict with string keys and string values. The expression values
2364 should be valid Python expressions, each of which will be evaluated
2364 should be valid Python expressions, each of which will be evaluated
2365 in the user namespace.
2365 in the user namespace.
2366
2366
2367 Returns
2367 Returns
2368 -------
2368 -------
2369 A dict, keyed like the input expressions dict, with the rich mime-typed
2369 A dict, keyed like the input expressions dict, with the rich mime-typed
2370 display_data of each value.
2370 display_data of each value.
2371 """
2371 """
2372 out = {}
2372 out = {}
2373 user_ns = self.user_ns
2373 user_ns = self.user_ns
2374 global_ns = self.user_global_ns
2374 global_ns = self.user_global_ns
2375
2375
2376 for key, expr in expressions.items():
2376 for key, expr in expressions.items():
2377 try:
2377 try:
2378 value = self._format_user_obj(eval(expr, global_ns, user_ns))
2378 value = self._format_user_obj(eval(expr, global_ns, user_ns))
2379 except:
2379 except:
2380 value = self._user_obj_error()
2380 value = self._user_obj_error()
2381 out[key] = value
2381 out[key] = value
2382 return out
2382 return out
2383
2383
2384 #-------------------------------------------------------------------------
2384 #-------------------------------------------------------------------------
2385 # Things related to the running of code
2385 # Things related to the running of code
2386 #-------------------------------------------------------------------------
2386 #-------------------------------------------------------------------------
2387
2387
2388 def ex(self, cmd):
2388 def ex(self, cmd):
2389 """Execute a normal python statement in user namespace."""
2389 """Execute a normal python statement in user namespace."""
2390 with self.builtin_trap:
2390 with self.builtin_trap:
2391 exec(cmd, self.user_global_ns, self.user_ns)
2391 exec(cmd, self.user_global_ns, self.user_ns)
2392
2392
2393 def ev(self, expr):
2393 def ev(self, expr):
2394 """Evaluate python expression expr in user namespace.
2394 """Evaluate python expression expr in user namespace.
2395
2395
2396 Returns the result of evaluation
2396 Returns the result of evaluation
2397 """
2397 """
2398 with self.builtin_trap:
2398 with self.builtin_trap:
2399 return eval(expr, self.user_global_ns, self.user_ns)
2399 return eval(expr, self.user_global_ns, self.user_ns)
2400
2400
2401 def safe_execfile(self, fname, *where, exit_ignore=False, raise_exceptions=False, shell_futures=False):
2401 def safe_execfile(self, fname, *where, exit_ignore=False, raise_exceptions=False, shell_futures=False):
2402 """A safe version of the builtin execfile().
2402 """A safe version of the builtin execfile().
2403
2403
2404 This version will never throw an exception, but instead print
2404 This version will never throw an exception, but instead print
2405 helpful error messages to the screen. This only works on pure
2405 helpful error messages to the screen. This only works on pure
2406 Python files with the .py extension.
2406 Python files with the .py extension.
2407
2407
2408 Parameters
2408 Parameters
2409 ----------
2409 ----------
2410 fname : string
2410 fname : string
2411 The name of the file to be executed.
2411 The name of the file to be executed.
2412 where : tuple
2412 where : tuple
2413 One or two namespaces, passed to execfile() as (globals,locals).
2413 One or two namespaces, passed to execfile() as (globals,locals).
2414 If only one is given, it is passed as both.
2414 If only one is given, it is passed as both.
2415 exit_ignore : bool (False)
2415 exit_ignore : bool (False)
2416 If True, then silence SystemExit for non-zero status (it is always
2416 If True, then silence SystemExit for non-zero status (it is always
2417 silenced for zero status, as it is so common).
2417 silenced for zero status, as it is so common).
2418 raise_exceptions : bool (False)
2418 raise_exceptions : bool (False)
2419 If True raise exceptions everywhere. Meant for testing.
2419 If True raise exceptions everywhere. Meant for testing.
2420 shell_futures : bool (False)
2420 shell_futures : bool (False)
2421 If True, the code will share future statements with the interactive
2421 If True, the code will share future statements with the interactive
2422 shell. It will both be affected by previous __future__ imports, and
2422 shell. It will both be affected by previous __future__ imports, and
2423 any __future__ imports in the code will affect the shell. If False,
2423 any __future__ imports in the code will affect the shell. If False,
2424 __future__ imports are not shared in either direction.
2424 __future__ imports are not shared in either direction.
2425
2425
2426 """
2426 """
2427 fname = os.path.abspath(os.path.expanduser(fname))
2427 fname = os.path.abspath(os.path.expanduser(fname))
2428
2428
2429 # Make sure we can open the file
2429 # Make sure we can open the file
2430 try:
2430 try:
2431 with open(fname):
2431 with open(fname):
2432 pass
2432 pass
2433 except:
2433 except:
2434 warn('Could not open file <%s> for safe execution.' % fname)
2434 warn('Could not open file <%s> for safe execution.' % fname)
2435 return
2435 return
2436
2436
2437 # Find things also in current directory. This is needed to mimic the
2437 # Find things also in current directory. This is needed to mimic the
2438 # behavior of running a script from the system command line, where
2438 # behavior of running a script from the system command line, where
2439 # Python inserts the script's directory into sys.path
2439 # Python inserts the script's directory into sys.path
2440 dname = os.path.dirname(fname)
2440 dname = os.path.dirname(fname)
2441
2441
2442 with prepended_to_syspath(dname), self.builtin_trap:
2442 with prepended_to_syspath(dname), self.builtin_trap:
2443 try:
2443 try:
2444 glob, loc = (where + (None, ))[:2]
2444 glob, loc = (where + (None, ))[:2]
2445 py3compat.execfile(
2445 py3compat.execfile(
2446 fname, glob, loc,
2446 fname, glob, loc,
2447 self.compile if shell_futures else None)
2447 self.compile if shell_futures else None)
2448 except SystemExit as status:
2448 except SystemExit as status:
2449 # If the call was made with 0 or None exit status (sys.exit(0)
2449 # If the call was made with 0 or None exit status (sys.exit(0)
2450 # or sys.exit() ), don't bother showing a traceback, as both of
2450 # or sys.exit() ), don't bother showing a traceback, as both of
2451 # these are considered normal by the OS:
2451 # these are considered normal by the OS:
2452 # > python -c'import sys;sys.exit(0)'; echo $?
2452 # > python -c'import sys;sys.exit(0)'; echo $?
2453 # 0
2453 # 0
2454 # > python -c'import sys;sys.exit()'; echo $?
2454 # > python -c'import sys;sys.exit()'; echo $?
2455 # 0
2455 # 0
2456 # For other exit status, we show the exception unless
2456 # For other exit status, we show the exception unless
2457 # explicitly silenced, but only in short form.
2457 # explicitly silenced, but only in short form.
2458 if status.code:
2458 if status.code:
2459 if raise_exceptions:
2459 if raise_exceptions:
2460 raise
2460 raise
2461 if not exit_ignore:
2461 if not exit_ignore:
2462 self.showtraceback(exception_only=True)
2462 self.showtraceback(exception_only=True)
2463 except:
2463 except:
2464 if raise_exceptions:
2464 if raise_exceptions:
2465 raise
2465 raise
2466 # tb offset is 2 because we wrap execfile
2466 # tb offset is 2 because we wrap execfile
2467 self.showtraceback(tb_offset=2)
2467 self.showtraceback(tb_offset=2)
2468
2468
2469 def safe_execfile_ipy(self, fname, shell_futures=False, raise_exceptions=False):
2469 def safe_execfile_ipy(self, fname, shell_futures=False, raise_exceptions=False):
2470 """Like safe_execfile, but for .ipy or .ipynb files with IPython syntax.
2470 """Like safe_execfile, but for .ipy or .ipynb files with IPython syntax.
2471
2471
2472 Parameters
2472 Parameters
2473 ----------
2473 ----------
2474 fname : str
2474 fname : str
2475 The name of the file to execute. The filename must have a
2475 The name of the file to execute. The filename must have a
2476 .ipy or .ipynb extension.
2476 .ipy or .ipynb extension.
2477 shell_futures : bool (False)
2477 shell_futures : bool (False)
2478 If True, the code will share future statements with the interactive
2478 If True, the code will share future statements with the interactive
2479 shell. It will both be affected by previous __future__ imports, and
2479 shell. It will both be affected by previous __future__ imports, and
2480 any __future__ imports in the code will affect the shell. If False,
2480 any __future__ imports in the code will affect the shell. If False,
2481 __future__ imports are not shared in either direction.
2481 __future__ imports are not shared in either direction.
2482 raise_exceptions : bool (False)
2482 raise_exceptions : bool (False)
2483 If True raise exceptions everywhere. Meant for testing.
2483 If True raise exceptions everywhere. Meant for testing.
2484 """
2484 """
2485 fname = os.path.abspath(os.path.expanduser(fname))
2485 fname = os.path.abspath(os.path.expanduser(fname))
2486
2486
2487 # Make sure we can open the file
2487 # Make sure we can open the file
2488 try:
2488 try:
2489 with open(fname):
2489 with open(fname):
2490 pass
2490 pass
2491 except:
2491 except:
2492 warn('Could not open file <%s> for safe execution.' % fname)
2492 warn('Could not open file <%s> for safe execution.' % fname)
2493 return
2493 return
2494
2494
2495 # Find things also in current directory. This is needed to mimic the
2495 # Find things also in current directory. This is needed to mimic the
2496 # behavior of running a script from the system command line, where
2496 # behavior of running a script from the system command line, where
2497 # Python inserts the script's directory into sys.path
2497 # Python inserts the script's directory into sys.path
2498 dname = os.path.dirname(fname)
2498 dname = os.path.dirname(fname)
2499
2499
2500 def get_cells():
2500 def get_cells():
2501 """generator for sequence of code blocks to run"""
2501 """generator for sequence of code blocks to run"""
2502 if fname.endswith('.ipynb'):
2502 if fname.endswith('.ipynb'):
2503 from nbformat import read
2503 from nbformat import read
2504 with io_open(fname) as f:
2504 with io_open(fname) as f:
2505 nb = read(f, as_version=4)
2505 nb = read(f, as_version=4)
2506 if not nb.cells:
2506 if not nb.cells:
2507 return
2507 return
2508 for cell in nb.cells:
2508 for cell in nb.cells:
2509 if cell.cell_type == 'code':
2509 if cell.cell_type == 'code':
2510 yield cell.source
2510 yield cell.source
2511 else:
2511 else:
2512 with open(fname) as f:
2512 with open(fname) as f:
2513 yield f.read()
2513 yield f.read()
2514
2514
2515 with prepended_to_syspath(dname):
2515 with prepended_to_syspath(dname):
2516 try:
2516 try:
2517 for cell in get_cells():
2517 for cell in get_cells():
2518 result = self.run_cell(cell, silent=True, shell_futures=shell_futures)
2518 result = self.run_cell(cell, silent=True, shell_futures=shell_futures)
2519 if raise_exceptions:
2519 if raise_exceptions:
2520 result.raise_error()
2520 result.raise_error()
2521 elif not result.success:
2521 elif not result.success:
2522 break
2522 break
2523 except:
2523 except:
2524 if raise_exceptions:
2524 if raise_exceptions:
2525 raise
2525 raise
2526 self.showtraceback()
2526 self.showtraceback()
2527 warn('Unknown failure executing file: <%s>' % fname)
2527 warn('Unknown failure executing file: <%s>' % fname)
2528
2528
2529 def safe_run_module(self, mod_name, where):
2529 def safe_run_module(self, mod_name, where):
2530 """A safe version of runpy.run_module().
2530 """A safe version of runpy.run_module().
2531
2531
2532 This version will never throw an exception, but instead print
2532 This version will never throw an exception, but instead print
2533 helpful error messages to the screen.
2533 helpful error messages to the screen.
2534
2534
2535 `SystemExit` exceptions with status code 0 or None are ignored.
2535 `SystemExit` exceptions with status code 0 or None are ignored.
2536
2536
2537 Parameters
2537 Parameters
2538 ----------
2538 ----------
2539 mod_name : string
2539 mod_name : string
2540 The name of the module to be executed.
2540 The name of the module to be executed.
2541 where : dict
2541 where : dict
2542 The globals namespace.
2542 The globals namespace.
2543 """
2543 """
2544 try:
2544 try:
2545 try:
2545 try:
2546 where.update(
2546 where.update(
2547 runpy.run_module(str(mod_name), run_name="__main__",
2547 runpy.run_module(str(mod_name), run_name="__main__",
2548 alter_sys=True)
2548 alter_sys=True)
2549 )
2549 )
2550 except SystemExit as status:
2550 except SystemExit as status:
2551 if status.code:
2551 if status.code:
2552 raise
2552 raise
2553 except:
2553 except:
2554 self.showtraceback()
2554 self.showtraceback()
2555 warn('Unknown failure executing module: <%s>' % mod_name)
2555 warn('Unknown failure executing module: <%s>' % mod_name)
2556
2556
2557 def run_cell(self, raw_cell, store_history=False, silent=False, shell_futures=True):
2557 def run_cell(self, raw_cell, store_history=False, silent=False, shell_futures=True):
2558 """Run a complete IPython cell.
2558 """Run a complete IPython cell.
2559
2559
2560 Parameters
2560 Parameters
2561 ----------
2561 ----------
2562 raw_cell : str
2562 raw_cell : str
2563 The code (including IPython code such as %magic functions) to run.
2563 The code (including IPython code such as %magic functions) to run.
2564 store_history : bool
2564 store_history : bool
2565 If True, the raw and translated cell will be stored in IPython's
2565 If True, the raw and translated cell will be stored in IPython's
2566 history. For user code calling back into IPython's machinery, this
2566 history. For user code calling back into IPython's machinery, this
2567 should be set to False.
2567 should be set to False.
2568 silent : bool
2568 silent : bool
2569 If True, avoid side-effects, such as implicit displayhooks and
2569 If True, avoid side-effects, such as implicit displayhooks and
2570 and logging. silent=True forces store_history=False.
2570 and logging. silent=True forces store_history=False.
2571 shell_futures : bool
2571 shell_futures : bool
2572 If True, the code will share future statements with the interactive
2572 If True, the code will share future statements with the interactive
2573 shell. It will both be affected by previous __future__ imports, and
2573 shell. It will both be affected by previous __future__ imports, and
2574 any __future__ imports in the code will affect the shell. If False,
2574 any __future__ imports in the code will affect the shell. If False,
2575 __future__ imports are not shared in either direction.
2575 __future__ imports are not shared in either direction.
2576
2576
2577 Returns
2577 Returns
2578 -------
2578 -------
2579 result : :class:`ExecutionResult`
2579 result : :class:`ExecutionResult`
2580 """
2580 """
2581 result = ExecutionResult()
2581 result = ExecutionResult()
2582
2582
2583 if (not raw_cell) or raw_cell.isspace():
2583 if (not raw_cell) or raw_cell.isspace():
2584 self.last_execution_succeeded = True
2584 self.last_execution_succeeded = True
2585 return result
2585 return result
2586
2586
2587 if silent:
2587 if silent:
2588 store_history = False
2588 store_history = False
2589
2589
2590 if store_history:
2590 if store_history:
2591 result.execution_count = self.execution_count
2591 result.execution_count = self.execution_count
2592
2592
2593 def error_before_exec(value):
2593 def error_before_exec(value):
2594 result.error_before_exec = value
2594 result.error_before_exec = value
2595 self.last_execution_succeeded = False
2595 self.last_execution_succeeded = False
2596 return result
2596 return result
2597
2597
2598 self.events.trigger('pre_execute')
2598 self.events.trigger('pre_execute')
2599 if not silent:
2599 if not silent:
2600 self.events.trigger('pre_run_cell')
2600 self.events.trigger('pre_run_cell')
2601
2601
2602 # If any of our input transformation (input_transformer_manager or
2602 # If any of our input transformation (input_transformer_manager or
2603 # prefilter_manager) raises an exception, we store it in this variable
2603 # prefilter_manager) raises an exception, we store it in this variable
2604 # so that we can display the error after logging the input and storing
2604 # so that we can display the error after logging the input and storing
2605 # it in the history.
2605 # it in the history.
2606 preprocessing_exc_tuple = None
2606 preprocessing_exc_tuple = None
2607 try:
2607 try:
2608 # Static input transformations
2608 # Static input transformations
2609 cell = self.input_transformer_manager.transform_cell(raw_cell)
2609 cell = self.input_transformer_manager.transform_cell(raw_cell)
2610 except SyntaxError:
2610 except SyntaxError:
2611 preprocessing_exc_tuple = sys.exc_info()
2611 preprocessing_exc_tuple = sys.exc_info()
2612 cell = raw_cell # cell has to exist so it can be stored/logged
2612 cell = raw_cell # cell has to exist so it can be stored/logged
2613 else:
2613 else:
2614 if len(cell.splitlines()) == 1:
2614 if len(cell.splitlines()) == 1:
2615 # Dynamic transformations - only applied for single line commands
2615 # Dynamic transformations - only applied for single line commands
2616 with self.builtin_trap:
2616 with self.builtin_trap:
2617 try:
2617 try:
2618 # use prefilter_lines to handle trailing newlines
2618 # use prefilter_lines to handle trailing newlines
2619 # restore trailing newline for ast.parse
2619 # restore trailing newline for ast.parse
2620 cell = self.prefilter_manager.prefilter_lines(cell) + '\n'
2620 cell = self.prefilter_manager.prefilter_lines(cell) + '\n'
2621 except Exception:
2621 except Exception:
2622 # don't allow prefilter errors to crash IPython
2622 # don't allow prefilter errors to crash IPython
2623 preprocessing_exc_tuple = sys.exc_info()
2623 preprocessing_exc_tuple = sys.exc_info()
2624
2624
2625 # Store raw and processed history
2625 # Store raw and processed history
2626 if store_history:
2626 if store_history:
2627 self.history_manager.store_inputs(self.execution_count,
2627 self.history_manager.store_inputs(self.execution_count,
2628 cell, raw_cell)
2628 cell, raw_cell)
2629 if not silent:
2629 if not silent:
2630 self.logger.log(cell, raw_cell)
2630 self.logger.log(cell, raw_cell)
2631
2631
2632 # Display the exception if input processing failed.
2632 # Display the exception if input processing failed.
2633 if preprocessing_exc_tuple is not None:
2633 if preprocessing_exc_tuple is not None:
2634 self.showtraceback(preprocessing_exc_tuple)
2634 self.showtraceback(preprocessing_exc_tuple)
2635 if store_history:
2635 if store_history:
2636 self.execution_count += 1
2636 self.execution_count += 1
2637 return error_before_exec(preprocessing_exc_tuple[2])
2637 return error_before_exec(preprocessing_exc_tuple[2])
2638
2638
2639 # Our own compiler remembers the __future__ environment. If we want to
2639 # Our own compiler remembers the __future__ environment. If we want to
2640 # run code with a separate __future__ environment, use the default
2640 # run code with a separate __future__ environment, use the default
2641 # compiler
2641 # compiler
2642 compiler = self.compile if shell_futures else CachingCompiler()
2642 compiler = self.compile if shell_futures else CachingCompiler()
2643
2643
2644 with self.builtin_trap:
2644 with self.builtin_trap:
2645 cell_name = self.compile.cache(cell, self.execution_count)
2645 cell_name = self.compile.cache(cell, self.execution_count)
2646
2646
2647 with self.display_trap:
2647 with self.display_trap:
2648 # Compile to bytecode
2648 # Compile to bytecode
2649 try:
2649 try:
2650 code_ast = compiler.ast_parse(cell, filename=cell_name)
2650 code_ast = compiler.ast_parse(cell, filename=cell_name)
2651 except self.custom_exceptions as e:
2651 except self.custom_exceptions as e:
2652 etype, value, tb = sys.exc_info()
2652 etype, value, tb = sys.exc_info()
2653 self.CustomTB(etype, value, tb)
2653 self.CustomTB(etype, value, tb)
2654 return error_before_exec(e)
2654 return error_before_exec(e)
2655 except IndentationError as e:
2655 except IndentationError as e:
2656 self.showindentationerror()
2656 self.showindentationerror()
2657 if store_history:
2657 if store_history:
2658 self.execution_count += 1
2658 self.execution_count += 1
2659 return error_before_exec(e)
2659 return error_before_exec(e)
2660 except (OverflowError, SyntaxError, ValueError, TypeError,
2660 except (OverflowError, SyntaxError, ValueError, TypeError,
2661 MemoryError) as e:
2661 MemoryError) as e:
2662 self.showsyntaxerror()
2662 self.showsyntaxerror()
2663 if store_history:
2663 if store_history:
2664 self.execution_count += 1
2664 self.execution_count += 1
2665 return error_before_exec(e)
2665 return error_before_exec(e)
2666
2666
2667 # Apply AST transformations
2667 # Apply AST transformations
2668 try:
2668 try:
2669 code_ast = self.transform_ast(code_ast)
2669 code_ast = self.transform_ast(code_ast)
2670 except InputRejected as e:
2670 except InputRejected as e:
2671 self.showtraceback()
2671 self.showtraceback()
2672 if store_history:
2672 if store_history:
2673 self.execution_count += 1
2673 self.execution_count += 1
2674 return error_before_exec(e)
2674 return error_before_exec(e)
2675
2675
2676 # Give the displayhook a reference to our ExecutionResult so it
2676 # Give the displayhook a reference to our ExecutionResult so it
2677 # can fill in the output value.
2677 # can fill in the output value.
2678 self.displayhook.exec_result = result
2678 self.displayhook.exec_result = result
2679
2679
2680 # Execute the user code
2680 # Execute the user code
2681 interactivity = "none" if silent else self.ast_node_interactivity
2681 interactivity = "none" if silent else self.ast_node_interactivity
2682 has_raised = self.run_ast_nodes(code_ast.body, cell_name,
2682 has_raised = self.run_ast_nodes(code_ast.body, cell_name,
2683 interactivity=interactivity, compiler=compiler, result=result)
2683 interactivity=interactivity, compiler=compiler, result=result)
2684
2684
2685 self.last_execution_succeeded = not has_raised
2685 self.last_execution_succeeded = not has_raised
2686
2686
2687 # Reset this so later displayed values do not modify the
2687 # Reset this so later displayed values do not modify the
2688 # ExecutionResult
2688 # ExecutionResult
2689 self.displayhook.exec_result = None
2689 self.displayhook.exec_result = None
2690
2690
2691 self.events.trigger('post_execute')
2691 self.events.trigger('post_execute')
2692 if not silent:
2692 if not silent:
2693 self.events.trigger('post_run_cell')
2693 self.events.trigger('post_run_cell')
2694
2694
2695 if store_history:
2695 if store_history:
2696 # Write output to the database. Does nothing unless
2696 # Write output to the database. Does nothing unless
2697 # history output logging is enabled.
2697 # history output logging is enabled.
2698 self.history_manager.store_output(self.execution_count)
2698 self.history_manager.store_output(self.execution_count)
2699 # Each cell is a *single* input, regardless of how many lines it has
2699 # Each cell is a *single* input, regardless of how many lines it has
2700 self.execution_count += 1
2700 self.execution_count += 1
2701
2701
2702 return result
2702 return result
2703
2703
2704 def transform_ast(self, node):
2704 def transform_ast(self, node):
2705 """Apply the AST transformations from self.ast_transformers
2705 """Apply the AST transformations from self.ast_transformers
2706
2706
2707 Parameters
2707 Parameters
2708 ----------
2708 ----------
2709 node : ast.Node
2709 node : ast.Node
2710 The root node to be transformed. Typically called with the ast.Module
2710 The root node to be transformed. Typically called with the ast.Module
2711 produced by parsing user input.
2711 produced by parsing user input.
2712
2712
2713 Returns
2713 Returns
2714 -------
2714 -------
2715 An ast.Node corresponding to the node it was called with. Note that it
2715 An ast.Node corresponding to the node it was called with. Note that it
2716 may also modify the passed object, so don't rely on references to the
2716 may also modify the passed object, so don't rely on references to the
2717 original AST.
2717 original AST.
2718 """
2718 """
2719 for transformer in self.ast_transformers:
2719 for transformer in self.ast_transformers:
2720 try:
2720 try:
2721 node = transformer.visit(node)
2721 node = transformer.visit(node)
2722 except InputRejected:
2722 except InputRejected:
2723 # User-supplied AST transformers can reject an input by raising
2723 # User-supplied AST transformers can reject an input by raising
2724 # an InputRejected. Short-circuit in this case so that we
2724 # an InputRejected. Short-circuit in this case so that we
2725 # don't unregister the transform.
2725 # don't unregister the transform.
2726 raise
2726 raise
2727 except Exception:
2727 except Exception:
2728 warn("AST transformer %r threw an error. It will be unregistered." % transformer)
2728 warn("AST transformer %r threw an error. It will be unregistered." % transformer)
2729 self.ast_transformers.remove(transformer)
2729 self.ast_transformers.remove(transformer)
2730
2730
2731 if self.ast_transformers:
2731 if self.ast_transformers:
2732 ast.fix_missing_locations(node)
2732 ast.fix_missing_locations(node)
2733 return node
2733 return node
2734
2734
2735
2735
2736 def run_ast_nodes(self, nodelist, cell_name, interactivity='last_expr',
2736 def run_ast_nodes(self, nodelist, cell_name, interactivity='last_expr',
2737 compiler=compile, result=None):
2737 compiler=compile, result=None):
2738 """Run a sequence of AST nodes. The execution mode depends on the
2738 """Run a sequence of AST nodes. The execution mode depends on the
2739 interactivity parameter.
2739 interactivity parameter.
2740
2740
2741 Parameters
2741 Parameters
2742 ----------
2742 ----------
2743 nodelist : list
2743 nodelist : list
2744 A sequence of AST nodes to run.
2744 A sequence of AST nodes to run.
2745 cell_name : str
2745 cell_name : str
2746 Will be passed to the compiler as the filename of the cell. Typically
2746 Will be passed to the compiler as the filename of the cell. Typically
2747 the value returned by ip.compile.cache(cell).
2747 the value returned by ip.compile.cache(cell).
2748 interactivity : str
2748 interactivity : str
2749 'all', 'last', 'last_expr' or 'none', specifying which nodes should be
2749 'all', 'last', 'last_expr' or 'none', specifying which nodes should be
2750 run interactively (displaying output from expressions). 'last_expr'
2750 run interactively (displaying output from expressions). 'last_expr'
2751 will run the last node interactively only if it is an expression (i.e.
2751 will run the last node interactively only if it is an expression (i.e.
2752 expressions in loops or other blocks are not displayed. Other values
2752 expressions in loops or other blocks are not displayed. Other values
2753 for this parameter will raise a ValueError.
2753 for this parameter will raise a ValueError.
2754 compiler : callable
2754 compiler : callable
2755 A function with the same interface as the built-in compile(), to turn
2755 A function with the same interface as the built-in compile(), to turn
2756 the AST nodes into code objects. Default is the built-in compile().
2756 the AST nodes into code objects. Default is the built-in compile().
2757 result : ExecutionResult, optional
2757 result : ExecutionResult, optional
2758 An object to store exceptions that occur during execution.
2758 An object to store exceptions that occur during execution.
2759
2759
2760 Returns
2760 Returns
2761 -------
2761 -------
2762 True if an exception occurred while running code, False if it finished
2762 True if an exception occurred while running code, False if it finished
2763 running.
2763 running.
2764 """
2764 """
2765 if not nodelist:
2765 if not nodelist:
2766 return
2766 return
2767
2767
2768 if interactivity == 'last_expr':
2768 if interactivity == 'last_expr':
2769 if isinstance(nodelist[-1], ast.Expr):
2769 if isinstance(nodelist[-1], ast.Expr):
2770 interactivity = "last"
2770 interactivity = "last"
2771 else:
2771 else:
2772 interactivity = "none"
2772 interactivity = "none"
2773
2773
2774 if interactivity == 'none':
2774 if interactivity == 'none':
2775 to_run_exec, to_run_interactive = nodelist, []
2775 to_run_exec, to_run_interactive = nodelist, []
2776 elif interactivity == 'last':
2776 elif interactivity == 'last':
2777 to_run_exec, to_run_interactive = nodelist[:-1], nodelist[-1:]
2777 to_run_exec, to_run_interactive = nodelist[:-1], nodelist[-1:]
2778 elif interactivity == 'all':
2778 elif interactivity == 'all':
2779 to_run_exec, to_run_interactive = [], nodelist
2779 to_run_exec, to_run_interactive = [], nodelist
2780 else:
2780 else:
2781 raise ValueError("Interactivity was %r" % interactivity)
2781 raise ValueError("Interactivity was %r" % interactivity)
2782
2782
2783 try:
2783 try:
2784 for i, node in enumerate(to_run_exec):
2784 for i, node in enumerate(to_run_exec):
2785 mod = ast.Module([node])
2785 mod = ast.Module([node])
2786 code = compiler(mod, cell_name, "exec")
2786 code = compiler(mod, cell_name, "exec")
2787 if self.run_code(code, result):
2787 if self.run_code(code, result):
2788 return True
2788 return True
2789
2789
2790 for i, node in enumerate(to_run_interactive):
2790 for i, node in enumerate(to_run_interactive):
2791 mod = ast.Interactive([node])
2791 mod = ast.Interactive([node])
2792 code = compiler(mod, cell_name, "single")
2792 code = compiler(mod, cell_name, "single")
2793 if self.run_code(code, result):
2793 if self.run_code(code, result):
2794 return True
2794 return True
2795
2795
2796 # Flush softspace
2796 # Flush softspace
2797 if softspace(sys.stdout, 0):
2797 if softspace(sys.stdout, 0):
2798 print()
2798 print()
2799
2799
2800 except:
2800 except:
2801 # It's possible to have exceptions raised here, typically by
2801 # It's possible to have exceptions raised here, typically by
2802 # compilation of odd code (such as a naked 'return' outside a
2802 # compilation of odd code (such as a naked 'return' outside a
2803 # function) that did parse but isn't valid. Typically the exception
2803 # function) that did parse but isn't valid. Typically the exception
2804 # is a SyntaxError, but it's safest just to catch anything and show
2804 # is a SyntaxError, but it's safest just to catch anything and show
2805 # the user a traceback.
2805 # the user a traceback.
2806
2806
2807 # We do only one try/except outside the loop to minimize the impact
2807 # We do only one try/except outside the loop to minimize the impact
2808 # on runtime, and also because if any node in the node list is
2808 # on runtime, and also because if any node in the node list is
2809 # broken, we should stop execution completely.
2809 # broken, we should stop execution completely.
2810 if result:
2810 if result:
2811 result.error_before_exec = sys.exc_info()[1]
2811 result.error_before_exec = sys.exc_info()[1]
2812 self.showtraceback()
2812 self.showtraceback()
2813 return True
2813 return True
2814
2814
2815 return False
2815 return False
2816
2816
2817 def run_code(self, code_obj, result=None):
2817 def run_code(self, code_obj, result=None):
2818 """Execute a code object.
2818 """Execute a code object.
2819
2819
2820 When an exception occurs, self.showtraceback() is called to display a
2820 When an exception occurs, self.showtraceback() is called to display a
2821 traceback.
2821 traceback.
2822
2822
2823 Parameters
2823 Parameters
2824 ----------
2824 ----------
2825 code_obj : code object
2825 code_obj : code object
2826 A compiled code object, to be executed
2826 A compiled code object, to be executed
2827 result : ExecutionResult, optional
2827 result : ExecutionResult, optional
2828 An object to store exceptions that occur during execution.
2828 An object to store exceptions that occur during execution.
2829
2829
2830 Returns
2830 Returns
2831 -------
2831 -------
2832 False : successful execution.
2832 False : successful execution.
2833 True : an error occurred.
2833 True : an error occurred.
2834 """
2834 """
2835 # Set our own excepthook in case the user code tries to call it
2835 # Set our own excepthook in case the user code tries to call it
2836 # directly, so that the IPython crash handler doesn't get triggered
2836 # directly, so that the IPython crash handler doesn't get triggered
2837 old_excepthook, sys.excepthook = sys.excepthook, self.excepthook
2837 old_excepthook, sys.excepthook = sys.excepthook, self.excepthook
2838
2838
2839 # we save the original sys.excepthook in the instance, in case config
2839 # we save the original sys.excepthook in the instance, in case config
2840 # code (such as magics) needs access to it.
2840 # code (such as magics) needs access to it.
2841 self.sys_excepthook = old_excepthook
2841 self.sys_excepthook = old_excepthook
2842 outflag = True # happens in more places, so it's easier as default
2842 outflag = True # happens in more places, so it's easier as default
2843 try:
2843 try:
2844 try:
2844 try:
2845 self.hooks.pre_run_code_hook()
2845 self.hooks.pre_run_code_hook()
2846 #rprint('Running code', repr(code_obj)) # dbg
2846 #rprint('Running code', repr(code_obj)) # dbg
2847 exec(code_obj, self.user_global_ns, self.user_ns)
2847 exec(code_obj, self.user_global_ns, self.user_ns)
2848 finally:
2848 finally:
2849 # Reset our crash handler in place
2849 # Reset our crash handler in place
2850 sys.excepthook = old_excepthook
2850 sys.excepthook = old_excepthook
2851 except SystemExit as e:
2851 except SystemExit as e:
2852 if result is not None:
2852 if result is not None:
2853 result.error_in_exec = e
2853 result.error_in_exec = e
2854 self.showtraceback(exception_only=True)
2854 self.showtraceback(exception_only=True)
2855 warn("To exit: use 'exit', 'quit', or Ctrl-D.", stacklevel=1)
2855 warn("To exit: use 'exit', 'quit', or Ctrl-D.", stacklevel=1)
2856 except self.custom_exceptions:
2856 except self.custom_exceptions:
2857 etype, value, tb = sys.exc_info()
2857 etype, value, tb = sys.exc_info()
2858 if result is not None:
2858 if result is not None:
2859 result.error_in_exec = value
2859 result.error_in_exec = value
2860 self.CustomTB(etype, value, tb)
2860 self.CustomTB(etype, value, tb)
2861 except:
2861 except:
2862 if result is not None:
2862 if result is not None:
2863 result.error_in_exec = sys.exc_info()[1]
2863 result.error_in_exec = sys.exc_info()[1]
2864 self.showtraceback()
2864 self.showtraceback()
2865 else:
2865 else:
2866 outflag = False
2866 outflag = False
2867 return outflag
2867 return outflag
2868
2868
2869 # For backwards compatibility
2869 # For backwards compatibility
2870 runcode = run_code
2870 runcode = run_code
2871
2871
2872 #-------------------------------------------------------------------------
2872 #-------------------------------------------------------------------------
2873 # Things related to GUI support and pylab
2873 # Things related to GUI support and pylab
2874 #-------------------------------------------------------------------------
2874 #-------------------------------------------------------------------------
2875
2875
2876 active_eventloop = None
2876 active_eventloop = None
2877
2877
2878 def enable_gui(self, gui=None):
2878 def enable_gui(self, gui=None):
2879 raise NotImplementedError('Implement enable_gui in a subclass')
2879 raise NotImplementedError('Implement enable_gui in a subclass')
2880
2880
2881 def enable_matplotlib(self, gui=None):
2881 def enable_matplotlib(self, gui=None):
2882 """Enable interactive matplotlib and inline figure support.
2882 """Enable interactive matplotlib and inline figure support.
2883
2883
2884 This takes the following steps:
2884 This takes the following steps:
2885
2885
2886 1. select the appropriate eventloop and matplotlib backend
2886 1. select the appropriate eventloop and matplotlib backend
2887 2. set up matplotlib for interactive use with that backend
2887 2. set up matplotlib for interactive use with that backend
2888 3. configure formatters for inline figure display
2888 3. configure formatters for inline figure display
2889 4. enable the selected gui eventloop
2889 4. enable the selected gui eventloop
2890
2890
2891 Parameters
2891 Parameters
2892 ----------
2892 ----------
2893 gui : optional, string
2893 gui : optional, string
2894 If given, dictates the choice of matplotlib GUI backend to use
2894 If given, dictates the choice of matplotlib GUI backend to use
2895 (should be one of IPython's supported backends, 'qt', 'osx', 'tk',
2895 (should be one of IPython's supported backends, 'qt', 'osx', 'tk',
2896 'gtk', 'wx' or 'inline'), otherwise we use the default chosen by
2896 'gtk', 'wx' or 'inline'), otherwise we use the default chosen by
2897 matplotlib (as dictated by the matplotlib build-time options plus the
2897 matplotlib (as dictated by the matplotlib build-time options plus the
2898 user's matplotlibrc configuration file). Note that not all backends
2898 user's matplotlibrc configuration file). Note that not all backends
2899 make sense in all contexts, for example a terminal ipython can't
2899 make sense in all contexts, for example a terminal ipython can't
2900 display figures inline.
2900 display figures inline.
2901 """
2901 """
2902 from IPython.core import pylabtools as pt
2902 from IPython.core import pylabtools as pt
2903 gui, backend = pt.find_gui_and_backend(gui, self.pylab_gui_select)
2903 gui, backend = pt.find_gui_and_backend(gui, self.pylab_gui_select)
2904
2904
2905 if gui != 'inline':
2905 if gui != 'inline':
2906 # If we have our first gui selection, store it
2906 # If we have our first gui selection, store it
2907 if self.pylab_gui_select is None:
2907 if self.pylab_gui_select is None:
2908 self.pylab_gui_select = gui
2908 self.pylab_gui_select = gui
2909 # Otherwise if they are different
2909 # Otherwise if they are different
2910 elif gui != self.pylab_gui_select:
2910 elif gui != self.pylab_gui_select:
2911 print ('Warning: Cannot change to a different GUI toolkit: %s.'
2911 print ('Warning: Cannot change to a different GUI toolkit: %s.'
2912 ' Using %s instead.' % (gui, self.pylab_gui_select))
2912 ' Using %s instead.' % (gui, self.pylab_gui_select))
2913 gui, backend = pt.find_gui_and_backend(self.pylab_gui_select)
2913 gui, backend = pt.find_gui_and_backend(self.pylab_gui_select)
2914
2914
2915 pt.activate_matplotlib(backend)
2915 pt.activate_matplotlib(backend)
2916 pt.configure_inline_support(self, backend)
2916 pt.configure_inline_support(self, backend)
2917
2917
2918 # Now we must activate the gui pylab wants to use, and fix %run to take
2918 # Now we must activate the gui pylab wants to use, and fix %run to take
2919 # plot updates into account
2919 # plot updates into account
2920 self.enable_gui(gui)
2920 self.enable_gui(gui)
2921 self.magics_manager.registry['ExecutionMagics'].default_runner = \
2921 self.magics_manager.registry['ExecutionMagics'].default_runner = \
2922 pt.mpl_runner(self.safe_execfile)
2922 pt.mpl_runner(self.safe_execfile)
2923
2923
2924 return gui, backend
2924 return gui, backend
2925
2925
2926 def enable_pylab(self, gui=None, import_all=True, welcome_message=False):
2926 def enable_pylab(self, gui=None, import_all=True, welcome_message=False):
2927 """Activate pylab support at runtime.
2927 """Activate pylab support at runtime.
2928
2928
2929 This turns on support for matplotlib, preloads into the interactive
2929 This turns on support for matplotlib, preloads into the interactive
2930 namespace all of numpy and pylab, and configures IPython to correctly
2930 namespace all of numpy and pylab, and configures IPython to correctly
2931 interact with the GUI event loop. The GUI backend to be used can be
2931 interact with the GUI event loop. The GUI backend to be used can be
2932 optionally selected with the optional ``gui`` argument.
2932 optionally selected with the optional ``gui`` argument.
2933
2933
2934 This method only adds preloading the namespace to InteractiveShell.enable_matplotlib.
2934 This method only adds preloading the namespace to InteractiveShell.enable_matplotlib.
2935
2935
2936 Parameters
2936 Parameters
2937 ----------
2937 ----------
2938 gui : optional, string
2938 gui : optional, string
2939 If given, dictates the choice of matplotlib GUI backend to use
2939 If given, dictates the choice of matplotlib GUI backend to use
2940 (should be one of IPython's supported backends, 'qt', 'osx', 'tk',
2940 (should be one of IPython's supported backends, 'qt', 'osx', 'tk',
2941 'gtk', 'wx' or 'inline'), otherwise we use the default chosen by
2941 'gtk', 'wx' or 'inline'), otherwise we use the default chosen by
2942 matplotlib (as dictated by the matplotlib build-time options plus the
2942 matplotlib (as dictated by the matplotlib build-time options plus the
2943 user's matplotlibrc configuration file). Note that not all backends
2943 user's matplotlibrc configuration file). Note that not all backends
2944 make sense in all contexts, for example a terminal ipython can't
2944 make sense in all contexts, for example a terminal ipython can't
2945 display figures inline.
2945 display figures inline.
2946 import_all : optional, bool, default: True
2946 import_all : optional, bool, default: True
2947 Whether to do `from numpy import *` and `from pylab import *`
2947 Whether to do `from numpy import *` and `from pylab import *`
2948 in addition to module imports.
2948 in addition to module imports.
2949 welcome_message : deprecated
2949 welcome_message : deprecated
2950 This argument is ignored, no welcome message will be displayed.
2950 This argument is ignored, no welcome message will be displayed.
2951 """
2951 """
2952 from IPython.core.pylabtools import import_pylab
2952 from IPython.core.pylabtools import import_pylab
2953
2953
2954 gui, backend = self.enable_matplotlib(gui)
2954 gui, backend = self.enable_matplotlib(gui)
2955
2955
2956 # We want to prevent the loading of pylab to pollute the user's
2956 # We want to prevent the loading of pylab to pollute the user's
2957 # namespace as shown by the %who* magics, so we execute the activation
2957 # namespace as shown by the %who* magics, so we execute the activation
2958 # code in an empty namespace, and we update *both* user_ns and
2958 # code in an empty namespace, and we update *both* user_ns and
2959 # user_ns_hidden with this information.
2959 # user_ns_hidden with this information.
2960 ns = {}
2960 ns = {}
2961 import_pylab(ns, import_all)
2961 import_pylab(ns, import_all)
2962 # warn about clobbered names
2962 # warn about clobbered names
2963 ignored = {"__builtins__"}
2963 ignored = {"__builtins__"}
2964 both = set(ns).intersection(self.user_ns).difference(ignored)
2964 both = set(ns).intersection(self.user_ns).difference(ignored)
2965 clobbered = [ name for name in both if self.user_ns[name] is not ns[name] ]
2965 clobbered = [ name for name in both if self.user_ns[name] is not ns[name] ]
2966 self.user_ns.update(ns)
2966 self.user_ns.update(ns)
2967 self.user_ns_hidden.update(ns)
2967 self.user_ns_hidden.update(ns)
2968 return gui, backend, clobbered
2968 return gui, backend, clobbered
2969
2969
2970 #-------------------------------------------------------------------------
2970 #-------------------------------------------------------------------------
2971 # Utilities
2971 # Utilities
2972 #-------------------------------------------------------------------------
2972 #-------------------------------------------------------------------------
2973
2973
2974 def var_expand(self, cmd, depth=0, formatter=DollarFormatter()):
2974 def var_expand(self, cmd, depth=0, formatter=DollarFormatter()):
2975 """Expand python variables in a string.
2975 """Expand python variables in a string.
2976
2976
2977 The depth argument indicates how many frames above the caller should
2977 The depth argument indicates how many frames above the caller should
2978 be walked to look for the local namespace where to expand variables.
2978 be walked to look for the local namespace where to expand variables.
2979
2979
2980 The global namespace for expansion is always the user's interactive
2980 The global namespace for expansion is always the user's interactive
2981 namespace.
2981 namespace.
2982 """
2982 """
2983 ns = self.user_ns.copy()
2983 ns = self.user_ns.copy()
2984 try:
2984 try:
2985 frame = sys._getframe(depth+1)
2985 frame = sys._getframe(depth+1)
2986 except ValueError:
2986 except ValueError:
2987 # This is thrown if there aren't that many frames on the stack,
2987 # This is thrown if there aren't that many frames on the stack,
2988 # e.g. if a script called run_line_magic() directly.
2988 # e.g. if a script called run_line_magic() directly.
2989 pass
2989 pass
2990 else:
2990 else:
2991 ns.update(frame.f_locals)
2991 ns.update(frame.f_locals)
2992
2992
2993 try:
2993 try:
2994 # We have to use .vformat() here, because 'self' is a valid and common
2994 # We have to use .vformat() here, because 'self' is a valid and common
2995 # name, and expanding **ns for .format() would make it collide with
2995 # name, and expanding **ns for .format() would make it collide with
2996 # the 'self' argument of the method.
2996 # the 'self' argument of the method.
2997 cmd = formatter.vformat(cmd, args=[], kwargs=ns)
2997 cmd = formatter.vformat(cmd, args=[], kwargs=ns)
2998 except Exception:
2998 except Exception:
2999 # if formatter couldn't format, just let it go untransformed
2999 # if formatter couldn't format, just let it go untransformed
3000 pass
3000 pass
3001 return cmd
3001 return cmd
3002
3002
3003 def mktempfile(self, data=None, prefix='ipython_edit_'):
3003 def mktempfile(self, data=None, prefix='ipython_edit_'):
3004 """Make a new tempfile and return its filename.
3004 """Make a new tempfile and return its filename.
3005
3005
3006 This makes a call to tempfile.mkstemp (created in a tempfile.mkdtemp),
3006 This makes a call to tempfile.mkstemp (created in a tempfile.mkdtemp),
3007 but it registers the created filename internally so ipython cleans it up
3007 but it registers the created filename internally so ipython cleans it up
3008 at exit time.
3008 at exit time.
3009
3009
3010 Optional inputs:
3010 Optional inputs:
3011
3011
3012 - data(None): if data is given, it gets written out to the temp file
3012 - data(None): if data is given, it gets written out to the temp file
3013 immediately, and the file is closed again."""
3013 immediately, and the file is closed again."""
3014
3014
3015 dirname = tempfile.mkdtemp(prefix=prefix)
3015 dirname = tempfile.mkdtemp(prefix=prefix)
3016 self.tempdirs.append(dirname)
3016 self.tempdirs.append(dirname)
3017
3017
3018 handle, filename = tempfile.mkstemp('.py', prefix, dir=dirname)
3018 handle, filename = tempfile.mkstemp('.py', prefix, dir=dirname)
3019 os.close(handle) # On Windows, there can only be one open handle on a file
3019 os.close(handle) # On Windows, there can only be one open handle on a file
3020 self.tempfiles.append(filename)
3020 self.tempfiles.append(filename)
3021
3021
3022 if data:
3022 if data:
3023 tmp_file = open(filename,'w')
3023 tmp_file = open(filename,'w')
3024 tmp_file.write(data)
3024 tmp_file.write(data)
3025 tmp_file.close()
3025 tmp_file.close()
3026 return filename
3026 return filename
3027
3027
3028 @undoc
3028 @undoc
3029 def write(self,data):
3029 def write(self,data):
3030 """DEPRECATED: Write a string to the default output"""
3030 """DEPRECATED: Write a string to the default output"""
3031 warn('InteractiveShell.write() is deprecated, use sys.stdout instead',
3031 warn('InteractiveShell.write() is deprecated, use sys.stdout instead',
3032 DeprecationWarning, stacklevel=2)
3032 DeprecationWarning, stacklevel=2)
3033 sys.stdout.write(data)
3033 sys.stdout.write(data)
3034
3034
3035 @undoc
3035 @undoc
3036 def write_err(self,data):
3036 def write_err(self,data):
3037 """DEPRECATED: Write a string to the default error output"""
3037 """DEPRECATED: Write a string to the default error output"""
3038 warn('InteractiveShell.write_err() is deprecated, use sys.stderr instead',
3038 warn('InteractiveShell.write_err() is deprecated, use sys.stderr instead',
3039 DeprecationWarning, stacklevel=2)
3039 DeprecationWarning, stacklevel=2)
3040 sys.stderr.write(data)
3040 sys.stderr.write(data)
3041
3041
3042 def ask_yes_no(self, prompt, default=None, interrupt=None):
3042 def ask_yes_no(self, prompt, default=None, interrupt=None):
3043 if self.quiet:
3043 if self.quiet:
3044 return True
3044 return True
3045 return ask_yes_no(prompt,default,interrupt)
3045 return ask_yes_no(prompt,default,interrupt)
3046
3046
3047 def show_usage(self):
3047 def show_usage(self):
3048 """Show a usage message"""
3048 """Show a usage message"""
3049 page.page(IPython.core.usage.interactive_usage)
3049 page.page(IPython.core.usage.interactive_usage)
3050
3050
3051 def extract_input_lines(self, range_str, raw=False):
3051 def extract_input_lines(self, range_str, raw=False):
3052 """Return as a string a set of input history slices.
3052 """Return as a string a set of input history slices.
3053
3053
3054 Parameters
3054 Parameters
3055 ----------
3055 ----------
3056 range_str : string
3056 range_str : string
3057 The set of slices is given as a string, like "~5/6-~4/2 4:8 9",
3057 The set of slices is given as a string, like "~5/6-~4/2 4:8 9",
3058 since this function is for use by magic functions which get their
3058 since this function is for use by magic functions which get their
3059 arguments as strings. The number before the / is the session
3059 arguments as strings. The number before the / is the session
3060 number: ~n goes n back from the current session.
3060 number: ~n goes n back from the current session.
3061
3061
3062 raw : bool, optional
3062 raw : bool, optional
3063 By default, the processed input is used. If this is true, the raw
3063 By default, the processed input is used. If this is true, the raw
3064 input history is used instead.
3064 input history is used instead.
3065
3065
3066 Notes
3066 Notes
3067 -----
3067 -----
3068
3068
3069 Slices can be described with two notations:
3069 Slices can be described with two notations:
3070
3070
3071 * ``N:M`` -> standard python form, means including items N...(M-1).
3071 * ``N:M`` -> standard python form, means including items N...(M-1).
3072 * ``N-M`` -> include items N..M (closed endpoint).
3072 * ``N-M`` -> include items N..M (closed endpoint).
3073 """
3073 """
3074 lines = self.history_manager.get_range_by_str(range_str, raw=raw)
3074 lines = self.history_manager.get_range_by_str(range_str, raw=raw)
3075 return "\n".join(x for _, _, x in lines)
3075 return "\n".join(x for _, _, x in lines)
3076
3076
3077 def find_user_code(self, target, raw=True, py_only=False, skip_encoding_cookie=True, search_ns=False):
3077 def find_user_code(self, target, raw=True, py_only=False, skip_encoding_cookie=True, search_ns=False):
3078 """Get a code string from history, file, url, or a string or macro.
3078 """Get a code string from history, file, url, or a string or macro.
3079
3079
3080 This is mainly used by magic functions.
3080 This is mainly used by magic functions.
3081
3081
3082 Parameters
3082 Parameters
3083 ----------
3083 ----------
3084
3084
3085 target : str
3085 target : str
3086
3086
3087 A string specifying code to retrieve. This will be tried respectively
3087 A string specifying code to retrieve. This will be tried respectively
3088 as: ranges of input history (see %history for syntax), url,
3088 as: ranges of input history (see %history for syntax), url,
3089 corresponding .py file, filename, or an expression evaluating to a
3089 corresponding .py file, filename, or an expression evaluating to a
3090 string or Macro in the user namespace.
3090 string or Macro in the user namespace.
3091
3091
3092 raw : bool
3092 raw : bool
3093 If true (default), retrieve raw history. Has no effect on the other
3093 If true (default), retrieve raw history. Has no effect on the other
3094 retrieval mechanisms.
3094 retrieval mechanisms.
3095
3095
3096 py_only : bool (default False)
3096 py_only : bool (default False)
3097 Only try to fetch python code, do not try alternative methods to decode file
3097 Only try to fetch python code, do not try alternative methods to decode file
3098 if unicode fails.
3098 if unicode fails.
3099
3099
3100 Returns
3100 Returns
3101 -------
3101 -------
3102 A string of code.
3102 A string of code.
3103
3103
3104 ValueError is raised if nothing is found, and TypeError if it evaluates
3104 ValueError is raised if nothing is found, and TypeError if it evaluates
3105 to an object of another type. In each case, .args[0] is a printable
3105 to an object of another type. In each case, .args[0] is a printable
3106 message.
3106 message.
3107 """
3107 """
3108 code = self.extract_input_lines(target, raw=raw) # Grab history
3108 code = self.extract_input_lines(target, raw=raw) # Grab history
3109 if code:
3109 if code:
3110 return code
3110 return code
3111 try:
3111 try:
3112 if target.startswith(('http://', 'https://')):
3112 if target.startswith(('http://', 'https://')):
3113 return openpy.read_py_url(target, skip_encoding_cookie=skip_encoding_cookie)
3113 return openpy.read_py_url(target, skip_encoding_cookie=skip_encoding_cookie)
3114 except UnicodeDecodeError:
3114 except UnicodeDecodeError:
3115 if not py_only :
3115 if not py_only :
3116 # Deferred import
3116 # Deferred import
3117 from urllib.request import urlopen
3117 from urllib.request import urlopen
3118 response = urlopen(target)
3118 response = urlopen(target)
3119 return response.read().decode('latin1')
3119 return response.read().decode('latin1')
3120 raise ValueError(("'%s' seem to be unreadable.") % target)
3120 raise ValueError(("'%s' seem to be unreadable.") % target)
3121
3121
3122 potential_target = [target]
3122 potential_target = [target]
3123 try :
3123 try :
3124 potential_target.insert(0,get_py_filename(target))
3124 potential_target.insert(0,get_py_filename(target))
3125 except IOError:
3125 except IOError:
3126 pass
3126 pass
3127
3127
3128 for tgt in potential_target :
3128 for tgt in potential_target :
3129 if os.path.isfile(tgt): # Read file
3129 if os.path.isfile(tgt): # Read file
3130 try :
3130 try :
3131 return openpy.read_py_file(tgt, skip_encoding_cookie=skip_encoding_cookie)
3131 return openpy.read_py_file(tgt, skip_encoding_cookie=skip_encoding_cookie)
3132 except UnicodeDecodeError :
3132 except UnicodeDecodeError :
3133 if not py_only :
3133 if not py_only :
3134 with io_open(tgt,'r', encoding='latin1') as f :
3134 with io_open(tgt,'r', encoding='latin1') as f :
3135 return f.read()
3135 return f.read()
3136 raise ValueError(("'%s' seem to be unreadable.") % target)
3136 raise ValueError(("'%s' seem to be unreadable.") % target)
3137 elif os.path.isdir(os.path.expanduser(tgt)):
3137 elif os.path.isdir(os.path.expanduser(tgt)):
3138 raise ValueError("'%s' is a directory, not a regular file." % target)
3138 raise ValueError("'%s' is a directory, not a regular file." % target)
3139
3139
3140 if search_ns:
3140 if search_ns:
3141 # Inspect namespace to load object source
3141 # Inspect namespace to load object source
3142 object_info = self.object_inspect(target, detail_level=1)
3142 object_info = self.object_inspect(target, detail_level=1)
3143 if object_info['found'] and object_info['source']:
3143 if object_info['found'] and object_info['source']:
3144 return object_info['source']
3144 return object_info['source']
3145
3145
3146 try: # User namespace
3146 try: # User namespace
3147 codeobj = eval(target, self.user_ns)
3147 codeobj = eval(target, self.user_ns)
3148 except Exception:
3148 except Exception:
3149 raise ValueError(("'%s' was not found in history, as a file, url, "
3149 raise ValueError(("'%s' was not found in history, as a file, url, "
3150 "nor in the user namespace.") % target)
3150 "nor in the user namespace.") % target)
3151
3151
3152 if isinstance(codeobj, str):
3152 if isinstance(codeobj, str):
3153 return codeobj
3153 return codeobj
3154 elif isinstance(codeobj, Macro):
3154 elif isinstance(codeobj, Macro):
3155 return codeobj.value
3155 return codeobj.value
3156
3156
3157 raise TypeError("%s is neither a string nor a macro." % target,
3157 raise TypeError("%s is neither a string nor a macro." % target,
3158 codeobj)
3158 codeobj)
3159
3159
3160 #-------------------------------------------------------------------------
3160 #-------------------------------------------------------------------------
3161 # Things related to IPython exiting
3161 # Things related to IPython exiting
3162 #-------------------------------------------------------------------------
3162 #-------------------------------------------------------------------------
3163 def atexit_operations(self):
3163 def atexit_operations(self):
3164 """This will be executed at the time of exit.
3164 """This will be executed at the time of exit.
3165
3165
3166 Cleanup operations and saving of persistent data that is done
3166 Cleanup operations and saving of persistent data that is done
3167 unconditionally by IPython should be performed here.
3167 unconditionally by IPython should be performed here.
3168
3168
3169 For things that may depend on startup flags or platform specifics (such
3169 For things that may depend on startup flags or platform specifics (such
3170 as having readline or not), register a separate atexit function in the
3170 as having readline or not), register a separate atexit function in the
3171 code that has the appropriate information, rather than trying to
3171 code that has the appropriate information, rather than trying to
3172 clutter
3172 clutter
3173 """
3173 """
3174 # Close the history session (this stores the end time and line count)
3174 # Close the history session (this stores the end time and line count)
3175 # this must be *before* the tempfile cleanup, in case of temporary
3175 # this must be *before* the tempfile cleanup, in case of temporary
3176 # history db
3176 # history db
3177 self.history_manager.end_session()
3177 self.history_manager.end_session()
3178
3178
3179 # Cleanup all tempfiles and folders left around
3179 # Cleanup all tempfiles and folders left around
3180 for tfile in self.tempfiles:
3180 for tfile in self.tempfiles:
3181 try:
3181 try:
3182 os.unlink(tfile)
3182 os.unlink(tfile)
3183 except OSError:
3183 except OSError:
3184 pass
3184 pass
3185
3185
3186 for tdir in self.tempdirs:
3186 for tdir in self.tempdirs:
3187 try:
3187 try:
3188 os.rmdir(tdir)
3188 os.rmdir(tdir)
3189 except OSError:
3189 except OSError:
3190 pass
3190 pass
3191
3191
3192 # Clear all user namespaces to release all references cleanly.
3192 # Clear all user namespaces to release all references cleanly.
3193 self.reset(new_session=False)
3193 self.reset(new_session=False)
3194
3194
3195 # Run user hooks
3195 # Run user hooks
3196 self.hooks.shutdown_hook()
3196 self.hooks.shutdown_hook()
3197
3197
3198 def cleanup(self):
3198 def cleanup(self):
3199 self.restore_sys_module_state()
3199 self.restore_sys_module_state()
3200
3200
3201
3201
3202 # Overridden in terminal subclass to change prompts
3202 # Overridden in terminal subclass to change prompts
3203 def switch_doctest_mode(self, mode):
3203 def switch_doctest_mode(self, mode):
3204 pass
3204 pass
3205
3205
3206
3206
3207 class InteractiveShellABC(metaclass=abc.ABCMeta):
3207 class InteractiveShellABC(metaclass=abc.ABCMeta):
3208 """An abstract base class for InteractiveShell."""
3208 """An abstract base class for InteractiveShell."""
3209
3209
3210 InteractiveShellABC.register(InteractiveShell)
3210 InteractiveShellABC.register(InteractiveShell)
@@ -1,520 +1,518 b''
1 """IPython terminal interface using prompt_toolkit"""
1 """IPython terminal interface using prompt_toolkit"""
2
2
3 import os
3 import os
4 import sys
4 import sys
5 import warnings
5 import warnings
6 from warnings import warn
6 from warnings import warn
7
7
8 from IPython.core.interactiveshell import InteractiveShell, InteractiveShellABC
8 from IPython.core.interactiveshell import InteractiveShell, InteractiveShellABC
9 from IPython.utils import io
9 from IPython.utils import io
10 from IPython.utils.py3compat import cast_unicode_py2, input
10 from IPython.utils.py3compat import cast_unicode_py2, input
11 from IPython.utils.terminal import toggle_set_term_title, set_term_title
11 from IPython.utils.terminal import toggle_set_term_title, set_term_title
12 from IPython.utils.process import abbrev_cwd
12 from IPython.utils.process import abbrev_cwd
13 from traitlets import Bool, Unicode, Dict, Integer, observe, Instance, Type, default, Enum, Union
13 from traitlets import Bool, Unicode, Dict, Integer, observe, Instance, Type, default, Enum, Union
14
14
15 from prompt_toolkit.document import Document
15 from prompt_toolkit.document import Document
16 from prompt_toolkit.enums import DEFAULT_BUFFER, EditingMode
16 from prompt_toolkit.enums import DEFAULT_BUFFER, EditingMode
17 from prompt_toolkit.filters import (HasFocus, Condition, IsDone)
17 from prompt_toolkit.filters import (HasFocus, Condition, IsDone)
18 from prompt_toolkit.history import InMemoryHistory
18 from prompt_toolkit.history import InMemoryHistory
19 from prompt_toolkit.shortcuts import create_prompt_application, create_eventloop, create_prompt_layout, create_output
19 from prompt_toolkit.shortcuts import create_prompt_application, create_eventloop, create_prompt_layout, create_output
20 from prompt_toolkit.interface import CommandLineInterface
20 from prompt_toolkit.interface import CommandLineInterface
21 from prompt_toolkit.key_binding.manager import KeyBindingManager
21 from prompt_toolkit.key_binding.manager import KeyBindingManager
22 from prompt_toolkit.layout.processors import ConditionalProcessor, HighlightMatchingBracketProcessor
22 from prompt_toolkit.layout.processors import ConditionalProcessor, HighlightMatchingBracketProcessor
23 from prompt_toolkit.styles import PygmentsStyle, DynamicStyle
23 from prompt_toolkit.styles import PygmentsStyle, DynamicStyle
24
24
25 from pygments.styles import get_style_by_name, get_all_styles
25 from pygments.styles import get_style_by_name, get_all_styles
26 from pygments.style import Style
26 from pygments.style import Style
27 from pygments.token import Token
27 from pygments.token import Token
28
28
29 from .debugger import TerminalPdb, Pdb
29 from .debugger import TerminalPdb, Pdb
30 from .magics import TerminalMagics
30 from .magics import TerminalMagics
31 from .pt_inputhooks import get_inputhook_name_and_func
31 from .pt_inputhooks import get_inputhook_name_and_func
32 from .prompts import Prompts, ClassicPrompts, RichPromptDisplayHook
32 from .prompts import Prompts, ClassicPrompts, RichPromptDisplayHook
33 from .ptutils import IPythonPTCompleter, IPythonPTLexer
33 from .ptutils import IPythonPTCompleter, IPythonPTLexer
34 from .shortcuts import register_ipython_shortcuts
34 from .shortcuts import register_ipython_shortcuts
35
35
36 DISPLAY_BANNER_DEPRECATED = object()
36 DISPLAY_BANNER_DEPRECATED = object()
37
37
38
38
39 from pygments.style import Style
40
41 class _NoStyle(Style): pass
39 class _NoStyle(Style): pass
42
40
43
41
44
42
45 _style_overrides_light_bg = {
43 _style_overrides_light_bg = {
46 Token.Prompt: '#0000ff',
44 Token.Prompt: '#0000ff',
47 Token.PromptNum: '#0000ee bold',
45 Token.PromptNum: '#0000ee bold',
48 Token.OutPrompt: '#cc0000',
46 Token.OutPrompt: '#cc0000',
49 Token.OutPromptNum: '#bb0000 bold',
47 Token.OutPromptNum: '#bb0000 bold',
50 }
48 }
51
49
52 _style_overrides_linux = {
50 _style_overrides_linux = {
53 Token.Prompt: '#00cc00',
51 Token.Prompt: '#00cc00',
54 Token.PromptNum: '#00bb00 bold',
52 Token.PromptNum: '#00bb00 bold',
55 Token.OutPrompt: '#cc0000',
53 Token.OutPrompt: '#cc0000',
56 Token.OutPromptNum: '#bb0000 bold',
54 Token.OutPromptNum: '#bb0000 bold',
57 }
55 }
58
56
59
57
60
58
61 def get_default_editor():
59 def get_default_editor():
62 try:
60 try:
63 return os.environ['EDITOR']
61 return os.environ['EDITOR']
64 except KeyError:
62 except KeyError:
65 pass
63 pass
66 except UnicodeError:
64 except UnicodeError:
67 warn("$EDITOR environment variable is not pure ASCII. Using platform "
65 warn("$EDITOR environment variable is not pure ASCII. Using platform "
68 "default editor.")
66 "default editor.")
69
67
70 if os.name == 'posix':
68 if os.name == 'posix':
71 return 'vi' # the only one guaranteed to be there!
69 return 'vi' # the only one guaranteed to be there!
72 else:
70 else:
73 return 'notepad' # same in Windows!
71 return 'notepad' # same in Windows!
74
72
75 # conservatively check for tty
73 # conservatively check for tty
76 # overridden streams can result in things like:
74 # overridden streams can result in things like:
77 # - sys.stdin = None
75 # - sys.stdin = None
78 # - no isatty method
76 # - no isatty method
79 for _name in ('stdin', 'stdout', 'stderr'):
77 for _name in ('stdin', 'stdout', 'stderr'):
80 _stream = getattr(sys, _name)
78 _stream = getattr(sys, _name)
81 if not _stream or not hasattr(_stream, 'isatty') or not _stream.isatty():
79 if not _stream or not hasattr(_stream, 'isatty') or not _stream.isatty():
82 _is_tty = False
80 _is_tty = False
83 break
81 break
84 else:
82 else:
85 _is_tty = True
83 _is_tty = True
86
84
87
85
88 _use_simple_prompt = ('IPY_TEST_SIMPLE_PROMPT' in os.environ) or (not _is_tty)
86 _use_simple_prompt = ('IPY_TEST_SIMPLE_PROMPT' in os.environ) or (not _is_tty)
89
87
90 class TerminalInteractiveShell(InteractiveShell):
88 class TerminalInteractiveShell(InteractiveShell):
91 space_for_menu = Integer(6, help='Number of line at the bottom of the screen '
89 space_for_menu = Integer(6, help='Number of line at the bottom of the screen '
92 'to reserve for the completion menu'
90 'to reserve for the completion menu'
93 ).tag(config=True)
91 ).tag(config=True)
94
92
95 def _space_for_menu_changed(self, old, new):
93 def _space_for_menu_changed(self, old, new):
96 self._update_layout()
94 self._update_layout()
97
95
98 pt_cli = None
96 pt_cli = None
99 debugger_history = None
97 debugger_history = None
100 _pt_app = None
98 _pt_app = None
101
99
102 simple_prompt = Bool(_use_simple_prompt,
100 simple_prompt = Bool(_use_simple_prompt,
103 help="""Use `raw_input` for the REPL, without completion, multiline input, and prompt colors.
101 help="""Use `raw_input` for the REPL, without completion, multiline input, and prompt colors.
104
102
105 Useful when controlling IPython as a subprocess, and piping STDIN/OUT/ERR. Known usage are:
103 Useful when controlling IPython as a subprocess, and piping STDIN/OUT/ERR. Known usage are:
106 IPython own testing machinery, and emacs inferior-shell integration through elpy.
104 IPython own testing machinery, and emacs inferior-shell integration through elpy.
107
105
108 This mode default to `True` if the `IPY_TEST_SIMPLE_PROMPT`
106 This mode default to `True` if the `IPY_TEST_SIMPLE_PROMPT`
109 environment variable is set, or the current terminal is not a tty.
107 environment variable is set, or the current terminal is not a tty.
110
108
111 """
109 """
112 ).tag(config=True)
110 ).tag(config=True)
113
111
114 @property
112 @property
115 def debugger_cls(self):
113 def debugger_cls(self):
116 return Pdb if self.simple_prompt else TerminalPdb
114 return Pdb if self.simple_prompt else TerminalPdb
117
115
118 confirm_exit = Bool(True,
116 confirm_exit = Bool(True,
119 help="""
117 help="""
120 Set to confirm when you try to exit IPython with an EOF (Control-D
118 Set to confirm when you try to exit IPython with an EOF (Control-D
121 in Unix, Control-Z/Enter in Windows). By typing 'exit' or 'quit',
119 in Unix, Control-Z/Enter in Windows). By typing 'exit' or 'quit',
122 you can force a direct exit without any confirmation.""",
120 you can force a direct exit without any confirmation.""",
123 ).tag(config=True)
121 ).tag(config=True)
124
122
125 editing_mode = Unicode('emacs',
123 editing_mode = Unicode('emacs',
126 help="Shortcut style to use at the prompt. 'vi' or 'emacs'.",
124 help="Shortcut style to use at the prompt. 'vi' or 'emacs'.",
127 ).tag(config=True)
125 ).tag(config=True)
128
126
129 mouse_support = Bool(False,
127 mouse_support = Bool(False,
130 help="Enable mouse support in the prompt"
128 help="Enable mouse support in the prompt"
131 ).tag(config=True)
129 ).tag(config=True)
132
130
133 highlighting_style = Union([Unicode('legacy'), Type(klass=Style)],
131 highlighting_style = Union([Unicode('legacy'), Type(klass=Style)],
134 help="""The name or class of a Pygments style to use for syntax
132 help="""The name or class of a Pygments style to use for syntax
135 highlighting: \n %s""" % ', '.join(get_all_styles())
133 highlighting: \n %s""" % ', '.join(get_all_styles())
136 ).tag(config=True)
134 ).tag(config=True)
137
135
138
136
139 @observe('highlighting_style')
137 @observe('highlighting_style')
140 @observe('colors')
138 @observe('colors')
141 def _highlighting_style_changed(self, change):
139 def _highlighting_style_changed(self, change):
142 self.refresh_style()
140 self.refresh_style()
143
141
144 def refresh_style(self):
142 def refresh_style(self):
145 self._style = self._make_style_from_name_or_cls(self.highlighting_style)
143 self._style = self._make_style_from_name_or_cls(self.highlighting_style)
146
144
147
145
148 highlighting_style_overrides = Dict(
146 highlighting_style_overrides = Dict(
149 help="Override highlighting format for specific tokens"
147 help="Override highlighting format for specific tokens"
150 ).tag(config=True)
148 ).tag(config=True)
151
149
152 true_color = Bool(False,
150 true_color = Bool(False,
153 help=("Use 24bit colors instead of 256 colors in prompt highlighting. "
151 help=("Use 24bit colors instead of 256 colors in prompt highlighting. "
154 "If your terminal supports true color, the following command "
152 "If your terminal supports true color, the following command "
155 "should print 'TRUECOLOR' in orange: "
153 "should print 'TRUECOLOR' in orange: "
156 "printf \"\\x1b[38;2;255;100;0mTRUECOLOR\\x1b[0m\\n\"")
154 "printf \"\\x1b[38;2;255;100;0mTRUECOLOR\\x1b[0m\\n\"")
157 ).tag(config=True)
155 ).tag(config=True)
158
156
159 editor = Unicode(get_default_editor(),
157 editor = Unicode(get_default_editor(),
160 help="Set the editor used by IPython (default to $EDITOR/vi/notepad)."
158 help="Set the editor used by IPython (default to $EDITOR/vi/notepad)."
161 ).tag(config=True)
159 ).tag(config=True)
162
160
163 prompts_class = Type(Prompts, help='Class used to generate Prompt token for prompt_toolkit').tag(config=True)
161 prompts_class = Type(Prompts, help='Class used to generate Prompt token for prompt_toolkit').tag(config=True)
164
162
165 prompts = Instance(Prompts)
163 prompts = Instance(Prompts)
166
164
167 @default('prompts')
165 @default('prompts')
168 def _prompts_default(self):
166 def _prompts_default(self):
169 return self.prompts_class(self)
167 return self.prompts_class(self)
170
168
171 @observe('prompts')
169 @observe('prompts')
172 def _(self, change):
170 def _(self, change):
173 self._update_layout()
171 self._update_layout()
174
172
175 @default('displayhook_class')
173 @default('displayhook_class')
176 def _displayhook_class_default(self):
174 def _displayhook_class_default(self):
177 return RichPromptDisplayHook
175 return RichPromptDisplayHook
178
176
179 term_title = Bool(True,
177 term_title = Bool(True,
180 help="Automatically set the terminal title"
178 help="Automatically set the terminal title"
181 ).tag(config=True)
179 ).tag(config=True)
182
180
183 display_completions = Enum(('column', 'multicolumn','readlinelike'),
181 display_completions = Enum(('column', 'multicolumn','readlinelike'),
184 help= ( "Options for displaying tab completions, 'column', 'multicolumn', and "
182 help= ( "Options for displaying tab completions, 'column', 'multicolumn', and "
185 "'readlinelike'. These options are for `prompt_toolkit`, see "
183 "'readlinelike'. These options are for `prompt_toolkit`, see "
186 "`prompt_toolkit` documentation for more information."
184 "`prompt_toolkit` documentation for more information."
187 ),
185 ),
188 default_value='multicolumn').tag(config=True)
186 default_value='multicolumn').tag(config=True)
189
187
190 highlight_matching_brackets = Bool(True,
188 highlight_matching_brackets = Bool(True,
191 help="Highlight matching brackets.",
189 help="Highlight matching brackets.",
192 ).tag(config=True)
190 ).tag(config=True)
193
191
194 extra_open_editor_shortcuts = Bool(False,
192 extra_open_editor_shortcuts = Bool(False,
195 help="Enable vi (v) or Emacs (C-X C-E) shortcuts to open an external editor. "
193 help="Enable vi (v) or Emacs (C-X C-E) shortcuts to open an external editor. "
196 "This is in addition to the F2 binding, which is always enabled."
194 "This is in addition to the F2 binding, which is always enabled."
197 ).tag(config=True)
195 ).tag(config=True)
198
196
199 @observe('term_title')
197 @observe('term_title')
200 def init_term_title(self, change=None):
198 def init_term_title(self, change=None):
201 # Enable or disable the terminal title.
199 # Enable or disable the terminal title.
202 if self.term_title:
200 if self.term_title:
203 toggle_set_term_title(True)
201 toggle_set_term_title(True)
204 set_term_title('IPython: ' + abbrev_cwd())
202 set_term_title('IPython: ' + abbrev_cwd())
205 else:
203 else:
206 toggle_set_term_title(False)
204 toggle_set_term_title(False)
207
205
208 def init_display_formatter(self):
206 def init_display_formatter(self):
209 super(TerminalInteractiveShell, self).init_display_formatter()
207 super(TerminalInteractiveShell, self).init_display_formatter()
210 # terminal only supports plain text
208 # terminal only supports plain text
211 self.display_formatter.active_types = ['text/plain']
209 self.display_formatter.active_types = ['text/plain']
212 # disable `_ipython_display_`
210 # disable `_ipython_display_`
213 self.display_formatter.ipython_display_formatter.enabled = False
211 self.display_formatter.ipython_display_formatter.enabled = False
214
212
215 def init_prompt_toolkit_cli(self):
213 def init_prompt_toolkit_cli(self):
216 if self.simple_prompt:
214 if self.simple_prompt:
217 # Fall back to plain non-interactive output for tests.
215 # Fall back to plain non-interactive output for tests.
218 # This is very limited, and only accepts a single line.
216 # This is very limited, and only accepts a single line.
219 def prompt():
217 def prompt():
220 return cast_unicode_py2(input('In [%d]: ' % self.execution_count))
218 return cast_unicode_py2(input('In [%d]: ' % self.execution_count))
221 self.prompt_for_code = prompt
219 self.prompt_for_code = prompt
222 return
220 return
223
221
224 # Set up keyboard shortcuts
222 # Set up keyboard shortcuts
225 kbmanager = KeyBindingManager.for_prompt(
223 kbmanager = KeyBindingManager.for_prompt(
226 enable_open_in_editor=self.extra_open_editor_shortcuts,
224 enable_open_in_editor=self.extra_open_editor_shortcuts,
227 )
225 )
228 register_ipython_shortcuts(kbmanager.registry, self)
226 register_ipython_shortcuts(kbmanager.registry, self)
229
227
230 # Pre-populate history from IPython's history database
228 # Pre-populate history from IPython's history database
231 history = InMemoryHistory()
229 history = InMemoryHistory()
232 last_cell = u""
230 last_cell = u""
233 for __, ___, cell in self.history_manager.get_tail(self.history_load_length,
231 for __, ___, cell in self.history_manager.get_tail(self.history_load_length,
234 include_latest=True):
232 include_latest=True):
235 # Ignore blank lines and consecutive duplicates
233 # Ignore blank lines and consecutive duplicates
236 cell = cell.rstrip()
234 cell = cell.rstrip()
237 if cell and (cell != last_cell):
235 if cell and (cell != last_cell):
238 history.append(cell)
236 history.append(cell)
239 last_cell = cell
237 last_cell = cell
240
238
241 self._style = self._make_style_from_name_or_cls(self.highlighting_style)
239 self._style = self._make_style_from_name_or_cls(self.highlighting_style)
242 style = DynamicStyle(lambda: self._style)
240 style = DynamicStyle(lambda: self._style)
243
241
244 editing_mode = getattr(EditingMode, self.editing_mode.upper())
242 editing_mode = getattr(EditingMode, self.editing_mode.upper())
245
243
246 def patch_stdout(**kwargs):
244 def patch_stdout(**kwargs):
247 return self.pt_cli.patch_stdout_context(**kwargs)
245 return self.pt_cli.patch_stdout_context(**kwargs)
248
246
249 self._pt_app = create_prompt_application(
247 self._pt_app = create_prompt_application(
250 editing_mode=editing_mode,
248 editing_mode=editing_mode,
251 key_bindings_registry=kbmanager.registry,
249 key_bindings_registry=kbmanager.registry,
252 history=history,
250 history=history,
253 completer=IPythonPTCompleter(shell=self,
251 completer=IPythonPTCompleter(shell=self,
254 patch_stdout=patch_stdout),
252 patch_stdout=patch_stdout),
255 enable_history_search=True,
253 enable_history_search=True,
256 style=style,
254 style=style,
257 mouse_support=self.mouse_support,
255 mouse_support=self.mouse_support,
258 **self._layout_options()
256 **self._layout_options()
259 )
257 )
260 self._eventloop = create_eventloop(self.inputhook)
258 self._eventloop = create_eventloop(self.inputhook)
261 self.pt_cli = CommandLineInterface(
259 self.pt_cli = CommandLineInterface(
262 self._pt_app, eventloop=self._eventloop,
260 self._pt_app, eventloop=self._eventloop,
263 output=create_output(true_color=self.true_color))
261 output=create_output(true_color=self.true_color))
264
262
265 def _make_style_from_name_or_cls(self, name_or_cls):
263 def _make_style_from_name_or_cls(self, name_or_cls):
266 """
264 """
267 Small wrapper that make an IPython compatible style from a style name
265 Small wrapper that make an IPython compatible style from a style name
268
266
269 We need that to add style for prompt ... etc.
267 We need that to add style for prompt ... etc.
270 """
268 """
271 style_overrides = {}
269 style_overrides = {}
272 if name_or_cls == 'legacy':
270 if name_or_cls == 'legacy':
273 legacy = self.colors.lower()
271 legacy = self.colors.lower()
274 if legacy == 'linux':
272 if legacy == 'linux':
275 style_cls = get_style_by_name('monokai')
273 style_cls = get_style_by_name('monokai')
276 style_overrides = _style_overrides_linux
274 style_overrides = _style_overrides_linux
277 elif legacy == 'lightbg':
275 elif legacy == 'lightbg':
278 style_overrides = _style_overrides_light_bg
276 style_overrides = _style_overrides_light_bg
279 style_cls = get_style_by_name('pastie')
277 style_cls = get_style_by_name('pastie')
280 elif legacy == 'neutral':
278 elif legacy == 'neutral':
281 # The default theme needs to be visible on both a dark background
279 # The default theme needs to be visible on both a dark background
282 # and a light background, because we can't tell what the terminal
280 # and a light background, because we can't tell what the terminal
283 # looks like. These tweaks to the default theme help with that.
281 # looks like. These tweaks to the default theme help with that.
284 style_cls = get_style_by_name('default')
282 style_cls = get_style_by_name('default')
285 style_overrides.update({
283 style_overrides.update({
286 Token.Number: '#007700',
284 Token.Number: '#007700',
287 Token.Operator: 'noinherit',
285 Token.Operator: 'noinherit',
288 Token.String: '#BB6622',
286 Token.String: '#BB6622',
289 Token.Name.Function: '#2080D0',
287 Token.Name.Function: '#2080D0',
290 Token.Name.Class: 'bold #2080D0',
288 Token.Name.Class: 'bold #2080D0',
291 Token.Name.Namespace: 'bold #2080D0',
289 Token.Name.Namespace: 'bold #2080D0',
292 Token.Prompt: '#009900',
290 Token.Prompt: '#009900',
293 Token.PromptNum: '#00ff00 bold',
291 Token.PromptNum: '#00ff00 bold',
294 Token.OutPrompt: '#990000',
292 Token.OutPrompt: '#990000',
295 Token.OutPromptNum: '#ff0000 bold',
293 Token.OutPromptNum: '#ff0000 bold',
296 })
294 })
297
295
298 # Hack: Due to limited color support on the Windows console
296 # Hack: Due to limited color support on the Windows console
299 # the prompt colors will be wrong without this
297 # the prompt colors will be wrong without this
300 if os.name == 'nt':
298 if os.name == 'nt':
301 style_overrides.update({
299 style_overrides.update({
302 Token.Prompt: '#ansidarkgreen',
300 Token.Prompt: '#ansidarkgreen',
303 Token.PromptNum: '#ansigreen bold',
301 Token.PromptNum: '#ansigreen bold',
304 Token.OutPrompt: '#ansidarkred',
302 Token.OutPrompt: '#ansidarkred',
305 Token.OutPromptNum: '#ansired bold',
303 Token.OutPromptNum: '#ansired bold',
306 })
304 })
307 elif legacy =='nocolor':
305 elif legacy =='nocolor':
308 style_cls=_NoStyle
306 style_cls=_NoStyle
309 style_overrides = {}
307 style_overrides = {}
310 else :
308 else :
311 raise ValueError('Got unknown colors: ', legacy)
309 raise ValueError('Got unknown colors: ', legacy)
312 else :
310 else :
313 if isinstance(name_or_cls, str):
311 if isinstance(name_or_cls, str):
314 style_cls = get_style_by_name(name_or_cls)
312 style_cls = get_style_by_name(name_or_cls)
315 else:
313 else:
316 style_cls = name_or_cls
314 style_cls = name_or_cls
317 style_overrides = {
315 style_overrides = {
318 Token.Prompt: '#009900',
316 Token.Prompt: '#009900',
319 Token.PromptNum: '#00ff00 bold',
317 Token.PromptNum: '#00ff00 bold',
320 Token.OutPrompt: '#990000',
318 Token.OutPrompt: '#990000',
321 Token.OutPromptNum: '#ff0000 bold',
319 Token.OutPromptNum: '#ff0000 bold',
322 }
320 }
323 style_overrides.update(self.highlighting_style_overrides)
321 style_overrides.update(self.highlighting_style_overrides)
324 style = PygmentsStyle.from_defaults(pygments_style_cls=style_cls,
322 style = PygmentsStyle.from_defaults(pygments_style_cls=style_cls,
325 style_dict=style_overrides)
323 style_dict=style_overrides)
326
324
327 return style
325 return style
328
326
329 def _layout_options(self):
327 def _layout_options(self):
330 """
328 """
331 Return the current layout option for the current Terminal InteractiveShell
329 Return the current layout option for the current Terminal InteractiveShell
332 """
330 """
333 return {
331 return {
334 'lexer':IPythonPTLexer(),
332 'lexer':IPythonPTLexer(),
335 'reserve_space_for_menu':self.space_for_menu,
333 'reserve_space_for_menu':self.space_for_menu,
336 'get_prompt_tokens':self.prompts.in_prompt_tokens,
334 'get_prompt_tokens':self.prompts.in_prompt_tokens,
337 'get_continuation_tokens':self.prompts.continuation_prompt_tokens,
335 'get_continuation_tokens':self.prompts.continuation_prompt_tokens,
338 'multiline':True,
336 'multiline':True,
339 'display_completions_in_columns': (self.display_completions == 'multicolumn'),
337 'display_completions_in_columns': (self.display_completions == 'multicolumn'),
340
338
341 # Highlight matching brackets, but only when this setting is
339 # Highlight matching brackets, but only when this setting is
342 # enabled, and only when the DEFAULT_BUFFER has the focus.
340 # enabled, and only when the DEFAULT_BUFFER has the focus.
343 'extra_input_processors': [ConditionalProcessor(
341 'extra_input_processors': [ConditionalProcessor(
344 processor=HighlightMatchingBracketProcessor(chars='[](){}'),
342 processor=HighlightMatchingBracketProcessor(chars='[](){}'),
345 filter=HasFocus(DEFAULT_BUFFER) & ~IsDone() &
343 filter=HasFocus(DEFAULT_BUFFER) & ~IsDone() &
346 Condition(lambda cli: self.highlight_matching_brackets))],
344 Condition(lambda cli: self.highlight_matching_brackets))],
347 }
345 }
348
346
349 def _update_layout(self):
347 def _update_layout(self):
350 """
348 """
351 Ask for a re computation of the application layout, if for example ,
349 Ask for a re computation of the application layout, if for example ,
352 some configuration options have changed.
350 some configuration options have changed.
353 """
351 """
354 if self._pt_app:
352 if self._pt_app:
355 self._pt_app.layout = create_prompt_layout(**self._layout_options())
353 self._pt_app.layout = create_prompt_layout(**self._layout_options())
356
354
357 def prompt_for_code(self):
355 def prompt_for_code(self):
358 document = self.pt_cli.run(
356 document = self.pt_cli.run(
359 pre_run=self.pre_prompt, reset_current_buffer=True)
357 pre_run=self.pre_prompt, reset_current_buffer=True)
360 return document.text
358 return document.text
361
359
362 def enable_win_unicode_console(self):
360 def enable_win_unicode_console(self):
363 if sys.version_info >= (3, 6):
361 if sys.version_info >= (3, 6):
364 # Since PEP 528, Python uses the unicode APIs for the Windows
362 # Since PEP 528, Python uses the unicode APIs for the Windows
365 # console by default, so WUC shouldn't be needed.
363 # console by default, so WUC shouldn't be needed.
366 return
364 return
367
365
368 import win_unicode_console
366 import win_unicode_console
369 win_unicode_console.enable()
367 win_unicode_console.enable()
370
368
371 def init_io(self):
369 def init_io(self):
372 if sys.platform not in {'win32', 'cli'}:
370 if sys.platform not in {'win32', 'cli'}:
373 return
371 return
374
372
375 self.enable_win_unicode_console()
373 self.enable_win_unicode_console()
376
374
377 import colorama
375 import colorama
378 colorama.init()
376 colorama.init()
379
377
380 # For some reason we make these wrappers around stdout/stderr.
378 # For some reason we make these wrappers around stdout/stderr.
381 # For now, we need to reset them so all output gets coloured.
379 # For now, we need to reset them so all output gets coloured.
382 # https://github.com/ipython/ipython/issues/8669
380 # https://github.com/ipython/ipython/issues/8669
383 # io.std* are deprecated, but don't show our own deprecation warnings
381 # io.std* are deprecated, but don't show our own deprecation warnings
384 # during initialization of the deprecated API.
382 # during initialization of the deprecated API.
385 with warnings.catch_warnings():
383 with warnings.catch_warnings():
386 warnings.simplefilter('ignore', DeprecationWarning)
384 warnings.simplefilter('ignore', DeprecationWarning)
387 io.stdout = io.IOStream(sys.stdout)
385 io.stdout = io.IOStream(sys.stdout)
388 io.stderr = io.IOStream(sys.stderr)
386 io.stderr = io.IOStream(sys.stderr)
389
387
390 def init_magics(self):
388 def init_magics(self):
391 super(TerminalInteractiveShell, self).init_magics()
389 super(TerminalInteractiveShell, self).init_magics()
392 self.register_magics(TerminalMagics)
390 self.register_magics(TerminalMagics)
393
391
394 def init_alias(self):
392 def init_alias(self):
395 # The parent class defines aliases that can be safely used with any
393 # The parent class defines aliases that can be safely used with any
396 # frontend.
394 # frontend.
397 super(TerminalInteractiveShell, self).init_alias()
395 super(TerminalInteractiveShell, self).init_alias()
398
396
399 # Now define aliases that only make sense on the terminal, because they
397 # Now define aliases that only make sense on the terminal, because they
400 # need direct access to the console in a way that we can't emulate in
398 # need direct access to the console in a way that we can't emulate in
401 # GUI or web frontend
399 # GUI or web frontend
402 if os.name == 'posix':
400 if os.name == 'posix':
403 for cmd in ['clear', 'more', 'less', 'man']:
401 for cmd in ['clear', 'more', 'less', 'man']:
404 self.alias_manager.soft_define_alias(cmd, cmd)
402 self.alias_manager.soft_define_alias(cmd, cmd)
405
403
406
404
407 def __init__(self, *args, **kwargs):
405 def __init__(self, *args, **kwargs):
408 super(TerminalInteractiveShell, self).__init__(*args, **kwargs)
406 super(TerminalInteractiveShell, self).__init__(*args, **kwargs)
409 self.init_prompt_toolkit_cli()
407 self.init_prompt_toolkit_cli()
410 self.init_term_title()
408 self.init_term_title()
411 self.keep_running = True
409 self.keep_running = True
412
410
413 self.debugger_history = InMemoryHistory()
411 self.debugger_history = InMemoryHistory()
414
412
415 def ask_exit(self):
413 def ask_exit(self):
416 self.keep_running = False
414 self.keep_running = False
417
415
418 rl_next_input = None
416 rl_next_input = None
419
417
420 def pre_prompt(self):
418 def pre_prompt(self):
421 if self.rl_next_input:
419 if self.rl_next_input:
422 # We can't set the buffer here, because it will be reset just after
420 # We can't set the buffer here, because it will be reset just after
423 # this. Adding a callable to pre_run_callables does what we need
421 # this. Adding a callable to pre_run_callables does what we need
424 # after the buffer is reset.
422 # after the buffer is reset.
425 s = cast_unicode_py2(self.rl_next_input)
423 s = cast_unicode_py2(self.rl_next_input)
426 def set_doc():
424 def set_doc():
427 self.pt_cli.application.buffer.document = Document(s)
425 self.pt_cli.application.buffer.document = Document(s)
428 if hasattr(self.pt_cli, 'pre_run_callables'):
426 if hasattr(self.pt_cli, 'pre_run_callables'):
429 self.pt_cli.pre_run_callables.append(set_doc)
427 self.pt_cli.pre_run_callables.append(set_doc)
430 else:
428 else:
431 # Older version of prompt_toolkit; it's OK to set the document
429 # Older version of prompt_toolkit; it's OK to set the document
432 # directly here.
430 # directly here.
433 set_doc()
431 set_doc()
434 self.rl_next_input = None
432 self.rl_next_input = None
435
433
436 def interact(self, display_banner=DISPLAY_BANNER_DEPRECATED):
434 def interact(self, display_banner=DISPLAY_BANNER_DEPRECATED):
437
435
438 if display_banner is not DISPLAY_BANNER_DEPRECATED:
436 if display_banner is not DISPLAY_BANNER_DEPRECATED:
439 warn('interact `display_banner` argument is deprecated since IPython 5.0. Call `show_banner()` if needed.', DeprecationWarning, stacklevel=2)
437 warn('interact `display_banner` argument is deprecated since IPython 5.0. Call `show_banner()` if needed.', DeprecationWarning, stacklevel=2)
440
438
441 self.keep_running = True
439 self.keep_running = True
442 while self.keep_running:
440 while self.keep_running:
443 print(self.separate_in, end='')
441 print(self.separate_in, end='')
444
442
445 try:
443 try:
446 code = self.prompt_for_code()
444 code = self.prompt_for_code()
447 except EOFError:
445 except EOFError:
448 if (not self.confirm_exit) \
446 if (not self.confirm_exit) \
449 or self.ask_yes_no('Do you really want to exit ([y]/n)?','y','n'):
447 or self.ask_yes_no('Do you really want to exit ([y]/n)?','y','n'):
450 self.ask_exit()
448 self.ask_exit()
451
449
452 else:
450 else:
453 if code:
451 if code:
454 self.run_cell(code, store_history=True)
452 self.run_cell(code, store_history=True)
455
453
456 def mainloop(self, display_banner=DISPLAY_BANNER_DEPRECATED):
454 def mainloop(self, display_banner=DISPLAY_BANNER_DEPRECATED):
457 # An extra layer of protection in case someone mashing Ctrl-C breaks
455 # An extra layer of protection in case someone mashing Ctrl-C breaks
458 # out of our internal code.
456 # out of our internal code.
459 if display_banner is not DISPLAY_BANNER_DEPRECATED:
457 if display_banner is not DISPLAY_BANNER_DEPRECATED:
460 warn('mainloop `display_banner` argument is deprecated since IPython 5.0. Call `show_banner()` if needed.', DeprecationWarning, stacklevel=2)
458 warn('mainloop `display_banner` argument is deprecated since IPython 5.0. Call `show_banner()` if needed.', DeprecationWarning, stacklevel=2)
461 while True:
459 while True:
462 try:
460 try:
463 self.interact()
461 self.interact()
464 break
462 break
465 except KeyboardInterrupt as e:
463 except KeyboardInterrupt as e:
466 print("\n%s escaped interact()\n" % type(e).__name__)
464 print("\n%s escaped interact()\n" % type(e).__name__)
467 finally:
465 finally:
468 # An interrupt during the eventloop will mess up the
466 # An interrupt during the eventloop will mess up the
469 # internal state of the prompt_toolkit library.
467 # internal state of the prompt_toolkit library.
470 # Stopping the eventloop fixes this, see
468 # Stopping the eventloop fixes this, see
471 # https://github.com/ipython/ipython/pull/9867
469 # https://github.com/ipython/ipython/pull/9867
472 if hasattr(self, '_eventloop'):
470 if hasattr(self, '_eventloop'):
473 self._eventloop.stop()
471 self._eventloop.stop()
474
472
475 _inputhook = None
473 _inputhook = None
476 def inputhook(self, context):
474 def inputhook(self, context):
477 if self._inputhook is not None:
475 if self._inputhook is not None:
478 self._inputhook(context)
476 self._inputhook(context)
479
477
480 active_eventloop = None
478 active_eventloop = None
481 def enable_gui(self, gui=None):
479 def enable_gui(self, gui=None):
482 if gui:
480 if gui:
483 self.active_eventloop, self._inputhook =\
481 self.active_eventloop, self._inputhook =\
484 get_inputhook_name_and_func(gui)
482 get_inputhook_name_and_func(gui)
485 else:
483 else:
486 self.active_eventloop = self._inputhook = None
484 self.active_eventloop = self._inputhook = None
487
485
488 # Run !system commands directly, not through pipes, so terminal programs
486 # Run !system commands directly, not through pipes, so terminal programs
489 # work correctly.
487 # work correctly.
490 system = InteractiveShell.system_raw
488 system = InteractiveShell.system_raw
491
489
492 def auto_rewrite_input(self, cmd):
490 def auto_rewrite_input(self, cmd):
493 """Overridden from the parent class to use fancy rewriting prompt"""
491 """Overridden from the parent class to use fancy rewriting prompt"""
494 if not self.show_rewritten_input:
492 if not self.show_rewritten_input:
495 return
493 return
496
494
497 tokens = self.prompts.rewrite_prompt_tokens()
495 tokens = self.prompts.rewrite_prompt_tokens()
498 if self.pt_cli:
496 if self.pt_cli:
499 self.pt_cli.print_tokens(tokens)
497 self.pt_cli.print_tokens(tokens)
500 print(cmd)
498 print(cmd)
501 else:
499 else:
502 prompt = ''.join(s for t, s in tokens)
500 prompt = ''.join(s for t, s in tokens)
503 print(prompt, cmd, sep='')
501 print(prompt, cmd, sep='')
504
502
505 _prompts_before = None
503 _prompts_before = None
506 def switch_doctest_mode(self, mode):
504 def switch_doctest_mode(self, mode):
507 """Switch prompts to classic for %doctest_mode"""
505 """Switch prompts to classic for %doctest_mode"""
508 if mode:
506 if mode:
509 self._prompts_before = self.prompts
507 self._prompts_before = self.prompts
510 self.prompts = ClassicPrompts(self)
508 self.prompts = ClassicPrompts(self)
511 elif self._prompts_before:
509 elif self._prompts_before:
512 self.prompts = self._prompts_before
510 self.prompts = self._prompts_before
513 self._prompts_before = None
511 self._prompts_before = None
514 self._update_layout()
512 self._update_layout()
515
513
516
514
517 InteractiveShellABC.register(TerminalInteractiveShell)
515 InteractiveShellABC.register(TerminalInteractiveShell)
518
516
519 if __name__ == '__main__':
517 if __name__ == '__main__':
520 TerminalInteractiveShell.instance().interact()
518 TerminalInteractiveShell.instance().interact()
General Comments 0
You need to be logged in to leave comments. Login now