##// END OF EJS Templates
Merge pull request #1671 from takluyver/back-to-the-future...
Thomas Kluyver -
r9163:0aacf477 merge
parent child Browse files
Show More
@@ -1,144 +1,144 b''
1 """Compiler tools with improved interactive support.
1 """Compiler tools with improved interactive support.
2
2
3 Provides compilation machinery similar to codeop, but with caching support so
3 Provides compilation machinery similar to codeop, but with caching support so
4 we can provide interactive tracebacks.
4 we can provide interactive tracebacks.
5
5
6 Authors
6 Authors
7 -------
7 -------
8 * Robert Kern
8 * Robert Kern
9 * Fernando Perez
9 * Fernando Perez
10 * Thomas Kluyver
10 * Thomas Kluyver
11 """
11 """
12
12
13 # Note: though it might be more natural to name this module 'compiler', that
13 # Note: though it might be more natural to name this module 'compiler', that
14 # name is in the stdlib and name collisions with the stdlib tend to produce
14 # name is in the stdlib and name collisions with the stdlib tend to produce
15 # weird problems (often with third-party tools).
15 # weird problems (often with third-party tools).
16
16
17 #-----------------------------------------------------------------------------
17 #-----------------------------------------------------------------------------
18 # Copyright (C) 2010-2011 The IPython Development Team.
18 # Copyright (C) 2010-2011 The IPython Development Team.
19 #
19 #
20 # Distributed under the terms of the BSD License.
20 # Distributed under the terms of the BSD License.
21 #
21 #
22 # The full license is in the file COPYING.txt, distributed with this software.
22 # The full license is in the file COPYING.txt, distributed with this software.
23 #-----------------------------------------------------------------------------
23 #-----------------------------------------------------------------------------
24
24
25 #-----------------------------------------------------------------------------
25 #-----------------------------------------------------------------------------
26 # Imports
26 # Imports
27 #-----------------------------------------------------------------------------
27 #-----------------------------------------------------------------------------
28 from __future__ import print_function
28 from __future__ import print_function
29
29
30 # Stdlib imports
30 # Stdlib imports
31 import __future__
31 import __future__
32 from ast import PyCF_ONLY_AST
32 from ast import PyCF_ONLY_AST
33 import codeop
33 import codeop
34 import functools
34 import functools
35 import hashlib
35 import hashlib
36 import linecache
36 import linecache
37 import operator
37 import operator
38 import time
38 import time
39
39
40 #-----------------------------------------------------------------------------
40 #-----------------------------------------------------------------------------
41 # Constants
41 # Constants
42 #-----------------------------------------------------------------------------
42 #-----------------------------------------------------------------------------
43
43
44 # Roughtly equal to PyCF_MASK | PyCF_MASK_OBSOLETE as defined in pythonrun.h,
44 # Roughtly equal to PyCF_MASK | PyCF_MASK_OBSOLETE as defined in pythonrun.h,
45 # this is used as a bitmask to extract future-related code flags.
45 # this is used as a bitmask to extract future-related code flags.
46 PyCF_MASK = functools.reduce(operator.or_,
46 PyCF_MASK = functools.reduce(operator.or_,
47 (getattr(__future__, fname).compiler_flag
47 (getattr(__future__, fname).compiler_flag
48 for fname in __future__.all_feature_names))
48 for fname in __future__.all_feature_names))
49
49
50 #-----------------------------------------------------------------------------
50 #-----------------------------------------------------------------------------
51 # Local utilities
51 # Local utilities
52 #-----------------------------------------------------------------------------
52 #-----------------------------------------------------------------------------
53
53
54 def code_name(code, number=0):
54 def code_name(code, number=0):
55 """ Compute a (probably) unique name for code for caching.
55 """ Compute a (probably) unique name for code for caching.
56
56
57 This now expects code to be unicode.
57 This now expects code to be unicode.
58 """
58 """
59 hash_digest = hashlib.md5(code.encode("utf-8")).hexdigest()
59 hash_digest = hashlib.md5(code.encode("utf-8")).hexdigest()
60 # Include the number and 12 characters of the hash in the name. It's
60 # Include the number and 12 characters of the hash in the name. It's
61 # pretty much impossible that in a single session we'll have collisions
61 # pretty much impossible that in a single session we'll have collisions
62 # even with truncated hashes, and the full one makes tracebacks too long
62 # even with truncated hashes, and the full one makes tracebacks too long
63 return '<ipython-input-{0}-{1}>'.format(number, hash_digest[:12])
63 return '<ipython-input-{0}-{1}>'.format(number, hash_digest[:12])
64
64
65 #-----------------------------------------------------------------------------
65 #-----------------------------------------------------------------------------
66 # Classes and functions
66 # Classes and functions
67 #-----------------------------------------------------------------------------
67 #-----------------------------------------------------------------------------
68
68
69 class CachingCompiler(codeop.Compile):
69 class CachingCompiler(codeop.Compile):
70 """A compiler that caches code compiled from interactive statements.
70 """A compiler that caches code compiled from interactive statements.
71 """
71 """
72
72
73 def __init__(self):
73 def __init__(self):
74 codeop.Compile.__init__(self)
74 codeop.Compile.__init__(self)
75
75
76 # This is ugly, but it must be done this way to allow multiple
76 # This is ugly, but it must be done this way to allow multiple
77 # simultaneous ipython instances to coexist. Since Python itself
77 # simultaneous ipython instances to coexist. Since Python itself
78 # directly accesses the data structures in the linecache module, and
78 # directly accesses the data structures in the linecache module, and
79 # the cache therein is global, we must work with that data structure.
79 # the cache therein is global, we must work with that data structure.
80 # We must hold a reference to the original checkcache routine and call
80 # We must hold a reference to the original checkcache routine and call
81 # that in our own check_cache() below, but the special IPython cache
81 # that in our own check_cache() below, but the special IPython cache
82 # must also be shared by all IPython instances. If we were to hold
82 # must also be shared by all IPython instances. If we were to hold
83 # separate caches (one in each CachingCompiler instance), any call made
83 # separate caches (one in each CachingCompiler instance), any call made
84 # by Python itself to linecache.checkcache() would obliterate the
84 # by Python itself to linecache.checkcache() would obliterate the
85 # cached data from the other IPython instances.
85 # cached data from the other IPython instances.
86 if not hasattr(linecache, '_ipython_cache'):
86 if not hasattr(linecache, '_ipython_cache'):
87 linecache._ipython_cache = {}
87 linecache._ipython_cache = {}
88 if not hasattr(linecache, '_checkcache_ori'):
88 if not hasattr(linecache, '_checkcache_ori'):
89 linecache._checkcache_ori = linecache.checkcache
89 linecache._checkcache_ori = linecache.checkcache
90 # Now, we must monkeypatch the linecache directly so that parts of the
90 # Now, we must monkeypatch the linecache directly so that parts of the
91 # stdlib that call it outside our control go through our codepath
91 # stdlib that call it outside our control go through our codepath
92 # (otherwise we'd lose our tracebacks).
92 # (otherwise we'd lose our tracebacks).
93 linecache.checkcache = self.check_cache
93 linecache.checkcache = check_linecache_ipython
94
94
95 def ast_parse(self, source, filename='<unknown>', symbol='exec'):
95 def ast_parse(self, source, filename='<unknown>', symbol='exec'):
96 """Parse code to an AST with the current compiler flags active.
96 """Parse code to an AST with the current compiler flags active.
97
97
98 Arguments are exactly the same as ast.parse (in the standard library),
98 Arguments are exactly the same as ast.parse (in the standard library),
99 and are passed to the built-in compile function."""
99 and are passed to the built-in compile function."""
100 return compile(source, filename, symbol, self.flags | PyCF_ONLY_AST, 1)
100 return compile(source, filename, symbol, self.flags | PyCF_ONLY_AST, 1)
101
101
102 def reset_compiler_flags(self):
102 def reset_compiler_flags(self):
103 """Reset compiler flags to default state."""
103 """Reset compiler flags to default state."""
104 # This value is copied from codeop.Compile.__init__, so if that ever
104 # This value is copied from codeop.Compile.__init__, so if that ever
105 # changes, it will need to be updated.
105 # changes, it will need to be updated.
106 self.flags = codeop.PyCF_DONT_IMPLY_DEDENT
106 self.flags = codeop.PyCF_DONT_IMPLY_DEDENT
107
107
108 @property
108 @property
109 def compiler_flags(self):
109 def compiler_flags(self):
110 """Flags currently active in the compilation process.
110 """Flags currently active in the compilation process.
111 """
111 """
112 return self.flags
112 return self.flags
113
113
114 def cache(self, code, number=0):
114 def cache(self, code, number=0):
115 """Make a name for a block of code, and cache the code.
115 """Make a name for a block of code, and cache the code.
116
116
117 Parameters
117 Parameters
118 ----------
118 ----------
119 code : str
119 code : str
120 The Python source code to cache.
120 The Python source code to cache.
121 number : int
121 number : int
122 A number which forms part of the code's name. Used for the execution
122 A number which forms part of the code's name. Used for the execution
123 counter.
123 counter.
124
124
125 Returns
125 Returns
126 -------
126 -------
127 The name of the cached code (as a string). Pass this as the filename
127 The name of the cached code (as a string). Pass this as the filename
128 argument to compilation, so that tracebacks are correctly hooked up.
128 argument to compilation, so that tracebacks are correctly hooked up.
129 """
129 """
130 name = code_name(code, number)
130 name = code_name(code, number)
131 entry = (len(code), time.time(),
131 entry = (len(code), time.time(),
132 [line+'\n' for line in code.splitlines()], name)
132 [line+'\n' for line in code.splitlines()], name)
133 linecache.cache[name] = entry
133 linecache.cache[name] = entry
134 linecache._ipython_cache[name] = entry
134 linecache._ipython_cache[name] = entry
135 return name
135 return name
136
136
137 def check_cache(self, *args):
137 def check_linecache_ipython(*args):
138 """Call linecache.checkcache() safely protecting our cached values.
138 """Call linecache.checkcache() safely protecting our cached values.
139 """
139 """
140 # First call the orignal checkcache as intended
140 # First call the orignal checkcache as intended
141 linecache._checkcache_ori(*args)
141 linecache._checkcache_ori(*args)
142 # Then, update back the cache with our data, so that tracebacks related
142 # Then, update back the cache with our data, so that tracebacks related
143 # to our compiled codes can be produced.
143 # to our compiled codes can be produced.
144 linecache.cache.update(linecache._ipython_cache)
144 linecache.cache.update(linecache._ipython_cache)
@@ -1,3052 +1,3064 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 # Imports
14 # Imports
15 #-----------------------------------------------------------------------------
15 #-----------------------------------------------------------------------------
16
16
17 from __future__ import with_statement
18 from __future__ import absolute_import
17 from __future__ import absolute_import
19 from __future__ import print_function
18 from __future__ import print_function
20
19
21 import __builtin__ as builtin_mod
20 import __builtin__ as builtin_mod
22 import __future__
21 import __future__
23 import abc
22 import abc
24 import ast
23 import ast
25 import atexit
24 import atexit
26 import os
25 import os
27 import re
26 import re
28 import runpy
27 import runpy
29 import sys
28 import sys
30 import tempfile
29 import tempfile
31 import types
30 import types
32 import urllib
31 import urllib
33 from io import open as io_open
32 from io import open as io_open
34
33
35 from IPython.config.configurable import SingletonConfigurable
34 from IPython.config.configurable import SingletonConfigurable
36 from IPython.core import debugger, oinspect
35 from IPython.core import debugger, oinspect
37 from IPython.core import magic
36 from IPython.core import magic
38 from IPython.core import page
37 from IPython.core import page
39 from IPython.core import prefilter
38 from IPython.core import prefilter
40 from IPython.core import shadowns
39 from IPython.core import shadowns
41 from IPython.core import ultratb
40 from IPython.core import ultratb
42 from IPython.core.alias import AliasManager, AliasError
41 from IPython.core.alias import AliasManager, AliasError
43 from IPython.core.autocall import ExitAutocall
42 from IPython.core.autocall import ExitAutocall
44 from IPython.core.builtin_trap import BuiltinTrap
43 from IPython.core.builtin_trap import BuiltinTrap
45 from IPython.core.compilerop import CachingCompiler
44 from IPython.core.compilerop import CachingCompiler, check_linecache_ipython
46 from IPython.core.display_trap import DisplayTrap
45 from IPython.core.display_trap import DisplayTrap
47 from IPython.core.displayhook import DisplayHook
46 from IPython.core.displayhook import DisplayHook
48 from IPython.core.displaypub import DisplayPublisher
47 from IPython.core.displaypub import DisplayPublisher
49 from IPython.core.error import UsageError
48 from IPython.core.error import UsageError
50 from IPython.core.extensions import ExtensionManager
49 from IPython.core.extensions import ExtensionManager
51 from IPython.core.fakemodule import FakeModule, init_fakemod_dict
50 from IPython.core.fakemodule import FakeModule, init_fakemod_dict
52 from IPython.core.formatters import DisplayFormatter
51 from IPython.core.formatters import DisplayFormatter
53 from IPython.core.history import HistoryManager
52 from IPython.core.history import HistoryManager
54 from IPython.core.inputsplitter import IPythonInputSplitter, ESC_MAGIC, ESC_MAGIC2
53 from IPython.core.inputsplitter import IPythonInputSplitter, ESC_MAGIC, ESC_MAGIC2
55 from IPython.core.logger import Logger
54 from IPython.core.logger import Logger
56 from IPython.core.macro import Macro
55 from IPython.core.macro import Macro
57 from IPython.core.payload import PayloadManager
56 from IPython.core.payload import PayloadManager
58 from IPython.core.prefilter import PrefilterManager
57 from IPython.core.prefilter import PrefilterManager
59 from IPython.core.profiledir import ProfileDir
58 from IPython.core.profiledir import ProfileDir
60 from IPython.core.pylabtools import pylab_activate
59 from IPython.core.pylabtools import pylab_activate
61 from IPython.core.prompts import PromptManager
60 from IPython.core.prompts import PromptManager
62 from IPython.lib.latextools import LaTeXTool
61 from IPython.lib.latextools import LaTeXTool
63 from IPython.utils import PyColorize
62 from IPython.utils import PyColorize
64 from IPython.utils import io
63 from IPython.utils import io
65 from IPython.utils import py3compat
64 from IPython.utils import py3compat
66 from IPython.utils import openpy
65 from IPython.utils import openpy
67 from IPython.utils.decorators import undoc
66 from IPython.utils.decorators import undoc
68 from IPython.utils.doctestreload import doctest_reload
67 from IPython.utils.doctestreload import doctest_reload
69 from IPython.utils.io import ask_yes_no
68 from IPython.utils.io import ask_yes_no
70 from IPython.utils.ipstruct import Struct
69 from IPython.utils.ipstruct import Struct
71 from IPython.utils.path import get_home_dir, get_ipython_dir, get_py_filename, unquote_filename
70 from IPython.utils.path import get_home_dir, get_ipython_dir, get_py_filename, unquote_filename
72 from IPython.utils.pickleshare import PickleShareDB
71 from IPython.utils.pickleshare import PickleShareDB
73 from IPython.utils.process import system, getoutput
72 from IPython.utils.process import system, getoutput
74 from IPython.utils.strdispatch import StrDispatch
73 from IPython.utils.strdispatch import StrDispatch
75 from IPython.utils.syspathcontext import prepended_to_syspath
74 from IPython.utils.syspathcontext import prepended_to_syspath
76 from IPython.utils.text import (format_screen, LSString, SList,
75 from IPython.utils.text import (format_screen, LSString, SList,
77 DollarFormatter)
76 DollarFormatter)
78 from IPython.utils.traitlets import (Integer, CBool, CaselessStrEnum, Enum,
77 from IPython.utils.traitlets import (Integer, CBool, CaselessStrEnum, Enum,
79 List, Unicode, Instance, Type)
78 List, Unicode, Instance, Type)
80 from IPython.utils.warn import warn, error
79 from IPython.utils.warn import warn, error
81 import IPython.core.hooks
80 import IPython.core.hooks
82
81
83 #-----------------------------------------------------------------------------
82 #-----------------------------------------------------------------------------
84 # Globals
83 # Globals
85 #-----------------------------------------------------------------------------
84 #-----------------------------------------------------------------------------
86
85
87 # compiled regexps for autoindent management
86 # compiled regexps for autoindent management
88 dedent_re = re.compile(r'^\s+raise|^\s+return|^\s+pass')
87 dedent_re = re.compile(r'^\s+raise|^\s+return|^\s+pass')
89
88
90 #-----------------------------------------------------------------------------
89 #-----------------------------------------------------------------------------
91 # Utilities
90 # Utilities
92 #-----------------------------------------------------------------------------
91 #-----------------------------------------------------------------------------
93
92
94 @undoc
93 @undoc
95 def softspace(file, newvalue):
94 def softspace(file, newvalue):
96 """Copied from code.py, to remove the dependency"""
95 """Copied from code.py, to remove the dependency"""
97
96
98 oldvalue = 0
97 oldvalue = 0
99 try:
98 try:
100 oldvalue = file.softspace
99 oldvalue = file.softspace
101 except AttributeError:
100 except AttributeError:
102 pass
101 pass
103 try:
102 try:
104 file.softspace = newvalue
103 file.softspace = newvalue
105 except (AttributeError, TypeError):
104 except (AttributeError, TypeError):
106 # "attribute-less object" or "read-only attributes"
105 # "attribute-less object" or "read-only attributes"
107 pass
106 pass
108 return oldvalue
107 return oldvalue
109
108
110 @undoc
109 @undoc
111 def no_op(*a, **kw): pass
110 def no_op(*a, **kw): pass
112
111
113 @undoc
112 @undoc
114 class NoOpContext(object):
113 class NoOpContext(object):
115 def __enter__(self): pass
114 def __enter__(self): pass
116 def __exit__(self, type, value, traceback): pass
115 def __exit__(self, type, value, traceback): pass
117 no_op_context = NoOpContext()
116 no_op_context = NoOpContext()
118
117
119 class SpaceInInput(Exception): pass
118 class SpaceInInput(Exception): pass
120
119
121 @undoc
120 @undoc
122 class Bunch: pass
121 class Bunch: pass
123
122
124
123
125 def get_default_colors():
124 def get_default_colors():
126 if sys.platform=='darwin':
125 if sys.platform=='darwin':
127 return "LightBG"
126 return "LightBG"
128 elif os.name=='nt':
127 elif os.name=='nt':
129 return 'Linux'
128 return 'Linux'
130 else:
129 else:
131 return 'Linux'
130 return 'Linux'
132
131
133
132
134 class SeparateUnicode(Unicode):
133 class SeparateUnicode(Unicode):
135 """A Unicode subclass to validate separate_in, separate_out, etc.
134 """A Unicode subclass to validate separate_in, separate_out, etc.
136
135
137 This is a Unicode based trait that converts '0'->'' and '\\n'->'\n'.
136 This is a Unicode based trait that converts '0'->'' and '\\n'->'\n'.
138 """
137 """
139
138
140 def validate(self, obj, value):
139 def validate(self, obj, value):
141 if value == '0': value = ''
140 if value == '0': value = ''
142 value = value.replace('\\n','\n')
141 value = value.replace('\\n','\n')
143 return super(SeparateUnicode, self).validate(obj, value)
142 return super(SeparateUnicode, self).validate(obj, value)
144
143
145
144
146 class ReadlineNoRecord(object):
145 class ReadlineNoRecord(object):
147 """Context manager to execute some code, then reload readline history
146 """Context manager to execute some code, then reload readline history
148 so that interactive input to the code doesn't appear when pressing up."""
147 so that interactive input to the code doesn't appear when pressing up."""
149 def __init__(self, shell):
148 def __init__(self, shell):
150 self.shell = shell
149 self.shell = shell
151 self._nested_level = 0
150 self._nested_level = 0
152
151
153 def __enter__(self):
152 def __enter__(self):
154 if self._nested_level == 0:
153 if self._nested_level == 0:
155 try:
154 try:
156 self.orig_length = self.current_length()
155 self.orig_length = self.current_length()
157 self.readline_tail = self.get_readline_tail()
156 self.readline_tail = self.get_readline_tail()
158 except (AttributeError, IndexError): # Can fail with pyreadline
157 except (AttributeError, IndexError): # Can fail with pyreadline
159 self.orig_length, self.readline_tail = 999999, []
158 self.orig_length, self.readline_tail = 999999, []
160 self._nested_level += 1
159 self._nested_level += 1
161
160
162 def __exit__(self, type, value, traceback):
161 def __exit__(self, type, value, traceback):
163 self._nested_level -= 1
162 self._nested_level -= 1
164 if self._nested_level == 0:
163 if self._nested_level == 0:
165 # Try clipping the end if it's got longer
164 # Try clipping the end if it's got longer
166 try:
165 try:
167 e = self.current_length() - self.orig_length
166 e = self.current_length() - self.orig_length
168 if e > 0:
167 if e > 0:
169 for _ in range(e):
168 for _ in range(e):
170 self.shell.readline.remove_history_item(self.orig_length)
169 self.shell.readline.remove_history_item(self.orig_length)
171
170
172 # If it still doesn't match, just reload readline history.
171 # If it still doesn't match, just reload readline history.
173 if self.current_length() != self.orig_length \
172 if self.current_length() != self.orig_length \
174 or self.get_readline_tail() != self.readline_tail:
173 or self.get_readline_tail() != self.readline_tail:
175 self.shell.refill_readline_hist()
174 self.shell.refill_readline_hist()
176 except (AttributeError, IndexError):
175 except (AttributeError, IndexError):
177 pass
176 pass
178 # Returning False will cause exceptions to propagate
177 # Returning False will cause exceptions to propagate
179 return False
178 return False
180
179
181 def current_length(self):
180 def current_length(self):
182 return self.shell.readline.get_current_history_length()
181 return self.shell.readline.get_current_history_length()
183
182
184 def get_readline_tail(self, n=10):
183 def get_readline_tail(self, n=10):
185 """Get the last n items in readline history."""
184 """Get the last n items in readline history."""
186 end = self.shell.readline.get_current_history_length() + 1
185 end = self.shell.readline.get_current_history_length() + 1
187 start = max(end-n, 1)
186 start = max(end-n, 1)
188 ghi = self.shell.readline.get_history_item
187 ghi = self.shell.readline.get_history_item
189 return [ghi(x) for x in range(start, end)]
188 return [ghi(x) for x in range(start, end)]
190
189
191 #-----------------------------------------------------------------------------
190 #-----------------------------------------------------------------------------
192 # Main IPython class
191 # Main IPython class
193 #-----------------------------------------------------------------------------
192 #-----------------------------------------------------------------------------
194
193
195 class InteractiveShell(SingletonConfigurable):
194 class InteractiveShell(SingletonConfigurable):
196 """An enhanced, interactive shell for Python."""
195 """An enhanced, interactive shell for Python."""
197
196
198 _instance = None
197 _instance = None
199
198
200 ast_transformers = List([], config=True, help=
199 ast_transformers = List([], config=True, help=
201 """
200 """
202 A list of ast.NodeTransformer subclass instances, which will be applied
201 A list of ast.NodeTransformer subclass instances, which will be applied
203 to user input before code is run.
202 to user input before code is run.
204 """
203 """
205 )
204 )
206
205
207 autocall = Enum((0,1,2), default_value=0, config=True, help=
206 autocall = Enum((0,1,2), default_value=0, config=True, help=
208 """
207 """
209 Make IPython automatically call any callable object even if you didn't
208 Make IPython automatically call any callable object even if you didn't
210 type explicit parentheses. For example, 'str 43' becomes 'str(43)'
209 type explicit parentheses. For example, 'str 43' becomes 'str(43)'
211 automatically. The value can be '0' to disable the feature, '1' for
210 automatically. The value can be '0' to disable the feature, '1' for
212 'smart' autocall, where it is not applied if there are no more
211 'smart' autocall, where it is not applied if there are no more
213 arguments on the line, and '2' for 'full' autocall, where all callable
212 arguments on the line, and '2' for 'full' autocall, where all callable
214 objects are automatically called (even if no arguments are present).
213 objects are automatically called (even if no arguments are present).
215 """
214 """
216 )
215 )
217 # TODO: remove all autoindent logic and put into frontends.
216 # TODO: remove all autoindent logic and put into frontends.
218 # We can't do this yet because even runlines uses the autoindent.
217 # We can't do this yet because even runlines uses the autoindent.
219 autoindent = CBool(True, config=True, help=
218 autoindent = CBool(True, config=True, help=
220 """
219 """
221 Autoindent IPython code entered interactively.
220 Autoindent IPython code entered interactively.
222 """
221 """
223 )
222 )
224 automagic = CBool(True, config=True, help=
223 automagic = CBool(True, config=True, help=
225 """
224 """
226 Enable magic commands to be called without the leading %.
225 Enable magic commands to be called without the leading %.
227 """
226 """
228 )
227 )
229 cache_size = Integer(1000, config=True, help=
228 cache_size = Integer(1000, config=True, help=
230 """
229 """
231 Set the size of the output cache. The default is 1000, you can
230 Set the size of the output cache. The default is 1000, you can
232 change it permanently in your config file. Setting it to 0 completely
231 change it permanently in your config file. Setting it to 0 completely
233 disables the caching system, and the minimum value accepted is 20 (if
232 disables the caching system, and the minimum value accepted is 20 (if
234 you provide a value less than 20, it is reset to 0 and a warning is
233 you provide a value less than 20, it is reset to 0 and a warning is
235 issued). This limit is defined because otherwise you'll spend more
234 issued). This limit is defined because otherwise you'll spend more
236 time re-flushing a too small cache than working
235 time re-flushing a too small cache than working
237 """
236 """
238 )
237 )
239 color_info = CBool(True, config=True, help=
238 color_info = CBool(True, config=True, help=
240 """
239 """
241 Use colors for displaying information about objects. Because this
240 Use colors for displaying information about objects. Because this
242 information is passed through a pager (like 'less'), and some pagers
241 information is passed through a pager (like 'less'), and some pagers
243 get confused with color codes, this capability can be turned off.
242 get confused with color codes, this capability can be turned off.
244 """
243 """
245 )
244 )
246 colors = CaselessStrEnum(('NoColor','LightBG','Linux'),
245 colors = CaselessStrEnum(('NoColor','LightBG','Linux'),
247 default_value=get_default_colors(), config=True,
246 default_value=get_default_colors(), config=True,
248 help="Set the color scheme (NoColor, Linux, or LightBG)."
247 help="Set the color scheme (NoColor, Linux, or LightBG)."
249 )
248 )
250 colors_force = CBool(False, help=
249 colors_force = CBool(False, help=
251 """
250 """
252 Force use of ANSI color codes, regardless of OS and readline
251 Force use of ANSI color codes, regardless of OS and readline
253 availability.
252 availability.
254 """
253 """
255 # FIXME: This is essentially a hack to allow ZMQShell to show colors
254 # FIXME: This is essentially a hack to allow ZMQShell to show colors
256 # without readline on Win32. When the ZMQ formatting system is
255 # without readline on Win32. When the ZMQ formatting system is
257 # refactored, this should be removed.
256 # refactored, this should be removed.
258 )
257 )
259 debug = CBool(False, config=True)
258 debug = CBool(False, config=True)
260 deep_reload = CBool(False, config=True, help=
259 deep_reload = CBool(False, config=True, help=
261 """
260 """
262 Enable deep (recursive) reloading by default. IPython can use the
261 Enable deep (recursive) reloading by default. IPython can use the
263 deep_reload module which reloads changes in modules recursively (it
262 deep_reload module which reloads changes in modules recursively (it
264 replaces the reload() function, so you don't need to change anything to
263 replaces the reload() function, so you don't need to change anything to
265 use it). deep_reload() forces a full reload of modules whose code may
264 use it). deep_reload() forces a full reload of modules whose code may
266 have changed, which the default reload() function does not. When
265 have changed, which the default reload() function does not. When
267 deep_reload is off, IPython will use the normal reload(), but
266 deep_reload is off, IPython will use the normal reload(), but
268 deep_reload will still be available as dreload().
267 deep_reload will still be available as dreload().
269 """
268 """
270 )
269 )
271 disable_failing_post_execute = CBool(False, config=True,
270 disable_failing_post_execute = CBool(False, config=True,
272 help="Don't call post-execute functions that have failed in the past."
271 help="Don't call post-execute functions that have failed in the past."
273 )
272 )
274 display_formatter = Instance(DisplayFormatter)
273 display_formatter = Instance(DisplayFormatter)
275 displayhook_class = Type(DisplayHook)
274 displayhook_class = Type(DisplayHook)
276 display_pub_class = Type(DisplayPublisher)
275 display_pub_class = Type(DisplayPublisher)
277 data_pub_class = None
276 data_pub_class = None
278
277
279 exit_now = CBool(False)
278 exit_now = CBool(False)
280 exiter = Instance(ExitAutocall)
279 exiter = Instance(ExitAutocall)
281 def _exiter_default(self):
280 def _exiter_default(self):
282 return ExitAutocall(self)
281 return ExitAutocall(self)
283 # Monotonically increasing execution counter
282 # Monotonically increasing execution counter
284 execution_count = Integer(1)
283 execution_count = Integer(1)
285 filename = Unicode("<ipython console>")
284 filename = Unicode("<ipython console>")
286 ipython_dir= Unicode('', config=True) # Set to get_ipython_dir() in __init__
285 ipython_dir= Unicode('', config=True) # Set to get_ipython_dir() in __init__
287
286
288 # Input splitter, to split entire cells of input into either individual
287 # Input splitter, to split entire cells of input into either individual
289 # interactive statements or whole blocks.
288 # interactive statements or whole blocks.
290 input_splitter = Instance('IPython.core.inputsplitter.IPythonInputSplitter',
289 input_splitter = Instance('IPython.core.inputsplitter.IPythonInputSplitter',
291 (), {})
290 (), {})
292 logstart = CBool(False, config=True, help=
291 logstart = CBool(False, config=True, help=
293 """
292 """
294 Start logging to the default log file.
293 Start logging to the default log file.
295 """
294 """
296 )
295 )
297 logfile = Unicode('', config=True, help=
296 logfile = Unicode('', config=True, help=
298 """
297 """
299 The name of the logfile to use.
298 The name of the logfile to use.
300 """
299 """
301 )
300 )
302 logappend = Unicode('', config=True, help=
301 logappend = Unicode('', config=True, help=
303 """
302 """
304 Start logging to the given file in append mode.
303 Start logging to the given file in append mode.
305 """
304 """
306 )
305 )
307 object_info_string_level = Enum((0,1,2), default_value=0,
306 object_info_string_level = Enum((0,1,2), default_value=0,
308 config=True)
307 config=True)
309 pdb = CBool(False, config=True, help=
308 pdb = CBool(False, config=True, help=
310 """
309 """
311 Automatically call the pdb debugger after every exception.
310 Automatically call the pdb debugger after every exception.
312 """
311 """
313 )
312 )
314 multiline_history = CBool(sys.platform != 'win32', config=True,
313 multiline_history = CBool(sys.platform != 'win32', config=True,
315 help="Save multi-line entries as one entry in readline history"
314 help="Save multi-line entries as one entry in readline history"
316 )
315 )
317
316
318 # deprecated prompt traits:
317 # deprecated prompt traits:
319
318
320 prompt_in1 = Unicode('In [\\#]: ', config=True,
319 prompt_in1 = Unicode('In [\\#]: ', config=True,
321 help="Deprecated, use PromptManager.in_template")
320 help="Deprecated, use PromptManager.in_template")
322 prompt_in2 = Unicode(' .\\D.: ', config=True,
321 prompt_in2 = Unicode(' .\\D.: ', config=True,
323 help="Deprecated, use PromptManager.in2_template")
322 help="Deprecated, use PromptManager.in2_template")
324 prompt_out = Unicode('Out[\\#]: ', config=True,
323 prompt_out = Unicode('Out[\\#]: ', config=True,
325 help="Deprecated, use PromptManager.out_template")
324 help="Deprecated, use PromptManager.out_template")
326 prompts_pad_left = CBool(True, config=True,
325 prompts_pad_left = CBool(True, config=True,
327 help="Deprecated, use PromptManager.justify")
326 help="Deprecated, use PromptManager.justify")
328
327
329 def _prompt_trait_changed(self, name, old, new):
328 def _prompt_trait_changed(self, name, old, new):
330 table = {
329 table = {
331 'prompt_in1' : 'in_template',
330 'prompt_in1' : 'in_template',
332 'prompt_in2' : 'in2_template',
331 'prompt_in2' : 'in2_template',
333 'prompt_out' : 'out_template',
332 'prompt_out' : 'out_template',
334 'prompts_pad_left' : 'justify',
333 'prompts_pad_left' : 'justify',
335 }
334 }
336 warn("InteractiveShell.{name} is deprecated, use PromptManager.{newname}".format(
335 warn("InteractiveShell.{name} is deprecated, use PromptManager.{newname}".format(
337 name=name, newname=table[name])
336 name=name, newname=table[name])
338 )
337 )
339 # protect against weird cases where self.config may not exist:
338 # protect against weird cases where self.config may not exist:
340 if self.config is not None:
339 if self.config is not None:
341 # propagate to corresponding PromptManager trait
340 # propagate to corresponding PromptManager trait
342 setattr(self.config.PromptManager, table[name], new)
341 setattr(self.config.PromptManager, table[name], new)
343
342
344 _prompt_in1_changed = _prompt_trait_changed
343 _prompt_in1_changed = _prompt_trait_changed
345 _prompt_in2_changed = _prompt_trait_changed
344 _prompt_in2_changed = _prompt_trait_changed
346 _prompt_out_changed = _prompt_trait_changed
345 _prompt_out_changed = _prompt_trait_changed
347 _prompt_pad_left_changed = _prompt_trait_changed
346 _prompt_pad_left_changed = _prompt_trait_changed
348
347
349 show_rewritten_input = CBool(True, config=True,
348 show_rewritten_input = CBool(True, config=True,
350 help="Show rewritten input, e.g. for autocall."
349 help="Show rewritten input, e.g. for autocall."
351 )
350 )
352
351
353 quiet = CBool(False, config=True)
352 quiet = CBool(False, config=True)
354
353
355 history_length = Integer(10000, config=True)
354 history_length = Integer(10000, config=True)
356
355
357 # The readline stuff will eventually be moved to the terminal subclass
356 # The readline stuff will eventually be moved to the terminal subclass
358 # but for now, we can't do that as readline is welded in everywhere.
357 # but for now, we can't do that as readline is welded in everywhere.
359 readline_use = CBool(True, config=True)
358 readline_use = CBool(True, config=True)
360 readline_remove_delims = Unicode('-/~', config=True)
359 readline_remove_delims = Unicode('-/~', config=True)
361 readline_delims = Unicode() # set by init_readline()
360 readline_delims = Unicode() # set by init_readline()
362 # don't use \M- bindings by default, because they
361 # don't use \M- bindings by default, because they
363 # conflict with 8-bit encodings. See gh-58,gh-88
362 # conflict with 8-bit encodings. See gh-58,gh-88
364 readline_parse_and_bind = List([
363 readline_parse_and_bind = List([
365 'tab: complete',
364 'tab: complete',
366 '"\C-l": clear-screen',
365 '"\C-l": clear-screen',
367 'set show-all-if-ambiguous on',
366 'set show-all-if-ambiguous on',
368 '"\C-o": tab-insert',
367 '"\C-o": tab-insert',
369 '"\C-r": reverse-search-history',
368 '"\C-r": reverse-search-history',
370 '"\C-s": forward-search-history',
369 '"\C-s": forward-search-history',
371 '"\C-p": history-search-backward',
370 '"\C-p": history-search-backward',
372 '"\C-n": history-search-forward',
371 '"\C-n": history-search-forward',
373 '"\e[A": history-search-backward',
372 '"\e[A": history-search-backward',
374 '"\e[B": history-search-forward',
373 '"\e[B": history-search-forward',
375 '"\C-k": kill-line',
374 '"\C-k": kill-line',
376 '"\C-u": unix-line-discard',
375 '"\C-u": unix-line-discard',
377 ], allow_none=False, config=True)
376 ], allow_none=False, config=True)
378
377
379 ast_node_interactivity = Enum(['all', 'last', 'last_expr', 'none'],
378 ast_node_interactivity = Enum(['all', 'last', 'last_expr', 'none'],
380 default_value='last_expr', config=True,
379 default_value='last_expr', config=True,
381 help="""
380 help="""
382 'all', 'last', 'last_expr' or 'none', specifying which nodes should be
381 'all', 'last', 'last_expr' or 'none', specifying which nodes should be
383 run interactively (displaying output from expressions).""")
382 run interactively (displaying output from expressions).""")
384
383
385 # TODO: this part of prompt management should be moved to the frontends.
384 # TODO: this part of prompt management should be moved to the frontends.
386 # Use custom TraitTypes that convert '0'->'' and '\\n'->'\n'
385 # Use custom TraitTypes that convert '0'->'' and '\\n'->'\n'
387 separate_in = SeparateUnicode('\n', config=True)
386 separate_in = SeparateUnicode('\n', config=True)
388 separate_out = SeparateUnicode('', config=True)
387 separate_out = SeparateUnicode('', config=True)
389 separate_out2 = SeparateUnicode('', config=True)
388 separate_out2 = SeparateUnicode('', config=True)
390 wildcards_case_sensitive = CBool(True, config=True)
389 wildcards_case_sensitive = CBool(True, config=True)
391 xmode = CaselessStrEnum(('Context','Plain', 'Verbose'),
390 xmode = CaselessStrEnum(('Context','Plain', 'Verbose'),
392 default_value='Context', config=True)
391 default_value='Context', config=True)
393
392
394 # Subcomponents of InteractiveShell
393 # Subcomponents of InteractiveShell
395 alias_manager = Instance('IPython.core.alias.AliasManager')
394 alias_manager = Instance('IPython.core.alias.AliasManager')
396 prefilter_manager = Instance('IPython.core.prefilter.PrefilterManager')
395 prefilter_manager = Instance('IPython.core.prefilter.PrefilterManager')
397 builtin_trap = Instance('IPython.core.builtin_trap.BuiltinTrap')
396 builtin_trap = Instance('IPython.core.builtin_trap.BuiltinTrap')
398 display_trap = Instance('IPython.core.display_trap.DisplayTrap')
397 display_trap = Instance('IPython.core.display_trap.DisplayTrap')
399 extension_manager = Instance('IPython.core.extensions.ExtensionManager')
398 extension_manager = Instance('IPython.core.extensions.ExtensionManager')
400 payload_manager = Instance('IPython.core.payload.PayloadManager')
399 payload_manager = Instance('IPython.core.payload.PayloadManager')
401 history_manager = Instance('IPython.core.history.HistoryManager')
400 history_manager = Instance('IPython.core.history.HistoryManager')
402 magics_manager = Instance('IPython.core.magic.MagicsManager')
401 magics_manager = Instance('IPython.core.magic.MagicsManager')
403
402
404 profile_dir = Instance('IPython.core.application.ProfileDir')
403 profile_dir = Instance('IPython.core.application.ProfileDir')
405 @property
404 @property
406 def profile(self):
405 def profile(self):
407 if self.profile_dir is not None:
406 if self.profile_dir is not None:
408 name = os.path.basename(self.profile_dir.location)
407 name = os.path.basename(self.profile_dir.location)
409 return name.replace('profile_','')
408 return name.replace('profile_','')
410
409
411
410
412 # Private interface
411 # Private interface
413 _post_execute = Instance(dict)
412 _post_execute = Instance(dict)
414
413
415 # Tracks any GUI loop loaded for pylab
414 # Tracks any GUI loop loaded for pylab
416 pylab_gui_select = None
415 pylab_gui_select = None
417
416
418 def __init__(self, config=None, ipython_dir=None, profile_dir=None,
417 def __init__(self, config=None, ipython_dir=None, profile_dir=None,
419 user_module=None, user_ns=None,
418 user_module=None, user_ns=None,
420 custom_exceptions=((), None)):
419 custom_exceptions=((), None)):
421
420
422 # This is where traits with a config_key argument are updated
421 # This is where traits with a config_key argument are updated
423 # from the values on config.
422 # from the values on config.
424 super(InteractiveShell, self).__init__(config=config)
423 super(InteractiveShell, self).__init__(config=config)
425 self.configurables = [self]
424 self.configurables = [self]
426
425
427 # These are relatively independent and stateless
426 # These are relatively independent and stateless
428 self.init_ipython_dir(ipython_dir)
427 self.init_ipython_dir(ipython_dir)
429 self.init_profile_dir(profile_dir)
428 self.init_profile_dir(profile_dir)
430 self.init_instance_attrs()
429 self.init_instance_attrs()
431 self.init_environment()
430 self.init_environment()
432
431
433 # Check if we're in a virtualenv, and set up sys.path.
432 # Check if we're in a virtualenv, and set up sys.path.
434 self.init_virtualenv()
433 self.init_virtualenv()
435
434
436 # Create namespaces (user_ns, user_global_ns, etc.)
435 # Create namespaces (user_ns, user_global_ns, etc.)
437 self.init_create_namespaces(user_module, user_ns)
436 self.init_create_namespaces(user_module, user_ns)
438 # This has to be done after init_create_namespaces because it uses
437 # This has to be done after init_create_namespaces because it uses
439 # something in self.user_ns, but before init_sys_modules, which
438 # something in self.user_ns, but before init_sys_modules, which
440 # is the first thing to modify sys.
439 # is the first thing to modify sys.
441 # TODO: When we override sys.stdout and sys.stderr before this class
440 # TODO: When we override sys.stdout and sys.stderr before this class
442 # is created, we are saving the overridden ones here. Not sure if this
441 # is created, we are saving the overridden ones here. Not sure if this
443 # is what we want to do.
442 # is what we want to do.
444 self.save_sys_module_state()
443 self.save_sys_module_state()
445 self.init_sys_modules()
444 self.init_sys_modules()
446
445
447 # While we're trying to have each part of the code directly access what
446 # While we're trying to have each part of the code directly access what
448 # it needs without keeping redundant references to objects, we have too
447 # it needs without keeping redundant references to objects, we have too
449 # much legacy code that expects ip.db to exist.
448 # much legacy code that expects ip.db to exist.
450 self.db = PickleShareDB(os.path.join(self.profile_dir.location, 'db'))
449 self.db = PickleShareDB(os.path.join(self.profile_dir.location, 'db'))
451
450
452 self.init_history()
451 self.init_history()
453 self.init_encoding()
452 self.init_encoding()
454 self.init_prefilter()
453 self.init_prefilter()
455
454
456 self.init_syntax_highlighting()
455 self.init_syntax_highlighting()
457 self.init_hooks()
456 self.init_hooks()
458 self.init_pushd_popd_magic()
457 self.init_pushd_popd_magic()
459 # self.init_traceback_handlers use to be here, but we moved it below
458 # self.init_traceback_handlers use to be here, but we moved it below
460 # because it and init_io have to come after init_readline.
459 # because it and init_io have to come after init_readline.
461 self.init_user_ns()
460 self.init_user_ns()
462 self.init_logger()
461 self.init_logger()
463 self.init_alias()
462 self.init_alias()
464 self.init_builtins()
463 self.init_builtins()
465
464
466 # The following was in post_config_initialization
465 # The following was in post_config_initialization
467 self.init_inspector()
466 self.init_inspector()
468 # init_readline() must come before init_io(), because init_io uses
467 # init_readline() must come before init_io(), because init_io uses
469 # readline related things.
468 # readline related things.
470 self.init_readline()
469 self.init_readline()
471 # We save this here in case user code replaces raw_input, but it needs
470 # We save this here in case user code replaces raw_input, but it needs
472 # to be after init_readline(), because PyPy's readline works by replacing
471 # to be after init_readline(), because PyPy's readline works by replacing
473 # raw_input.
472 # raw_input.
474 if py3compat.PY3:
473 if py3compat.PY3:
475 self.raw_input_original = input
474 self.raw_input_original = input
476 else:
475 else:
477 self.raw_input_original = raw_input
476 self.raw_input_original = raw_input
478 # init_completer must come after init_readline, because it needs to
477 # init_completer must come after init_readline, because it needs to
479 # know whether readline is present or not system-wide to configure the
478 # know whether readline is present or not system-wide to configure the
480 # completers, since the completion machinery can now operate
479 # completers, since the completion machinery can now operate
481 # independently of readline (e.g. over the network)
480 # independently of readline (e.g. over the network)
482 self.init_completer()
481 self.init_completer()
483 # TODO: init_io() needs to happen before init_traceback handlers
482 # TODO: init_io() needs to happen before init_traceback handlers
484 # because the traceback handlers hardcode the stdout/stderr streams.
483 # because the traceback handlers hardcode the stdout/stderr streams.
485 # This logic in in debugger.Pdb and should eventually be changed.
484 # This logic in in debugger.Pdb and should eventually be changed.
486 self.init_io()
485 self.init_io()
487 self.init_traceback_handlers(custom_exceptions)
486 self.init_traceback_handlers(custom_exceptions)
488 self.init_prompts()
487 self.init_prompts()
489 self.init_display_formatter()
488 self.init_display_formatter()
490 self.init_display_pub()
489 self.init_display_pub()
491 self.init_data_pub()
490 self.init_data_pub()
492 self.init_displayhook()
491 self.init_displayhook()
493 self.init_reload_doctest()
492 self.init_reload_doctest()
494 self.init_latextool()
493 self.init_latextool()
495 self.init_magics()
494 self.init_magics()
496 self.init_logstart()
495 self.init_logstart()
497 self.init_pdb()
496 self.init_pdb()
498 self.init_extension_manager()
497 self.init_extension_manager()
499 self.init_payload()
498 self.init_payload()
500 self.hooks.late_startup_hook()
499 self.hooks.late_startup_hook()
501 atexit.register(self.atexit_operations)
500 atexit.register(self.atexit_operations)
502
501
503 def get_ipython(self):
502 def get_ipython(self):
504 """Return the currently running IPython instance."""
503 """Return the currently running IPython instance."""
505 return self
504 return self
506
505
507 #-------------------------------------------------------------------------
506 #-------------------------------------------------------------------------
508 # Trait changed handlers
507 # Trait changed handlers
509 #-------------------------------------------------------------------------
508 #-------------------------------------------------------------------------
510
509
511 def _ipython_dir_changed(self, name, new):
510 def _ipython_dir_changed(self, name, new):
512 if not os.path.isdir(new):
511 if not os.path.isdir(new):
513 os.makedirs(new, mode = 0o777)
512 os.makedirs(new, mode = 0o777)
514
513
515 def set_autoindent(self,value=None):
514 def set_autoindent(self,value=None):
516 """Set the autoindent flag, checking for readline support.
515 """Set the autoindent flag, checking for readline support.
517
516
518 If called with no arguments, it acts as a toggle."""
517 If called with no arguments, it acts as a toggle."""
519
518
520 if value != 0 and not self.has_readline:
519 if value != 0 and not self.has_readline:
521 if os.name == 'posix':
520 if os.name == 'posix':
522 warn("The auto-indent feature requires the readline library")
521 warn("The auto-indent feature requires the readline library")
523 self.autoindent = 0
522 self.autoindent = 0
524 return
523 return
525 if value is None:
524 if value is None:
526 self.autoindent = not self.autoindent
525 self.autoindent = not self.autoindent
527 else:
526 else:
528 self.autoindent = value
527 self.autoindent = value
529
528
530 #-------------------------------------------------------------------------
529 #-------------------------------------------------------------------------
531 # init_* methods called by __init__
530 # init_* methods called by __init__
532 #-------------------------------------------------------------------------
531 #-------------------------------------------------------------------------
533
532
534 def init_ipython_dir(self, ipython_dir):
533 def init_ipython_dir(self, ipython_dir):
535 if ipython_dir is not None:
534 if ipython_dir is not None:
536 self.ipython_dir = ipython_dir
535 self.ipython_dir = ipython_dir
537 return
536 return
538
537
539 self.ipython_dir = get_ipython_dir()
538 self.ipython_dir = get_ipython_dir()
540
539
541 def init_profile_dir(self, profile_dir):
540 def init_profile_dir(self, profile_dir):
542 if profile_dir is not None:
541 if profile_dir is not None:
543 self.profile_dir = profile_dir
542 self.profile_dir = profile_dir
544 return
543 return
545 self.profile_dir =\
544 self.profile_dir =\
546 ProfileDir.create_profile_dir_by_name(self.ipython_dir, 'default')
545 ProfileDir.create_profile_dir_by_name(self.ipython_dir, 'default')
547
546
548 def init_instance_attrs(self):
547 def init_instance_attrs(self):
549 self.more = False
548 self.more = False
550
549
551 # command compiler
550 # command compiler
552 self.compile = CachingCompiler()
551 self.compile = CachingCompiler()
553
552
554 # Make an empty namespace, which extension writers can rely on both
553 # Make an empty namespace, which extension writers can rely on both
555 # existing and NEVER being used by ipython itself. This gives them a
554 # existing and NEVER being used by ipython itself. This gives them a
556 # convenient location for storing additional information and state
555 # convenient location for storing additional information and state
557 # their extensions may require, without fear of collisions with other
556 # their extensions may require, without fear of collisions with other
558 # ipython names that may develop later.
557 # ipython names that may develop later.
559 self.meta = Struct()
558 self.meta = Struct()
560
559
561 # Temporary files used for various purposes. Deleted at exit.
560 # Temporary files used for various purposes. Deleted at exit.
562 self.tempfiles = []
561 self.tempfiles = []
563
562
564 # Keep track of readline usage (later set by init_readline)
563 # Keep track of readline usage (later set by init_readline)
565 self.has_readline = False
564 self.has_readline = False
566
565
567 # keep track of where we started running (mainly for crash post-mortem)
566 # keep track of where we started running (mainly for crash post-mortem)
568 # This is not being used anywhere currently.
567 # This is not being used anywhere currently.
569 self.starting_dir = os.getcwdu()
568 self.starting_dir = os.getcwdu()
570
569
571 # Indentation management
570 # Indentation management
572 self.indent_current_nsp = 0
571 self.indent_current_nsp = 0
573
572
574 # Dict to track post-execution functions that have been registered
573 # Dict to track post-execution functions that have been registered
575 self._post_execute = {}
574 self._post_execute = {}
576
575
577 def init_environment(self):
576 def init_environment(self):
578 """Any changes we need to make to the user's environment."""
577 """Any changes we need to make to the user's environment."""
579 pass
578 pass
580
579
581 def init_encoding(self):
580 def init_encoding(self):
582 # Get system encoding at startup time. Certain terminals (like Emacs
581 # Get system encoding at startup time. Certain terminals (like Emacs
583 # under Win32 have it set to None, and we need to have a known valid
582 # under Win32 have it set to None, and we need to have a known valid
584 # encoding to use in the raw_input() method
583 # encoding to use in the raw_input() method
585 try:
584 try:
586 self.stdin_encoding = sys.stdin.encoding or 'ascii'
585 self.stdin_encoding = sys.stdin.encoding or 'ascii'
587 except AttributeError:
586 except AttributeError:
588 self.stdin_encoding = 'ascii'
587 self.stdin_encoding = 'ascii'
589
588
590 def init_syntax_highlighting(self):
589 def init_syntax_highlighting(self):
591 # Python source parser/formatter for syntax highlighting
590 # Python source parser/formatter for syntax highlighting
592 pyformat = PyColorize.Parser().format
591 pyformat = PyColorize.Parser().format
593 self.pycolorize = lambda src: pyformat(src,'str',self.colors)
592 self.pycolorize = lambda src: pyformat(src,'str',self.colors)
594
593
595 def init_pushd_popd_magic(self):
594 def init_pushd_popd_magic(self):
596 # for pushd/popd management
595 # for pushd/popd management
597 self.home_dir = get_home_dir()
596 self.home_dir = get_home_dir()
598
597
599 self.dir_stack = []
598 self.dir_stack = []
600
599
601 def init_logger(self):
600 def init_logger(self):
602 self.logger = Logger(self.home_dir, logfname='ipython_log.py',
601 self.logger = Logger(self.home_dir, logfname='ipython_log.py',
603 logmode='rotate')
602 logmode='rotate')
604
603
605 def init_logstart(self):
604 def init_logstart(self):
606 """Initialize logging in case it was requested at the command line.
605 """Initialize logging in case it was requested at the command line.
607 """
606 """
608 if self.logappend:
607 if self.logappend:
609 self.magic('logstart %s append' % self.logappend)
608 self.magic('logstart %s append' % self.logappend)
610 elif self.logfile:
609 elif self.logfile:
611 self.magic('logstart %s' % self.logfile)
610 self.magic('logstart %s' % self.logfile)
612 elif self.logstart:
611 elif self.logstart:
613 self.magic('logstart')
612 self.magic('logstart')
614
613
615 def init_builtins(self):
614 def init_builtins(self):
616 # A single, static flag that we set to True. Its presence indicates
615 # 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
616 # 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
617 # removing on exit or representing the existence of more than one
619 # IPython at a time.
618 # IPython at a time.
620 builtin_mod.__dict__['__IPYTHON__'] = True
619 builtin_mod.__dict__['__IPYTHON__'] = True
621
620
622 # In 0.11 we introduced '__IPYTHON__active' as an integer we'd try to
621 # In 0.11 we introduced '__IPYTHON__active' as an integer we'd try to
623 # manage on enter/exit, but with all our shells it's virtually
622 # manage on enter/exit, but with all our shells it's virtually
624 # impossible to get all the cases right. We're leaving the name in for
623 # impossible to get all the cases right. We're leaving the name in for
625 # those who adapted their codes to check for this flag, but will
624 # those who adapted their codes to check for this flag, but will
626 # eventually remove it after a few more releases.
625 # eventually remove it after a few more releases.
627 builtin_mod.__dict__['__IPYTHON__active'] = \
626 builtin_mod.__dict__['__IPYTHON__active'] = \
628 'Deprecated, check for __IPYTHON__'
627 'Deprecated, check for __IPYTHON__'
629
628
630 self.builtin_trap = BuiltinTrap(shell=self)
629 self.builtin_trap = BuiltinTrap(shell=self)
631
630
632 def init_inspector(self):
631 def init_inspector(self):
633 # Object inspector
632 # Object inspector
634 self.inspector = oinspect.Inspector(oinspect.InspectColors,
633 self.inspector = oinspect.Inspector(oinspect.InspectColors,
635 PyColorize.ANSICodeColors,
634 PyColorize.ANSICodeColors,
636 'NoColor',
635 'NoColor',
637 self.object_info_string_level)
636 self.object_info_string_level)
638
637
639 def init_io(self):
638 def init_io(self):
640 # This will just use sys.stdout and sys.stderr. If you want to
639 # This will just use sys.stdout and sys.stderr. If you want to
641 # override sys.stdout and sys.stderr themselves, you need to do that
640 # override sys.stdout and sys.stderr themselves, you need to do that
642 # *before* instantiating this class, because io holds onto
641 # *before* instantiating this class, because io holds onto
643 # references to the underlying streams.
642 # references to the underlying streams.
644 if (sys.platform == 'win32' or sys.platform == 'cli') and self.has_readline:
643 if (sys.platform == 'win32' or sys.platform == 'cli') and self.has_readline:
645 io.stdout = io.stderr = io.IOStream(self.readline._outputfile)
644 io.stdout = io.stderr = io.IOStream(self.readline._outputfile)
646 else:
645 else:
647 io.stdout = io.IOStream(sys.stdout)
646 io.stdout = io.IOStream(sys.stdout)
648 io.stderr = io.IOStream(sys.stderr)
647 io.stderr = io.IOStream(sys.stderr)
649
648
650 def init_prompts(self):
649 def init_prompts(self):
651 self.prompt_manager = PromptManager(shell=self, config=self.config)
650 self.prompt_manager = PromptManager(shell=self, config=self.config)
652 self.configurables.append(self.prompt_manager)
651 self.configurables.append(self.prompt_manager)
653 # Set system prompts, so that scripts can decide if they are running
652 # Set system prompts, so that scripts can decide if they are running
654 # interactively.
653 # interactively.
655 sys.ps1 = 'In : '
654 sys.ps1 = 'In : '
656 sys.ps2 = '...: '
655 sys.ps2 = '...: '
657 sys.ps3 = 'Out: '
656 sys.ps3 = 'Out: '
658
657
659 def init_display_formatter(self):
658 def init_display_formatter(self):
660 self.display_formatter = DisplayFormatter(config=self.config)
659 self.display_formatter = DisplayFormatter(config=self.config)
661 self.configurables.append(self.display_formatter)
660 self.configurables.append(self.display_formatter)
662
661
663 def init_display_pub(self):
662 def init_display_pub(self):
664 self.display_pub = self.display_pub_class(config=self.config)
663 self.display_pub = self.display_pub_class(config=self.config)
665 self.configurables.append(self.display_pub)
664 self.configurables.append(self.display_pub)
666
665
667 def init_data_pub(self):
666 def init_data_pub(self):
668 if not self.data_pub_class:
667 if not self.data_pub_class:
669 self.data_pub = None
668 self.data_pub = None
670 return
669 return
671 self.data_pub = self.data_pub_class(config=self.config)
670 self.data_pub = self.data_pub_class(config=self.config)
672 self.configurables.append(self.data_pub)
671 self.configurables.append(self.data_pub)
673
672
674 def init_displayhook(self):
673 def init_displayhook(self):
675 # Initialize displayhook, set in/out prompts and printing system
674 # Initialize displayhook, set in/out prompts and printing system
676 self.displayhook = self.displayhook_class(
675 self.displayhook = self.displayhook_class(
677 config=self.config,
676 config=self.config,
678 shell=self,
677 shell=self,
679 cache_size=self.cache_size,
678 cache_size=self.cache_size,
680 )
679 )
681 self.configurables.append(self.displayhook)
680 self.configurables.append(self.displayhook)
682 # This is a context manager that installs/revmoes the displayhook at
681 # This is a context manager that installs/revmoes the displayhook at
683 # the appropriate time.
682 # the appropriate time.
684 self.display_trap = DisplayTrap(hook=self.displayhook)
683 self.display_trap = DisplayTrap(hook=self.displayhook)
685
684
686 def init_reload_doctest(self):
685 def init_reload_doctest(self):
687 # Do a proper resetting of doctest, including the necessary displayhook
686 # Do a proper resetting of doctest, including the necessary displayhook
688 # monkeypatching
687 # monkeypatching
689 try:
688 try:
690 doctest_reload()
689 doctest_reload()
691 except ImportError:
690 except ImportError:
692 warn("doctest module does not exist.")
691 warn("doctest module does not exist.")
693
692
694 def init_latextool(self):
693 def init_latextool(self):
695 """Configure LaTeXTool."""
694 """Configure LaTeXTool."""
696 cfg = LaTeXTool.instance(config=self.config)
695 cfg = LaTeXTool.instance(config=self.config)
697 if cfg not in self.configurables:
696 if cfg not in self.configurables:
698 self.configurables.append(cfg)
697 self.configurables.append(cfg)
699
698
700 def init_virtualenv(self):
699 def init_virtualenv(self):
701 """Add a virtualenv to sys.path so the user can import modules from it.
700 """Add a virtualenv to sys.path so the user can import modules from it.
702 This isn't perfect: it doesn't use the Python interpreter with which the
701 This isn't perfect: it doesn't use the Python interpreter with which the
703 virtualenv was built, and it ignores the --no-site-packages option. A
702 virtualenv was built, and it ignores the --no-site-packages option. A
704 warning will appear suggesting the user installs IPython in the
703 warning will appear suggesting the user installs IPython in the
705 virtualenv, but for many cases, it probably works well enough.
704 virtualenv, but for many cases, it probably works well enough.
706
705
707 Adapted from code snippets online.
706 Adapted from code snippets online.
708
707
709 http://blog.ufsoft.org/2009/1/29/ipython-and-virtualenv
708 http://blog.ufsoft.org/2009/1/29/ipython-and-virtualenv
710 """
709 """
711 if 'VIRTUAL_ENV' not in os.environ:
710 if 'VIRTUAL_ENV' not in os.environ:
712 # Not in a virtualenv
711 # Not in a virtualenv
713 return
712 return
714
713
715 if sys.executable.startswith(os.environ['VIRTUAL_ENV']):
714 if sys.executable.startswith(os.environ['VIRTUAL_ENV']):
716 # Running properly in the virtualenv, don't need to do anything
715 # Running properly in the virtualenv, don't need to do anything
717 return
716 return
718
717
719 warn("Attempting to work in a virtualenv. If you encounter problems, please "
718 warn("Attempting to work in a virtualenv. If you encounter problems, please "
720 "install IPython inside the virtualenv.")
719 "install IPython inside the virtualenv.")
721 if sys.platform == "win32":
720 if sys.platform == "win32":
722 virtual_env = os.path.join(os.environ['VIRTUAL_ENV'], 'Lib', 'site-packages')
721 virtual_env = os.path.join(os.environ['VIRTUAL_ENV'], 'Lib', 'site-packages')
723 else:
722 else:
724 virtual_env = os.path.join(os.environ['VIRTUAL_ENV'], 'lib',
723 virtual_env = os.path.join(os.environ['VIRTUAL_ENV'], 'lib',
725 'python%d.%d' % sys.version_info[:2], 'site-packages')
724 'python%d.%d' % sys.version_info[:2], 'site-packages')
726
725
727 import site
726 import site
728 sys.path.insert(0, virtual_env)
727 sys.path.insert(0, virtual_env)
729 site.addsitedir(virtual_env)
728 site.addsitedir(virtual_env)
730
729
731 #-------------------------------------------------------------------------
730 #-------------------------------------------------------------------------
732 # Things related to injections into the sys module
731 # Things related to injections into the sys module
733 #-------------------------------------------------------------------------
732 #-------------------------------------------------------------------------
734
733
735 def save_sys_module_state(self):
734 def save_sys_module_state(self):
736 """Save the state of hooks in the sys module.
735 """Save the state of hooks in the sys module.
737
736
738 This has to be called after self.user_module is created.
737 This has to be called after self.user_module is created.
739 """
738 """
740 self._orig_sys_module_state = {}
739 self._orig_sys_module_state = {}
741 self._orig_sys_module_state['stdin'] = sys.stdin
740 self._orig_sys_module_state['stdin'] = sys.stdin
742 self._orig_sys_module_state['stdout'] = sys.stdout
741 self._orig_sys_module_state['stdout'] = sys.stdout
743 self._orig_sys_module_state['stderr'] = sys.stderr
742 self._orig_sys_module_state['stderr'] = sys.stderr
744 self._orig_sys_module_state['excepthook'] = sys.excepthook
743 self._orig_sys_module_state['excepthook'] = sys.excepthook
745 self._orig_sys_modules_main_name = self.user_module.__name__
744 self._orig_sys_modules_main_name = self.user_module.__name__
746 self._orig_sys_modules_main_mod = sys.modules.get(self.user_module.__name__)
745 self._orig_sys_modules_main_mod = sys.modules.get(self.user_module.__name__)
747
746
748 def restore_sys_module_state(self):
747 def restore_sys_module_state(self):
749 """Restore the state of the sys module."""
748 """Restore the state of the sys module."""
750 try:
749 try:
751 for k, v in self._orig_sys_module_state.iteritems():
750 for k, v in self._orig_sys_module_state.iteritems():
752 setattr(sys, k, v)
751 setattr(sys, k, v)
753 except AttributeError:
752 except AttributeError:
754 pass
753 pass
755 # Reset what what done in self.init_sys_modules
754 # Reset what what done in self.init_sys_modules
756 if self._orig_sys_modules_main_mod is not None:
755 if self._orig_sys_modules_main_mod is not None:
757 sys.modules[self._orig_sys_modules_main_name] = self._orig_sys_modules_main_mod
756 sys.modules[self._orig_sys_modules_main_name] = self._orig_sys_modules_main_mod
758
757
759 #-------------------------------------------------------------------------
758 #-------------------------------------------------------------------------
760 # Things related to hooks
759 # Things related to hooks
761 #-------------------------------------------------------------------------
760 #-------------------------------------------------------------------------
762
761
763 def init_hooks(self):
762 def init_hooks(self):
764 # hooks holds pointers used for user-side customizations
763 # hooks holds pointers used for user-side customizations
765 self.hooks = Struct()
764 self.hooks = Struct()
766
765
767 self.strdispatchers = {}
766 self.strdispatchers = {}
768
767
769 # Set all default hooks, defined in the IPython.hooks module.
768 # Set all default hooks, defined in the IPython.hooks module.
770 hooks = IPython.core.hooks
769 hooks = IPython.core.hooks
771 for hook_name in hooks.__all__:
770 for hook_name in hooks.__all__:
772 # default hooks have priority 100, i.e. low; user hooks should have
771 # default hooks have priority 100, i.e. low; user hooks should have
773 # 0-100 priority
772 # 0-100 priority
774 self.set_hook(hook_name,getattr(hooks,hook_name), 100)
773 self.set_hook(hook_name,getattr(hooks,hook_name), 100)
775
774
776 def set_hook(self,name,hook, priority = 50, str_key = None, re_key = None):
775 def set_hook(self,name,hook, priority = 50, str_key = None, re_key = None):
777 """set_hook(name,hook) -> sets an internal IPython hook.
776 """set_hook(name,hook) -> sets an internal IPython hook.
778
777
779 IPython exposes some of its internal API as user-modifiable hooks. By
778 IPython exposes some of its internal API as user-modifiable hooks. By
780 adding your function to one of these hooks, you can modify IPython's
779 adding your function to one of these hooks, you can modify IPython's
781 behavior to call at runtime your own routines."""
780 behavior to call at runtime your own routines."""
782
781
783 # At some point in the future, this should validate the hook before it
782 # At some point in the future, this should validate the hook before it
784 # accepts it. Probably at least check that the hook takes the number
783 # accepts it. Probably at least check that the hook takes the number
785 # of args it's supposed to.
784 # of args it's supposed to.
786
785
787 f = types.MethodType(hook,self)
786 f = types.MethodType(hook,self)
788
787
789 # check if the hook is for strdispatcher first
788 # check if the hook is for strdispatcher first
790 if str_key is not None:
789 if str_key is not None:
791 sdp = self.strdispatchers.get(name, StrDispatch())
790 sdp = self.strdispatchers.get(name, StrDispatch())
792 sdp.add_s(str_key, f, priority )
791 sdp.add_s(str_key, f, priority )
793 self.strdispatchers[name] = sdp
792 self.strdispatchers[name] = sdp
794 return
793 return
795 if re_key is not None:
794 if re_key is not None:
796 sdp = self.strdispatchers.get(name, StrDispatch())
795 sdp = self.strdispatchers.get(name, StrDispatch())
797 sdp.add_re(re.compile(re_key), f, priority )
796 sdp.add_re(re.compile(re_key), f, priority )
798 self.strdispatchers[name] = sdp
797 self.strdispatchers[name] = sdp
799 return
798 return
800
799
801 dp = getattr(self.hooks, name, None)
800 dp = getattr(self.hooks, name, None)
802 if name not in IPython.core.hooks.__all__:
801 if name not in IPython.core.hooks.__all__:
803 print("Warning! Hook '%s' is not one of %s" % \
802 print("Warning! Hook '%s' is not one of %s" % \
804 (name, IPython.core.hooks.__all__ ))
803 (name, IPython.core.hooks.__all__ ))
805 if not dp:
804 if not dp:
806 dp = IPython.core.hooks.CommandChainDispatcher()
805 dp = IPython.core.hooks.CommandChainDispatcher()
807
806
808 try:
807 try:
809 dp.add(f,priority)
808 dp.add(f,priority)
810 except AttributeError:
809 except AttributeError:
811 # it was not commandchain, plain old func - replace
810 # it was not commandchain, plain old func - replace
812 dp = f
811 dp = f
813
812
814 setattr(self.hooks,name, dp)
813 setattr(self.hooks,name, dp)
815
814
816 def register_post_execute(self, func):
815 def register_post_execute(self, func):
817 """Register a function for calling after code execution.
816 """Register a function for calling after code execution.
818 """
817 """
819 if not callable(func):
818 if not callable(func):
820 raise ValueError('argument %s must be callable' % func)
819 raise ValueError('argument %s must be callable' % func)
821 self._post_execute[func] = True
820 self._post_execute[func] = True
822
821
823 #-------------------------------------------------------------------------
822 #-------------------------------------------------------------------------
824 # Things related to the "main" module
823 # Things related to the "main" module
825 #-------------------------------------------------------------------------
824 #-------------------------------------------------------------------------
826
825
827 def new_main_mod(self,ns=None):
826 def new_main_mod(self,ns=None):
828 """Return a new 'main' module object for user code execution.
827 """Return a new 'main' module object for user code execution.
829 """
828 """
830 main_mod = self._user_main_module
829 main_mod = self._user_main_module
831 init_fakemod_dict(main_mod,ns)
830 init_fakemod_dict(main_mod,ns)
832 return main_mod
831 return main_mod
833
832
834 def cache_main_mod(self,ns,fname):
833 def cache_main_mod(self,ns,fname):
835 """Cache a main module's namespace.
834 """Cache a main module's namespace.
836
835
837 When scripts are executed via %run, we must keep a reference to the
836 When scripts are executed via %run, we must keep a reference to the
838 namespace of their __main__ module (a FakeModule instance) around so
837 namespace of their __main__ module (a FakeModule instance) around so
839 that Python doesn't clear it, rendering objects defined therein
838 that Python doesn't clear it, rendering objects defined therein
840 useless.
839 useless.
841
840
842 This method keeps said reference in a private dict, keyed by the
841 This method keeps said reference in a private dict, keyed by the
843 absolute path of the module object (which corresponds to the script
842 absolute path of the module object (which corresponds to the script
844 path). This way, for multiple executions of the same script we only
843 path). This way, for multiple executions of the same script we only
845 keep one copy of the namespace (the last one), thus preventing memory
844 keep one copy of the namespace (the last one), thus preventing memory
846 leaks from old references while allowing the objects from the last
845 leaks from old references while allowing the objects from the last
847 execution to be accessible.
846 execution to be accessible.
848
847
849 Note: we can not allow the actual FakeModule instances to be deleted,
848 Note: we can not allow the actual FakeModule instances to be deleted,
850 because of how Python tears down modules (it hard-sets all their
849 because of how Python tears down modules (it hard-sets all their
851 references to None without regard for reference counts). This method
850 references to None without regard for reference counts). This method
852 must therefore make a *copy* of the given namespace, to allow the
851 must therefore make a *copy* of the given namespace, to allow the
853 original module's __dict__ to be cleared and reused.
852 original module's __dict__ to be cleared and reused.
854
853
855
854
856 Parameters
855 Parameters
857 ----------
856 ----------
858 ns : a namespace (a dict, typically)
857 ns : a namespace (a dict, typically)
859
858
860 fname : str
859 fname : str
861 Filename associated with the namespace.
860 Filename associated with the namespace.
862
861
863 Examples
862 Examples
864 --------
863 --------
865
864
866 In [10]: import IPython
865 In [10]: import IPython
867
866
868 In [11]: _ip.cache_main_mod(IPython.__dict__,IPython.__file__)
867 In [11]: _ip.cache_main_mod(IPython.__dict__,IPython.__file__)
869
868
870 In [12]: IPython.__file__ in _ip._main_ns_cache
869 In [12]: IPython.__file__ in _ip._main_ns_cache
871 Out[12]: True
870 Out[12]: True
872 """
871 """
873 self._main_ns_cache[os.path.abspath(fname)] = ns.copy()
872 self._main_ns_cache[os.path.abspath(fname)] = ns.copy()
874
873
875 def clear_main_mod_cache(self):
874 def clear_main_mod_cache(self):
876 """Clear the cache of main modules.
875 """Clear the cache of main modules.
877
876
878 Mainly for use by utilities like %reset.
877 Mainly for use by utilities like %reset.
879
878
880 Examples
879 Examples
881 --------
880 --------
882
881
883 In [15]: import IPython
882 In [15]: import IPython
884
883
885 In [16]: _ip.cache_main_mod(IPython.__dict__,IPython.__file__)
884 In [16]: _ip.cache_main_mod(IPython.__dict__,IPython.__file__)
886
885
887 In [17]: len(_ip._main_ns_cache) > 0
886 In [17]: len(_ip._main_ns_cache) > 0
888 Out[17]: True
887 Out[17]: True
889
888
890 In [18]: _ip.clear_main_mod_cache()
889 In [18]: _ip.clear_main_mod_cache()
891
890
892 In [19]: len(_ip._main_ns_cache) == 0
891 In [19]: len(_ip._main_ns_cache) == 0
893 Out[19]: True
892 Out[19]: True
894 """
893 """
895 self._main_ns_cache.clear()
894 self._main_ns_cache.clear()
896
895
897 #-------------------------------------------------------------------------
896 #-------------------------------------------------------------------------
898 # Things related to debugging
897 # Things related to debugging
899 #-------------------------------------------------------------------------
898 #-------------------------------------------------------------------------
900
899
901 def init_pdb(self):
900 def init_pdb(self):
902 # Set calling of pdb on exceptions
901 # Set calling of pdb on exceptions
903 # self.call_pdb is a property
902 # self.call_pdb is a property
904 self.call_pdb = self.pdb
903 self.call_pdb = self.pdb
905
904
906 def _get_call_pdb(self):
905 def _get_call_pdb(self):
907 return self._call_pdb
906 return self._call_pdb
908
907
909 def _set_call_pdb(self,val):
908 def _set_call_pdb(self,val):
910
909
911 if val not in (0,1,False,True):
910 if val not in (0,1,False,True):
912 raise ValueError('new call_pdb value must be boolean')
911 raise ValueError('new call_pdb value must be boolean')
913
912
914 # store value in instance
913 # store value in instance
915 self._call_pdb = val
914 self._call_pdb = val
916
915
917 # notify the actual exception handlers
916 # notify the actual exception handlers
918 self.InteractiveTB.call_pdb = val
917 self.InteractiveTB.call_pdb = val
919
918
920 call_pdb = property(_get_call_pdb,_set_call_pdb,None,
919 call_pdb = property(_get_call_pdb,_set_call_pdb,None,
921 'Control auto-activation of pdb at exceptions')
920 'Control auto-activation of pdb at exceptions')
922
921
923 def debugger(self,force=False):
922 def debugger(self,force=False):
924 """Call the pydb/pdb debugger.
923 """Call the pydb/pdb debugger.
925
924
926 Keywords:
925 Keywords:
927
926
928 - force(False): by default, this routine checks the instance call_pdb
927 - force(False): by default, this routine checks the instance call_pdb
929 flag and does not actually invoke the debugger if the flag is false.
928 flag and does not actually invoke the debugger if the flag is false.
930 The 'force' option forces the debugger to activate even if the flag
929 The 'force' option forces the debugger to activate even if the flag
931 is false.
930 is false.
932 """
931 """
933
932
934 if not (force or self.call_pdb):
933 if not (force or self.call_pdb):
935 return
934 return
936
935
937 if not hasattr(sys,'last_traceback'):
936 if not hasattr(sys,'last_traceback'):
938 error('No traceback has been produced, nothing to debug.')
937 error('No traceback has been produced, nothing to debug.')
939 return
938 return
940
939
941 # use pydb if available
940 # use pydb if available
942 if debugger.has_pydb:
941 if debugger.has_pydb:
943 from pydb import pm
942 from pydb import pm
944 else:
943 else:
945 # fallback to our internal debugger
944 # fallback to our internal debugger
946 pm = lambda : self.InteractiveTB.debugger(force=True)
945 pm = lambda : self.InteractiveTB.debugger(force=True)
947
946
948 with self.readline_no_record:
947 with self.readline_no_record:
949 pm()
948 pm()
950
949
951 #-------------------------------------------------------------------------
950 #-------------------------------------------------------------------------
952 # Things related to IPython's various namespaces
951 # Things related to IPython's various namespaces
953 #-------------------------------------------------------------------------
952 #-------------------------------------------------------------------------
954 default_user_namespaces = True
953 default_user_namespaces = True
955
954
956 def init_create_namespaces(self, user_module=None, user_ns=None):
955 def init_create_namespaces(self, user_module=None, user_ns=None):
957 # Create the namespace where the user will operate. user_ns is
956 # Create the namespace where the user will operate. user_ns is
958 # normally the only one used, and it is passed to the exec calls as
957 # normally the only one used, and it is passed to the exec calls as
959 # the locals argument. But we do carry a user_global_ns namespace
958 # the locals argument. But we do carry a user_global_ns namespace
960 # given as the exec 'globals' argument, This is useful in embedding
959 # given as the exec 'globals' argument, This is useful in embedding
961 # situations where the ipython shell opens in a context where the
960 # situations where the ipython shell opens in a context where the
962 # distinction between locals and globals is meaningful. For
961 # distinction between locals and globals is meaningful. For
963 # non-embedded contexts, it is just the same object as the user_ns dict.
962 # non-embedded contexts, it is just the same object as the user_ns dict.
964
963
965 # FIXME. For some strange reason, __builtins__ is showing up at user
964 # FIXME. For some strange reason, __builtins__ is showing up at user
966 # level as a dict instead of a module. This is a manual fix, but I
965 # level as a dict instead of a module. This is a manual fix, but I
967 # should really track down where the problem is coming from. Alex
966 # should really track down where the problem is coming from. Alex
968 # Schmolck reported this problem first.
967 # Schmolck reported this problem first.
969
968
970 # A useful post by Alex Martelli on this topic:
969 # A useful post by Alex Martelli on this topic:
971 # Re: inconsistent value from __builtins__
970 # Re: inconsistent value from __builtins__
972 # Von: Alex Martelli <aleaxit@yahoo.com>
971 # Von: Alex Martelli <aleaxit@yahoo.com>
973 # Datum: Freitag 01 Oktober 2004 04:45:34 nachmittags/abends
972 # Datum: Freitag 01 Oktober 2004 04:45:34 nachmittags/abends
974 # Gruppen: comp.lang.python
973 # Gruppen: comp.lang.python
975
974
976 # Michael Hohn <hohn@hooknose.lbl.gov> wrote:
975 # Michael Hohn <hohn@hooknose.lbl.gov> wrote:
977 # > >>> print type(builtin_check.get_global_binding('__builtins__'))
976 # > >>> print type(builtin_check.get_global_binding('__builtins__'))
978 # > <type 'dict'>
977 # > <type 'dict'>
979 # > >>> print type(__builtins__)
978 # > >>> print type(__builtins__)
980 # > <type 'module'>
979 # > <type 'module'>
981 # > Is this difference in return value intentional?
980 # > Is this difference in return value intentional?
982
981
983 # Well, it's documented that '__builtins__' can be either a dictionary
982 # Well, it's documented that '__builtins__' can be either a dictionary
984 # or a module, and it's been that way for a long time. Whether it's
983 # or a module, and it's been that way for a long time. Whether it's
985 # intentional (or sensible), I don't know. In any case, the idea is
984 # intentional (or sensible), I don't know. In any case, the idea is
986 # that if you need to access the built-in namespace directly, you
985 # that if you need to access the built-in namespace directly, you
987 # should start with "import __builtin__" (note, no 's') which will
986 # should start with "import __builtin__" (note, no 's') which will
988 # definitely give you a module. Yeah, it's somewhat confusing:-(.
987 # definitely give you a module. Yeah, it's somewhat confusing:-(.
989
988
990 # These routines return a properly built module and dict as needed by
989 # These routines return a properly built module and dict as needed by
991 # the rest of the code, and can also be used by extension writers to
990 # the rest of the code, and can also be used by extension writers to
992 # generate properly initialized namespaces.
991 # generate properly initialized namespaces.
993 if (user_ns is not None) or (user_module is not None):
992 if (user_ns is not None) or (user_module is not None):
994 self.default_user_namespaces = False
993 self.default_user_namespaces = False
995 self.user_module, self.user_ns = self.prepare_user_module(user_module, user_ns)
994 self.user_module, self.user_ns = self.prepare_user_module(user_module, user_ns)
996
995
997 # A record of hidden variables we have added to the user namespace, so
996 # A record of hidden variables we have added to the user namespace, so
998 # we can list later only variables defined in actual interactive use.
997 # we can list later only variables defined in actual interactive use.
999 self.user_ns_hidden = set()
998 self.user_ns_hidden = set()
1000
999
1001 # Now that FakeModule produces a real module, we've run into a nasty
1000 # Now that FakeModule produces a real module, we've run into a nasty
1002 # problem: after script execution (via %run), the module where the user
1001 # problem: after script execution (via %run), the module where the user
1003 # code ran is deleted. Now that this object is a true module (needed
1002 # code ran is deleted. Now that this object is a true module (needed
1004 # so docetst and other tools work correctly), the Python module
1003 # so docetst and other tools work correctly), the Python module
1005 # teardown mechanism runs over it, and sets to None every variable
1004 # teardown mechanism runs over it, and sets to None every variable
1006 # present in that module. Top-level references to objects from the
1005 # present in that module. Top-level references to objects from the
1007 # script survive, because the user_ns is updated with them. However,
1006 # script survive, because the user_ns is updated with them. However,
1008 # calling functions defined in the script that use other things from
1007 # calling functions defined in the script that use other things from
1009 # the script will fail, because the function's closure had references
1008 # the script will fail, because the function's closure had references
1010 # to the original objects, which are now all None. So we must protect
1009 # to the original objects, which are now all None. So we must protect
1011 # these modules from deletion by keeping a cache.
1010 # these modules from deletion by keeping a cache.
1012 #
1011 #
1013 # To avoid keeping stale modules around (we only need the one from the
1012 # To avoid keeping stale modules around (we only need the one from the
1014 # last run), we use a dict keyed with the full path to the script, so
1013 # last run), we use a dict keyed with the full path to the script, so
1015 # only the last version of the module is held in the cache. Note,
1014 # only the last version of the module is held in the cache. Note,
1016 # however, that we must cache the module *namespace contents* (their
1015 # however, that we must cache the module *namespace contents* (their
1017 # __dict__). Because if we try to cache the actual modules, old ones
1016 # __dict__). Because if we try to cache the actual modules, old ones
1018 # (uncached) could be destroyed while still holding references (such as
1017 # (uncached) could be destroyed while still holding references (such as
1019 # those held by GUI objects that tend to be long-lived)>
1018 # those held by GUI objects that tend to be long-lived)>
1020 #
1019 #
1021 # The %reset command will flush this cache. See the cache_main_mod()
1020 # The %reset command will flush this cache. See the cache_main_mod()
1022 # and clear_main_mod_cache() methods for details on use.
1021 # and clear_main_mod_cache() methods for details on use.
1023
1022
1024 # This is the cache used for 'main' namespaces
1023 # This is the cache used for 'main' namespaces
1025 self._main_ns_cache = {}
1024 self._main_ns_cache = {}
1026 # And this is the single instance of FakeModule whose __dict__ we keep
1025 # And this is the single instance of FakeModule whose __dict__ we keep
1027 # copying and clearing for reuse on each %run
1026 # copying and clearing for reuse on each %run
1028 self._user_main_module = FakeModule()
1027 self._user_main_module = FakeModule()
1029
1028
1030 # A table holding all the namespaces IPython deals with, so that
1029 # A table holding all the namespaces IPython deals with, so that
1031 # introspection facilities can search easily.
1030 # introspection facilities can search easily.
1032 self.ns_table = {'user_global':self.user_module.__dict__,
1031 self.ns_table = {'user_global':self.user_module.__dict__,
1033 'user_local':self.user_ns,
1032 'user_local':self.user_ns,
1034 'builtin':builtin_mod.__dict__
1033 'builtin':builtin_mod.__dict__
1035 }
1034 }
1036
1035
1037 @property
1036 @property
1038 def user_global_ns(self):
1037 def user_global_ns(self):
1039 return self.user_module.__dict__
1038 return self.user_module.__dict__
1040
1039
1041 def prepare_user_module(self, user_module=None, user_ns=None):
1040 def prepare_user_module(self, user_module=None, user_ns=None):
1042 """Prepare the module and namespace in which user code will be run.
1041 """Prepare the module and namespace in which user code will be run.
1043
1042
1044 When IPython is started normally, both parameters are None: a new module
1043 When IPython is started normally, both parameters are None: a new module
1045 is created automatically, and its __dict__ used as the namespace.
1044 is created automatically, and its __dict__ used as the namespace.
1046
1045
1047 If only user_module is provided, its __dict__ is used as the namespace.
1046 If only user_module is provided, its __dict__ is used as the namespace.
1048 If only user_ns is provided, a dummy module is created, and user_ns
1047 If only user_ns is provided, a dummy module is created, and user_ns
1049 becomes the global namespace. If both are provided (as they may be
1048 becomes the global namespace. If both are provided (as they may be
1050 when embedding), user_ns is the local namespace, and user_module
1049 when embedding), user_ns is the local namespace, and user_module
1051 provides the global namespace.
1050 provides the global namespace.
1052
1051
1053 Parameters
1052 Parameters
1054 ----------
1053 ----------
1055 user_module : module, optional
1054 user_module : module, optional
1056 The current user module in which IPython is being run. If None,
1055 The current user module in which IPython is being run. If None,
1057 a clean module will be created.
1056 a clean module will be created.
1058 user_ns : dict, optional
1057 user_ns : dict, optional
1059 A namespace in which to run interactive commands.
1058 A namespace in which to run interactive commands.
1060
1059
1061 Returns
1060 Returns
1062 -------
1061 -------
1063 A tuple of user_module and user_ns, each properly initialised.
1062 A tuple of user_module and user_ns, each properly initialised.
1064 """
1063 """
1065 if user_module is None and user_ns is not None:
1064 if user_module is None and user_ns is not None:
1066 user_ns.setdefault("__name__", "__main__")
1065 user_ns.setdefault("__name__", "__main__")
1067 class DummyMod(object):
1066 class DummyMod(object):
1068 "A dummy module used for IPython's interactive namespace."
1067 "A dummy module used for IPython's interactive namespace."
1069 pass
1068 pass
1070 user_module = DummyMod()
1069 user_module = DummyMod()
1071 user_module.__dict__ = user_ns
1070 user_module.__dict__ = user_ns
1072
1071
1073 if user_module is None:
1072 if user_module is None:
1074 user_module = types.ModuleType("__main__",
1073 user_module = types.ModuleType("__main__",
1075 doc="Automatically created module for IPython interactive environment")
1074 doc="Automatically created module for IPython interactive environment")
1076
1075
1077 # We must ensure that __builtin__ (without the final 's') is always
1076 # We must ensure that __builtin__ (without the final 's') is always
1078 # available and pointing to the __builtin__ *module*. For more details:
1077 # available and pointing to the __builtin__ *module*. For more details:
1079 # http://mail.python.org/pipermail/python-dev/2001-April/014068.html
1078 # http://mail.python.org/pipermail/python-dev/2001-April/014068.html
1080 user_module.__dict__.setdefault('__builtin__', builtin_mod)
1079 user_module.__dict__.setdefault('__builtin__', builtin_mod)
1081 user_module.__dict__.setdefault('__builtins__', builtin_mod)
1080 user_module.__dict__.setdefault('__builtins__', builtin_mod)
1082
1081
1083 if user_ns is None:
1082 if user_ns is None:
1084 user_ns = user_module.__dict__
1083 user_ns = user_module.__dict__
1085
1084
1086 return user_module, user_ns
1085 return user_module, user_ns
1087
1086
1088 def init_sys_modules(self):
1087 def init_sys_modules(self):
1089 # We need to insert into sys.modules something that looks like a
1088 # We need to insert into sys.modules something that looks like a
1090 # module but which accesses the IPython namespace, for shelve and
1089 # module but which accesses the IPython namespace, for shelve and
1091 # pickle to work interactively. Normally they rely on getting
1090 # pickle to work interactively. Normally they rely on getting
1092 # everything out of __main__, but for embedding purposes each IPython
1091 # everything out of __main__, but for embedding purposes each IPython
1093 # instance has its own private namespace, so we can't go shoving
1092 # instance has its own private namespace, so we can't go shoving
1094 # everything into __main__.
1093 # everything into __main__.
1095
1094
1096 # note, however, that we should only do this for non-embedded
1095 # note, however, that we should only do this for non-embedded
1097 # ipythons, which really mimic the __main__.__dict__ with their own
1096 # ipythons, which really mimic the __main__.__dict__ with their own
1098 # namespace. Embedded instances, on the other hand, should not do
1097 # namespace. Embedded instances, on the other hand, should not do
1099 # this because they need to manage the user local/global namespaces
1098 # this because they need to manage the user local/global namespaces
1100 # only, but they live within a 'normal' __main__ (meaning, they
1099 # only, but they live within a 'normal' __main__ (meaning, they
1101 # shouldn't overtake the execution environment of the script they're
1100 # shouldn't overtake the execution environment of the script they're
1102 # embedded in).
1101 # embedded in).
1103
1102
1104 # This is overridden in the InteractiveShellEmbed subclass to a no-op.
1103 # This is overridden in the InteractiveShellEmbed subclass to a no-op.
1105 main_name = self.user_module.__name__
1104 main_name = self.user_module.__name__
1106 sys.modules[main_name] = self.user_module
1105 sys.modules[main_name] = self.user_module
1107
1106
1108 def init_user_ns(self):
1107 def init_user_ns(self):
1109 """Initialize all user-visible namespaces to their minimum defaults.
1108 """Initialize all user-visible namespaces to their minimum defaults.
1110
1109
1111 Certain history lists are also initialized here, as they effectively
1110 Certain history lists are also initialized here, as they effectively
1112 act as user namespaces.
1111 act as user namespaces.
1113
1112
1114 Notes
1113 Notes
1115 -----
1114 -----
1116 All data structures here are only filled in, they are NOT reset by this
1115 All data structures here are only filled in, they are NOT reset by this
1117 method. If they were not empty before, data will simply be added to
1116 method. If they were not empty before, data will simply be added to
1118 therm.
1117 therm.
1119 """
1118 """
1120 # This function works in two parts: first we put a few things in
1119 # This function works in two parts: first we put a few things in
1121 # user_ns, and we sync that contents into user_ns_hidden so that these
1120 # user_ns, and we sync that contents into user_ns_hidden so that these
1122 # initial variables aren't shown by %who. After the sync, we add the
1121 # initial variables aren't shown by %who. After the sync, we add the
1123 # rest of what we *do* want the user to see with %who even on a new
1122 # rest of what we *do* want the user to see with %who even on a new
1124 # session (probably nothing, so theye really only see their own stuff)
1123 # session (probably nothing, so theye really only see their own stuff)
1125
1124
1126 # The user dict must *always* have a __builtin__ reference to the
1125 # The user dict must *always* have a __builtin__ reference to the
1127 # Python standard __builtin__ namespace, which must be imported.
1126 # Python standard __builtin__ namespace, which must be imported.
1128 # This is so that certain operations in prompt evaluation can be
1127 # This is so that certain operations in prompt evaluation can be
1129 # reliably executed with builtins. Note that we can NOT use
1128 # reliably executed with builtins. Note that we can NOT use
1130 # __builtins__ (note the 's'), because that can either be a dict or a
1129 # __builtins__ (note the 's'), because that can either be a dict or a
1131 # module, and can even mutate at runtime, depending on the context
1130 # module, and can even mutate at runtime, depending on the context
1132 # (Python makes no guarantees on it). In contrast, __builtin__ is
1131 # (Python makes no guarantees on it). In contrast, __builtin__ is
1133 # always a module object, though it must be explicitly imported.
1132 # always a module object, though it must be explicitly imported.
1134
1133
1135 # For more details:
1134 # For more details:
1136 # http://mail.python.org/pipermail/python-dev/2001-April/014068.html
1135 # http://mail.python.org/pipermail/python-dev/2001-April/014068.html
1137 ns = dict()
1136 ns = dict()
1138
1137
1139 # Put 'help' in the user namespace
1138 # Put 'help' in the user namespace
1140 try:
1139 try:
1141 from site import _Helper
1140 from site import _Helper
1142 ns['help'] = _Helper()
1141 ns['help'] = _Helper()
1143 except ImportError:
1142 except ImportError:
1144 warn('help() not available - check site.py')
1143 warn('help() not available - check site.py')
1145
1144
1146 # make global variables for user access to the histories
1145 # make global variables for user access to the histories
1147 ns['_ih'] = self.history_manager.input_hist_parsed
1146 ns['_ih'] = self.history_manager.input_hist_parsed
1148 ns['_oh'] = self.history_manager.output_hist
1147 ns['_oh'] = self.history_manager.output_hist
1149 ns['_dh'] = self.history_manager.dir_hist
1148 ns['_dh'] = self.history_manager.dir_hist
1150
1149
1151 ns['_sh'] = shadowns
1150 ns['_sh'] = shadowns
1152
1151
1153 # user aliases to input and output histories. These shouldn't show up
1152 # user aliases to input and output histories. These shouldn't show up
1154 # in %who, as they can have very large reprs.
1153 # in %who, as they can have very large reprs.
1155 ns['In'] = self.history_manager.input_hist_parsed
1154 ns['In'] = self.history_manager.input_hist_parsed
1156 ns['Out'] = self.history_manager.output_hist
1155 ns['Out'] = self.history_manager.output_hist
1157
1156
1158 # Store myself as the public api!!!
1157 # Store myself as the public api!!!
1159 ns['get_ipython'] = self.get_ipython
1158 ns['get_ipython'] = self.get_ipython
1160
1159
1161 ns['exit'] = self.exiter
1160 ns['exit'] = self.exiter
1162 ns['quit'] = self.exiter
1161 ns['quit'] = self.exiter
1163
1162
1164 # Sync what we've added so far to user_ns_hidden so these aren't seen
1163 # Sync what we've added so far to user_ns_hidden so these aren't seen
1165 # by %who
1164 # by %who
1166 self.user_ns_hidden.update(ns)
1165 self.user_ns_hidden.update(ns)
1167
1166
1168 # Anything put into ns now would show up in %who. Think twice before
1167 # 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
1168 # putting anything here, as we really want %who to show the user their
1170 # stuff, not our variables.
1169 # stuff, not our variables.
1171
1170
1172 # Finally, update the real user's namespace
1171 # Finally, update the real user's namespace
1173 self.user_ns.update(ns)
1172 self.user_ns.update(ns)
1174
1173
1175 @property
1174 @property
1176 def all_ns_refs(self):
1175 def all_ns_refs(self):
1177 """Get a list of references to all the namespace dictionaries in which
1176 """Get a list of references to all the namespace dictionaries in which
1178 IPython might store a user-created object.
1177 IPython might store a user-created object.
1179
1178
1180 Note that this does not include the displayhook, which also caches
1179 Note that this does not include the displayhook, which also caches
1181 objects from the output."""
1180 objects from the output."""
1182 return [self.user_ns, self.user_global_ns,
1181 return [self.user_ns, self.user_global_ns,
1183 self._user_main_module.__dict__] + self._main_ns_cache.values()
1182 self._user_main_module.__dict__] + self._main_ns_cache.values()
1184
1183
1185 def reset(self, new_session=True):
1184 def reset(self, new_session=True):
1186 """Clear all internal namespaces, and attempt to release references to
1185 """Clear all internal namespaces, and attempt to release references to
1187 user objects.
1186 user objects.
1188
1187
1189 If new_session is True, a new history session will be opened.
1188 If new_session is True, a new history session will be opened.
1190 """
1189 """
1191 # Clear histories
1190 # Clear histories
1192 self.history_manager.reset(new_session)
1191 self.history_manager.reset(new_session)
1193 # Reset counter used to index all histories
1192 # Reset counter used to index all histories
1194 if new_session:
1193 if new_session:
1195 self.execution_count = 1
1194 self.execution_count = 1
1196
1195
1197 # Flush cached output items
1196 # Flush cached output items
1198 if self.displayhook.do_full_cache:
1197 if self.displayhook.do_full_cache:
1199 self.displayhook.flush()
1198 self.displayhook.flush()
1200
1199
1201 # The main execution namespaces must be cleared very carefully,
1200 # The main execution namespaces must be cleared very carefully,
1202 # skipping the deletion of the builtin-related keys, because doing so
1201 # skipping the deletion of the builtin-related keys, because doing so
1203 # would cause errors in many object's __del__ methods.
1202 # would cause errors in many object's __del__ methods.
1204 if self.user_ns is not self.user_global_ns:
1203 if self.user_ns is not self.user_global_ns:
1205 self.user_ns.clear()
1204 self.user_ns.clear()
1206 ns = self.user_global_ns
1205 ns = self.user_global_ns
1207 drop_keys = set(ns.keys())
1206 drop_keys = set(ns.keys())
1208 drop_keys.discard('__builtin__')
1207 drop_keys.discard('__builtin__')
1209 drop_keys.discard('__builtins__')
1208 drop_keys.discard('__builtins__')
1210 drop_keys.discard('__name__')
1209 drop_keys.discard('__name__')
1211 for k in drop_keys:
1210 for k in drop_keys:
1212 del ns[k]
1211 del ns[k]
1213
1212
1214 self.user_ns_hidden.clear()
1213 self.user_ns_hidden.clear()
1215
1214
1216 # Restore the user namespaces to minimal usability
1215 # Restore the user namespaces to minimal usability
1217 self.init_user_ns()
1216 self.init_user_ns()
1218
1217
1219 # Restore the default and user aliases
1218 # Restore the default and user aliases
1220 self.alias_manager.clear_aliases()
1219 self.alias_manager.clear_aliases()
1221 self.alias_manager.init_aliases()
1220 self.alias_manager.init_aliases()
1222
1221
1223 # Flush the private list of module references kept for script
1222 # Flush the private list of module references kept for script
1224 # execution protection
1223 # execution protection
1225 self.clear_main_mod_cache()
1224 self.clear_main_mod_cache()
1226
1225
1227 # Clear out the namespace from the last %run
1226 # Clear out the namespace from the last %run
1228 self.new_main_mod()
1227 self.new_main_mod()
1229
1228
1230 def del_var(self, varname, by_name=False):
1229 def del_var(self, varname, by_name=False):
1231 """Delete a variable from the various namespaces, so that, as
1230 """Delete a variable from the various namespaces, so that, as
1232 far as possible, we're not keeping any hidden references to it.
1231 far as possible, we're not keeping any hidden references to it.
1233
1232
1234 Parameters
1233 Parameters
1235 ----------
1234 ----------
1236 varname : str
1235 varname : str
1237 The name of the variable to delete.
1236 The name of the variable to delete.
1238 by_name : bool
1237 by_name : bool
1239 If True, delete variables with the given name in each
1238 If True, delete variables with the given name in each
1240 namespace. If False (default), find the variable in the user
1239 namespace. If False (default), find the variable in the user
1241 namespace, and delete references to it.
1240 namespace, and delete references to it.
1242 """
1241 """
1243 if varname in ('__builtin__', '__builtins__'):
1242 if varname in ('__builtin__', '__builtins__'):
1244 raise ValueError("Refusing to delete %s" % varname)
1243 raise ValueError("Refusing to delete %s" % varname)
1245
1244
1246 ns_refs = self.all_ns_refs
1245 ns_refs = self.all_ns_refs
1247
1246
1248 if by_name: # Delete by name
1247 if by_name: # Delete by name
1249 for ns in ns_refs:
1248 for ns in ns_refs:
1250 try:
1249 try:
1251 del ns[varname]
1250 del ns[varname]
1252 except KeyError:
1251 except KeyError:
1253 pass
1252 pass
1254 else: # Delete by object
1253 else: # Delete by object
1255 try:
1254 try:
1256 obj = self.user_ns[varname]
1255 obj = self.user_ns[varname]
1257 except KeyError:
1256 except KeyError:
1258 raise NameError("name '%s' is not defined" % varname)
1257 raise NameError("name '%s' is not defined" % varname)
1259 # Also check in output history
1258 # Also check in output history
1260 ns_refs.append(self.history_manager.output_hist)
1259 ns_refs.append(self.history_manager.output_hist)
1261 for ns in ns_refs:
1260 for ns in ns_refs:
1262 to_delete = [n for n, o in ns.iteritems() if o is obj]
1261 to_delete = [n for n, o in ns.iteritems() if o is obj]
1263 for name in to_delete:
1262 for name in to_delete:
1264 del ns[name]
1263 del ns[name]
1265
1264
1266 # displayhook keeps extra references, but not in a dictionary
1265 # displayhook keeps extra references, but not in a dictionary
1267 for name in ('_', '__', '___'):
1266 for name in ('_', '__', '___'):
1268 if getattr(self.displayhook, name) is obj:
1267 if getattr(self.displayhook, name) is obj:
1269 setattr(self.displayhook, name, None)
1268 setattr(self.displayhook, name, None)
1270
1269
1271 def reset_selective(self, regex=None):
1270 def reset_selective(self, regex=None):
1272 """Clear selective variables from internal namespaces based on a
1271 """Clear selective variables from internal namespaces based on a
1273 specified regular expression.
1272 specified regular expression.
1274
1273
1275 Parameters
1274 Parameters
1276 ----------
1275 ----------
1277 regex : string or compiled pattern, optional
1276 regex : string or compiled pattern, optional
1278 A regular expression pattern that will be used in searching
1277 A regular expression pattern that will be used in searching
1279 variable names in the users namespaces.
1278 variable names in the users namespaces.
1280 """
1279 """
1281 if regex is not None:
1280 if regex is not None:
1282 try:
1281 try:
1283 m = re.compile(regex)
1282 m = re.compile(regex)
1284 except TypeError:
1283 except TypeError:
1285 raise TypeError('regex must be a string or compiled pattern')
1284 raise TypeError('regex must be a string or compiled pattern')
1286 # Search for keys in each namespace that match the given regex
1285 # Search for keys in each namespace that match the given regex
1287 # If a match is found, delete the key/value pair.
1286 # If a match is found, delete the key/value pair.
1288 for ns in self.all_ns_refs:
1287 for ns in self.all_ns_refs:
1289 for var in ns:
1288 for var in ns:
1290 if m.search(var):
1289 if m.search(var):
1291 del ns[var]
1290 del ns[var]
1292
1291
1293 def push(self, variables, interactive=True):
1292 def push(self, variables, interactive=True):
1294 """Inject a group of variables into the IPython user namespace.
1293 """Inject a group of variables into the IPython user namespace.
1295
1294
1296 Parameters
1295 Parameters
1297 ----------
1296 ----------
1298 variables : dict, str or list/tuple of str
1297 variables : dict, str or list/tuple of str
1299 The variables to inject into the user's namespace. If a dict, a
1298 The variables to inject into the user's namespace. If a dict, a
1300 simple update is done. If a str, the string is assumed to have
1299 simple update is done. If a str, the string is assumed to have
1301 variable names separated by spaces. A list/tuple of str can also
1300 variable names separated by spaces. A list/tuple of str can also
1302 be used to give the variable names. If just the variable names are
1301 be used to give the variable names. If just the variable names are
1303 give (list/tuple/str) then the variable values looked up in the
1302 give (list/tuple/str) then the variable values looked up in the
1304 callers frame.
1303 callers frame.
1305 interactive : bool
1304 interactive : bool
1306 If True (default), the variables will be listed with the ``who``
1305 If True (default), the variables will be listed with the ``who``
1307 magic.
1306 magic.
1308 """
1307 """
1309 vdict = None
1308 vdict = None
1310
1309
1311 # We need a dict of name/value pairs to do namespace updates.
1310 # We need a dict of name/value pairs to do namespace updates.
1312 if isinstance(variables, dict):
1311 if isinstance(variables, dict):
1313 vdict = variables
1312 vdict = variables
1314 elif isinstance(variables, (basestring, list, tuple)):
1313 elif isinstance(variables, (basestring, list, tuple)):
1315 if isinstance(variables, basestring):
1314 if isinstance(variables, basestring):
1316 vlist = variables.split()
1315 vlist = variables.split()
1317 else:
1316 else:
1318 vlist = variables
1317 vlist = variables
1319 vdict = {}
1318 vdict = {}
1320 cf = sys._getframe(1)
1319 cf = sys._getframe(1)
1321 for name in vlist:
1320 for name in vlist:
1322 try:
1321 try:
1323 vdict[name] = eval(name, cf.f_globals, cf.f_locals)
1322 vdict[name] = eval(name, cf.f_globals, cf.f_locals)
1324 except:
1323 except:
1325 print('Could not get variable %s from %s' %
1324 print('Could not get variable %s from %s' %
1326 (name,cf.f_code.co_name))
1325 (name,cf.f_code.co_name))
1327 else:
1326 else:
1328 raise ValueError('variables must be a dict/str/list/tuple')
1327 raise ValueError('variables must be a dict/str/list/tuple')
1329
1328
1330 # Propagate variables to user namespace
1329 # Propagate variables to user namespace
1331 self.user_ns.update(vdict)
1330 self.user_ns.update(vdict)
1332
1331
1333 # And configure interactive visibility
1332 # And configure interactive visibility
1334 user_ns_hidden = self.user_ns_hidden
1333 user_ns_hidden = self.user_ns_hidden
1335 if interactive:
1334 if interactive:
1336 user_ns_hidden.difference_update(vdict)
1335 user_ns_hidden.difference_update(vdict)
1337 else:
1336 else:
1338 user_ns_hidden.update(vdict)
1337 user_ns_hidden.update(vdict)
1339
1338
1340 def drop_by_id(self, variables):
1339 def drop_by_id(self, variables):
1341 """Remove a dict of variables from the user namespace, if they are the
1340 """Remove a dict of variables from the user namespace, if they are the
1342 same as the values in the dictionary.
1341 same as the values in the dictionary.
1343
1342
1344 This is intended for use by extensions: variables that they've added can
1343 This is intended for use by extensions: variables that they've added can
1345 be taken back out if they are unloaded, without removing any that the
1344 be taken back out if they are unloaded, without removing any that the
1346 user has overwritten.
1345 user has overwritten.
1347
1346
1348 Parameters
1347 Parameters
1349 ----------
1348 ----------
1350 variables : dict
1349 variables : dict
1351 A dictionary mapping object names (as strings) to the objects.
1350 A dictionary mapping object names (as strings) to the objects.
1352 """
1351 """
1353 for name, obj in variables.iteritems():
1352 for name, obj in variables.iteritems():
1354 if name in self.user_ns and self.user_ns[name] is obj:
1353 if name in self.user_ns and self.user_ns[name] is obj:
1355 del self.user_ns[name]
1354 del self.user_ns[name]
1356 self.user_ns_hidden.discard(name)
1355 self.user_ns_hidden.discard(name)
1357
1356
1358 #-------------------------------------------------------------------------
1357 #-------------------------------------------------------------------------
1359 # Things related to object introspection
1358 # Things related to object introspection
1360 #-------------------------------------------------------------------------
1359 #-------------------------------------------------------------------------
1361
1360
1362 def _ofind(self, oname, namespaces=None):
1361 def _ofind(self, oname, namespaces=None):
1363 """Find an object in the available namespaces.
1362 """Find an object in the available namespaces.
1364
1363
1365 self._ofind(oname) -> dict with keys: found,obj,ospace,ismagic
1364 self._ofind(oname) -> dict with keys: found,obj,ospace,ismagic
1366
1365
1367 Has special code to detect magic functions.
1366 Has special code to detect magic functions.
1368 """
1367 """
1369 oname = oname.strip()
1368 oname = oname.strip()
1370 #print '1- oname: <%r>' % oname # dbg
1369 #print '1- oname: <%r>' % oname # dbg
1371 if not oname.startswith(ESC_MAGIC) and \
1370 if not oname.startswith(ESC_MAGIC) and \
1372 not oname.startswith(ESC_MAGIC2) and \
1371 not oname.startswith(ESC_MAGIC2) and \
1373 not py3compat.isidentifier(oname, dotted=True):
1372 not py3compat.isidentifier(oname, dotted=True):
1374 return dict(found=False)
1373 return dict(found=False)
1375
1374
1376 alias_ns = None
1375 alias_ns = None
1377 if namespaces is None:
1376 if namespaces is None:
1378 # Namespaces to search in:
1377 # Namespaces to search in:
1379 # Put them in a list. The order is important so that we
1378 # Put them in a list. The order is important so that we
1380 # find things in the same order that Python finds them.
1379 # find things in the same order that Python finds them.
1381 namespaces = [ ('Interactive', self.user_ns),
1380 namespaces = [ ('Interactive', self.user_ns),
1382 ('Interactive (global)', self.user_global_ns),
1381 ('Interactive (global)', self.user_global_ns),
1383 ('Python builtin', builtin_mod.__dict__),
1382 ('Python builtin', builtin_mod.__dict__),
1384 ('Alias', self.alias_manager.alias_table),
1383 ('Alias', self.alias_manager.alias_table),
1385 ]
1384 ]
1386 alias_ns = self.alias_manager.alias_table
1385 alias_ns = self.alias_manager.alias_table
1387
1386
1388 # initialize results to 'null'
1387 # initialize results to 'null'
1389 found = False; obj = None; ospace = None; ds = None;
1388 found = False; obj = None; ospace = None; ds = None;
1390 ismagic = False; isalias = False; parent = None
1389 ismagic = False; isalias = False; parent = None
1391
1390
1392 # We need to special-case 'print', which as of python2.6 registers as a
1391 # We need to special-case 'print', which as of python2.6 registers as a
1393 # function but should only be treated as one if print_function was
1392 # function but should only be treated as one if print_function was
1394 # loaded with a future import. In this case, just bail.
1393 # loaded with a future import. In this case, just bail.
1395 if (oname == 'print' and not py3compat.PY3 and not \
1394 if (oname == 'print' and not py3compat.PY3 and not \
1396 (self.compile.compiler_flags & __future__.CO_FUTURE_PRINT_FUNCTION)):
1395 (self.compile.compiler_flags & __future__.CO_FUTURE_PRINT_FUNCTION)):
1397 return {'found':found, 'obj':obj, 'namespace':ospace,
1396 return {'found':found, 'obj':obj, 'namespace':ospace,
1398 'ismagic':ismagic, 'isalias':isalias, 'parent':parent}
1397 'ismagic':ismagic, 'isalias':isalias, 'parent':parent}
1399
1398
1400 # Look for the given name by splitting it in parts. If the head is
1399 # Look for the given name by splitting it in parts. If the head is
1401 # found, then we look for all the remaining parts as members, and only
1400 # found, then we look for all the remaining parts as members, and only
1402 # declare success if we can find them all.
1401 # declare success if we can find them all.
1403 oname_parts = oname.split('.')
1402 oname_parts = oname.split('.')
1404 oname_head, oname_rest = oname_parts[0],oname_parts[1:]
1403 oname_head, oname_rest = oname_parts[0],oname_parts[1:]
1405 for nsname,ns in namespaces:
1404 for nsname,ns in namespaces:
1406 try:
1405 try:
1407 obj = ns[oname_head]
1406 obj = ns[oname_head]
1408 except KeyError:
1407 except KeyError:
1409 continue
1408 continue
1410 else:
1409 else:
1411 #print 'oname_rest:', oname_rest # dbg
1410 #print 'oname_rest:', oname_rest # dbg
1412 for part in oname_rest:
1411 for part in oname_rest:
1413 try:
1412 try:
1414 parent = obj
1413 parent = obj
1415 obj = getattr(obj,part)
1414 obj = getattr(obj,part)
1416 except:
1415 except:
1417 # Blanket except b/c some badly implemented objects
1416 # Blanket except b/c some badly implemented objects
1418 # allow __getattr__ to raise exceptions other than
1417 # allow __getattr__ to raise exceptions other than
1419 # AttributeError, which then crashes IPython.
1418 # AttributeError, which then crashes IPython.
1420 break
1419 break
1421 else:
1420 else:
1422 # If we finish the for loop (no break), we got all members
1421 # If we finish the for loop (no break), we got all members
1423 found = True
1422 found = True
1424 ospace = nsname
1423 ospace = nsname
1425 if ns == alias_ns:
1424 if ns == alias_ns:
1426 isalias = True
1425 isalias = True
1427 break # namespace loop
1426 break # namespace loop
1428
1427
1429 # Try to see if it's magic
1428 # Try to see if it's magic
1430 if not found:
1429 if not found:
1431 obj = None
1430 obj = None
1432 if oname.startswith(ESC_MAGIC2):
1431 if oname.startswith(ESC_MAGIC2):
1433 oname = oname.lstrip(ESC_MAGIC2)
1432 oname = oname.lstrip(ESC_MAGIC2)
1434 obj = self.find_cell_magic(oname)
1433 obj = self.find_cell_magic(oname)
1435 elif oname.startswith(ESC_MAGIC):
1434 elif oname.startswith(ESC_MAGIC):
1436 oname = oname.lstrip(ESC_MAGIC)
1435 oname = oname.lstrip(ESC_MAGIC)
1437 obj = self.find_line_magic(oname)
1436 obj = self.find_line_magic(oname)
1438 else:
1437 else:
1439 # search without prefix, so run? will find %run?
1438 # search without prefix, so run? will find %run?
1440 obj = self.find_line_magic(oname)
1439 obj = self.find_line_magic(oname)
1441 if obj is None:
1440 if obj is None:
1442 obj = self.find_cell_magic(oname)
1441 obj = self.find_cell_magic(oname)
1443 if obj is not None:
1442 if obj is not None:
1444 found = True
1443 found = True
1445 ospace = 'IPython internal'
1444 ospace = 'IPython internal'
1446 ismagic = True
1445 ismagic = True
1447
1446
1448 # Last try: special-case some literals like '', [], {}, etc:
1447 # Last try: special-case some literals like '', [], {}, etc:
1449 if not found and oname_head in ["''",'""','[]','{}','()']:
1448 if not found and oname_head in ["''",'""','[]','{}','()']:
1450 obj = eval(oname_head)
1449 obj = eval(oname_head)
1451 found = True
1450 found = True
1452 ospace = 'Interactive'
1451 ospace = 'Interactive'
1453
1452
1454 return {'found':found, 'obj':obj, 'namespace':ospace,
1453 return {'found':found, 'obj':obj, 'namespace':ospace,
1455 'ismagic':ismagic, 'isalias':isalias, 'parent':parent}
1454 'ismagic':ismagic, 'isalias':isalias, 'parent':parent}
1456
1455
1457 def _ofind_property(self, oname, info):
1456 def _ofind_property(self, oname, info):
1458 """Second part of object finding, to look for property details."""
1457 """Second part of object finding, to look for property details."""
1459 if info.found:
1458 if info.found:
1460 # Get the docstring of the class property if it exists.
1459 # Get the docstring of the class property if it exists.
1461 path = oname.split('.')
1460 path = oname.split('.')
1462 root = '.'.join(path[:-1])
1461 root = '.'.join(path[:-1])
1463 if info.parent is not None:
1462 if info.parent is not None:
1464 try:
1463 try:
1465 target = getattr(info.parent, '__class__')
1464 target = getattr(info.parent, '__class__')
1466 # The object belongs to a class instance.
1465 # The object belongs to a class instance.
1467 try:
1466 try:
1468 target = getattr(target, path[-1])
1467 target = getattr(target, path[-1])
1469 # The class defines the object.
1468 # The class defines the object.
1470 if isinstance(target, property):
1469 if isinstance(target, property):
1471 oname = root + '.__class__.' + path[-1]
1470 oname = root + '.__class__.' + path[-1]
1472 info = Struct(self._ofind(oname))
1471 info = Struct(self._ofind(oname))
1473 except AttributeError: pass
1472 except AttributeError: pass
1474 except AttributeError: pass
1473 except AttributeError: pass
1475
1474
1476 # We return either the new info or the unmodified input if the object
1475 # We return either the new info or the unmodified input if the object
1477 # hadn't been found
1476 # hadn't been found
1478 return info
1477 return info
1479
1478
1480 def _object_find(self, oname, namespaces=None):
1479 def _object_find(self, oname, namespaces=None):
1481 """Find an object and return a struct with info about it."""
1480 """Find an object and return a struct with info about it."""
1482 inf = Struct(self._ofind(oname, namespaces))
1481 inf = Struct(self._ofind(oname, namespaces))
1483 return Struct(self._ofind_property(oname, inf))
1482 return Struct(self._ofind_property(oname, inf))
1484
1483
1485 def _inspect(self, meth, oname, namespaces=None, **kw):
1484 def _inspect(self, meth, oname, namespaces=None, **kw):
1486 """Generic interface to the inspector system.
1485 """Generic interface to the inspector system.
1487
1486
1488 This function is meant to be called by pdef, pdoc & friends."""
1487 This function is meant to be called by pdef, pdoc & friends."""
1489 info = self._object_find(oname, namespaces)
1488 info = self._object_find(oname, namespaces)
1490 if info.found:
1489 if info.found:
1491 pmethod = getattr(self.inspector, meth)
1490 pmethod = getattr(self.inspector, meth)
1492 formatter = format_screen if info.ismagic else None
1491 formatter = format_screen if info.ismagic else None
1493 if meth == 'pdoc':
1492 if meth == 'pdoc':
1494 pmethod(info.obj, oname, formatter)
1493 pmethod(info.obj, oname, formatter)
1495 elif meth == 'pinfo':
1494 elif meth == 'pinfo':
1496 pmethod(info.obj, oname, formatter, info, **kw)
1495 pmethod(info.obj, oname, formatter, info, **kw)
1497 else:
1496 else:
1498 pmethod(info.obj, oname)
1497 pmethod(info.obj, oname)
1499 else:
1498 else:
1500 print('Object `%s` not found.' % oname)
1499 print('Object `%s` not found.' % oname)
1501 return 'not found' # so callers can take other action
1500 return 'not found' # so callers can take other action
1502
1501
1503 def object_inspect(self, oname, detail_level=0):
1502 def object_inspect(self, oname, detail_level=0):
1504 with self.builtin_trap:
1503 with self.builtin_trap:
1505 info = self._object_find(oname)
1504 info = self._object_find(oname)
1506 if info.found:
1505 if info.found:
1507 return self.inspector.info(info.obj, oname, info=info,
1506 return self.inspector.info(info.obj, oname, info=info,
1508 detail_level=detail_level
1507 detail_level=detail_level
1509 )
1508 )
1510 else:
1509 else:
1511 return oinspect.object_info(name=oname, found=False)
1510 return oinspect.object_info(name=oname, found=False)
1512
1511
1513 #-------------------------------------------------------------------------
1512 #-------------------------------------------------------------------------
1514 # Things related to history management
1513 # Things related to history management
1515 #-------------------------------------------------------------------------
1514 #-------------------------------------------------------------------------
1516
1515
1517 def init_history(self):
1516 def init_history(self):
1518 """Sets up the command history, and starts regular autosaves."""
1517 """Sets up the command history, and starts regular autosaves."""
1519 self.history_manager = HistoryManager(shell=self, config=self.config)
1518 self.history_manager = HistoryManager(shell=self, config=self.config)
1520 self.configurables.append(self.history_manager)
1519 self.configurables.append(self.history_manager)
1521
1520
1522 #-------------------------------------------------------------------------
1521 #-------------------------------------------------------------------------
1523 # Things related to exception handling and tracebacks (not debugging)
1522 # Things related to exception handling and tracebacks (not debugging)
1524 #-------------------------------------------------------------------------
1523 #-------------------------------------------------------------------------
1525
1524
1526 def init_traceback_handlers(self, custom_exceptions):
1525 def init_traceback_handlers(self, custom_exceptions):
1527 # Syntax error handler.
1526 # Syntax error handler.
1528 self.SyntaxTB = ultratb.SyntaxTB(color_scheme='NoColor')
1527 self.SyntaxTB = ultratb.SyntaxTB(color_scheme='NoColor')
1529
1528
1530 # The interactive one is initialized with an offset, meaning we always
1529 # The interactive one is initialized with an offset, meaning we always
1531 # want to remove the topmost item in the traceback, which is our own
1530 # want to remove the topmost item in the traceback, which is our own
1532 # internal code. Valid modes: ['Plain','Context','Verbose']
1531 # internal code. Valid modes: ['Plain','Context','Verbose']
1533 self.InteractiveTB = ultratb.AutoFormattedTB(mode = 'Plain',
1532 self.InteractiveTB = ultratb.AutoFormattedTB(mode = 'Plain',
1534 color_scheme='NoColor',
1533 color_scheme='NoColor',
1535 tb_offset = 1,
1534 tb_offset = 1,
1536 check_cache=self.compile.check_cache)
1535 check_cache=check_linecache_ipython)
1537
1536
1538 # The instance will store a pointer to the system-wide exception hook,
1537 # The instance will store a pointer to the system-wide exception hook,
1539 # so that runtime code (such as magics) can access it. This is because
1538 # so that runtime code (such as magics) can access it. This is because
1540 # during the read-eval loop, it may get temporarily overwritten.
1539 # during the read-eval loop, it may get temporarily overwritten.
1541 self.sys_excepthook = sys.excepthook
1540 self.sys_excepthook = sys.excepthook
1542
1541
1543 # and add any custom exception handlers the user may have specified
1542 # and add any custom exception handlers the user may have specified
1544 self.set_custom_exc(*custom_exceptions)
1543 self.set_custom_exc(*custom_exceptions)
1545
1544
1546 # Set the exception mode
1545 # Set the exception mode
1547 self.InteractiveTB.set_mode(mode=self.xmode)
1546 self.InteractiveTB.set_mode(mode=self.xmode)
1548
1547
1549 def set_custom_exc(self, exc_tuple, handler):
1548 def set_custom_exc(self, exc_tuple, handler):
1550 """set_custom_exc(exc_tuple,handler)
1549 """set_custom_exc(exc_tuple,handler)
1551
1550
1552 Set a custom exception handler, which will be called if any of the
1551 Set a custom exception handler, which will be called if any of the
1553 exceptions in exc_tuple occur in the mainloop (specifically, in the
1552 exceptions in exc_tuple occur in the mainloop (specifically, in the
1554 run_code() method).
1553 run_code() method).
1555
1554
1556 Parameters
1555 Parameters
1557 ----------
1556 ----------
1558
1557
1559 exc_tuple : tuple of exception classes
1558 exc_tuple : tuple of exception classes
1560 A *tuple* of exception classes, for which to call the defined
1559 A *tuple* of exception classes, for which to call the defined
1561 handler. It is very important that you use a tuple, and NOT A
1560 handler. It is very important that you use a tuple, and NOT A
1562 LIST here, because of the way Python's except statement works. If
1561 LIST here, because of the way Python's except statement works. If
1563 you only want to trap a single exception, use a singleton tuple::
1562 you only want to trap a single exception, use a singleton tuple::
1564
1563
1565 exc_tuple == (MyCustomException,)
1564 exc_tuple == (MyCustomException,)
1566
1565
1567 handler : callable
1566 handler : callable
1568 handler must have the following signature::
1567 handler must have the following signature::
1569
1568
1570 def my_handler(self, etype, value, tb, tb_offset=None):
1569 def my_handler(self, etype, value, tb, tb_offset=None):
1571 ...
1570 ...
1572 return structured_traceback
1571 return structured_traceback
1573
1572
1574 Your handler must return a structured traceback (a list of strings),
1573 Your handler must return a structured traceback (a list of strings),
1575 or None.
1574 or None.
1576
1575
1577 This will be made into an instance method (via types.MethodType)
1576 This will be made into an instance method (via types.MethodType)
1578 of IPython itself, and it will be called if any of the exceptions
1577 of IPython itself, and it will be called if any of the exceptions
1579 listed in the exc_tuple are caught. If the handler is None, an
1578 listed in the exc_tuple are caught. If the handler is None, an
1580 internal basic one is used, which just prints basic info.
1579 internal basic one is used, which just prints basic info.
1581
1580
1582 To protect IPython from crashes, if your handler ever raises an
1581 To protect IPython from crashes, if your handler ever raises an
1583 exception or returns an invalid result, it will be immediately
1582 exception or returns an invalid result, it will be immediately
1584 disabled.
1583 disabled.
1585
1584
1586 WARNING: by putting in your own exception handler into IPython's main
1585 WARNING: by putting in your own exception handler into IPython's main
1587 execution loop, you run a very good chance of nasty crashes. This
1586 execution loop, you run a very good chance of nasty crashes. This
1588 facility should only be used if you really know what you are doing."""
1587 facility should only be used if you really know what you are doing."""
1589
1588
1590 assert type(exc_tuple)==type(()) , \
1589 assert type(exc_tuple)==type(()) , \
1591 "The custom exceptions must be given AS A TUPLE."
1590 "The custom exceptions must be given AS A TUPLE."
1592
1591
1593 def dummy_handler(self,etype,value,tb,tb_offset=None):
1592 def dummy_handler(self,etype,value,tb,tb_offset=None):
1594 print('*** Simple custom exception handler ***')
1593 print('*** Simple custom exception handler ***')
1595 print('Exception type :',etype)
1594 print('Exception type :',etype)
1596 print('Exception value:',value)
1595 print('Exception value:',value)
1597 print('Traceback :',tb)
1596 print('Traceback :',tb)
1598 #print 'Source code :','\n'.join(self.buffer)
1597 #print 'Source code :','\n'.join(self.buffer)
1599
1598
1600 def validate_stb(stb):
1599 def validate_stb(stb):
1601 """validate structured traceback return type
1600 """validate structured traceback return type
1602
1601
1603 return type of CustomTB *should* be a list of strings, but allow
1602 return type of CustomTB *should* be a list of strings, but allow
1604 single strings or None, which are harmless.
1603 single strings or None, which are harmless.
1605
1604
1606 This function will *always* return a list of strings,
1605 This function will *always* return a list of strings,
1607 and will raise a TypeError if stb is inappropriate.
1606 and will raise a TypeError if stb is inappropriate.
1608 """
1607 """
1609 msg = "CustomTB must return list of strings, not %r" % stb
1608 msg = "CustomTB must return list of strings, not %r" % stb
1610 if stb is None:
1609 if stb is None:
1611 return []
1610 return []
1612 elif isinstance(stb, basestring):
1611 elif isinstance(stb, basestring):
1613 return [stb]
1612 return [stb]
1614 elif not isinstance(stb, list):
1613 elif not isinstance(stb, list):
1615 raise TypeError(msg)
1614 raise TypeError(msg)
1616 # it's a list
1615 # it's a list
1617 for line in stb:
1616 for line in stb:
1618 # check every element
1617 # check every element
1619 if not isinstance(line, basestring):
1618 if not isinstance(line, basestring):
1620 raise TypeError(msg)
1619 raise TypeError(msg)
1621 return stb
1620 return stb
1622
1621
1623 if handler is None:
1622 if handler is None:
1624 wrapped = dummy_handler
1623 wrapped = dummy_handler
1625 else:
1624 else:
1626 def wrapped(self,etype,value,tb,tb_offset=None):
1625 def wrapped(self,etype,value,tb,tb_offset=None):
1627 """wrap CustomTB handler, to protect IPython from user code
1626 """wrap CustomTB handler, to protect IPython from user code
1628
1627
1629 This makes it harder (but not impossible) for custom exception
1628 This makes it harder (but not impossible) for custom exception
1630 handlers to crash IPython.
1629 handlers to crash IPython.
1631 """
1630 """
1632 try:
1631 try:
1633 stb = handler(self,etype,value,tb,tb_offset=tb_offset)
1632 stb = handler(self,etype,value,tb,tb_offset=tb_offset)
1634 return validate_stb(stb)
1633 return validate_stb(stb)
1635 except:
1634 except:
1636 # clear custom handler immediately
1635 # clear custom handler immediately
1637 self.set_custom_exc((), None)
1636 self.set_custom_exc((), None)
1638 print("Custom TB Handler failed, unregistering", file=io.stderr)
1637 print("Custom TB Handler failed, unregistering", file=io.stderr)
1639 # show the exception in handler first
1638 # show the exception in handler first
1640 stb = self.InteractiveTB.structured_traceback(*sys.exc_info())
1639 stb = self.InteractiveTB.structured_traceback(*sys.exc_info())
1641 print(self.InteractiveTB.stb2text(stb), file=io.stdout)
1640 print(self.InteractiveTB.stb2text(stb), file=io.stdout)
1642 print("The original exception:", file=io.stdout)
1641 print("The original exception:", file=io.stdout)
1643 stb = self.InteractiveTB.structured_traceback(
1642 stb = self.InteractiveTB.structured_traceback(
1644 (etype,value,tb), tb_offset=tb_offset
1643 (etype,value,tb), tb_offset=tb_offset
1645 )
1644 )
1646 return stb
1645 return stb
1647
1646
1648 self.CustomTB = types.MethodType(wrapped,self)
1647 self.CustomTB = types.MethodType(wrapped,self)
1649 self.custom_exceptions = exc_tuple
1648 self.custom_exceptions = exc_tuple
1650
1649
1651 def excepthook(self, etype, value, tb):
1650 def excepthook(self, etype, value, tb):
1652 """One more defense for GUI apps that call sys.excepthook.
1651 """One more defense for GUI apps that call sys.excepthook.
1653
1652
1654 GUI frameworks like wxPython trap exceptions and call
1653 GUI frameworks like wxPython trap exceptions and call
1655 sys.excepthook themselves. I guess this is a feature that
1654 sys.excepthook themselves. I guess this is a feature that
1656 enables them to keep running after exceptions that would
1655 enables them to keep running after exceptions that would
1657 otherwise kill their mainloop. This is a bother for IPython
1656 otherwise kill their mainloop. This is a bother for IPython
1658 which excepts to catch all of the program exceptions with a try:
1657 which excepts to catch all of the program exceptions with a try:
1659 except: statement.
1658 except: statement.
1660
1659
1661 Normally, IPython sets sys.excepthook to a CrashHandler instance, so if
1660 Normally, IPython sets sys.excepthook to a CrashHandler instance, so if
1662 any app directly invokes sys.excepthook, it will look to the user like
1661 any app directly invokes sys.excepthook, it will look to the user like
1663 IPython crashed. In order to work around this, we can disable the
1662 IPython crashed. In order to work around this, we can disable the
1664 CrashHandler and replace it with this excepthook instead, which prints a
1663 CrashHandler and replace it with this excepthook instead, which prints a
1665 regular traceback using our InteractiveTB. In this fashion, apps which
1664 regular traceback using our InteractiveTB. In this fashion, apps which
1666 call sys.excepthook will generate a regular-looking exception from
1665 call sys.excepthook will generate a regular-looking exception from
1667 IPython, and the CrashHandler will only be triggered by real IPython
1666 IPython, and the CrashHandler will only be triggered by real IPython
1668 crashes.
1667 crashes.
1669
1668
1670 This hook should be used sparingly, only in places which are not likely
1669 This hook should be used sparingly, only in places which are not likely
1671 to be true IPython errors.
1670 to be true IPython errors.
1672 """
1671 """
1673 self.showtraceback((etype,value,tb),tb_offset=0)
1672 self.showtraceback((etype,value,tb),tb_offset=0)
1674
1673
1675 def _get_exc_info(self, exc_tuple=None):
1674 def _get_exc_info(self, exc_tuple=None):
1676 """get exc_info from a given tuple, sys.exc_info() or sys.last_type etc.
1675 """get exc_info from a given tuple, sys.exc_info() or sys.last_type etc.
1677
1676
1678 Ensures sys.last_type,value,traceback hold the exc_info we found,
1677 Ensures sys.last_type,value,traceback hold the exc_info we found,
1679 from whichever source.
1678 from whichever source.
1680
1679
1681 raises ValueError if none of these contain any information
1680 raises ValueError if none of these contain any information
1682 """
1681 """
1683 if exc_tuple is None:
1682 if exc_tuple is None:
1684 etype, value, tb = sys.exc_info()
1683 etype, value, tb = sys.exc_info()
1685 else:
1684 else:
1686 etype, value, tb = exc_tuple
1685 etype, value, tb = exc_tuple
1687
1686
1688 if etype is None:
1687 if etype is None:
1689 if hasattr(sys, 'last_type'):
1688 if hasattr(sys, 'last_type'):
1690 etype, value, tb = sys.last_type, sys.last_value, \
1689 etype, value, tb = sys.last_type, sys.last_value, \
1691 sys.last_traceback
1690 sys.last_traceback
1692
1691
1693 if etype is None:
1692 if etype is None:
1694 raise ValueError("No exception to find")
1693 raise ValueError("No exception to find")
1695
1694
1696 # Now store the exception info in sys.last_type etc.
1695 # Now store the exception info in sys.last_type etc.
1697 # WARNING: these variables are somewhat deprecated and not
1696 # WARNING: these variables are somewhat deprecated and not
1698 # necessarily safe to use in a threaded environment, but tools
1697 # necessarily safe to use in a threaded environment, but tools
1699 # like pdb depend on their existence, so let's set them. If we
1698 # like pdb depend on their existence, so let's set them. If we
1700 # find problems in the field, we'll need to revisit their use.
1699 # find problems in the field, we'll need to revisit their use.
1701 sys.last_type = etype
1700 sys.last_type = etype
1702 sys.last_value = value
1701 sys.last_value = value
1703 sys.last_traceback = tb
1702 sys.last_traceback = tb
1704
1703
1705 return etype, value, tb
1704 return etype, value, tb
1706
1705
1707
1706
1708 def showtraceback(self,exc_tuple = None,filename=None,tb_offset=None,
1707 def showtraceback(self,exc_tuple = None,filename=None,tb_offset=None,
1709 exception_only=False):
1708 exception_only=False):
1710 """Display the exception that just occurred.
1709 """Display the exception that just occurred.
1711
1710
1712 If nothing is known about the exception, this is the method which
1711 If nothing is known about the exception, this is the method which
1713 should be used throughout the code for presenting user tracebacks,
1712 should be used throughout the code for presenting user tracebacks,
1714 rather than directly invoking the InteractiveTB object.
1713 rather than directly invoking the InteractiveTB object.
1715
1714
1716 A specific showsyntaxerror() also exists, but this method can take
1715 A specific showsyntaxerror() also exists, but this method can take
1717 care of calling it if needed, so unless you are explicitly catching a
1716 care of calling it if needed, so unless you are explicitly catching a
1718 SyntaxError exception, don't try to analyze the stack manually and
1717 SyntaxError exception, don't try to analyze the stack manually and
1719 simply call this method."""
1718 simply call this method."""
1720
1719
1721 try:
1720 try:
1722 try:
1721 try:
1723 etype, value, tb = self._get_exc_info(exc_tuple)
1722 etype, value, tb = self._get_exc_info(exc_tuple)
1724 except ValueError:
1723 except ValueError:
1725 self.write_err('No traceback available to show.\n')
1724 self.write_err('No traceback available to show.\n')
1726 return
1725 return
1727
1726
1728 if issubclass(etype, SyntaxError):
1727 if issubclass(etype, SyntaxError):
1729 # Though this won't be called by syntax errors in the input
1728 # Though this won't be called by syntax errors in the input
1730 # line, there may be SyntaxError cases with imported code.
1729 # line, there may be SyntaxError cases with imported code.
1731 self.showsyntaxerror(filename)
1730 self.showsyntaxerror(filename)
1732 elif etype is UsageError:
1731 elif etype is UsageError:
1733 self.write_err("UsageError: %s" % value)
1732 self.write_err("UsageError: %s" % value)
1734 else:
1733 else:
1735 if exception_only:
1734 if exception_only:
1736 stb = ['An exception has occurred, use %tb to see '
1735 stb = ['An exception has occurred, use %tb to see '
1737 'the full traceback.\n']
1736 'the full traceback.\n']
1738 stb.extend(self.InteractiveTB.get_exception_only(etype,
1737 stb.extend(self.InteractiveTB.get_exception_only(etype,
1739 value))
1738 value))
1740 else:
1739 else:
1741 try:
1740 try:
1742 # Exception classes can customise their traceback - we
1741 # Exception classes can customise their traceback - we
1743 # use this in IPython.parallel for exceptions occurring
1742 # use this in IPython.parallel for exceptions occurring
1744 # in the engines. This should return a list of strings.
1743 # in the engines. This should return a list of strings.
1745 stb = value._render_traceback_()
1744 stb = value._render_traceback_()
1746 except Exception:
1745 except Exception:
1747 stb = self.InteractiveTB.structured_traceback(etype,
1746 stb = self.InteractiveTB.structured_traceback(etype,
1748 value, tb, tb_offset=tb_offset)
1747 value, tb, tb_offset=tb_offset)
1749
1748
1750 self._showtraceback(etype, value, stb)
1749 self._showtraceback(etype, value, stb)
1751 if self.call_pdb:
1750 if self.call_pdb:
1752 # drop into debugger
1751 # drop into debugger
1753 self.debugger(force=True)
1752 self.debugger(force=True)
1754 return
1753 return
1755
1754
1756 # Actually show the traceback
1755 # Actually show the traceback
1757 self._showtraceback(etype, value, stb)
1756 self._showtraceback(etype, value, stb)
1758
1757
1759 except KeyboardInterrupt:
1758 except KeyboardInterrupt:
1760 self.write_err("\nKeyboardInterrupt\n")
1759 self.write_err("\nKeyboardInterrupt\n")
1761
1760
1762 def _showtraceback(self, etype, evalue, stb):
1761 def _showtraceback(self, etype, evalue, stb):
1763 """Actually show a traceback.
1762 """Actually show a traceback.
1764
1763
1765 Subclasses may override this method to put the traceback on a different
1764 Subclasses may override this method to put the traceback on a different
1766 place, like a side channel.
1765 place, like a side channel.
1767 """
1766 """
1768 print(self.InteractiveTB.stb2text(stb), file=io.stdout)
1767 print(self.InteractiveTB.stb2text(stb), file=io.stdout)
1769
1768
1770 def showsyntaxerror(self, filename=None):
1769 def showsyntaxerror(self, filename=None):
1771 """Display the syntax error that just occurred.
1770 """Display the syntax error that just occurred.
1772
1771
1773 This doesn't display a stack trace because there isn't one.
1772 This doesn't display a stack trace because there isn't one.
1774
1773
1775 If a filename is given, it is stuffed in the exception instead
1774 If a filename is given, it is stuffed in the exception instead
1776 of what was there before (because Python's parser always uses
1775 of what was there before (because Python's parser always uses
1777 "<string>" when reading from a string).
1776 "<string>" when reading from a string).
1778 """
1777 """
1779 etype, value, last_traceback = self._get_exc_info()
1778 etype, value, last_traceback = self._get_exc_info()
1780
1779
1781 if filename and issubclass(etype, SyntaxError):
1780 if filename and issubclass(etype, SyntaxError):
1782 try:
1781 try:
1783 value.filename = filename
1782 value.filename = filename
1784 except:
1783 except:
1785 # Not the format we expect; leave it alone
1784 # Not the format we expect; leave it alone
1786 pass
1785 pass
1787
1786
1788 stb = self.SyntaxTB.structured_traceback(etype, value, [])
1787 stb = self.SyntaxTB.structured_traceback(etype, value, [])
1789 self._showtraceback(etype, value, stb)
1788 self._showtraceback(etype, value, stb)
1790
1789
1791 # This is overridden in TerminalInteractiveShell to show a message about
1790 # This is overridden in TerminalInteractiveShell to show a message about
1792 # the %paste magic.
1791 # the %paste magic.
1793 def showindentationerror(self):
1792 def showindentationerror(self):
1794 """Called by run_cell when there's an IndentationError in code entered
1793 """Called by run_cell when there's an IndentationError in code entered
1795 at the prompt.
1794 at the prompt.
1796
1795
1797 This is overridden in TerminalInteractiveShell to show a message about
1796 This is overridden in TerminalInteractiveShell to show a message about
1798 the %paste magic."""
1797 the %paste magic."""
1799 self.showsyntaxerror()
1798 self.showsyntaxerror()
1800
1799
1801 #-------------------------------------------------------------------------
1800 #-------------------------------------------------------------------------
1802 # Things related to readline
1801 # Things related to readline
1803 #-------------------------------------------------------------------------
1802 #-------------------------------------------------------------------------
1804
1803
1805 def init_readline(self):
1804 def init_readline(self):
1806 """Command history completion/saving/reloading."""
1805 """Command history completion/saving/reloading."""
1807
1806
1808 if self.readline_use:
1807 if self.readline_use:
1809 import IPython.utils.rlineimpl as readline
1808 import IPython.utils.rlineimpl as readline
1810
1809
1811 self.rl_next_input = None
1810 self.rl_next_input = None
1812 self.rl_do_indent = False
1811 self.rl_do_indent = False
1813
1812
1814 if not self.readline_use or not readline.have_readline:
1813 if not self.readline_use or not readline.have_readline:
1815 self.has_readline = False
1814 self.has_readline = False
1816 self.readline = None
1815 self.readline = None
1817 # Set a number of methods that depend on readline to be no-op
1816 # Set a number of methods that depend on readline to be no-op
1818 self.readline_no_record = no_op_context
1817 self.readline_no_record = no_op_context
1819 self.set_readline_completer = no_op
1818 self.set_readline_completer = no_op
1820 self.set_custom_completer = no_op
1819 self.set_custom_completer = no_op
1821 if self.readline_use:
1820 if self.readline_use:
1822 warn('Readline services not available or not loaded.')
1821 warn('Readline services not available or not loaded.')
1823 else:
1822 else:
1824 self.has_readline = True
1823 self.has_readline = True
1825 self.readline = readline
1824 self.readline = readline
1826 sys.modules['readline'] = readline
1825 sys.modules['readline'] = readline
1827
1826
1828 # Platform-specific configuration
1827 # Platform-specific configuration
1829 if os.name == 'nt':
1828 if os.name == 'nt':
1830 # FIXME - check with Frederick to see if we can harmonize
1829 # FIXME - check with Frederick to see if we can harmonize
1831 # naming conventions with pyreadline to avoid this
1830 # naming conventions with pyreadline to avoid this
1832 # platform-dependent check
1831 # platform-dependent check
1833 self.readline_startup_hook = readline.set_pre_input_hook
1832 self.readline_startup_hook = readline.set_pre_input_hook
1834 else:
1833 else:
1835 self.readline_startup_hook = readline.set_startup_hook
1834 self.readline_startup_hook = readline.set_startup_hook
1836
1835
1837 # Load user's initrc file (readline config)
1836 # Load user's initrc file (readline config)
1838 # Or if libedit is used, load editrc.
1837 # Or if libedit is used, load editrc.
1839 inputrc_name = os.environ.get('INPUTRC')
1838 inputrc_name = os.environ.get('INPUTRC')
1840 if inputrc_name is None:
1839 if inputrc_name is None:
1841 inputrc_name = '.inputrc'
1840 inputrc_name = '.inputrc'
1842 if readline.uses_libedit:
1841 if readline.uses_libedit:
1843 inputrc_name = '.editrc'
1842 inputrc_name = '.editrc'
1844 inputrc_name = os.path.join(self.home_dir, inputrc_name)
1843 inputrc_name = os.path.join(self.home_dir, inputrc_name)
1845 if os.path.isfile(inputrc_name):
1844 if os.path.isfile(inputrc_name):
1846 try:
1845 try:
1847 readline.read_init_file(inputrc_name)
1846 readline.read_init_file(inputrc_name)
1848 except:
1847 except:
1849 warn('Problems reading readline initialization file <%s>'
1848 warn('Problems reading readline initialization file <%s>'
1850 % inputrc_name)
1849 % inputrc_name)
1851
1850
1852 # Configure readline according to user's prefs
1851 # Configure readline according to user's prefs
1853 # This is only done if GNU readline is being used. If libedit
1852 # This is only done if GNU readline is being used. If libedit
1854 # is being used (as on Leopard) the readline config is
1853 # is being used (as on Leopard) the readline config is
1855 # not run as the syntax for libedit is different.
1854 # not run as the syntax for libedit is different.
1856 if not readline.uses_libedit:
1855 if not readline.uses_libedit:
1857 for rlcommand in self.readline_parse_and_bind:
1856 for rlcommand in self.readline_parse_and_bind:
1858 #print "loading rl:",rlcommand # dbg
1857 #print "loading rl:",rlcommand # dbg
1859 readline.parse_and_bind(rlcommand)
1858 readline.parse_and_bind(rlcommand)
1860
1859
1861 # Remove some chars from the delimiters list. If we encounter
1860 # Remove some chars from the delimiters list. If we encounter
1862 # unicode chars, discard them.
1861 # unicode chars, discard them.
1863 delims = readline.get_completer_delims()
1862 delims = readline.get_completer_delims()
1864 if not py3compat.PY3:
1863 if not py3compat.PY3:
1865 delims = delims.encode("ascii", "ignore")
1864 delims = delims.encode("ascii", "ignore")
1866 for d in self.readline_remove_delims:
1865 for d in self.readline_remove_delims:
1867 delims = delims.replace(d, "")
1866 delims = delims.replace(d, "")
1868 delims = delims.replace(ESC_MAGIC, '')
1867 delims = delims.replace(ESC_MAGIC, '')
1869 readline.set_completer_delims(delims)
1868 readline.set_completer_delims(delims)
1870 # Store these so we can restore them if something like rpy2 modifies
1869 # Store these so we can restore them if something like rpy2 modifies
1871 # them.
1870 # them.
1872 self.readline_delims = delims
1871 self.readline_delims = delims
1873 # otherwise we end up with a monster history after a while:
1872 # otherwise we end up with a monster history after a while:
1874 readline.set_history_length(self.history_length)
1873 readline.set_history_length(self.history_length)
1875
1874
1876 self.refill_readline_hist()
1875 self.refill_readline_hist()
1877 self.readline_no_record = ReadlineNoRecord(self)
1876 self.readline_no_record = ReadlineNoRecord(self)
1878
1877
1879 # Configure auto-indent for all platforms
1878 # Configure auto-indent for all platforms
1880 self.set_autoindent(self.autoindent)
1879 self.set_autoindent(self.autoindent)
1881
1880
1882 def refill_readline_hist(self):
1881 def refill_readline_hist(self):
1883 # Load the last 1000 lines from history
1882 # Load the last 1000 lines from history
1884 self.readline.clear_history()
1883 self.readline.clear_history()
1885 stdin_encoding = sys.stdin.encoding or "utf-8"
1884 stdin_encoding = sys.stdin.encoding or "utf-8"
1886 last_cell = u""
1885 last_cell = u""
1887 for _, _, cell in self.history_manager.get_tail(1000,
1886 for _, _, cell in self.history_manager.get_tail(1000,
1888 include_latest=True):
1887 include_latest=True):
1889 # Ignore blank lines and consecutive duplicates
1888 # Ignore blank lines and consecutive duplicates
1890 cell = cell.rstrip()
1889 cell = cell.rstrip()
1891 if cell and (cell != last_cell):
1890 if cell and (cell != last_cell):
1892 if self.multiline_history:
1891 if self.multiline_history:
1893 self.readline.add_history(py3compat.unicode_to_str(cell,
1892 self.readline.add_history(py3compat.unicode_to_str(cell,
1894 stdin_encoding))
1893 stdin_encoding))
1895 else:
1894 else:
1896 for line in cell.splitlines():
1895 for line in cell.splitlines():
1897 self.readline.add_history(py3compat.unicode_to_str(line,
1896 self.readline.add_history(py3compat.unicode_to_str(line,
1898 stdin_encoding))
1897 stdin_encoding))
1899 last_cell = cell
1898 last_cell = cell
1900
1899
1901 def set_next_input(self, s):
1900 def set_next_input(self, s):
1902 """ Sets the 'default' input string for the next command line.
1901 """ Sets the 'default' input string for the next command line.
1903
1902
1904 Requires readline.
1903 Requires readline.
1905
1904
1906 Example:
1905 Example:
1907
1906
1908 [D:\ipython]|1> _ip.set_next_input("Hello Word")
1907 [D:\ipython]|1> _ip.set_next_input("Hello Word")
1909 [D:\ipython]|2> Hello Word_ # cursor is here
1908 [D:\ipython]|2> Hello Word_ # cursor is here
1910 """
1909 """
1911 self.rl_next_input = py3compat.cast_bytes_py2(s)
1910 self.rl_next_input = py3compat.cast_bytes_py2(s)
1912
1911
1913 # Maybe move this to the terminal subclass?
1912 # Maybe move this to the terminal subclass?
1914 def pre_readline(self):
1913 def pre_readline(self):
1915 """readline hook to be used at the start of each line.
1914 """readline hook to be used at the start of each line.
1916
1915
1917 Currently it handles auto-indent only."""
1916 Currently it handles auto-indent only."""
1918
1917
1919 if self.rl_do_indent:
1918 if self.rl_do_indent:
1920 self.readline.insert_text(self._indent_current_str())
1919 self.readline.insert_text(self._indent_current_str())
1921 if self.rl_next_input is not None:
1920 if self.rl_next_input is not None:
1922 self.readline.insert_text(self.rl_next_input)
1921 self.readline.insert_text(self.rl_next_input)
1923 self.rl_next_input = None
1922 self.rl_next_input = None
1924
1923
1925 def _indent_current_str(self):
1924 def _indent_current_str(self):
1926 """return the current level of indentation as a string"""
1925 """return the current level of indentation as a string"""
1927 return self.input_splitter.indent_spaces * ' '
1926 return self.input_splitter.indent_spaces * ' '
1928
1927
1929 #-------------------------------------------------------------------------
1928 #-------------------------------------------------------------------------
1930 # Things related to text completion
1929 # Things related to text completion
1931 #-------------------------------------------------------------------------
1930 #-------------------------------------------------------------------------
1932
1931
1933 def init_completer(self):
1932 def init_completer(self):
1934 """Initialize the completion machinery.
1933 """Initialize the completion machinery.
1935
1934
1936 This creates completion machinery that can be used by client code,
1935 This creates completion machinery that can be used by client code,
1937 either interactively in-process (typically triggered by the readline
1936 either interactively in-process (typically triggered by the readline
1938 library), programatically (such as in test suites) or out-of-prcess
1937 library), programatically (such as in test suites) or out-of-prcess
1939 (typically over the network by remote frontends).
1938 (typically over the network by remote frontends).
1940 """
1939 """
1941 from IPython.core.completer import IPCompleter
1940 from IPython.core.completer import IPCompleter
1942 from IPython.core.completerlib import (module_completer,
1941 from IPython.core.completerlib import (module_completer,
1943 magic_run_completer, cd_completer, reset_completer)
1942 magic_run_completer, cd_completer, reset_completer)
1944
1943
1945 self.Completer = IPCompleter(shell=self,
1944 self.Completer = IPCompleter(shell=self,
1946 namespace=self.user_ns,
1945 namespace=self.user_ns,
1947 global_namespace=self.user_global_ns,
1946 global_namespace=self.user_global_ns,
1948 alias_table=self.alias_manager.alias_table,
1947 alias_table=self.alias_manager.alias_table,
1949 use_readline=self.has_readline,
1948 use_readline=self.has_readline,
1950 config=self.config,
1949 config=self.config,
1951 )
1950 )
1952 self.configurables.append(self.Completer)
1951 self.configurables.append(self.Completer)
1953
1952
1954 # Add custom completers to the basic ones built into IPCompleter
1953 # Add custom completers to the basic ones built into IPCompleter
1955 sdisp = self.strdispatchers.get('complete_command', StrDispatch())
1954 sdisp = self.strdispatchers.get('complete_command', StrDispatch())
1956 self.strdispatchers['complete_command'] = sdisp
1955 self.strdispatchers['complete_command'] = sdisp
1957 self.Completer.custom_completers = sdisp
1956 self.Completer.custom_completers = sdisp
1958
1957
1959 self.set_hook('complete_command', module_completer, str_key = 'import')
1958 self.set_hook('complete_command', module_completer, str_key = 'import')
1960 self.set_hook('complete_command', module_completer, str_key = 'from')
1959 self.set_hook('complete_command', module_completer, str_key = 'from')
1961 self.set_hook('complete_command', magic_run_completer, str_key = '%run')
1960 self.set_hook('complete_command', magic_run_completer, str_key = '%run')
1962 self.set_hook('complete_command', cd_completer, str_key = '%cd')
1961 self.set_hook('complete_command', cd_completer, str_key = '%cd')
1963 self.set_hook('complete_command', reset_completer, str_key = '%reset')
1962 self.set_hook('complete_command', reset_completer, str_key = '%reset')
1964
1963
1965 # Only configure readline if we truly are using readline. IPython can
1964 # Only configure readline if we truly are using readline. IPython can
1966 # do tab-completion over the network, in GUIs, etc, where readline
1965 # do tab-completion over the network, in GUIs, etc, where readline
1967 # itself may be absent
1966 # itself may be absent
1968 if self.has_readline:
1967 if self.has_readline:
1969 self.set_readline_completer()
1968 self.set_readline_completer()
1970
1969
1971 def complete(self, text, line=None, cursor_pos=None):
1970 def complete(self, text, line=None, cursor_pos=None):
1972 """Return the completed text and a list of completions.
1971 """Return the completed text and a list of completions.
1973
1972
1974 Parameters
1973 Parameters
1975 ----------
1974 ----------
1976
1975
1977 text : string
1976 text : string
1978 A string of text to be completed on. It can be given as empty and
1977 A string of text to be completed on. It can be given as empty and
1979 instead a line/position pair are given. In this case, the
1978 instead a line/position pair are given. In this case, the
1980 completer itself will split the line like readline does.
1979 completer itself will split the line like readline does.
1981
1980
1982 line : string, optional
1981 line : string, optional
1983 The complete line that text is part of.
1982 The complete line that text is part of.
1984
1983
1985 cursor_pos : int, optional
1984 cursor_pos : int, optional
1986 The position of the cursor on the input line.
1985 The position of the cursor on the input line.
1987
1986
1988 Returns
1987 Returns
1989 -------
1988 -------
1990 text : string
1989 text : string
1991 The actual text that was completed.
1990 The actual text that was completed.
1992
1991
1993 matches : list
1992 matches : list
1994 A sorted list with all possible completions.
1993 A sorted list with all possible completions.
1995
1994
1996 The optional arguments allow the completion to take more context into
1995 The optional arguments allow the completion to take more context into
1997 account, and are part of the low-level completion API.
1996 account, and are part of the low-level completion API.
1998
1997
1999 This is a wrapper around the completion mechanism, similar to what
1998 This is a wrapper around the completion mechanism, similar to what
2000 readline does at the command line when the TAB key is hit. By
1999 readline does at the command line when the TAB key is hit. By
2001 exposing it as a method, it can be used by other non-readline
2000 exposing it as a method, it can be used by other non-readline
2002 environments (such as GUIs) for text completion.
2001 environments (such as GUIs) for text completion.
2003
2002
2004 Simple usage example:
2003 Simple usage example:
2005
2004
2006 In [1]: x = 'hello'
2005 In [1]: x = 'hello'
2007
2006
2008 In [2]: _ip.complete('x.l')
2007 In [2]: _ip.complete('x.l')
2009 Out[2]: ('x.l', ['x.ljust', 'x.lower', 'x.lstrip'])
2008 Out[2]: ('x.l', ['x.ljust', 'x.lower', 'x.lstrip'])
2010 """
2009 """
2011
2010
2012 # Inject names into __builtin__ so we can complete on the added names.
2011 # Inject names into __builtin__ so we can complete on the added names.
2013 with self.builtin_trap:
2012 with self.builtin_trap:
2014 return self.Completer.complete(text, line, cursor_pos)
2013 return self.Completer.complete(text, line, cursor_pos)
2015
2014
2016 def set_custom_completer(self, completer, pos=0):
2015 def set_custom_completer(self, completer, pos=0):
2017 """Adds a new custom completer function.
2016 """Adds a new custom completer function.
2018
2017
2019 The position argument (defaults to 0) is the index in the completers
2018 The position argument (defaults to 0) is the index in the completers
2020 list where you want the completer to be inserted."""
2019 list where you want the completer to be inserted."""
2021
2020
2022 newcomp = types.MethodType(completer,self.Completer)
2021 newcomp = types.MethodType(completer,self.Completer)
2023 self.Completer.matchers.insert(pos,newcomp)
2022 self.Completer.matchers.insert(pos,newcomp)
2024
2023
2025 def set_readline_completer(self):
2024 def set_readline_completer(self):
2026 """Reset readline's completer to be our own."""
2025 """Reset readline's completer to be our own."""
2027 self.readline.set_completer(self.Completer.rlcomplete)
2026 self.readline.set_completer(self.Completer.rlcomplete)
2028
2027
2029 def set_completer_frame(self, frame=None):
2028 def set_completer_frame(self, frame=None):
2030 """Set the frame of the completer."""
2029 """Set the frame of the completer."""
2031 if frame:
2030 if frame:
2032 self.Completer.namespace = frame.f_locals
2031 self.Completer.namespace = frame.f_locals
2033 self.Completer.global_namespace = frame.f_globals
2032 self.Completer.global_namespace = frame.f_globals
2034 else:
2033 else:
2035 self.Completer.namespace = self.user_ns
2034 self.Completer.namespace = self.user_ns
2036 self.Completer.global_namespace = self.user_global_ns
2035 self.Completer.global_namespace = self.user_global_ns
2037
2036
2038 #-------------------------------------------------------------------------
2037 #-------------------------------------------------------------------------
2039 # Things related to magics
2038 # Things related to magics
2040 #-------------------------------------------------------------------------
2039 #-------------------------------------------------------------------------
2041
2040
2042 def init_magics(self):
2041 def init_magics(self):
2043 from IPython.core import magics as m
2042 from IPython.core import magics as m
2044 self.magics_manager = magic.MagicsManager(shell=self,
2043 self.magics_manager = magic.MagicsManager(shell=self,
2045 confg=self.config,
2044 confg=self.config,
2046 user_magics=m.UserMagics(self))
2045 user_magics=m.UserMagics(self))
2047 self.configurables.append(self.magics_manager)
2046 self.configurables.append(self.magics_manager)
2048
2047
2049 # Expose as public API from the magics manager
2048 # Expose as public API from the magics manager
2050 self.register_magics = self.magics_manager.register
2049 self.register_magics = self.magics_manager.register
2051 self.register_magic_function = self.magics_manager.register_function
2050 self.register_magic_function = self.magics_manager.register_function
2052 self.define_magic = self.magics_manager.define_magic
2051 self.define_magic = self.magics_manager.define_magic
2053
2052
2054 self.register_magics(m.AutoMagics, m.BasicMagics, m.CodeMagics,
2053 self.register_magics(m.AutoMagics, m.BasicMagics, m.CodeMagics,
2055 m.ConfigMagics, m.DeprecatedMagics, m.DisplayMagics, m.ExecutionMagics,
2054 m.ConfigMagics, m.DeprecatedMagics, m.DisplayMagics, m.ExecutionMagics,
2056 m.ExtensionMagics, m.HistoryMagics, m.LoggingMagics,
2055 m.ExtensionMagics, m.HistoryMagics, m.LoggingMagics,
2057 m.NamespaceMagics, m.OSMagics, m.PylabMagics, m.ScriptMagics,
2056 m.NamespaceMagics, m.OSMagics, m.PylabMagics, m.ScriptMagics,
2058 )
2057 )
2059
2058
2060 # Register Magic Aliases
2059 # Register Magic Aliases
2061 mman = self.magics_manager
2060 mman = self.magics_manager
2062 mman.register_alias('ed', 'edit')
2061 mman.register_alias('ed', 'edit')
2063 mman.register_alias('hist', 'history')
2062 mman.register_alias('hist', 'history')
2064 mman.register_alias('rep', 'recall')
2063 mman.register_alias('rep', 'recall')
2065
2064
2066 # FIXME: Move the color initialization to the DisplayHook, which
2065 # FIXME: Move the color initialization to the DisplayHook, which
2067 # should be split into a prompt manager and displayhook. We probably
2066 # should be split into a prompt manager and displayhook. We probably
2068 # even need a centralize colors management object.
2067 # even need a centralize colors management object.
2069 self.magic('colors %s' % self.colors)
2068 self.magic('colors %s' % self.colors)
2070
2069
2071 def run_line_magic(self, magic_name, line):
2070 def run_line_magic(self, magic_name, line):
2072 """Execute the given line magic.
2071 """Execute the given line magic.
2073
2072
2074 Parameters
2073 Parameters
2075 ----------
2074 ----------
2076 magic_name : str
2075 magic_name : str
2077 Name of the desired magic function, without '%' prefix.
2076 Name of the desired magic function, without '%' prefix.
2078
2077
2079 line : str
2078 line : str
2080 The rest of the input line as a single string.
2079 The rest of the input line as a single string.
2081 """
2080 """
2082 fn = self.find_line_magic(magic_name)
2081 fn = self.find_line_magic(magic_name)
2083 if fn is None:
2082 if fn is None:
2084 cm = self.find_cell_magic(magic_name)
2083 cm = self.find_cell_magic(magic_name)
2085 etpl = "Line magic function `%%%s` not found%s."
2084 etpl = "Line magic function `%%%s` not found%s."
2086 extra = '' if cm is None else (' (But cell magic `%%%%%s` exists, '
2085 extra = '' if cm is None else (' (But cell magic `%%%%%s` exists, '
2087 'did you mean that instead?)' % magic_name )
2086 'did you mean that instead?)' % magic_name )
2088 error(etpl % (magic_name, extra))
2087 error(etpl % (magic_name, extra))
2089 else:
2088 else:
2090 # Note: this is the distance in the stack to the user's frame.
2089 # Note: this is the distance in the stack to the user's frame.
2091 # This will need to be updated if the internal calling logic gets
2090 # This will need to be updated if the internal calling logic gets
2092 # refactored, or else we'll be expanding the wrong variables.
2091 # refactored, or else we'll be expanding the wrong variables.
2093 stack_depth = 2
2092 stack_depth = 2
2094 magic_arg_s = self.var_expand(line, stack_depth)
2093 magic_arg_s = self.var_expand(line, stack_depth)
2095 # Put magic args in a list so we can call with f(*a) syntax
2094 # Put magic args in a list so we can call with f(*a) syntax
2096 args = [magic_arg_s]
2095 args = [magic_arg_s]
2097 kwargs = {}
2096 kwargs = {}
2098 # Grab local namespace if we need it:
2097 # Grab local namespace if we need it:
2099 if getattr(fn, "needs_local_scope", False):
2098 if getattr(fn, "needs_local_scope", False):
2100 kwargs['local_ns'] = sys._getframe(stack_depth).f_locals
2099 kwargs['local_ns'] = sys._getframe(stack_depth).f_locals
2101 with self.builtin_trap:
2100 with self.builtin_trap:
2102 result = fn(*args,**kwargs)
2101 result = fn(*args,**kwargs)
2103 return result
2102 return result
2104
2103
2105 def run_cell_magic(self, magic_name, line, cell):
2104 def run_cell_magic(self, magic_name, line, cell):
2106 """Execute the given cell magic.
2105 """Execute the given cell magic.
2107
2106
2108 Parameters
2107 Parameters
2109 ----------
2108 ----------
2110 magic_name : str
2109 magic_name : str
2111 Name of the desired magic function, without '%' prefix.
2110 Name of the desired magic function, without '%' prefix.
2112
2111
2113 line : str
2112 line : str
2114 The rest of the first input line as a single string.
2113 The rest of the first input line as a single string.
2115
2114
2116 cell : str
2115 cell : str
2117 The body of the cell as a (possibly multiline) string.
2116 The body of the cell as a (possibly multiline) string.
2118 """
2117 """
2119 fn = self.find_cell_magic(magic_name)
2118 fn = self.find_cell_magic(magic_name)
2120 if fn is None:
2119 if fn is None:
2121 lm = self.find_line_magic(magic_name)
2120 lm = self.find_line_magic(magic_name)
2122 etpl = "Cell magic function `%%%%%s` not found%s."
2121 etpl = "Cell magic function `%%%%%s` not found%s."
2123 extra = '' if lm is None else (' (But line magic `%%%s` exists, '
2122 extra = '' if lm is None else (' (But line magic `%%%s` exists, '
2124 'did you mean that instead?)' % magic_name )
2123 'did you mean that instead?)' % magic_name )
2125 error(etpl % (magic_name, extra))
2124 error(etpl % (magic_name, extra))
2126 else:
2125 else:
2127 # Note: this is the distance in the stack to the user's frame.
2126 # Note: this is the distance in the stack to the user's frame.
2128 # This will need to be updated if the internal calling logic gets
2127 # This will need to be updated if the internal calling logic gets
2129 # refactored, or else we'll be expanding the wrong variables.
2128 # refactored, or else we'll be expanding the wrong variables.
2130 stack_depth = 2
2129 stack_depth = 2
2131 magic_arg_s = self.var_expand(line, stack_depth)
2130 magic_arg_s = self.var_expand(line, stack_depth)
2132 with self.builtin_trap:
2131 with self.builtin_trap:
2133 result = fn(magic_arg_s, cell)
2132 result = fn(magic_arg_s, cell)
2134 return result
2133 return result
2135
2134
2136 def find_line_magic(self, magic_name):
2135 def find_line_magic(self, magic_name):
2137 """Find and return a line magic by name.
2136 """Find and return a line magic by name.
2138
2137
2139 Returns None if the magic isn't found."""
2138 Returns None if the magic isn't found."""
2140 return self.magics_manager.magics['line'].get(magic_name)
2139 return self.magics_manager.magics['line'].get(magic_name)
2141
2140
2142 def find_cell_magic(self, magic_name):
2141 def find_cell_magic(self, magic_name):
2143 """Find and return a cell magic by name.
2142 """Find and return a cell magic by name.
2144
2143
2145 Returns None if the magic isn't found."""
2144 Returns None if the magic isn't found."""
2146 return self.magics_manager.magics['cell'].get(magic_name)
2145 return self.magics_manager.magics['cell'].get(magic_name)
2147
2146
2148 def find_magic(self, magic_name, magic_kind='line'):
2147 def find_magic(self, magic_name, magic_kind='line'):
2149 """Find and return a magic of the given type by name.
2148 """Find and return a magic of the given type by name.
2150
2149
2151 Returns None if the magic isn't found."""
2150 Returns None if the magic isn't found."""
2152 return self.magics_manager.magics[magic_kind].get(magic_name)
2151 return self.magics_manager.magics[magic_kind].get(magic_name)
2153
2152
2154 def magic(self, arg_s):
2153 def magic(self, arg_s):
2155 """DEPRECATED. Use run_line_magic() instead.
2154 """DEPRECATED. Use run_line_magic() instead.
2156
2155
2157 Call a magic function by name.
2156 Call a magic function by name.
2158
2157
2159 Input: a string containing the name of the magic function to call and
2158 Input: a string containing the name of the magic function to call and
2160 any additional arguments to be passed to the magic.
2159 any additional arguments to be passed to the magic.
2161
2160
2162 magic('name -opt foo bar') is equivalent to typing at the ipython
2161 magic('name -opt foo bar') is equivalent to typing at the ipython
2163 prompt:
2162 prompt:
2164
2163
2165 In[1]: %name -opt foo bar
2164 In[1]: %name -opt foo bar
2166
2165
2167 To call a magic without arguments, simply use magic('name').
2166 To call a magic without arguments, simply use magic('name').
2168
2167
2169 This provides a proper Python function to call IPython's magics in any
2168 This provides a proper Python function to call IPython's magics in any
2170 valid Python code you can type at the interpreter, including loops and
2169 valid Python code you can type at the interpreter, including loops and
2171 compound statements.
2170 compound statements.
2172 """
2171 """
2173 # TODO: should we issue a loud deprecation warning here?
2172 # TODO: should we issue a loud deprecation warning here?
2174 magic_name, _, magic_arg_s = arg_s.partition(' ')
2173 magic_name, _, magic_arg_s = arg_s.partition(' ')
2175 magic_name = magic_name.lstrip(prefilter.ESC_MAGIC)
2174 magic_name = magic_name.lstrip(prefilter.ESC_MAGIC)
2176 return self.run_line_magic(magic_name, magic_arg_s)
2175 return self.run_line_magic(magic_name, magic_arg_s)
2177
2176
2178 #-------------------------------------------------------------------------
2177 #-------------------------------------------------------------------------
2179 # Things related to macros
2178 # Things related to macros
2180 #-------------------------------------------------------------------------
2179 #-------------------------------------------------------------------------
2181
2180
2182 def define_macro(self, name, themacro):
2181 def define_macro(self, name, themacro):
2183 """Define a new macro
2182 """Define a new macro
2184
2183
2185 Parameters
2184 Parameters
2186 ----------
2185 ----------
2187 name : str
2186 name : str
2188 The name of the macro.
2187 The name of the macro.
2189 themacro : str or Macro
2188 themacro : str or Macro
2190 The action to do upon invoking the macro. If a string, a new
2189 The action to do upon invoking the macro. If a string, a new
2191 Macro object is created by passing the string to it.
2190 Macro object is created by passing the string to it.
2192 """
2191 """
2193
2192
2194 from IPython.core import macro
2193 from IPython.core import macro
2195
2194
2196 if isinstance(themacro, basestring):
2195 if isinstance(themacro, basestring):
2197 themacro = macro.Macro(themacro)
2196 themacro = macro.Macro(themacro)
2198 if not isinstance(themacro, macro.Macro):
2197 if not isinstance(themacro, macro.Macro):
2199 raise ValueError('A macro must be a string or a Macro instance.')
2198 raise ValueError('A macro must be a string or a Macro instance.')
2200 self.user_ns[name] = themacro
2199 self.user_ns[name] = themacro
2201
2200
2202 #-------------------------------------------------------------------------
2201 #-------------------------------------------------------------------------
2203 # Things related to the running of system commands
2202 # Things related to the running of system commands
2204 #-------------------------------------------------------------------------
2203 #-------------------------------------------------------------------------
2205
2204
2206 def system_piped(self, cmd):
2205 def system_piped(self, cmd):
2207 """Call the given cmd in a subprocess, piping stdout/err
2206 """Call the given cmd in a subprocess, piping stdout/err
2208
2207
2209 Parameters
2208 Parameters
2210 ----------
2209 ----------
2211 cmd : str
2210 cmd : str
2212 Command to execute (can not end in '&', as background processes are
2211 Command to execute (can not end in '&', as background processes are
2213 not supported. Should not be a command that expects input
2212 not supported. Should not be a command that expects input
2214 other than simple text.
2213 other than simple text.
2215 """
2214 """
2216 if cmd.rstrip().endswith('&'):
2215 if cmd.rstrip().endswith('&'):
2217 # this is *far* from a rigorous test
2216 # this is *far* from a rigorous test
2218 # We do not support backgrounding processes because we either use
2217 # We do not support backgrounding processes because we either use
2219 # pexpect or pipes to read from. Users can always just call
2218 # pexpect or pipes to read from. Users can always just call
2220 # os.system() or use ip.system=ip.system_raw
2219 # os.system() or use ip.system=ip.system_raw
2221 # if they really want a background process.
2220 # if they really want a background process.
2222 raise OSError("Background processes not supported.")
2221 raise OSError("Background processes not supported.")
2223
2222
2224 # we explicitly do NOT return the subprocess status code, because
2223 # we explicitly do NOT return the subprocess status code, because
2225 # a non-None value would trigger :func:`sys.displayhook` calls.
2224 # a non-None value would trigger :func:`sys.displayhook` calls.
2226 # Instead, we store the exit_code in user_ns.
2225 # Instead, we store the exit_code in user_ns.
2227 self.user_ns['_exit_code'] = system(self.var_expand(cmd, depth=1))
2226 self.user_ns['_exit_code'] = system(self.var_expand(cmd, depth=1))
2228
2227
2229 def system_raw(self, cmd):
2228 def system_raw(self, cmd):
2230 """Call the given cmd in a subprocess using os.system
2229 """Call the given cmd in a subprocess using os.system
2231
2230
2232 Parameters
2231 Parameters
2233 ----------
2232 ----------
2234 cmd : str
2233 cmd : str
2235 Command to execute.
2234 Command to execute.
2236 """
2235 """
2237 cmd = self.var_expand(cmd, depth=1)
2236 cmd = self.var_expand(cmd, depth=1)
2238 # protect os.system from UNC paths on Windows, which it can't handle:
2237 # protect os.system from UNC paths on Windows, which it can't handle:
2239 if sys.platform == 'win32':
2238 if sys.platform == 'win32':
2240 from IPython.utils._process_win32 import AvoidUNCPath
2239 from IPython.utils._process_win32 import AvoidUNCPath
2241 with AvoidUNCPath() as path:
2240 with AvoidUNCPath() as path:
2242 if path is not None:
2241 if path is not None:
2243 cmd = '"pushd %s &&"%s' % (path, cmd)
2242 cmd = '"pushd %s &&"%s' % (path, cmd)
2244 cmd = py3compat.unicode_to_str(cmd)
2243 cmd = py3compat.unicode_to_str(cmd)
2245 ec = os.system(cmd)
2244 ec = os.system(cmd)
2246 else:
2245 else:
2247 cmd = py3compat.unicode_to_str(cmd)
2246 cmd = py3compat.unicode_to_str(cmd)
2248 ec = os.system(cmd)
2247 ec = os.system(cmd)
2249 # The high byte is the exit code, the low byte is a signal number
2248 # The high byte is the exit code, the low byte is a signal number
2250 # that we discard for now. See the docs for os.wait()
2249 # that we discard for now. See the docs for os.wait()
2251 if ec > 255:
2250 if ec > 255:
2252 ec >>= 8
2251 ec >>= 8
2253
2252
2254 # We explicitly do NOT return the subprocess status code, because
2253 # We explicitly do NOT return the subprocess status code, because
2255 # a non-None value would trigger :func:`sys.displayhook` calls.
2254 # a non-None value would trigger :func:`sys.displayhook` calls.
2256 # Instead, we store the exit_code in user_ns.
2255 # Instead, we store the exit_code in user_ns.
2257 self.user_ns['_exit_code'] = ec
2256 self.user_ns['_exit_code'] = ec
2258
2257
2259 # use piped system by default, because it is better behaved
2258 # use piped system by default, because it is better behaved
2260 system = system_piped
2259 system = system_piped
2261
2260
2262 def getoutput(self, cmd, split=True, depth=0):
2261 def getoutput(self, cmd, split=True, depth=0):
2263 """Get output (possibly including stderr) from a subprocess.
2262 """Get output (possibly including stderr) from a subprocess.
2264
2263
2265 Parameters
2264 Parameters
2266 ----------
2265 ----------
2267 cmd : str
2266 cmd : str
2268 Command to execute (can not end in '&', as background processes are
2267 Command to execute (can not end in '&', as background processes are
2269 not supported.
2268 not supported.
2270 split : bool, optional
2269 split : bool, optional
2271 If True, split the output into an IPython SList. Otherwise, an
2270 If True, split the output into an IPython SList. Otherwise, an
2272 IPython LSString is returned. These are objects similar to normal
2271 IPython LSString is returned. These are objects similar to normal
2273 lists and strings, with a few convenience attributes for easier
2272 lists and strings, with a few convenience attributes for easier
2274 manipulation of line-based output. You can use '?' on them for
2273 manipulation of line-based output. You can use '?' on them for
2275 details.
2274 details.
2276 depth : int, optional
2275 depth : int, optional
2277 How many frames above the caller are the local variables which should
2276 How many frames above the caller are the local variables which should
2278 be expanded in the command string? The default (0) assumes that the
2277 be expanded in the command string? The default (0) assumes that the
2279 expansion variables are in the stack frame calling this function.
2278 expansion variables are in the stack frame calling this function.
2280 """
2279 """
2281 if cmd.rstrip().endswith('&'):
2280 if cmd.rstrip().endswith('&'):
2282 # this is *far* from a rigorous test
2281 # this is *far* from a rigorous test
2283 raise OSError("Background processes not supported.")
2282 raise OSError("Background processes not supported.")
2284 out = getoutput(self.var_expand(cmd, depth=depth+1))
2283 out = getoutput(self.var_expand(cmd, depth=depth+1))
2285 if split:
2284 if split:
2286 out = SList(out.splitlines())
2285 out = SList(out.splitlines())
2287 else:
2286 else:
2288 out = LSString(out)
2287 out = LSString(out)
2289 return out
2288 return out
2290
2289
2291 #-------------------------------------------------------------------------
2290 #-------------------------------------------------------------------------
2292 # Things related to aliases
2291 # Things related to aliases
2293 #-------------------------------------------------------------------------
2292 #-------------------------------------------------------------------------
2294
2293
2295 def init_alias(self):
2294 def init_alias(self):
2296 self.alias_manager = AliasManager(shell=self, config=self.config)
2295 self.alias_manager = AliasManager(shell=self, config=self.config)
2297 self.configurables.append(self.alias_manager)
2296 self.configurables.append(self.alias_manager)
2298 self.ns_table['alias'] = self.alias_manager.alias_table,
2297 self.ns_table['alias'] = self.alias_manager.alias_table,
2299
2298
2300 #-------------------------------------------------------------------------
2299 #-------------------------------------------------------------------------
2301 # Things related to extensions
2300 # Things related to extensions
2302 #-------------------------------------------------------------------------
2301 #-------------------------------------------------------------------------
2303
2302
2304 def init_extension_manager(self):
2303 def init_extension_manager(self):
2305 self.extension_manager = ExtensionManager(shell=self, config=self.config)
2304 self.extension_manager = ExtensionManager(shell=self, config=self.config)
2306 self.configurables.append(self.extension_manager)
2305 self.configurables.append(self.extension_manager)
2307
2306
2308 #-------------------------------------------------------------------------
2307 #-------------------------------------------------------------------------
2309 # Things related to payloads
2308 # Things related to payloads
2310 #-------------------------------------------------------------------------
2309 #-------------------------------------------------------------------------
2311
2310
2312 def init_payload(self):
2311 def init_payload(self):
2313 self.payload_manager = PayloadManager(config=self.config)
2312 self.payload_manager = PayloadManager(config=self.config)
2314 self.configurables.append(self.payload_manager)
2313 self.configurables.append(self.payload_manager)
2315
2314
2316 #-------------------------------------------------------------------------
2315 #-------------------------------------------------------------------------
2317 # Things related to the prefilter
2316 # Things related to the prefilter
2318 #-------------------------------------------------------------------------
2317 #-------------------------------------------------------------------------
2319
2318
2320 def init_prefilter(self):
2319 def init_prefilter(self):
2321 self.prefilter_manager = PrefilterManager(shell=self, config=self.config)
2320 self.prefilter_manager = PrefilterManager(shell=self, config=self.config)
2322 self.configurables.append(self.prefilter_manager)
2321 self.configurables.append(self.prefilter_manager)
2323 # Ultimately this will be refactored in the new interpreter code, but
2322 # Ultimately this will be refactored in the new interpreter code, but
2324 # for now, we should expose the main prefilter method (there's legacy
2323 # for now, we should expose the main prefilter method (there's legacy
2325 # code out there that may rely on this).
2324 # code out there that may rely on this).
2326 self.prefilter = self.prefilter_manager.prefilter_lines
2325 self.prefilter = self.prefilter_manager.prefilter_lines
2327
2326
2328 def auto_rewrite_input(self, cmd):
2327 def auto_rewrite_input(self, cmd):
2329 """Print to the screen the rewritten form of the user's command.
2328 """Print to the screen the rewritten form of the user's command.
2330
2329
2331 This shows visual feedback by rewriting input lines that cause
2330 This shows visual feedback by rewriting input lines that cause
2332 automatic calling to kick in, like::
2331 automatic calling to kick in, like::
2333
2332
2334 /f x
2333 /f x
2335
2334
2336 into::
2335 into::
2337
2336
2338 ------> f(x)
2337 ------> f(x)
2339
2338
2340 after the user's input prompt. This helps the user understand that the
2339 after the user's input prompt. This helps the user understand that the
2341 input line was transformed automatically by IPython.
2340 input line was transformed automatically by IPython.
2342 """
2341 """
2343 if not self.show_rewritten_input:
2342 if not self.show_rewritten_input:
2344 return
2343 return
2345
2344
2346 rw = self.prompt_manager.render('rewrite') + cmd
2345 rw = self.prompt_manager.render('rewrite') + cmd
2347
2346
2348 try:
2347 try:
2349 # plain ascii works better w/ pyreadline, on some machines, so
2348 # plain ascii works better w/ pyreadline, on some machines, so
2350 # we use it and only print uncolored rewrite if we have unicode
2349 # we use it and only print uncolored rewrite if we have unicode
2351 rw = str(rw)
2350 rw = str(rw)
2352 print(rw, file=io.stdout)
2351 print(rw, file=io.stdout)
2353 except UnicodeEncodeError:
2352 except UnicodeEncodeError:
2354 print("------> " + cmd)
2353 print("------> " + cmd)
2355
2354
2356 #-------------------------------------------------------------------------
2355 #-------------------------------------------------------------------------
2357 # Things related to extracting values/expressions from kernel and user_ns
2356 # Things related to extracting values/expressions from kernel and user_ns
2358 #-------------------------------------------------------------------------
2357 #-------------------------------------------------------------------------
2359
2358
2360 def _simple_error(self):
2359 def _simple_error(self):
2361 etype, value = sys.exc_info()[:2]
2360 etype, value = sys.exc_info()[:2]
2362 return u'[ERROR] {e.__name__}: {v}'.format(e=etype, v=value)
2361 return u'[ERROR] {e.__name__}: {v}'.format(e=etype, v=value)
2363
2362
2364 def user_variables(self, names):
2363 def user_variables(self, names):
2365 """Get a list of variable names from the user's namespace.
2364 """Get a list of variable names from the user's namespace.
2366
2365
2367 Parameters
2366 Parameters
2368 ----------
2367 ----------
2369 names : list of strings
2368 names : list of strings
2370 A list of names of variables to be read from the user namespace.
2369 A list of names of variables to be read from the user namespace.
2371
2370
2372 Returns
2371 Returns
2373 -------
2372 -------
2374 A dict, keyed by the input names and with the repr() of each value.
2373 A dict, keyed by the input names and with the repr() of each value.
2375 """
2374 """
2376 out = {}
2375 out = {}
2377 user_ns = self.user_ns
2376 user_ns = self.user_ns
2378 for varname in names:
2377 for varname in names:
2379 try:
2378 try:
2380 value = repr(user_ns[varname])
2379 value = repr(user_ns[varname])
2381 except:
2380 except:
2382 value = self._simple_error()
2381 value = self._simple_error()
2383 out[varname] = value
2382 out[varname] = value
2384 return out
2383 return out
2385
2384
2386 def user_expressions(self, expressions):
2385 def user_expressions(self, expressions):
2387 """Evaluate a dict of expressions in the user's namespace.
2386 """Evaluate a dict of expressions in the user's namespace.
2388
2387
2389 Parameters
2388 Parameters
2390 ----------
2389 ----------
2391 expressions : dict
2390 expressions : dict
2392 A dict with string keys and string values. The expression values
2391 A dict with string keys and string values. The expression values
2393 should be valid Python expressions, each of which will be evaluated
2392 should be valid Python expressions, each of which will be evaluated
2394 in the user namespace.
2393 in the user namespace.
2395
2394
2396 Returns
2395 Returns
2397 -------
2396 -------
2398 A dict, keyed like the input expressions dict, with the repr() of each
2397 A dict, keyed like the input expressions dict, with the repr() of each
2399 value.
2398 value.
2400 """
2399 """
2401 out = {}
2400 out = {}
2402 user_ns = self.user_ns
2401 user_ns = self.user_ns
2403 global_ns = self.user_global_ns
2402 global_ns = self.user_global_ns
2404 for key, expr in expressions.iteritems():
2403 for key, expr in expressions.iteritems():
2405 try:
2404 try:
2406 value = repr(eval(expr, global_ns, user_ns))
2405 value = repr(eval(expr, global_ns, user_ns))
2407 except:
2406 except:
2408 value = self._simple_error()
2407 value = self._simple_error()
2409 out[key] = value
2408 out[key] = value
2410 return out
2409 return out
2411
2410
2412 #-------------------------------------------------------------------------
2411 #-------------------------------------------------------------------------
2413 # Things related to the running of code
2412 # Things related to the running of code
2414 #-------------------------------------------------------------------------
2413 #-------------------------------------------------------------------------
2415
2414
2416 def ex(self, cmd):
2415 def ex(self, cmd):
2417 """Execute a normal python statement in user namespace."""
2416 """Execute a normal python statement in user namespace."""
2418 with self.builtin_trap:
2417 with self.builtin_trap:
2419 exec cmd in self.user_global_ns, self.user_ns
2418 exec cmd in self.user_global_ns, self.user_ns
2420
2419
2421 def ev(self, expr):
2420 def ev(self, expr):
2422 """Evaluate python expression expr in user namespace.
2421 """Evaluate python expression expr in user namespace.
2423
2422
2424 Returns the result of evaluation
2423 Returns the result of evaluation
2425 """
2424 """
2426 with self.builtin_trap:
2425 with self.builtin_trap:
2427 return eval(expr, self.user_global_ns, self.user_ns)
2426 return eval(expr, self.user_global_ns, self.user_ns)
2428
2427
2429 def safe_execfile(self, fname, *where, **kw):
2428 def safe_execfile(self, fname, *where, **kw):
2430 """A safe version of the builtin execfile().
2429 """A safe version of the builtin execfile().
2431
2430
2432 This version will never throw an exception, but instead print
2431 This version will never throw an exception, but instead print
2433 helpful error messages to the screen. This only works on pure
2432 helpful error messages to the screen. This only works on pure
2434 Python files with the .py extension.
2433 Python files with the .py extension.
2435
2434
2436 Parameters
2435 Parameters
2437 ----------
2436 ----------
2438 fname : string
2437 fname : string
2439 The name of the file to be executed.
2438 The name of the file to be executed.
2440 where : tuple
2439 where : tuple
2441 One or two namespaces, passed to execfile() as (globals,locals).
2440 One or two namespaces, passed to execfile() as (globals,locals).
2442 If only one is given, it is passed as both.
2441 If only one is given, it is passed as both.
2443 exit_ignore : bool (False)
2442 exit_ignore : bool (False)
2444 If True, then silence SystemExit for non-zero status (it is always
2443 If True, then silence SystemExit for non-zero status (it is always
2445 silenced for zero status, as it is so common).
2444 silenced for zero status, as it is so common).
2446 raise_exceptions : bool (False)
2445 raise_exceptions : bool (False)
2447 If True raise exceptions everywhere. Meant for testing.
2446 If True raise exceptions everywhere. Meant for testing.
2448
2447
2449 """
2448 """
2450 kw.setdefault('exit_ignore', False)
2449 kw.setdefault('exit_ignore', False)
2451 kw.setdefault('raise_exceptions', False)
2450 kw.setdefault('raise_exceptions', False)
2452
2451
2453 fname = os.path.abspath(os.path.expanduser(fname))
2452 fname = os.path.abspath(os.path.expanduser(fname))
2454
2453
2455 # Make sure we can open the file
2454 # Make sure we can open the file
2456 try:
2455 try:
2457 with open(fname) as thefile:
2456 with open(fname) as thefile:
2458 pass
2457 pass
2459 except:
2458 except:
2460 warn('Could not open file <%s> for safe execution.' % fname)
2459 warn('Could not open file <%s> for safe execution.' % fname)
2461 return
2460 return
2462
2461
2463 # Find things also in current directory. This is needed to mimic the
2462 # Find things also in current directory. This is needed to mimic the
2464 # behavior of running a script from the system command line, where
2463 # behavior of running a script from the system command line, where
2465 # Python inserts the script's directory into sys.path
2464 # Python inserts the script's directory into sys.path
2466 dname = os.path.dirname(fname)
2465 dname = os.path.dirname(fname)
2467
2466
2468 with prepended_to_syspath(dname):
2467 with prepended_to_syspath(dname):
2469 try:
2468 try:
2470 py3compat.execfile(fname,*where)
2469 py3compat.execfile(fname,*where)
2471 except SystemExit as status:
2470 except SystemExit as status:
2472 # If the call was made with 0 or None exit status (sys.exit(0)
2471 # If the call was made with 0 or None exit status (sys.exit(0)
2473 # or sys.exit() ), don't bother showing a traceback, as both of
2472 # or sys.exit() ), don't bother showing a traceback, as both of
2474 # these are considered normal by the OS:
2473 # these are considered normal by the OS:
2475 # > python -c'import sys;sys.exit(0)'; echo $?
2474 # > python -c'import sys;sys.exit(0)'; echo $?
2476 # 0
2475 # 0
2477 # > python -c'import sys;sys.exit()'; echo $?
2476 # > python -c'import sys;sys.exit()'; echo $?
2478 # 0
2477 # 0
2479 # For other exit status, we show the exception unless
2478 # For other exit status, we show the exception unless
2480 # explicitly silenced, but only in short form.
2479 # explicitly silenced, but only in short form.
2481 if kw['raise_exceptions']:
2480 if kw['raise_exceptions']:
2482 raise
2481 raise
2483 if status.code not in (0, None) and not kw['exit_ignore']:
2482 if status.code not in (0, None) and not kw['exit_ignore']:
2484 self.showtraceback(exception_only=True)
2483 self.showtraceback(exception_only=True)
2485 except:
2484 except:
2486 if kw['raise_exceptions']:
2485 if kw['raise_exceptions']:
2487 raise
2486 raise
2488 self.showtraceback()
2487 self.showtraceback()
2489
2488
2490 def safe_execfile_ipy(self, fname):
2489 def safe_execfile_ipy(self, fname):
2491 """Like safe_execfile, but for .ipy files with IPython syntax.
2490 """Like safe_execfile, but for .ipy files with IPython syntax.
2492
2491
2493 Parameters
2492 Parameters
2494 ----------
2493 ----------
2495 fname : str
2494 fname : str
2496 The name of the file to execute. The filename must have a
2495 The name of the file to execute. The filename must have a
2497 .ipy extension.
2496 .ipy extension.
2498 """
2497 """
2499 fname = os.path.abspath(os.path.expanduser(fname))
2498 fname = os.path.abspath(os.path.expanduser(fname))
2500
2499
2501 # Make sure we can open the file
2500 # Make sure we can open the file
2502 try:
2501 try:
2503 with open(fname) as thefile:
2502 with open(fname) as thefile:
2504 pass
2503 pass
2505 except:
2504 except:
2506 warn('Could not open file <%s> for safe execution.' % fname)
2505 warn('Could not open file <%s> for safe execution.' % fname)
2507 return
2506 return
2508
2507
2509 # Find things also in current directory. This is needed to mimic the
2508 # Find things also in current directory. This is needed to mimic the
2510 # behavior of running a script from the system command line, where
2509 # behavior of running a script from the system command line, where
2511 # Python inserts the script's directory into sys.path
2510 # Python inserts the script's directory into sys.path
2512 dname = os.path.dirname(fname)
2511 dname = os.path.dirname(fname)
2513
2512
2514 with prepended_to_syspath(dname):
2513 with prepended_to_syspath(dname):
2515 try:
2514 try:
2516 with open(fname) as thefile:
2515 with open(fname) as thefile:
2517 # self.run_cell currently captures all exceptions
2516 # self.run_cell currently captures all exceptions
2518 # raised in user code. It would be nice if there were
2517 # raised in user code. It would be nice if there were
2519 # versions of runlines, execfile that did raise, so
2518 # versions of runlines, execfile that did raise, so
2520 # we could catch the errors.
2519 # we could catch the errors.
2521 self.run_cell(thefile.read(), store_history=False)
2520 self.run_cell(thefile.read(), store_history=False, shell_futures=False)
2522 except:
2521 except:
2523 self.showtraceback()
2522 self.showtraceback()
2524 warn('Unknown failure executing file: <%s>' % fname)
2523 warn('Unknown failure executing file: <%s>' % fname)
2525
2524
2526 def safe_run_module(self, mod_name, where):
2525 def safe_run_module(self, mod_name, where):
2527 """A safe version of runpy.run_module().
2526 """A safe version of runpy.run_module().
2528
2527
2529 This version will never throw an exception, but instead print
2528 This version will never throw an exception, but instead print
2530 helpful error messages to the screen.
2529 helpful error messages to the screen.
2531
2530
2532 Parameters
2531 Parameters
2533 ----------
2532 ----------
2534 mod_name : string
2533 mod_name : string
2535 The name of the module to be executed.
2534 The name of the module to be executed.
2536 where : dict
2535 where : dict
2537 The globals namespace.
2536 The globals namespace.
2538 """
2537 """
2539 try:
2538 try:
2540 where.update(
2539 where.update(
2541 runpy.run_module(str(mod_name), run_name="__main__",
2540 runpy.run_module(str(mod_name), run_name="__main__",
2542 alter_sys=True)
2541 alter_sys=True)
2543 )
2542 )
2544 except:
2543 except:
2545 self.showtraceback()
2544 self.showtraceback()
2546 warn('Unknown failure executing module: <%s>' % mod_name)
2545 warn('Unknown failure executing module: <%s>' % mod_name)
2547
2546
2548 def _run_cached_cell_magic(self, magic_name, line):
2547 def _run_cached_cell_magic(self, magic_name, line):
2549 """Special method to call a cell magic with the data stored in self.
2548 """Special method to call a cell magic with the data stored in self.
2550 """
2549 """
2551 cell = self._current_cell_magic_body
2550 cell = self._current_cell_magic_body
2552 self._current_cell_magic_body = None
2551 self._current_cell_magic_body = None
2553 return self.run_cell_magic(magic_name, line, cell)
2552 return self.run_cell_magic(magic_name, line, cell)
2554
2553
2555 def run_cell(self, raw_cell, store_history=False, silent=False):
2554 def run_cell(self, raw_cell, store_history=False, silent=False, shell_futures=True):
2556 """Run a complete IPython cell.
2555 """Run a complete IPython cell.
2557
2556
2558 Parameters
2557 Parameters
2559 ----------
2558 ----------
2560 raw_cell : str
2559 raw_cell : str
2561 The code (including IPython code such as %magic functions) to run.
2560 The code (including IPython code such as %magic functions) to run.
2562 store_history : bool
2561 store_history : bool
2563 If True, the raw and translated cell will be stored in IPython's
2562 If True, the raw and translated cell will be stored in IPython's
2564 history. For user code calling back into IPython's machinery, this
2563 history. For user code calling back into IPython's machinery, this
2565 should be set to False.
2564 should be set to False.
2566 silent : bool
2565 silent : bool
2567 If True, avoid side-effects, such as implicit displayhooks and
2566 If True, avoid side-effects, such as implicit displayhooks and
2568 and logging. silent=True forces store_history=False.
2567 and logging. silent=True forces store_history=False.
2568 shell_futures : bool
2569 If True, the code will share future statements with the interactive
2570 shell. It will both be affected by previous __future__ imports, and
2571 any __future__ imports in the code will affect the shell. If False,
2572 __future__ imports are not shared in either direction.
2569 """
2573 """
2570 if (not raw_cell) or raw_cell.isspace():
2574 if (not raw_cell) or raw_cell.isspace():
2571 return
2575 return
2572
2576
2573 if silent:
2577 if silent:
2574 store_history = False
2578 store_history = False
2575
2579
2576 self.input_splitter.push(raw_cell)
2580 self.input_splitter.push(raw_cell)
2577
2581
2578 # Check for cell magics, which leave state behind. This interface is
2582 # Check for cell magics, which leave state behind. This interface is
2579 # ugly, we need to do something cleaner later... Now the logic is
2583 # ugly, we need to do something cleaner later... Now the logic is
2580 # simply that the input_splitter remembers if there was a cell magic,
2584 # simply that the input_splitter remembers if there was a cell magic,
2581 # and in that case we grab the cell body.
2585 # and in that case we grab the cell body.
2582 if self.input_splitter.cell_magic_parts:
2586 if self.input_splitter.cell_magic_parts:
2583 self._current_cell_magic_body = \
2587 self._current_cell_magic_body = \
2584 ''.join(self.input_splitter.cell_magic_parts)
2588 ''.join(self.input_splitter.cell_magic_parts)
2585 cell = self.input_splitter.source_reset()
2589 cell = self.input_splitter.source_reset()
2590
2591 # Our own compiler remembers the __future__ environment. If we want to
2592 # run code with a separate __future__ environment, use the default
2593 # compiler
2594 compiler = self.compile if shell_futures else CachingCompiler()
2586
2595
2587 with self.builtin_trap:
2596 with self.builtin_trap:
2588 prefilter_failed = False
2597 prefilter_failed = False
2589 if len(cell.splitlines()) == 1:
2598 if len(cell.splitlines()) == 1:
2590 try:
2599 try:
2591 # use prefilter_lines to handle trailing newlines
2600 # use prefilter_lines to handle trailing newlines
2592 # restore trailing newline for ast.parse
2601 # restore trailing newline for ast.parse
2593 cell = self.prefilter_manager.prefilter_lines(cell) + '\n'
2602 cell = self.prefilter_manager.prefilter_lines(cell) + '\n'
2594 except AliasError as e:
2603 except AliasError as e:
2595 error(e)
2604 error(e)
2596 prefilter_failed = True
2605 prefilter_failed = True
2597 except Exception:
2606 except Exception:
2598 # don't allow prefilter errors to crash IPython
2607 # don't allow prefilter errors to crash IPython
2599 self.showtraceback()
2608 self.showtraceback()
2600 prefilter_failed = True
2609 prefilter_failed = True
2601
2610
2602 # Store raw and processed history
2611 # Store raw and processed history
2603 if store_history:
2612 if store_history:
2604 self.history_manager.store_inputs(self.execution_count,
2613 self.history_manager.store_inputs(self.execution_count,
2605 cell, raw_cell)
2614 cell, raw_cell)
2606 if not silent:
2615 if not silent:
2607 self.logger.log(cell, raw_cell)
2616 self.logger.log(cell, raw_cell)
2608
2617
2609 if not prefilter_failed:
2618 if not prefilter_failed:
2610 # don't run if prefilter failed
2619 # don't run if prefilter failed
2611 cell_name = self.compile.cache(cell, self.execution_count)
2620 cell_name = self.compile.cache(cell, self.execution_count)
2612
2621
2613 with self.display_trap:
2622 with self.display_trap:
2614 try:
2623 try:
2615 code_ast = self.compile.ast_parse(cell,
2624 code_ast = compiler.ast_parse(cell, filename=cell_name)
2616 filename=cell_name)
2617 except IndentationError:
2625 except IndentationError:
2618 self.showindentationerror()
2626 self.showindentationerror()
2619 if store_history:
2627 if store_history:
2620 self.execution_count += 1
2628 self.execution_count += 1
2621 return None
2629 return None
2622 except (OverflowError, SyntaxError, ValueError, TypeError,
2630 except (OverflowError, SyntaxError, ValueError, TypeError,
2623 MemoryError):
2631 MemoryError):
2624 self.showsyntaxerror()
2632 self.showsyntaxerror()
2625 if store_history:
2633 if store_history:
2626 self.execution_count += 1
2634 self.execution_count += 1
2627 return None
2635 return None
2628
2636
2629 code_ast = self.transform_ast(code_ast)
2637 code_ast = self.transform_ast(code_ast)
2630
2638
2631 interactivity = "none" if silent else self.ast_node_interactivity
2639 interactivity = "none" if silent else self.ast_node_interactivity
2632 self.run_ast_nodes(code_ast.body, cell_name,
2640 self.run_ast_nodes(code_ast.body, cell_name,
2633 interactivity=interactivity)
2641 interactivity=interactivity, compiler=compiler)
2634
2642
2635 # Execute any registered post-execution functions.
2643 # Execute any registered post-execution functions.
2636 # unless we are silent
2644 # unless we are silent
2637 post_exec = [] if silent else self._post_execute.iteritems()
2645 post_exec = [] if silent else self._post_execute.iteritems()
2638
2646
2639 for func, status in post_exec:
2647 for func, status in post_exec:
2640 if self.disable_failing_post_execute and not status:
2648 if self.disable_failing_post_execute and not status:
2641 continue
2649 continue
2642 try:
2650 try:
2643 func()
2651 func()
2644 except KeyboardInterrupt:
2652 except KeyboardInterrupt:
2645 print("\nKeyboardInterrupt", file=io.stderr)
2653 print("\nKeyboardInterrupt", file=io.stderr)
2646 except Exception:
2654 except Exception:
2647 # register as failing:
2655 # register as failing:
2648 self._post_execute[func] = False
2656 self._post_execute[func] = False
2649 self.showtraceback()
2657 self.showtraceback()
2650 print('\n'.join([
2658 print('\n'.join([
2651 "post-execution function %r produced an error." % func,
2659 "post-execution function %r produced an error." % func,
2652 "If this problem persists, you can disable failing post-exec functions with:",
2660 "If this problem persists, you can disable failing post-exec functions with:",
2653 "",
2661 "",
2654 " get_ipython().disable_failing_post_execute = True"
2662 " get_ipython().disable_failing_post_execute = True"
2655 ]), file=io.stderr)
2663 ]), file=io.stderr)
2656
2664
2657 if store_history:
2665 if store_history:
2658 # Write output to the database. Does nothing unless
2666 # Write output to the database. Does nothing unless
2659 # history output logging is enabled.
2667 # history output logging is enabled.
2660 self.history_manager.store_output(self.execution_count)
2668 self.history_manager.store_output(self.execution_count)
2661 # Each cell is a *single* input, regardless of how many lines it has
2669 # Each cell is a *single* input, regardless of how many lines it has
2662 self.execution_count += 1
2670 self.execution_count += 1
2663
2671
2664 def transform_ast(self, node):
2672 def transform_ast(self, node):
2665 """Apply the AST transformations from self.ast_transformers
2673 """Apply the AST transformations from self.ast_transformers
2666
2674
2667 Parameters
2675 Parameters
2668 ----------
2676 ----------
2669 node : ast.Node
2677 node : ast.Node
2670 The root node to be transformed. Typically called with the ast.Module
2678 The root node to be transformed. Typically called with the ast.Module
2671 produced by parsing user input.
2679 produced by parsing user input.
2672
2680
2673 Returns
2681 Returns
2674 -------
2682 -------
2675 An ast.Node corresponding to the node it was called with. Note that it
2683 An ast.Node corresponding to the node it was called with. Note that it
2676 may also modify the passed object, so don't rely on references to the
2684 may also modify the passed object, so don't rely on references to the
2677 original AST.
2685 original AST.
2678 """
2686 """
2679 for transformer in self.ast_transformers:
2687 for transformer in self.ast_transformers:
2680 try:
2688 try:
2681 node = transformer.visit(node)
2689 node = transformer.visit(node)
2682 except Exception:
2690 except Exception:
2683 warn("AST transformer %r threw an error. It will be unregistered." % transformer)
2691 warn("AST transformer %r threw an error. It will be unregistered." % transformer)
2684 self.ast_transformers.remove(transformer)
2692 self.ast_transformers.remove(transformer)
2685
2693
2686 return ast.fix_missing_locations(node)
2694 return ast.fix_missing_locations(node)
2687
2695
2688
2696
2689 def run_ast_nodes(self, nodelist, cell_name, interactivity='last_expr'):
2697 def run_ast_nodes(self, nodelist, cell_name, interactivity='last_expr',
2698 compiler=compile):
2690 """Run a sequence of AST nodes. The execution mode depends on the
2699 """Run a sequence of AST nodes. The execution mode depends on the
2691 interactivity parameter.
2700 interactivity parameter.
2692
2701
2693 Parameters
2702 Parameters
2694 ----------
2703 ----------
2695 nodelist : list
2704 nodelist : list
2696 A sequence of AST nodes to run.
2705 A sequence of AST nodes to run.
2697 cell_name : str
2706 cell_name : str
2698 Will be passed to the compiler as the filename of the cell. Typically
2707 Will be passed to the compiler as the filename of the cell. Typically
2699 the value returned by ip.compile.cache(cell).
2708 the value returned by ip.compile.cache(cell).
2700 interactivity : str
2709 interactivity : str
2701 'all', 'last', 'last_expr' or 'none', specifying which nodes should be
2710 'all', 'last', 'last_expr' or 'none', specifying which nodes should be
2702 run interactively (displaying output from expressions). 'last_expr'
2711 run interactively (displaying output from expressions). 'last_expr'
2703 will run the last node interactively only if it is an expression (i.e.
2712 will run the last node interactively only if it is an expression (i.e.
2704 expressions in loops or other blocks are not displayed. Other values
2713 expressions in loops or other blocks are not displayed. Other values
2705 for this parameter will raise a ValueError.
2714 for this parameter will raise a ValueError.
2715 compiler : callable
2716 A function with the same interface as the built-in compile(), to turn
2717 the AST nodes into code objects. Default is the built-in compile().
2706 """
2718 """
2707 if not nodelist:
2719 if not nodelist:
2708 return
2720 return
2709
2721
2710 if interactivity == 'last_expr':
2722 if interactivity == 'last_expr':
2711 if isinstance(nodelist[-1], ast.Expr):
2723 if isinstance(nodelist[-1], ast.Expr):
2712 interactivity = "last"
2724 interactivity = "last"
2713 else:
2725 else:
2714 interactivity = "none"
2726 interactivity = "none"
2715
2727
2716 if interactivity == 'none':
2728 if interactivity == 'none':
2717 to_run_exec, to_run_interactive = nodelist, []
2729 to_run_exec, to_run_interactive = nodelist, []
2718 elif interactivity == 'last':
2730 elif interactivity == 'last':
2719 to_run_exec, to_run_interactive = nodelist[:-1], nodelist[-1:]
2731 to_run_exec, to_run_interactive = nodelist[:-1], nodelist[-1:]
2720 elif interactivity == 'all':
2732 elif interactivity == 'all':
2721 to_run_exec, to_run_interactive = [], nodelist
2733 to_run_exec, to_run_interactive = [], nodelist
2722 else:
2734 else:
2723 raise ValueError("Interactivity was %r" % interactivity)
2735 raise ValueError("Interactivity was %r" % interactivity)
2724
2736
2725 exec_count = self.execution_count
2737 exec_count = self.execution_count
2726
2738
2727 try:
2739 try:
2728 for i, node in enumerate(to_run_exec):
2740 for i, node in enumerate(to_run_exec):
2729 mod = ast.Module([node])
2741 mod = ast.Module([node])
2730 code = self.compile(mod, cell_name, "exec")
2742 code = compiler(mod, cell_name, "exec")
2731 if self.run_code(code):
2743 if self.run_code(code):
2732 return True
2744 return True
2733
2745
2734 for i, node in enumerate(to_run_interactive):
2746 for i, node in enumerate(to_run_interactive):
2735 mod = ast.Interactive([node])
2747 mod = ast.Interactive([node])
2736 code = self.compile(mod, cell_name, "single")
2748 code = compiler(mod, cell_name, "single")
2737 if self.run_code(code):
2749 if self.run_code(code):
2738 return True
2750 return True
2739
2751
2740 # Flush softspace
2752 # Flush softspace
2741 if softspace(sys.stdout, 0):
2753 if softspace(sys.stdout, 0):
2742 print()
2754 print()
2743
2755
2744 except:
2756 except:
2745 # It's possible to have exceptions raised here, typically by
2757 # It's possible to have exceptions raised here, typically by
2746 # compilation of odd code (such as a naked 'return' outside a
2758 # compilation of odd code (such as a naked 'return' outside a
2747 # function) that did parse but isn't valid. Typically the exception
2759 # function) that did parse but isn't valid. Typically the exception
2748 # is a SyntaxError, but it's safest just to catch anything and show
2760 # is a SyntaxError, but it's safest just to catch anything and show
2749 # the user a traceback.
2761 # the user a traceback.
2750
2762
2751 # We do only one try/except outside the loop to minimize the impact
2763 # We do only one try/except outside the loop to minimize the impact
2752 # on runtime, and also because if any node in the node list is
2764 # on runtime, and also because if any node in the node list is
2753 # broken, we should stop execution completely.
2765 # broken, we should stop execution completely.
2754 self.showtraceback()
2766 self.showtraceback()
2755
2767
2756 return False
2768 return False
2757
2769
2758 def run_code(self, code_obj):
2770 def run_code(self, code_obj):
2759 """Execute a code object.
2771 """Execute a code object.
2760
2772
2761 When an exception occurs, self.showtraceback() is called to display a
2773 When an exception occurs, self.showtraceback() is called to display a
2762 traceback.
2774 traceback.
2763
2775
2764 Parameters
2776 Parameters
2765 ----------
2777 ----------
2766 code_obj : code object
2778 code_obj : code object
2767 A compiled code object, to be executed
2779 A compiled code object, to be executed
2768
2780
2769 Returns
2781 Returns
2770 -------
2782 -------
2771 False : successful execution.
2783 False : successful execution.
2772 True : an error occurred.
2784 True : an error occurred.
2773 """
2785 """
2774
2786
2775 # Set our own excepthook in case the user code tries to call it
2787 # Set our own excepthook in case the user code tries to call it
2776 # directly, so that the IPython crash handler doesn't get triggered
2788 # directly, so that the IPython crash handler doesn't get triggered
2777 old_excepthook,sys.excepthook = sys.excepthook, self.excepthook
2789 old_excepthook,sys.excepthook = sys.excepthook, self.excepthook
2778
2790
2779 # we save the original sys.excepthook in the instance, in case config
2791 # we save the original sys.excepthook in the instance, in case config
2780 # code (such as magics) needs access to it.
2792 # code (such as magics) needs access to it.
2781 self.sys_excepthook = old_excepthook
2793 self.sys_excepthook = old_excepthook
2782 outflag = 1 # happens in more places, so it's easier as default
2794 outflag = 1 # happens in more places, so it's easier as default
2783 try:
2795 try:
2784 try:
2796 try:
2785 self.hooks.pre_run_code_hook()
2797 self.hooks.pre_run_code_hook()
2786 #rprint('Running code', repr(code_obj)) # dbg
2798 #rprint('Running code', repr(code_obj)) # dbg
2787 exec code_obj in self.user_global_ns, self.user_ns
2799 exec code_obj in self.user_global_ns, self.user_ns
2788 finally:
2800 finally:
2789 # Reset our crash handler in place
2801 # Reset our crash handler in place
2790 sys.excepthook = old_excepthook
2802 sys.excepthook = old_excepthook
2791 except SystemExit:
2803 except SystemExit:
2792 self.showtraceback(exception_only=True)
2804 self.showtraceback(exception_only=True)
2793 warn("To exit: use 'exit', 'quit', or Ctrl-D.", level=1)
2805 warn("To exit: use 'exit', 'quit', or Ctrl-D.", level=1)
2794 except self.custom_exceptions:
2806 except self.custom_exceptions:
2795 etype,value,tb = sys.exc_info()
2807 etype,value,tb = sys.exc_info()
2796 self.CustomTB(etype,value,tb)
2808 self.CustomTB(etype,value,tb)
2797 except:
2809 except:
2798 self.showtraceback()
2810 self.showtraceback()
2799 else:
2811 else:
2800 outflag = 0
2812 outflag = 0
2801 return outflag
2813 return outflag
2802
2814
2803 # For backwards compatibility
2815 # For backwards compatibility
2804 runcode = run_code
2816 runcode = run_code
2805
2817
2806 #-------------------------------------------------------------------------
2818 #-------------------------------------------------------------------------
2807 # Things related to GUI support and pylab
2819 # Things related to GUI support and pylab
2808 #-------------------------------------------------------------------------
2820 #-------------------------------------------------------------------------
2809
2821
2810 def enable_gui(self, gui=None):
2822 def enable_gui(self, gui=None):
2811 raise NotImplementedError('Implement enable_gui in a subclass')
2823 raise NotImplementedError('Implement enable_gui in a subclass')
2812
2824
2813 def enable_pylab(self, gui=None, import_all=True, welcome_message=False):
2825 def enable_pylab(self, gui=None, import_all=True, welcome_message=False):
2814 """Activate pylab support at runtime.
2826 """Activate pylab support at runtime.
2815
2827
2816 This turns on support for matplotlib, preloads into the interactive
2828 This turns on support for matplotlib, preloads into the interactive
2817 namespace all of numpy and pylab, and configures IPython to correctly
2829 namespace all of numpy and pylab, and configures IPython to correctly
2818 interact with the GUI event loop. The GUI backend to be used can be
2830 interact with the GUI event loop. The GUI backend to be used can be
2819 optionally selected with the optional :param:`gui` argument.
2831 optionally selected with the optional :param:`gui` argument.
2820
2832
2821 Parameters
2833 Parameters
2822 ----------
2834 ----------
2823 gui : optional, string
2835 gui : optional, string
2824
2836
2825 If given, dictates the choice of matplotlib GUI backend to use
2837 If given, dictates the choice of matplotlib GUI backend to use
2826 (should be one of IPython's supported backends, 'qt', 'osx', 'tk',
2838 (should be one of IPython's supported backends, 'qt', 'osx', 'tk',
2827 'gtk', 'wx' or 'inline'), otherwise we use the default chosen by
2839 'gtk', 'wx' or 'inline'), otherwise we use the default chosen by
2828 matplotlib (as dictated by the matplotlib build-time options plus the
2840 matplotlib (as dictated by the matplotlib build-time options plus the
2829 user's matplotlibrc configuration file). Note that not all backends
2841 user's matplotlibrc configuration file). Note that not all backends
2830 make sense in all contexts, for example a terminal ipython can't
2842 make sense in all contexts, for example a terminal ipython can't
2831 display figures inline.
2843 display figures inline.
2832 """
2844 """
2833 from IPython.core.pylabtools import mpl_runner
2845 from IPython.core.pylabtools import mpl_runner
2834 # We want to prevent the loading of pylab to pollute the user's
2846 # We want to prevent the loading of pylab to pollute the user's
2835 # namespace as shown by the %who* magics, so we execute the activation
2847 # namespace as shown by the %who* magics, so we execute the activation
2836 # code in an empty namespace, and we update *both* user_ns and
2848 # code in an empty namespace, and we update *both* user_ns and
2837 # user_ns_hidden with this information.
2849 # user_ns_hidden with this information.
2838 ns = {}
2850 ns = {}
2839 try:
2851 try:
2840 gui = pylab_activate(ns, gui, import_all, self, welcome_message=welcome_message)
2852 gui = pylab_activate(ns, gui, import_all, self, welcome_message=welcome_message)
2841 except KeyError:
2853 except KeyError:
2842 error("Backend %r not supported" % gui)
2854 error("Backend %r not supported" % gui)
2843 return
2855 return
2844 self.user_ns.update(ns)
2856 self.user_ns.update(ns)
2845 self.user_ns_hidden.update(ns)
2857 self.user_ns_hidden.update(ns)
2846 # Now we must activate the gui pylab wants to use, and fix %run to take
2858 # Now we must activate the gui pylab wants to use, and fix %run to take
2847 # plot updates into account
2859 # plot updates into account
2848 self.enable_gui(gui)
2860 self.enable_gui(gui)
2849 self.magics_manager.registry['ExecutionMagics'].default_runner = \
2861 self.magics_manager.registry['ExecutionMagics'].default_runner = \
2850 mpl_runner(self.safe_execfile)
2862 mpl_runner(self.safe_execfile)
2851
2863
2852 #-------------------------------------------------------------------------
2864 #-------------------------------------------------------------------------
2853 # Utilities
2865 # Utilities
2854 #-------------------------------------------------------------------------
2866 #-------------------------------------------------------------------------
2855
2867
2856 def var_expand(self, cmd, depth=0, formatter=DollarFormatter()):
2868 def var_expand(self, cmd, depth=0, formatter=DollarFormatter()):
2857 """Expand python variables in a string.
2869 """Expand python variables in a string.
2858
2870
2859 The depth argument indicates how many frames above the caller should
2871 The depth argument indicates how many frames above the caller should
2860 be walked to look for the local namespace where to expand variables.
2872 be walked to look for the local namespace where to expand variables.
2861
2873
2862 The global namespace for expansion is always the user's interactive
2874 The global namespace for expansion is always the user's interactive
2863 namespace.
2875 namespace.
2864 """
2876 """
2865 ns = self.user_ns.copy()
2877 ns = self.user_ns.copy()
2866 ns.update(sys._getframe(depth+1).f_locals)
2878 ns.update(sys._getframe(depth+1).f_locals)
2867 try:
2879 try:
2868 # We have to use .vformat() here, because 'self' is a valid and common
2880 # We have to use .vformat() here, because 'self' is a valid and common
2869 # name, and expanding **ns for .format() would make it collide with
2881 # name, and expanding **ns for .format() would make it collide with
2870 # the 'self' argument of the method.
2882 # the 'self' argument of the method.
2871 cmd = formatter.vformat(cmd, args=[], kwargs=ns)
2883 cmd = formatter.vformat(cmd, args=[], kwargs=ns)
2872 except Exception:
2884 except Exception:
2873 # if formatter couldn't format, just let it go untransformed
2885 # if formatter couldn't format, just let it go untransformed
2874 pass
2886 pass
2875 return cmd
2887 return cmd
2876
2888
2877 def mktempfile(self, data=None, prefix='ipython_edit_'):
2889 def mktempfile(self, data=None, prefix='ipython_edit_'):
2878 """Make a new tempfile and return its filename.
2890 """Make a new tempfile and return its filename.
2879
2891
2880 This makes a call to tempfile.mktemp, but it registers the created
2892 This makes a call to tempfile.mktemp, but it registers the created
2881 filename internally so ipython cleans it up at exit time.
2893 filename internally so ipython cleans it up at exit time.
2882
2894
2883 Optional inputs:
2895 Optional inputs:
2884
2896
2885 - data(None): if data is given, it gets written out to the temp file
2897 - data(None): if data is given, it gets written out to the temp file
2886 immediately, and the file is closed again."""
2898 immediately, and the file is closed again."""
2887
2899
2888 filename = tempfile.mktemp('.py', prefix)
2900 filename = tempfile.mktemp('.py', prefix)
2889 self.tempfiles.append(filename)
2901 self.tempfiles.append(filename)
2890
2902
2891 if data:
2903 if data:
2892 tmp_file = open(filename,'w')
2904 tmp_file = open(filename,'w')
2893 tmp_file.write(data)
2905 tmp_file.write(data)
2894 tmp_file.close()
2906 tmp_file.close()
2895 return filename
2907 return filename
2896
2908
2897 # TODO: This should be removed when Term is refactored.
2909 # TODO: This should be removed when Term is refactored.
2898 def write(self,data):
2910 def write(self,data):
2899 """Write a string to the default output"""
2911 """Write a string to the default output"""
2900 io.stdout.write(data)
2912 io.stdout.write(data)
2901
2913
2902 # TODO: This should be removed when Term is refactored.
2914 # TODO: This should be removed when Term is refactored.
2903 def write_err(self,data):
2915 def write_err(self,data):
2904 """Write a string to the default error output"""
2916 """Write a string to the default error output"""
2905 io.stderr.write(data)
2917 io.stderr.write(data)
2906
2918
2907 def ask_yes_no(self, prompt, default=None):
2919 def ask_yes_no(self, prompt, default=None):
2908 if self.quiet:
2920 if self.quiet:
2909 return True
2921 return True
2910 return ask_yes_no(prompt,default)
2922 return ask_yes_no(prompt,default)
2911
2923
2912 def show_usage(self):
2924 def show_usage(self):
2913 """Show a usage message"""
2925 """Show a usage message"""
2914 page.page(IPython.core.usage.interactive_usage)
2926 page.page(IPython.core.usage.interactive_usage)
2915
2927
2916 def extract_input_lines(self, range_str, raw=False):
2928 def extract_input_lines(self, range_str, raw=False):
2917 """Return as a string a set of input history slices.
2929 """Return as a string a set of input history slices.
2918
2930
2919 Parameters
2931 Parameters
2920 ----------
2932 ----------
2921 range_str : string
2933 range_str : string
2922 The set of slices is given as a string, like "~5/6-~4/2 4:8 9",
2934 The set of slices is given as a string, like "~5/6-~4/2 4:8 9",
2923 since this function is for use by magic functions which get their
2935 since this function is for use by magic functions which get their
2924 arguments as strings. The number before the / is the session
2936 arguments as strings. The number before the / is the session
2925 number: ~n goes n back from the current session.
2937 number: ~n goes n back from the current session.
2926
2938
2927 Optional Parameters:
2939 Optional Parameters:
2928 - raw(False): by default, the processed input is used. If this is
2940 - raw(False): by default, the processed input is used. If this is
2929 true, the raw input history is used instead.
2941 true, the raw input history is used instead.
2930
2942
2931 Note that slices can be called with two notations:
2943 Note that slices can be called with two notations:
2932
2944
2933 N:M -> standard python form, means including items N...(M-1).
2945 N:M -> standard python form, means including items N...(M-1).
2934
2946
2935 N-M -> include items N..M (closed endpoint)."""
2947 N-M -> include items N..M (closed endpoint)."""
2936 lines = self.history_manager.get_range_by_str(range_str, raw=raw)
2948 lines = self.history_manager.get_range_by_str(range_str, raw=raw)
2937 return "\n".join(x for _, _, x in lines)
2949 return "\n".join(x for _, _, x in lines)
2938
2950
2939 def find_user_code(self, target, raw=True, py_only=False, skip_encoding_cookie=True):
2951 def find_user_code(self, target, raw=True, py_only=False, skip_encoding_cookie=True):
2940 """Get a code string from history, file, url, or a string or macro.
2952 """Get a code string from history, file, url, or a string or macro.
2941
2953
2942 This is mainly used by magic functions.
2954 This is mainly used by magic functions.
2943
2955
2944 Parameters
2956 Parameters
2945 ----------
2957 ----------
2946
2958
2947 target : str
2959 target : str
2948
2960
2949 A string specifying code to retrieve. This will be tried respectively
2961 A string specifying code to retrieve. This will be tried respectively
2950 as: ranges of input history (see %history for syntax), url,
2962 as: ranges of input history (see %history for syntax), url,
2951 correspnding .py file, filename, or an expression evaluating to a
2963 correspnding .py file, filename, or an expression evaluating to a
2952 string or Macro in the user namespace.
2964 string or Macro in the user namespace.
2953
2965
2954 raw : bool
2966 raw : bool
2955 If true (default), retrieve raw history. Has no effect on the other
2967 If true (default), retrieve raw history. Has no effect on the other
2956 retrieval mechanisms.
2968 retrieval mechanisms.
2957
2969
2958 py_only : bool (default False)
2970 py_only : bool (default False)
2959 Only try to fetch python code, do not try alternative methods to decode file
2971 Only try to fetch python code, do not try alternative methods to decode file
2960 if unicode fails.
2972 if unicode fails.
2961
2973
2962 Returns
2974 Returns
2963 -------
2975 -------
2964 A string of code.
2976 A string of code.
2965
2977
2966 ValueError is raised if nothing is found, and TypeError if it evaluates
2978 ValueError is raised if nothing is found, and TypeError if it evaluates
2967 to an object of another type. In each case, .args[0] is a printable
2979 to an object of another type. In each case, .args[0] is a printable
2968 message.
2980 message.
2969 """
2981 """
2970 code = self.extract_input_lines(target, raw=raw) # Grab history
2982 code = self.extract_input_lines(target, raw=raw) # Grab history
2971 if code:
2983 if code:
2972 return code
2984 return code
2973 utarget = unquote_filename(target)
2985 utarget = unquote_filename(target)
2974 try:
2986 try:
2975 if utarget.startswith(('http://', 'https://')):
2987 if utarget.startswith(('http://', 'https://')):
2976 return openpy.read_py_url(utarget, skip_encoding_cookie=skip_encoding_cookie)
2988 return openpy.read_py_url(utarget, skip_encoding_cookie=skip_encoding_cookie)
2977 except UnicodeDecodeError:
2989 except UnicodeDecodeError:
2978 if not py_only :
2990 if not py_only :
2979 response = urllib.urlopen(target)
2991 response = urllib.urlopen(target)
2980 return response.read().decode('latin1')
2992 return response.read().decode('latin1')
2981 raise ValueError(("'%s' seem to be unreadable.") % utarget)
2993 raise ValueError(("'%s' seem to be unreadable.") % utarget)
2982
2994
2983 potential_target = [target]
2995 potential_target = [target]
2984 try :
2996 try :
2985 potential_target.insert(0,get_py_filename(target))
2997 potential_target.insert(0,get_py_filename(target))
2986 except IOError:
2998 except IOError:
2987 pass
2999 pass
2988
3000
2989 for tgt in potential_target :
3001 for tgt in potential_target :
2990 if os.path.isfile(tgt): # Read file
3002 if os.path.isfile(tgt): # Read file
2991 try :
3003 try :
2992 return openpy.read_py_file(tgt, skip_encoding_cookie=skip_encoding_cookie)
3004 return openpy.read_py_file(tgt, skip_encoding_cookie=skip_encoding_cookie)
2993 except UnicodeDecodeError :
3005 except UnicodeDecodeError :
2994 if not py_only :
3006 if not py_only :
2995 with io_open(tgt,'r', encoding='latin1') as f :
3007 with io_open(tgt,'r', encoding='latin1') as f :
2996 return f.read()
3008 return f.read()
2997 raise ValueError(("'%s' seem to be unreadable.") % target)
3009 raise ValueError(("'%s' seem to be unreadable.") % target)
2998
3010
2999 try: # User namespace
3011 try: # User namespace
3000 codeobj = eval(target, self.user_ns)
3012 codeobj = eval(target, self.user_ns)
3001 except Exception:
3013 except Exception:
3002 raise ValueError(("'%s' was not found in history, as a file, url, "
3014 raise ValueError(("'%s' was not found in history, as a file, url, "
3003 "nor in the user namespace.") % target)
3015 "nor in the user namespace.") % target)
3004 if isinstance(codeobj, basestring):
3016 if isinstance(codeobj, basestring):
3005 return codeobj
3017 return codeobj
3006 elif isinstance(codeobj, Macro):
3018 elif isinstance(codeobj, Macro):
3007 return codeobj.value
3019 return codeobj.value
3008
3020
3009 raise TypeError("%s is neither a string nor a macro." % target,
3021 raise TypeError("%s is neither a string nor a macro." % target,
3010 codeobj)
3022 codeobj)
3011
3023
3012 #-------------------------------------------------------------------------
3024 #-------------------------------------------------------------------------
3013 # Things related to IPython exiting
3025 # Things related to IPython exiting
3014 #-------------------------------------------------------------------------
3026 #-------------------------------------------------------------------------
3015 def atexit_operations(self):
3027 def atexit_operations(self):
3016 """This will be executed at the time of exit.
3028 """This will be executed at the time of exit.
3017
3029
3018 Cleanup operations and saving of persistent data that is done
3030 Cleanup operations and saving of persistent data that is done
3019 unconditionally by IPython should be performed here.
3031 unconditionally by IPython should be performed here.
3020
3032
3021 For things that may depend on startup flags or platform specifics (such
3033 For things that may depend on startup flags or platform specifics (such
3022 as having readline or not), register a separate atexit function in the
3034 as having readline or not), register a separate atexit function in the
3023 code that has the appropriate information, rather than trying to
3035 code that has the appropriate information, rather than trying to
3024 clutter
3036 clutter
3025 """
3037 """
3026 # Close the history session (this stores the end time and line count)
3038 # Close the history session (this stores the end time and line count)
3027 # this must be *before* the tempfile cleanup, in case of temporary
3039 # this must be *before* the tempfile cleanup, in case of temporary
3028 # history db
3040 # history db
3029 self.history_manager.end_session()
3041 self.history_manager.end_session()
3030
3042
3031 # Cleanup all tempfiles left around
3043 # Cleanup all tempfiles left around
3032 for tfile in self.tempfiles:
3044 for tfile in self.tempfiles:
3033 try:
3045 try:
3034 os.unlink(tfile)
3046 os.unlink(tfile)
3035 except OSError:
3047 except OSError:
3036 pass
3048 pass
3037
3049
3038 # Clear all user namespaces to release all references cleanly.
3050 # Clear all user namespaces to release all references cleanly.
3039 self.reset(new_session=False)
3051 self.reset(new_session=False)
3040
3052
3041 # Run user hooks
3053 # Run user hooks
3042 self.hooks.shutdown_hook()
3054 self.hooks.shutdown_hook()
3043
3055
3044 def cleanup(self):
3056 def cleanup(self):
3045 self.restore_sys_module_state()
3057 self.restore_sys_module_state()
3046
3058
3047
3059
3048 class InteractiveShellABC(object):
3060 class InteractiveShellABC(object):
3049 """An abstract base class for InteractiveShell."""
3061 """An abstract base class for InteractiveShell."""
3050 __metaclass__ = abc.ABCMeta
3062 __metaclass__ = abc.ABCMeta
3051
3063
3052 InteractiveShellABC.register(InteractiveShell)
3064 InteractiveShellABC.register(InteractiveShell)
@@ -1,75 +1,75 b''
1 # coding: utf-8
1 # coding: utf-8
2 """Tests for the compilerop module.
2 """Tests for the compilerop module.
3 """
3 """
4 #-----------------------------------------------------------------------------
4 #-----------------------------------------------------------------------------
5 # Copyright (C) 2010-2011 The IPython Development Team.
5 # Copyright (C) 2010-2011 The IPython Development Team.
6 #
6 #
7 # Distributed under the terms of the BSD License.
7 # Distributed under the terms of the BSD License.
8 #
8 #
9 # The full license is in the file COPYING.txt, distributed with this software.
9 # The full license is in the file COPYING.txt, distributed with this software.
10 #-----------------------------------------------------------------------------
10 #-----------------------------------------------------------------------------
11
11
12 #-----------------------------------------------------------------------------
12 #-----------------------------------------------------------------------------
13 # Imports
13 # Imports
14 #-----------------------------------------------------------------------------
14 #-----------------------------------------------------------------------------
15 from __future__ import print_function
15 from __future__ import print_function
16
16
17 # Stdlib imports
17 # Stdlib imports
18 import linecache
18 import linecache
19 import sys
19 import sys
20
20
21 # Third-party imports
21 # Third-party imports
22 import nose.tools as nt
22 import nose.tools as nt
23
23
24 # Our own imports
24 # Our own imports
25 from IPython.core import compilerop
25 from IPython.core import compilerop
26 from IPython.utils import py3compat
26 from IPython.utils import py3compat
27
27
28 #-----------------------------------------------------------------------------
28 #-----------------------------------------------------------------------------
29 # Test functions
29 # Test functions
30 #-----------------------------------------------------------------------------
30 #-----------------------------------------------------------------------------
31
31
32 def test_code_name():
32 def test_code_name():
33 code = 'x=1'
33 code = 'x=1'
34 name = compilerop.code_name(code)
34 name = compilerop.code_name(code)
35 nt.assert_true(name.startswith('<ipython-input-0'))
35 nt.assert_true(name.startswith('<ipython-input-0'))
36
36
37
37
38 def test_code_name2():
38 def test_code_name2():
39 code = 'x=1'
39 code = 'x=1'
40 name = compilerop.code_name(code, 9)
40 name = compilerop.code_name(code, 9)
41 nt.assert_true(name.startswith('<ipython-input-9'))
41 nt.assert_true(name.startswith('<ipython-input-9'))
42
42
43
43
44 def test_cache():
44 def test_cache():
45 """Test the compiler correctly compiles and caches inputs
45 """Test the compiler correctly compiles and caches inputs
46 """
46 """
47 cp = compilerop.CachingCompiler()
47 cp = compilerop.CachingCompiler()
48 ncache = len(linecache.cache)
48 ncache = len(linecache.cache)
49 cp.cache('x=1')
49 cp.cache('x=1')
50 nt.assert_true(len(linecache.cache) > ncache)
50 nt.assert_true(len(linecache.cache) > ncache)
51
51
52 def setUp():
52 def setUp():
53 # Check we're in a proper Python 2 environment (some imports, such
53 # Check we're in a proper Python 2 environment (some imports, such
54 # as GTK, can change the default encoding, which can hide bugs.)
54 # as GTK, can change the default encoding, which can hide bugs.)
55 nt.assert_equal(sys.getdefaultencoding(), "utf-8" if py3compat.PY3 else "ascii")
55 nt.assert_equal(sys.getdefaultencoding(), "utf-8" if py3compat.PY3 else "ascii")
56
56
57 def test_cache_unicode():
57 def test_cache_unicode():
58 cp = compilerop.CachingCompiler()
58 cp = compilerop.CachingCompiler()
59 ncache = len(linecache.cache)
59 ncache = len(linecache.cache)
60 cp.cache(u"t = 'žćčőđ'")
60 cp.cache(u"t = 'žćčőđ'")
61 nt.assert_true(len(linecache.cache) > ncache)
61 nt.assert_true(len(linecache.cache) > ncache)
62
62
63 def test_compiler_check_cache():
63 def test_compiler_check_cache():
64 """Test the compiler properly manages the cache.
64 """Test the compiler properly manages the cache.
65 """
65 """
66 # Rather simple-minded tests that just exercise the API
66 # Rather simple-minded tests that just exercise the API
67 cp = compilerop.CachingCompiler()
67 cp = compilerop.CachingCompiler()
68 cp.cache('x=1', 99)
68 cp.cache('x=1', 99)
69 # Ensure now that after clearing the cache, our entries survive
69 # Ensure now that after clearing the cache, our entries survive
70 cp.check_cache()
70 linecache.checkcache()
71 for k in linecache.cache:
71 for k in linecache.cache:
72 if k.startswith('<ipython-input-99'):
72 if k.startswith('<ipython-input-99'):
73 break
73 break
74 else:
74 else:
75 raise AssertionError('Entry for input-99 missing from linecache')
75 raise AssertionError('Entry for input-99 missing from linecache')
@@ -1,564 +1,580 b''
1 # -*- coding: utf-8 -*-
1 # -*- coding: utf-8 -*-
2 """Tests for the key interactiveshell module.
2 """Tests for the key interactiveshell module.
3
3
4 Historically the main classes in interactiveshell have been under-tested. This
4 Historically the main classes in interactiveshell have been under-tested. This
5 module should grow as many single-method tests as possible to trap many of the
5 module should grow as many single-method tests as possible to trap many of the
6 recurring bugs we seem to encounter with high-level interaction.
6 recurring bugs we seem to encounter with high-level interaction.
7
7
8 Authors
8 Authors
9 -------
9 -------
10 * Fernando Perez
10 * Fernando Perez
11 """
11 """
12 #-----------------------------------------------------------------------------
12 #-----------------------------------------------------------------------------
13 # Copyright (C) 2011 The IPython Development Team
13 # Copyright (C) 2011 The IPython Development Team
14 #
14 #
15 # Distributed under the terms of the BSD License. The full license is in
15 # Distributed under the terms of the BSD License. The full license is in
16 # the file COPYING, distributed as part of this software.
16 # the file COPYING, distributed as part of this software.
17 #-----------------------------------------------------------------------------
17 #-----------------------------------------------------------------------------
18
18
19 #-----------------------------------------------------------------------------
19 #-----------------------------------------------------------------------------
20 # Imports
20 # Imports
21 #-----------------------------------------------------------------------------
21 #-----------------------------------------------------------------------------
22 # stdlib
22 # stdlib
23 import ast
23 import ast
24 import os
24 import os
25 import shutil
25 import shutil
26 import sys
26 import sys
27 import tempfile
27 import tempfile
28 import unittest
28 import unittest
29 from os.path import join
29 from os.path import join
30 from StringIO import StringIO
30 from StringIO import StringIO
31
31
32 # third-party
32 # third-party
33 import nose.tools as nt
33 import nose.tools as nt
34
34
35 # Our own
35 # Our own
36 from IPython.testing.decorators import skipif
36 from IPython.testing.decorators import skipif
37 from IPython.testing import tools as tt
37 from IPython.testing import tools as tt
38 from IPython.utils import io
38 from IPython.utils import io
39
39
40 #-----------------------------------------------------------------------------
40 #-----------------------------------------------------------------------------
41 # Globals
41 # Globals
42 #-----------------------------------------------------------------------------
42 #-----------------------------------------------------------------------------
43 # This is used by every single test, no point repeating it ad nauseam
43 # This is used by every single test, no point repeating it ad nauseam
44 ip = get_ipython()
44 ip = get_ipython()
45
45
46 #-----------------------------------------------------------------------------
46 #-----------------------------------------------------------------------------
47 # Tests
47 # Tests
48 #-----------------------------------------------------------------------------
48 #-----------------------------------------------------------------------------
49
49
50 class InteractiveShellTestCase(unittest.TestCase):
50 class InteractiveShellTestCase(unittest.TestCase):
51 def test_naked_string_cells(self):
51 def test_naked_string_cells(self):
52 """Test that cells with only naked strings are fully executed"""
52 """Test that cells with only naked strings are fully executed"""
53 # First, single-line inputs
53 # First, single-line inputs
54 ip.run_cell('"a"\n')
54 ip.run_cell('"a"\n')
55 self.assertEqual(ip.user_ns['_'], 'a')
55 self.assertEqual(ip.user_ns['_'], 'a')
56 # And also multi-line cells
56 # And also multi-line cells
57 ip.run_cell('"""a\nb"""\n')
57 ip.run_cell('"""a\nb"""\n')
58 self.assertEqual(ip.user_ns['_'], 'a\nb')
58 self.assertEqual(ip.user_ns['_'], 'a\nb')
59
59
60 def test_run_empty_cell(self):
60 def test_run_empty_cell(self):
61 """Just make sure we don't get a horrible error with a blank
61 """Just make sure we don't get a horrible error with a blank
62 cell of input. Yes, I did overlook that."""
62 cell of input. Yes, I did overlook that."""
63 old_xc = ip.execution_count
63 old_xc = ip.execution_count
64 ip.run_cell('')
64 ip.run_cell('')
65 self.assertEqual(ip.execution_count, old_xc)
65 self.assertEqual(ip.execution_count, old_xc)
66
66
67 def test_run_cell_multiline(self):
67 def test_run_cell_multiline(self):
68 """Multi-block, multi-line cells must execute correctly.
68 """Multi-block, multi-line cells must execute correctly.
69 """
69 """
70 src = '\n'.join(["x=1",
70 src = '\n'.join(["x=1",
71 "y=2",
71 "y=2",
72 "if 1:",
72 "if 1:",
73 " x += 1",
73 " x += 1",
74 " y += 1",])
74 " y += 1",])
75 ip.run_cell(src)
75 ip.run_cell(src)
76 self.assertEqual(ip.user_ns['x'], 2)
76 self.assertEqual(ip.user_ns['x'], 2)
77 self.assertEqual(ip.user_ns['y'], 3)
77 self.assertEqual(ip.user_ns['y'], 3)
78
78
79 def test_multiline_string_cells(self):
79 def test_multiline_string_cells(self):
80 "Code sprinkled with multiline strings should execute (GH-306)"
80 "Code sprinkled with multiline strings should execute (GH-306)"
81 ip.run_cell('tmp=0')
81 ip.run_cell('tmp=0')
82 self.assertEqual(ip.user_ns['tmp'], 0)
82 self.assertEqual(ip.user_ns['tmp'], 0)
83 ip.run_cell('tmp=1;"""a\nb"""\n')
83 ip.run_cell('tmp=1;"""a\nb"""\n')
84 self.assertEqual(ip.user_ns['tmp'], 1)
84 self.assertEqual(ip.user_ns['tmp'], 1)
85
85
86 def test_dont_cache_with_semicolon(self):
86 def test_dont_cache_with_semicolon(self):
87 "Ending a line with semicolon should not cache the returned object (GH-307)"
87 "Ending a line with semicolon should not cache the returned object (GH-307)"
88 oldlen = len(ip.user_ns['Out'])
88 oldlen = len(ip.user_ns['Out'])
89 a = ip.run_cell('1;', store_history=True)
89 a = ip.run_cell('1;', store_history=True)
90 newlen = len(ip.user_ns['Out'])
90 newlen = len(ip.user_ns['Out'])
91 self.assertEqual(oldlen, newlen)
91 self.assertEqual(oldlen, newlen)
92 #also test the default caching behavior
92 #also test the default caching behavior
93 ip.run_cell('1', store_history=True)
93 ip.run_cell('1', store_history=True)
94 newlen = len(ip.user_ns['Out'])
94 newlen = len(ip.user_ns['Out'])
95 self.assertEqual(oldlen+1, newlen)
95 self.assertEqual(oldlen+1, newlen)
96
96
97 def test_In_variable(self):
97 def test_In_variable(self):
98 "Verify that In variable grows with user input (GH-284)"
98 "Verify that In variable grows with user input (GH-284)"
99 oldlen = len(ip.user_ns['In'])
99 oldlen = len(ip.user_ns['In'])
100 ip.run_cell('1;', store_history=True)
100 ip.run_cell('1;', store_history=True)
101 newlen = len(ip.user_ns['In'])
101 newlen = len(ip.user_ns['In'])
102 self.assertEqual(oldlen+1, newlen)
102 self.assertEqual(oldlen+1, newlen)
103 self.assertEqual(ip.user_ns['In'][-1],'1;')
103 self.assertEqual(ip.user_ns['In'][-1],'1;')
104
104
105 def test_magic_names_in_string(self):
105 def test_magic_names_in_string(self):
106 ip.run_cell('a = """\n%exit\n"""')
106 ip.run_cell('a = """\n%exit\n"""')
107 self.assertEqual(ip.user_ns['a'], '\n%exit\n')
107 self.assertEqual(ip.user_ns['a'], '\n%exit\n')
108
108
109 def test_alias_crash(self):
109 def test_alias_crash(self):
110 """Errors in prefilter can't crash IPython"""
110 """Errors in prefilter can't crash IPython"""
111 ip.run_cell('%alias parts echo first %s second %s')
111 ip.run_cell('%alias parts echo first %s second %s')
112 # capture stderr:
112 # capture stderr:
113 save_err = io.stderr
113 save_err = io.stderr
114 io.stderr = StringIO()
114 io.stderr = StringIO()
115 ip.run_cell('parts 1')
115 ip.run_cell('parts 1')
116 err = io.stderr.getvalue()
116 err = io.stderr.getvalue()
117 io.stderr = save_err
117 io.stderr = save_err
118 self.assertEqual(err.split(':')[0], 'ERROR')
118 self.assertEqual(err.split(':')[0], 'ERROR')
119
119
120 def test_trailing_newline(self):
120 def test_trailing_newline(self):
121 """test that running !(command) does not raise a SyntaxError"""
121 """test that running !(command) does not raise a SyntaxError"""
122 ip.run_cell('!(true)\n', False)
122 ip.run_cell('!(true)\n', False)
123 ip.run_cell('!(true)\n\n\n', False)
123 ip.run_cell('!(true)\n\n\n', False)
124
124
125 def test_gh_597(self):
125 def test_gh_597(self):
126 """Pretty-printing lists of objects with non-ascii reprs may cause
126 """Pretty-printing lists of objects with non-ascii reprs may cause
127 problems."""
127 problems."""
128 class Spam(object):
128 class Spam(object):
129 def __repr__(self):
129 def __repr__(self):
130 return "\xe9"*50
130 return "\xe9"*50
131 import IPython.core.formatters
131 import IPython.core.formatters
132 f = IPython.core.formatters.PlainTextFormatter()
132 f = IPython.core.formatters.PlainTextFormatter()
133 f([Spam(),Spam()])
133 f([Spam(),Spam()])
134
134
135
135
136 def test_future_flags(self):
136 def test_future_flags(self):
137 """Check that future flags are used for parsing code (gh-777)"""
137 """Check that future flags are used for parsing code (gh-777)"""
138 ip.run_cell('from __future__ import print_function')
138 ip.run_cell('from __future__ import print_function')
139 try:
139 try:
140 ip.run_cell('prfunc_return_val = print(1,2, sep=" ")')
140 ip.run_cell('prfunc_return_val = print(1,2, sep=" ")')
141 assert 'prfunc_return_val' in ip.user_ns
141 assert 'prfunc_return_val' in ip.user_ns
142 finally:
142 finally:
143 # Reset compiler flags so we don't mess up other tests.
143 # Reset compiler flags so we don't mess up other tests.
144 ip.compile.reset_compiler_flags()
144 ip.compile.reset_compiler_flags()
145
145
146 def test_future_unicode(self):
146 def test_future_unicode(self):
147 """Check that unicode_literals is imported from __future__ (gh #786)"""
147 """Check that unicode_literals is imported from __future__ (gh #786)"""
148 try:
148 try:
149 ip.run_cell(u'byte_str = "a"')
149 ip.run_cell(u'byte_str = "a"')
150 assert isinstance(ip.user_ns['byte_str'], str) # string literals are byte strings by default
150 assert isinstance(ip.user_ns['byte_str'], str) # string literals are byte strings by default
151 ip.run_cell('from __future__ import unicode_literals')
151 ip.run_cell('from __future__ import unicode_literals')
152 ip.run_cell(u'unicode_str = "a"')
152 ip.run_cell(u'unicode_str = "a"')
153 assert isinstance(ip.user_ns['unicode_str'], unicode) # strings literals are now unicode
153 assert isinstance(ip.user_ns['unicode_str'], unicode) # strings literals are now unicode
154 finally:
154 finally:
155 # Reset compiler flags so we don't mess up other tests.
155 # Reset compiler flags so we don't mess up other tests.
156 ip.compile.reset_compiler_flags()
156 ip.compile.reset_compiler_flags()
157
157
158 def test_can_pickle(self):
158 def test_can_pickle(self):
159 "Can we pickle objects defined interactively (GH-29)"
159 "Can we pickle objects defined interactively (GH-29)"
160 ip = get_ipython()
160 ip = get_ipython()
161 ip.reset()
161 ip.reset()
162 ip.run_cell(("class Mylist(list):\n"
162 ip.run_cell(("class Mylist(list):\n"
163 " def __init__(self,x=[]):\n"
163 " def __init__(self,x=[]):\n"
164 " list.__init__(self,x)"))
164 " list.__init__(self,x)"))
165 ip.run_cell("w=Mylist([1,2,3])")
165 ip.run_cell("w=Mylist([1,2,3])")
166
166
167 from cPickle import dumps
167 from cPickle import dumps
168
168
169 # We need to swap in our main module - this is only necessary
169 # We need to swap in our main module - this is only necessary
170 # inside the test framework, because IPython puts the interactive module
170 # inside the test framework, because IPython puts the interactive module
171 # in place (but the test framework undoes this).
171 # in place (but the test framework undoes this).
172 _main = sys.modules['__main__']
172 _main = sys.modules['__main__']
173 sys.modules['__main__'] = ip.user_module
173 sys.modules['__main__'] = ip.user_module
174 try:
174 try:
175 res = dumps(ip.user_ns["w"])
175 res = dumps(ip.user_ns["w"])
176 finally:
176 finally:
177 sys.modules['__main__'] = _main
177 sys.modules['__main__'] = _main
178 self.assertTrue(isinstance(res, bytes))
178 self.assertTrue(isinstance(res, bytes))
179
179
180 def test_global_ns(self):
180 def test_global_ns(self):
181 "Code in functions must be able to access variables outside them."
181 "Code in functions must be able to access variables outside them."
182 ip = get_ipython()
182 ip = get_ipython()
183 ip.run_cell("a = 10")
183 ip.run_cell("a = 10")
184 ip.run_cell(("def f(x):\n"
184 ip.run_cell(("def f(x):\n"
185 " return x + a"))
185 " return x + a"))
186 ip.run_cell("b = f(12)")
186 ip.run_cell("b = f(12)")
187 self.assertEqual(ip.user_ns["b"], 22)
187 self.assertEqual(ip.user_ns["b"], 22)
188
188
189 def test_bad_custom_tb(self):
189 def test_bad_custom_tb(self):
190 """Check that InteractiveShell is protected from bad custom exception handlers"""
190 """Check that InteractiveShell is protected from bad custom exception handlers"""
191 from IPython.utils import io
191 from IPython.utils import io
192 save_stderr = io.stderr
192 save_stderr = io.stderr
193 try:
193 try:
194 # capture stderr
194 # capture stderr
195 io.stderr = StringIO()
195 io.stderr = StringIO()
196 ip.set_custom_exc((IOError,), lambda etype,value,tb: 1/0)
196 ip.set_custom_exc((IOError,), lambda etype,value,tb: 1/0)
197 self.assertEqual(ip.custom_exceptions, (IOError,))
197 self.assertEqual(ip.custom_exceptions, (IOError,))
198 ip.run_cell(u'raise IOError("foo")')
198 ip.run_cell(u'raise IOError("foo")')
199 self.assertEqual(ip.custom_exceptions, ())
199 self.assertEqual(ip.custom_exceptions, ())
200 self.assertTrue("Custom TB Handler failed" in io.stderr.getvalue())
200 self.assertTrue("Custom TB Handler failed" in io.stderr.getvalue())
201 finally:
201 finally:
202 io.stderr = save_stderr
202 io.stderr = save_stderr
203
203
204 def test_bad_custom_tb_return(self):
204 def test_bad_custom_tb_return(self):
205 """Check that InteractiveShell is protected from bad return types in custom exception handlers"""
205 """Check that InteractiveShell is protected from bad return types in custom exception handlers"""
206 from IPython.utils import io
206 from IPython.utils import io
207 save_stderr = io.stderr
207 save_stderr = io.stderr
208 try:
208 try:
209 # capture stderr
209 # capture stderr
210 io.stderr = StringIO()
210 io.stderr = StringIO()
211 ip.set_custom_exc((NameError,),lambda etype,value,tb, tb_offset=None: 1)
211 ip.set_custom_exc((NameError,),lambda etype,value,tb, tb_offset=None: 1)
212 self.assertEqual(ip.custom_exceptions, (NameError,))
212 self.assertEqual(ip.custom_exceptions, (NameError,))
213 ip.run_cell(u'a=abracadabra')
213 ip.run_cell(u'a=abracadabra')
214 self.assertEqual(ip.custom_exceptions, ())
214 self.assertEqual(ip.custom_exceptions, ())
215 self.assertTrue("Custom TB Handler failed" in io.stderr.getvalue())
215 self.assertTrue("Custom TB Handler failed" in io.stderr.getvalue())
216 finally:
216 finally:
217 io.stderr = save_stderr
217 io.stderr = save_stderr
218
218
219 def test_drop_by_id(self):
219 def test_drop_by_id(self):
220 myvars = {"a":object(), "b":object(), "c": object()}
220 myvars = {"a":object(), "b":object(), "c": object()}
221 ip.push(myvars, interactive=False)
221 ip.push(myvars, interactive=False)
222 for name in myvars:
222 for name in myvars:
223 assert name in ip.user_ns, name
223 assert name in ip.user_ns, name
224 assert name in ip.user_ns_hidden, name
224 assert name in ip.user_ns_hidden, name
225 ip.user_ns['b'] = 12
225 ip.user_ns['b'] = 12
226 ip.drop_by_id(myvars)
226 ip.drop_by_id(myvars)
227 for name in ["a", "c"]:
227 for name in ["a", "c"]:
228 assert name not in ip.user_ns, name
228 assert name not in ip.user_ns, name
229 assert name not in ip.user_ns_hidden, name
229 assert name not in ip.user_ns_hidden, name
230 assert ip.user_ns['b'] == 12
230 assert ip.user_ns['b'] == 12
231 ip.reset()
231 ip.reset()
232
232
233 def test_var_expand(self):
233 def test_var_expand(self):
234 ip.user_ns['f'] = u'Ca\xf1o'
234 ip.user_ns['f'] = u'Ca\xf1o'
235 self.assertEqual(ip.var_expand(u'echo $f'), u'echo Ca\xf1o')
235 self.assertEqual(ip.var_expand(u'echo $f'), u'echo Ca\xf1o')
236 self.assertEqual(ip.var_expand(u'echo {f}'), u'echo Ca\xf1o')
236 self.assertEqual(ip.var_expand(u'echo {f}'), u'echo Ca\xf1o')
237 self.assertEqual(ip.var_expand(u'echo {f[:-1]}'), u'echo Ca\xf1')
237 self.assertEqual(ip.var_expand(u'echo {f[:-1]}'), u'echo Ca\xf1')
238 self.assertEqual(ip.var_expand(u'echo {1*2}'), u'echo 2')
238 self.assertEqual(ip.var_expand(u'echo {1*2}'), u'echo 2')
239
239
240 ip.user_ns['f'] = b'Ca\xc3\xb1o'
240 ip.user_ns['f'] = b'Ca\xc3\xb1o'
241 # This should not raise any exception:
241 # This should not raise any exception:
242 ip.var_expand(u'echo $f')
242 ip.var_expand(u'echo $f')
243
243
244 def test_var_expand_local(self):
244 def test_var_expand_local(self):
245 """Test local variable expansion in !system and %magic calls"""
245 """Test local variable expansion in !system and %magic calls"""
246 # !system
246 # !system
247 ip.run_cell('def test():\n'
247 ip.run_cell('def test():\n'
248 ' lvar = "ttt"\n'
248 ' lvar = "ttt"\n'
249 ' ret = !echo {lvar}\n'
249 ' ret = !echo {lvar}\n'
250 ' return ret[0]\n')
250 ' return ret[0]\n')
251 res = ip.user_ns['test']()
251 res = ip.user_ns['test']()
252 nt.assert_in('ttt', res)
252 nt.assert_in('ttt', res)
253
253
254 # %magic
254 # %magic
255 ip.run_cell('def makemacro():\n'
255 ip.run_cell('def makemacro():\n'
256 ' macroname = "macro_var_expand_locals"\n'
256 ' macroname = "macro_var_expand_locals"\n'
257 ' %macro {macroname} codestr\n')
257 ' %macro {macroname} codestr\n')
258 ip.user_ns['codestr'] = "str(12)"
258 ip.user_ns['codestr'] = "str(12)"
259 ip.run_cell('makemacro()')
259 ip.run_cell('makemacro()')
260 nt.assert_in('macro_var_expand_locals', ip.user_ns)
260 nt.assert_in('macro_var_expand_locals', ip.user_ns)
261
261
262 def test_var_expand_self(self):
262 def test_var_expand_self(self):
263 """Test variable expansion with the name 'self', which was failing.
263 """Test variable expansion with the name 'self', which was failing.
264
264
265 See https://github.com/ipython/ipython/issues/1878#issuecomment-7698218
265 See https://github.com/ipython/ipython/issues/1878#issuecomment-7698218
266 """
266 """
267 ip.run_cell('class cTest:\n'
267 ip.run_cell('class cTest:\n'
268 ' classvar="see me"\n'
268 ' classvar="see me"\n'
269 ' def test(self):\n'
269 ' def test(self):\n'
270 ' res = !echo Variable: {self.classvar}\n'
270 ' res = !echo Variable: {self.classvar}\n'
271 ' return res[0]\n')
271 ' return res[0]\n')
272 nt.assert_in('see me', ip.user_ns['cTest']().test())
272 nt.assert_in('see me', ip.user_ns['cTest']().test())
273
273
274 def test_bad_var_expand(self):
274 def test_bad_var_expand(self):
275 """var_expand on invalid formats shouldn't raise"""
275 """var_expand on invalid formats shouldn't raise"""
276 # SyntaxError
276 # SyntaxError
277 self.assertEqual(ip.var_expand(u"{'a':5}"), u"{'a':5}")
277 self.assertEqual(ip.var_expand(u"{'a':5}"), u"{'a':5}")
278 # NameError
278 # NameError
279 self.assertEqual(ip.var_expand(u"{asdf}"), u"{asdf}")
279 self.assertEqual(ip.var_expand(u"{asdf}"), u"{asdf}")
280 # ZeroDivisionError
280 # ZeroDivisionError
281 self.assertEqual(ip.var_expand(u"{1/0}"), u"{1/0}")
281 self.assertEqual(ip.var_expand(u"{1/0}"), u"{1/0}")
282
282
283 def test_silent_nopostexec(self):
283 def test_silent_nopostexec(self):
284 """run_cell(silent=True) doesn't invoke post-exec funcs"""
284 """run_cell(silent=True) doesn't invoke post-exec funcs"""
285 d = dict(called=False)
285 d = dict(called=False)
286 def set_called():
286 def set_called():
287 d['called'] = True
287 d['called'] = True
288
288
289 ip.register_post_execute(set_called)
289 ip.register_post_execute(set_called)
290 ip.run_cell("1", silent=True)
290 ip.run_cell("1", silent=True)
291 self.assertFalse(d['called'])
291 self.assertFalse(d['called'])
292 # double-check that non-silent exec did what we expected
292 # double-check that non-silent exec did what we expected
293 # silent to avoid
293 # silent to avoid
294 ip.run_cell("1")
294 ip.run_cell("1")
295 self.assertTrue(d['called'])
295 self.assertTrue(d['called'])
296 # remove post-exec
296 # remove post-exec
297 ip._post_execute.pop(set_called)
297 ip._post_execute.pop(set_called)
298
298
299 def test_silent_noadvance(self):
299 def test_silent_noadvance(self):
300 """run_cell(silent=True) doesn't advance execution_count"""
300 """run_cell(silent=True) doesn't advance execution_count"""
301 ec = ip.execution_count
301 ec = ip.execution_count
302 # silent should force store_history=False
302 # silent should force store_history=False
303 ip.run_cell("1", store_history=True, silent=True)
303 ip.run_cell("1", store_history=True, silent=True)
304
304
305 self.assertEqual(ec, ip.execution_count)
305 self.assertEqual(ec, ip.execution_count)
306 # double-check that non-silent exec did what we expected
306 # double-check that non-silent exec did what we expected
307 # silent to avoid
307 # silent to avoid
308 ip.run_cell("1", store_history=True)
308 ip.run_cell("1", store_history=True)
309 self.assertEqual(ec+1, ip.execution_count)
309 self.assertEqual(ec+1, ip.execution_count)
310
310
311 def test_silent_nodisplayhook(self):
311 def test_silent_nodisplayhook(self):
312 """run_cell(silent=True) doesn't trigger displayhook"""
312 """run_cell(silent=True) doesn't trigger displayhook"""
313 d = dict(called=False)
313 d = dict(called=False)
314
314
315 trap = ip.display_trap
315 trap = ip.display_trap
316 save_hook = trap.hook
316 save_hook = trap.hook
317
317
318 def failing_hook(*args, **kwargs):
318 def failing_hook(*args, **kwargs):
319 d['called'] = True
319 d['called'] = True
320
320
321 try:
321 try:
322 trap.hook = failing_hook
322 trap.hook = failing_hook
323 ip.run_cell("1", silent=True)
323 ip.run_cell("1", silent=True)
324 self.assertFalse(d['called'])
324 self.assertFalse(d['called'])
325 # double-check that non-silent exec did what we expected
325 # double-check that non-silent exec did what we expected
326 # silent to avoid
326 # silent to avoid
327 ip.run_cell("1")
327 ip.run_cell("1")
328 self.assertTrue(d['called'])
328 self.assertTrue(d['called'])
329 finally:
329 finally:
330 trap.hook = save_hook
330 trap.hook = save_hook
331
331
332 @skipif(sys.version_info[0] >= 3, "softspace removed in py3")
332 @skipif(sys.version_info[0] >= 3, "softspace removed in py3")
333 def test_print_softspace(self):
333 def test_print_softspace(self):
334 """Verify that softspace is handled correctly when executing multiple
334 """Verify that softspace is handled correctly when executing multiple
335 statements.
335 statements.
336
336
337 In [1]: print 1; print 2
337 In [1]: print 1; print 2
338 1
338 1
339 2
339 2
340
340
341 In [2]: print 1,; print 2
341 In [2]: print 1,; print 2
342 1 2
342 1 2
343 """
343 """
344
344
345 def test_ofind_line_magic(self):
345 def test_ofind_line_magic(self):
346 from IPython.core.magic import register_line_magic
346 from IPython.core.magic import register_line_magic
347
347
348 @register_line_magic
348 @register_line_magic
349 def lmagic(line):
349 def lmagic(line):
350 "A line magic"
350 "A line magic"
351
351
352 # Get info on line magic
352 # Get info on line magic
353 lfind = ip._ofind('lmagic')
353 lfind = ip._ofind('lmagic')
354 info = dict(found=True, isalias=False, ismagic=True,
354 info = dict(found=True, isalias=False, ismagic=True,
355 namespace = 'IPython internal', obj= lmagic.__wrapped__,
355 namespace = 'IPython internal', obj= lmagic.__wrapped__,
356 parent = None)
356 parent = None)
357 nt.assert_equal(lfind, info)
357 nt.assert_equal(lfind, info)
358
358
359 def test_ofind_cell_magic(self):
359 def test_ofind_cell_magic(self):
360 from IPython.core.magic import register_cell_magic
360 from IPython.core.magic import register_cell_magic
361
361
362 @register_cell_magic
362 @register_cell_magic
363 def cmagic(line, cell):
363 def cmagic(line, cell):
364 "A cell magic"
364 "A cell magic"
365
365
366 # Get info on cell magic
366 # Get info on cell magic
367 find = ip._ofind('cmagic')
367 find = ip._ofind('cmagic')
368 info = dict(found=True, isalias=False, ismagic=True,
368 info = dict(found=True, isalias=False, ismagic=True,
369 namespace = 'IPython internal', obj= cmagic.__wrapped__,
369 namespace = 'IPython internal', obj= cmagic.__wrapped__,
370 parent = None)
370 parent = None)
371 nt.assert_equal(find, info)
371 nt.assert_equal(find, info)
372
372
373 def test_custom_exception(self):
373 def test_custom_exception(self):
374 called = []
374 called = []
375 def my_handler(shell, etype, value, tb, tb_offset=None):
375 def my_handler(shell, etype, value, tb, tb_offset=None):
376 called.append(etype)
376 called.append(etype)
377 shell.showtraceback((etype, value, tb), tb_offset=tb_offset)
377 shell.showtraceback((etype, value, tb), tb_offset=tb_offset)
378
378
379 ip.set_custom_exc((ValueError,), my_handler)
379 ip.set_custom_exc((ValueError,), my_handler)
380 try:
380 try:
381 ip.run_cell("raise ValueError('test')")
381 ip.run_cell("raise ValueError('test')")
382 # Check that this was called, and only once.
382 # Check that this was called, and only once.
383 self.assertEqual(called, [ValueError])
383 self.assertEqual(called, [ValueError])
384 finally:
384 finally:
385 # Reset the custom exception hook
385 # Reset the custom exception hook
386 ip.set_custom_exc((), None)
386 ip.set_custom_exc((), None)
387
388 @skipif(sys.version_info[0] >= 3, "no differences with __future__ in py3")
389 def test_future_environment(self):
390 "Can we run code with & without the shell's __future__ imports?"
391 ip.run_cell("from __future__ import division")
392 ip.run_cell("a = 1/2", shell_futures=True)
393 self.assertEqual(ip.user_ns['a'], 0.5)
394 ip.run_cell("b = 1/2", shell_futures=False)
395 self.assertEqual(ip.user_ns['b'], 0)
396
397 ip.compile.reset_compiler_flags()
398 # This shouldn't leak to the shell's compiler
399 ip.run_cell("from __future__ import division \nc=1/2", shell_futures=False)
400 self.assertEqual(ip.user_ns['c'], 0.5)
401 ip.run_cell("d = 1/2", shell_futures=True)
402 self.assertEqual(ip.user_ns['d'], 0)
387
403
388
404
389 class TestSafeExecfileNonAsciiPath(unittest.TestCase):
405 class TestSafeExecfileNonAsciiPath(unittest.TestCase):
390
406
391 def setUp(self):
407 def setUp(self):
392 self.BASETESTDIR = tempfile.mkdtemp()
408 self.BASETESTDIR = tempfile.mkdtemp()
393 self.TESTDIR = join(self.BASETESTDIR, u"Γ₯Àâ")
409 self.TESTDIR = join(self.BASETESTDIR, u"Γ₯Àâ")
394 os.mkdir(self.TESTDIR)
410 os.mkdir(self.TESTDIR)
395 with open(join(self.TESTDIR, u"Γ₯Àâtestscript.py"), "w") as sfile:
411 with open(join(self.TESTDIR, u"Γ₯Àâtestscript.py"), "w") as sfile:
396 sfile.write("pass\n")
412 sfile.write("pass\n")
397 self.oldpath = os.getcwdu()
413 self.oldpath = os.getcwdu()
398 os.chdir(self.TESTDIR)
414 os.chdir(self.TESTDIR)
399 self.fname = u"Γ₯Àâtestscript.py"
415 self.fname = u"Γ₯Àâtestscript.py"
400
416
401 def tearDown(self):
417 def tearDown(self):
402 os.chdir(self.oldpath)
418 os.chdir(self.oldpath)
403 shutil.rmtree(self.BASETESTDIR)
419 shutil.rmtree(self.BASETESTDIR)
404
420
405 def test_1(self):
421 def test_1(self):
406 """Test safe_execfile with non-ascii path
422 """Test safe_execfile with non-ascii path
407 """
423 """
408 ip.safe_execfile(self.fname, {}, raise_exceptions=True)
424 ip.safe_execfile(self.fname, {}, raise_exceptions=True)
409
425
410
426
411 class TestSystemRaw(unittest.TestCase):
427 class TestSystemRaw(unittest.TestCase):
412 def test_1(self):
428 def test_1(self):
413 """Test system_raw with non-ascii cmd
429 """Test system_raw with non-ascii cmd
414 """
430 """
415 cmd = ur'''python -c "'Γ₯Àâ'" '''
431 cmd = ur'''python -c "'Γ₯Àâ'" '''
416 ip.system_raw(cmd)
432 ip.system_raw(cmd)
417
433
418 def test_exit_code(self):
434 def test_exit_code(self):
419 """Test that the exit code is parsed correctly."""
435 """Test that the exit code is parsed correctly."""
420 ip.system_raw('exit 1')
436 ip.system_raw('exit 1')
421 self.assertEqual(ip.user_ns['_exit_code'], 1)
437 self.assertEqual(ip.user_ns['_exit_code'], 1)
422
438
423 class TestModules(unittest.TestCase, tt.TempFileMixin):
439 class TestModules(unittest.TestCase, tt.TempFileMixin):
424 def test_extraneous_loads(self):
440 def test_extraneous_loads(self):
425 """Test we're not loading modules on startup that we shouldn't.
441 """Test we're not loading modules on startup that we shouldn't.
426 """
442 """
427 self.mktmp("import sys\n"
443 self.mktmp("import sys\n"
428 "print('numpy' in sys.modules)\n"
444 "print('numpy' in sys.modules)\n"
429 "print('IPython.parallel' in sys.modules)\n"
445 "print('IPython.parallel' in sys.modules)\n"
430 "print('IPython.zmq' in sys.modules)\n"
446 "print('IPython.zmq' in sys.modules)\n"
431 )
447 )
432 out = "False\nFalse\nFalse\n"
448 out = "False\nFalse\nFalse\n"
433 tt.ipexec_validate(self.fname, out)
449 tt.ipexec_validate(self.fname, out)
434
450
435 class Negator(ast.NodeTransformer):
451 class Negator(ast.NodeTransformer):
436 """Negates all number literals in an AST."""
452 """Negates all number literals in an AST."""
437 def visit_Num(self, node):
453 def visit_Num(self, node):
438 node.n = -node.n
454 node.n = -node.n
439 return node
455 return node
440
456
441 class TestAstTransform(unittest.TestCase):
457 class TestAstTransform(unittest.TestCase):
442 def setUp(self):
458 def setUp(self):
443 self.negator = Negator()
459 self.negator = Negator()
444 ip.ast_transformers.append(self.negator)
460 ip.ast_transformers.append(self.negator)
445
461
446 def tearDown(self):
462 def tearDown(self):
447 ip.ast_transformers.remove(self.negator)
463 ip.ast_transformers.remove(self.negator)
448
464
449 def test_run_cell(self):
465 def test_run_cell(self):
450 with tt.AssertPrints('-34'):
466 with tt.AssertPrints('-34'):
451 ip.run_cell('print (12 + 22)')
467 ip.run_cell('print (12 + 22)')
452
468
453 # A named reference to a number shouldn't be transformed.
469 # A named reference to a number shouldn't be transformed.
454 ip.user_ns['n'] = 55
470 ip.user_ns['n'] = 55
455 with tt.AssertNotPrints('-55'):
471 with tt.AssertNotPrints('-55'):
456 ip.run_cell('print (n)')
472 ip.run_cell('print (n)')
457
473
458 def test_timeit(self):
474 def test_timeit(self):
459 called = set()
475 called = set()
460 def f(x):
476 def f(x):
461 called.add(x)
477 called.add(x)
462 ip.push({'f':f})
478 ip.push({'f':f})
463
479
464 with tt.AssertPrints("best of "):
480 with tt.AssertPrints("best of "):
465 ip.run_line_magic("timeit", "-n1 f(1)")
481 ip.run_line_magic("timeit", "-n1 f(1)")
466 self.assertEqual(called, set([-1]))
482 self.assertEqual(called, set([-1]))
467 called.clear()
483 called.clear()
468
484
469 with tt.AssertPrints("best of "):
485 with tt.AssertPrints("best of "):
470 ip.run_cell_magic("timeit", "-n1 f(2)", "f(3)")
486 ip.run_cell_magic("timeit", "-n1 f(2)", "f(3)")
471 self.assertEqual(called, set([-2, -3]))
487 self.assertEqual(called, set([-2, -3]))
472
488
473 def test_time(self):
489 def test_time(self):
474 called = []
490 called = []
475 def f(x):
491 def f(x):
476 called.append(x)
492 called.append(x)
477 ip.push({'f':f})
493 ip.push({'f':f})
478
494
479 # Test with an expression
495 # Test with an expression
480 with tt.AssertPrints("CPU times"):
496 with tt.AssertPrints("CPU times"):
481 ip.run_line_magic("time", "f(5+9)")
497 ip.run_line_magic("time", "f(5+9)")
482 self.assertEqual(called, [-14])
498 self.assertEqual(called, [-14])
483 called[:] = []
499 called[:] = []
484
500
485 # Test with a statement (different code path)
501 # Test with a statement (different code path)
486 with tt.AssertPrints("CPU times"):
502 with tt.AssertPrints("CPU times"):
487 ip.run_line_magic("time", "a = f(-3 + -2)")
503 ip.run_line_magic("time", "a = f(-3 + -2)")
488 self.assertEqual(called, [5])
504 self.assertEqual(called, [5])
489
505
490 def test_macro(self):
506 def test_macro(self):
491 ip.push({'a':10})
507 ip.push({'a':10})
492 # The AST transformation makes this do a+=-1
508 # The AST transformation makes this do a+=-1
493 ip.define_macro("amacro", "a+=1\nprint(a)")
509 ip.define_macro("amacro", "a+=1\nprint(a)")
494
510
495 with tt.AssertPrints("9"):
511 with tt.AssertPrints("9"):
496 ip.run_cell("amacro")
512 ip.run_cell("amacro")
497 with tt.AssertPrints("8"):
513 with tt.AssertPrints("8"):
498 ip.run_cell("amacro")
514 ip.run_cell("amacro")
499
515
500 class IntegerWrapper(ast.NodeTransformer):
516 class IntegerWrapper(ast.NodeTransformer):
501 """Wraps all integers in a call to Integer()"""
517 """Wraps all integers in a call to Integer()"""
502 def visit_Num(self, node):
518 def visit_Num(self, node):
503 if isinstance(node.n, int):
519 if isinstance(node.n, int):
504 return ast.Call(func=ast.Name(id='Integer', ctx=ast.Load()),
520 return ast.Call(func=ast.Name(id='Integer', ctx=ast.Load()),
505 args=[node], keywords=[])
521 args=[node], keywords=[])
506 return node
522 return node
507
523
508 class TestAstTransform2(unittest.TestCase):
524 class TestAstTransform2(unittest.TestCase):
509 def setUp(self):
525 def setUp(self):
510 self.intwrapper = IntegerWrapper()
526 self.intwrapper = IntegerWrapper()
511 ip.ast_transformers.append(self.intwrapper)
527 ip.ast_transformers.append(self.intwrapper)
512
528
513 self.calls = []
529 self.calls = []
514 def Integer(*args):
530 def Integer(*args):
515 self.calls.append(args)
531 self.calls.append(args)
516 return args
532 return args
517 ip.push({"Integer": Integer})
533 ip.push({"Integer": Integer})
518
534
519 def tearDown(self):
535 def tearDown(self):
520 ip.ast_transformers.remove(self.intwrapper)
536 ip.ast_transformers.remove(self.intwrapper)
521 del ip.user_ns['Integer']
537 del ip.user_ns['Integer']
522
538
523 def test_run_cell(self):
539 def test_run_cell(self):
524 ip.run_cell("n = 2")
540 ip.run_cell("n = 2")
525 self.assertEqual(self.calls, [(2,)])
541 self.assertEqual(self.calls, [(2,)])
526
542
527 # This shouldn't throw an error
543 # This shouldn't throw an error
528 ip.run_cell("o = 2.0")
544 ip.run_cell("o = 2.0")
529 self.assertEqual(ip.user_ns['o'], 2.0)
545 self.assertEqual(ip.user_ns['o'], 2.0)
530
546
531 def test_timeit(self):
547 def test_timeit(self):
532 called = set()
548 called = set()
533 def f(x):
549 def f(x):
534 called.add(x)
550 called.add(x)
535 ip.push({'f':f})
551 ip.push({'f':f})
536
552
537 with tt.AssertPrints("best of "):
553 with tt.AssertPrints("best of "):
538 ip.run_line_magic("timeit", "-n1 f(1)")
554 ip.run_line_magic("timeit", "-n1 f(1)")
539 self.assertEqual(called, set([(1,)]))
555 self.assertEqual(called, set([(1,)]))
540 called.clear()
556 called.clear()
541
557
542 with tt.AssertPrints("best of "):
558 with tt.AssertPrints("best of "):
543 ip.run_cell_magic("timeit", "-n1 f(2)", "f(3)")
559 ip.run_cell_magic("timeit", "-n1 f(2)", "f(3)")
544 self.assertEqual(called, set([(2,), (3,)]))
560 self.assertEqual(called, set([(2,), (3,)]))
545
561
546 class ErrorTransformer(ast.NodeTransformer):
562 class ErrorTransformer(ast.NodeTransformer):
547 """Throws an error when it sees a number."""
563 """Throws an error when it sees a number."""
548 def visit_Num(self):
564 def visit_Num(self):
549 raise ValueError("test")
565 raise ValueError("test")
550
566
551 class TestAstTransformError(unittest.TestCase):
567 class TestAstTransformError(unittest.TestCase):
552 def test_unregistering(self):
568 def test_unregistering(self):
553 err_transformer = ErrorTransformer()
569 err_transformer = ErrorTransformer()
554 ip.ast_transformers.append(err_transformer)
570 ip.ast_transformers.append(err_transformer)
555
571
556 with tt.AssertPrints("unregister", channel='stderr'):
572 with tt.AssertPrints("unregister", channel='stderr'):
557 ip.run_cell("1 + 2")
573 ip.run_cell("1 + 2")
558
574
559 # This should have been removed.
575 # This should have been removed.
560 nt.assert_not_in(err_transformer, ip.ast_transformers)
576 nt.assert_not_in(err_transformer, ip.ast_transformers)
561
577
562 def test__IPYTHON__():
578 def test__IPYTHON__():
563 # This shouldn't raise a NameError, that's all
579 # This shouldn't raise a NameError, that's all
564 __IPYTHON__
580 __IPYTHON__
@@ -1,840 +1,840 b''
1 # -*- coding: utf-8 -*-
1 # -*- coding: utf-8 -*-
2 """Tests for various magic functions.
2 """Tests for various magic functions.
3
3
4 Needs to be run by nose (to make ipython session available).
4 Needs to be run by nose (to make ipython session available).
5 """
5 """
6 from __future__ import absolute_import
6 from __future__ import absolute_import
7
7
8 #-----------------------------------------------------------------------------
8 #-----------------------------------------------------------------------------
9 # Imports
9 # Imports
10 #-----------------------------------------------------------------------------
10 #-----------------------------------------------------------------------------
11
11
12 import io
12 import io
13 import os
13 import os
14 import sys
14 import sys
15 from StringIO import StringIO
15 from StringIO import StringIO
16 from unittest import TestCase
16 from unittest import TestCase
17
17
18 try:
18 try:
19 from importlib import invalidate_caches # Required from Python 3.3
19 from importlib import invalidate_caches # Required from Python 3.3
20 except ImportError:
20 except ImportError:
21 def invalidate_caches():
21 def invalidate_caches():
22 pass
22 pass
23
23
24 import nose.tools as nt
24 import nose.tools as nt
25
25
26 from IPython.core import magic
26 from IPython.core import magic
27 from IPython.core.magic import (Magics, magics_class, line_magic,
27 from IPython.core.magic import (Magics, magics_class, line_magic,
28 cell_magic, line_cell_magic,
28 cell_magic, line_cell_magic,
29 register_line_magic, register_cell_magic,
29 register_line_magic, register_cell_magic,
30 register_line_cell_magic)
30 register_line_cell_magic)
31 from IPython.core.magics import execution, script, code
31 from IPython.core.magics import execution, script, code
32 from IPython.nbformat.v3.tests.nbexamples import nb0
32 from IPython.nbformat.v3.tests.nbexamples import nb0
33 from IPython.nbformat import current
33 from IPython.nbformat import current
34 from IPython.testing import decorators as dec
34 from IPython.testing import decorators as dec
35 from IPython.testing import tools as tt
35 from IPython.testing import tools as tt
36 from IPython.utils import py3compat
36 from IPython.utils import py3compat
37 from IPython.utils.tempdir import TemporaryDirectory
37 from IPython.utils.tempdir import TemporaryDirectory
38 from IPython.utils.process import find_cmd
38 from IPython.utils.process import find_cmd
39
39
40 #-----------------------------------------------------------------------------
40 #-----------------------------------------------------------------------------
41 # Test functions begin
41 # Test functions begin
42 #-----------------------------------------------------------------------------
42 #-----------------------------------------------------------------------------
43
43
44 @magic.magics_class
44 @magic.magics_class
45 class DummyMagics(magic.Magics): pass
45 class DummyMagics(magic.Magics): pass
46
46
47 def test_rehashx():
47 def test_rehashx():
48 # clear up everything
48 # clear up everything
49 _ip = get_ipython()
49 _ip = get_ipython()
50 _ip.alias_manager.alias_table.clear()
50 _ip.alias_manager.alias_table.clear()
51 del _ip.db['syscmdlist']
51 del _ip.db['syscmdlist']
52
52
53 _ip.magic('rehashx')
53 _ip.magic('rehashx')
54 # Practically ALL ipython development systems will have more than 10 aliases
54 # Practically ALL ipython development systems will have more than 10 aliases
55
55
56 yield (nt.assert_true, len(_ip.alias_manager.alias_table) > 10)
56 yield (nt.assert_true, len(_ip.alias_manager.alias_table) > 10)
57 for key, val in _ip.alias_manager.alias_table.iteritems():
57 for key, val in _ip.alias_manager.alias_table.iteritems():
58 # we must strip dots from alias names
58 # we must strip dots from alias names
59 nt.assert_true('.' not in key)
59 nt.assert_true('.' not in key)
60
60
61 # rehashx must fill up syscmdlist
61 # rehashx must fill up syscmdlist
62 scoms = _ip.db['syscmdlist']
62 scoms = _ip.db['syscmdlist']
63 yield (nt.assert_true, len(scoms) > 10)
63 yield (nt.assert_true, len(scoms) > 10)
64
64
65
65
66 def test_magic_parse_options():
66 def test_magic_parse_options():
67 """Test that we don't mangle paths when parsing magic options."""
67 """Test that we don't mangle paths when parsing magic options."""
68 ip = get_ipython()
68 ip = get_ipython()
69 path = 'c:\\x'
69 path = 'c:\\x'
70 m = DummyMagics(ip)
70 m = DummyMagics(ip)
71 opts = m.parse_options('-f %s' % path,'f:')[0]
71 opts = m.parse_options('-f %s' % path,'f:')[0]
72 # argv splitting is os-dependent
72 # argv splitting is os-dependent
73 if os.name == 'posix':
73 if os.name == 'posix':
74 expected = 'c:x'
74 expected = 'c:x'
75 else:
75 else:
76 expected = path
76 expected = path
77 nt.assert_equal(opts['f'], expected)
77 nt.assert_equal(opts['f'], expected)
78
78
79 def test_magic_parse_long_options():
79 def test_magic_parse_long_options():
80 """Magic.parse_options can handle --foo=bar long options"""
80 """Magic.parse_options can handle --foo=bar long options"""
81 ip = get_ipython()
81 ip = get_ipython()
82 m = DummyMagics(ip)
82 m = DummyMagics(ip)
83 opts, _ = m.parse_options('--foo --bar=bubble', 'a', 'foo', 'bar=')
83 opts, _ = m.parse_options('--foo --bar=bubble', 'a', 'foo', 'bar=')
84 nt.assert_true('foo' in opts)
84 nt.assert_true('foo' in opts)
85 nt.assert_true('bar' in opts)
85 nt.assert_true('bar' in opts)
86 nt.assert_true(opts['bar'], "bubble")
86 nt.assert_true(opts['bar'], "bubble")
87
87
88
88
89 @dec.skip_without('sqlite3')
89 @dec.skip_without('sqlite3')
90 def doctest_hist_f():
90 def doctest_hist_f():
91 """Test %hist -f with temporary filename.
91 """Test %hist -f with temporary filename.
92
92
93 In [9]: import tempfile
93 In [9]: import tempfile
94
94
95 In [10]: tfile = tempfile.mktemp('.py','tmp-ipython-')
95 In [10]: tfile = tempfile.mktemp('.py','tmp-ipython-')
96
96
97 In [11]: %hist -nl -f $tfile 3
97 In [11]: %hist -nl -f $tfile 3
98
98
99 In [13]: import os; os.unlink(tfile)
99 In [13]: import os; os.unlink(tfile)
100 """
100 """
101
101
102
102
103 @dec.skip_without('sqlite3')
103 @dec.skip_without('sqlite3')
104 def doctest_hist_r():
104 def doctest_hist_r():
105 """Test %hist -r
105 """Test %hist -r
106
106
107 XXX - This test is not recording the output correctly. For some reason, in
107 XXX - This test is not recording the output correctly. For some reason, in
108 testing mode the raw history isn't getting populated. No idea why.
108 testing mode the raw history isn't getting populated. No idea why.
109 Disabling the output checking for now, though at least we do run it.
109 Disabling the output checking for now, though at least we do run it.
110
110
111 In [1]: 'hist' in _ip.lsmagic()
111 In [1]: 'hist' in _ip.lsmagic()
112 Out[1]: True
112 Out[1]: True
113
113
114 In [2]: x=1
114 In [2]: x=1
115
115
116 In [3]: %hist -rl 2
116 In [3]: %hist -rl 2
117 x=1 # random
117 x=1 # random
118 %hist -r 2
118 %hist -r 2
119 """
119 """
120
120
121
121
122 @dec.skip_without('sqlite3')
122 @dec.skip_without('sqlite3')
123 def doctest_hist_op():
123 def doctest_hist_op():
124 """Test %hist -op
124 """Test %hist -op
125
125
126 In [1]: class b(float):
126 In [1]: class b(float):
127 ...: pass
127 ...: pass
128 ...:
128 ...:
129
129
130 In [2]: class s(object):
130 In [2]: class s(object):
131 ...: def __str__(self):
131 ...: def __str__(self):
132 ...: return 's'
132 ...: return 's'
133 ...:
133 ...:
134
134
135 In [3]:
135 In [3]:
136
136
137 In [4]: class r(b):
137 In [4]: class r(b):
138 ...: def __repr__(self):
138 ...: def __repr__(self):
139 ...: return 'r'
139 ...: return 'r'
140 ...:
140 ...:
141
141
142 In [5]: class sr(s,r): pass
142 In [5]: class sr(s,r): pass
143 ...:
143 ...:
144
144
145 In [6]:
145 In [6]:
146
146
147 In [7]: bb=b()
147 In [7]: bb=b()
148
148
149 In [8]: ss=s()
149 In [8]: ss=s()
150
150
151 In [9]: rr=r()
151 In [9]: rr=r()
152
152
153 In [10]: ssrr=sr()
153 In [10]: ssrr=sr()
154
154
155 In [11]: 4.5
155 In [11]: 4.5
156 Out[11]: 4.5
156 Out[11]: 4.5
157
157
158 In [12]: str(ss)
158 In [12]: str(ss)
159 Out[12]: 's'
159 Out[12]: 's'
160
160
161 In [13]:
161 In [13]:
162
162
163 In [14]: %hist -op
163 In [14]: %hist -op
164 >>> class b:
164 >>> class b:
165 ... pass
165 ... pass
166 ...
166 ...
167 >>> class s(b):
167 >>> class s(b):
168 ... def __str__(self):
168 ... def __str__(self):
169 ... return 's'
169 ... return 's'
170 ...
170 ...
171 >>>
171 >>>
172 >>> class r(b):
172 >>> class r(b):
173 ... def __repr__(self):
173 ... def __repr__(self):
174 ... return 'r'
174 ... return 'r'
175 ...
175 ...
176 >>> class sr(s,r): pass
176 >>> class sr(s,r): pass
177 >>>
177 >>>
178 >>> bb=b()
178 >>> bb=b()
179 >>> ss=s()
179 >>> ss=s()
180 >>> rr=r()
180 >>> rr=r()
181 >>> ssrr=sr()
181 >>> ssrr=sr()
182 >>> 4.5
182 >>> 4.5
183 4.5
183 4.5
184 >>> str(ss)
184 >>> str(ss)
185 's'
185 's'
186 >>>
186 >>>
187 """
187 """
188
188
189
189
190 @dec.skip_without('sqlite3')
190 @dec.skip_without('sqlite3')
191 def test_macro():
191 def test_macro():
192 ip = get_ipython()
192 ip = get_ipython()
193 ip.history_manager.reset() # Clear any existing history.
193 ip.history_manager.reset() # Clear any existing history.
194 cmds = ["a=1", "def b():\n return a**2", "print(a,b())"]
194 cmds = ["a=1", "def b():\n return a**2", "print(a,b())"]
195 for i, cmd in enumerate(cmds, start=1):
195 for i, cmd in enumerate(cmds, start=1):
196 ip.history_manager.store_inputs(i, cmd)
196 ip.history_manager.store_inputs(i, cmd)
197 ip.magic("macro test 1-3")
197 ip.magic("macro test 1-3")
198 nt.assert_equal(ip.user_ns["test"].value, "\n".join(cmds)+"\n")
198 nt.assert_equal(ip.user_ns["test"].value, "\n".join(cmds)+"\n")
199
199
200 # List macros.
200 # List macros.
201 assert "test" in ip.magic("macro")
201 assert "test" in ip.magic("macro")
202
202
203
203
204 @dec.skip_without('sqlite3')
204 @dec.skip_without('sqlite3')
205 def test_macro_run():
205 def test_macro_run():
206 """Test that we can run a multi-line macro successfully."""
206 """Test that we can run a multi-line macro successfully."""
207 ip = get_ipython()
207 ip = get_ipython()
208 ip.history_manager.reset()
208 ip.history_manager.reset()
209 cmds = ["a=10", "a+=1", py3compat.doctest_refactor_print("print a"),
209 cmds = ["a=10", "a+=1", py3compat.doctest_refactor_print("print a"),
210 "%macro test 2-3"]
210 "%macro test 2-3"]
211 for cmd in cmds:
211 for cmd in cmds:
212 ip.run_cell(cmd, store_history=True)
212 ip.run_cell(cmd, store_history=True)
213 nt.assert_equal(ip.user_ns["test"].value,
213 nt.assert_equal(ip.user_ns["test"].value,
214 py3compat.doctest_refactor_print("a+=1\nprint a\n"))
214 py3compat.doctest_refactor_print("a+=1\nprint a\n"))
215 with tt.AssertPrints("12"):
215 with tt.AssertPrints("12"):
216 ip.run_cell("test")
216 ip.run_cell("test")
217 with tt.AssertPrints("13"):
217 with tt.AssertPrints("13"):
218 ip.run_cell("test")
218 ip.run_cell("test")
219
219
220
220
221 @dec.skipif_not_numpy
221 @dec.skipif_not_numpy
222 def test_numpy_reset_array_undec():
222 def test_numpy_reset_array_undec():
223 "Test '%reset array' functionality"
223 "Test '%reset array' functionality"
224 _ip.ex('import numpy as np')
224 _ip.ex('import numpy as np')
225 _ip.ex('a = np.empty(2)')
225 _ip.ex('a = np.empty(2)')
226 yield (nt.assert_true, 'a' in _ip.user_ns)
226 yield (nt.assert_true, 'a' in _ip.user_ns)
227 _ip.magic('reset -f array')
227 _ip.magic('reset -f array')
228 yield (nt.assert_false, 'a' in _ip.user_ns)
228 yield (nt.assert_false, 'a' in _ip.user_ns)
229
229
230 def test_reset_out():
230 def test_reset_out():
231 "Test '%reset out' magic"
231 "Test '%reset out' magic"
232 _ip.run_cell("parrot = 'dead'", store_history=True)
232 _ip.run_cell("parrot = 'dead'", store_history=True)
233 # test '%reset -f out', make an Out prompt
233 # test '%reset -f out', make an Out prompt
234 _ip.run_cell("parrot", store_history=True)
234 _ip.run_cell("parrot", store_history=True)
235 nt.assert_true('dead' in [_ip.user_ns[x] for x in '_','__','___'])
235 nt.assert_true('dead' in [_ip.user_ns[x] for x in '_','__','___'])
236 _ip.magic('reset -f out')
236 _ip.magic('reset -f out')
237 nt.assert_false('dead' in [_ip.user_ns[x] for x in '_','__','___'])
237 nt.assert_false('dead' in [_ip.user_ns[x] for x in '_','__','___'])
238 nt.assert_true(len(_ip.user_ns['Out']) == 0)
238 nt.assert_true(len(_ip.user_ns['Out']) == 0)
239
239
240 def test_reset_in():
240 def test_reset_in():
241 "Test '%reset in' magic"
241 "Test '%reset in' magic"
242 # test '%reset -f in'
242 # test '%reset -f in'
243 _ip.run_cell("parrot", store_history=True)
243 _ip.run_cell("parrot", store_history=True)
244 nt.assert_true('parrot' in [_ip.user_ns[x] for x in '_i','_ii','_iii'])
244 nt.assert_true('parrot' in [_ip.user_ns[x] for x in '_i','_ii','_iii'])
245 _ip.magic('%reset -f in')
245 _ip.magic('%reset -f in')
246 nt.assert_false('parrot' in [_ip.user_ns[x] for x in '_i','_ii','_iii'])
246 nt.assert_false('parrot' in [_ip.user_ns[x] for x in '_i','_ii','_iii'])
247 nt.assert_true(len(set(_ip.user_ns['In'])) == 1)
247 nt.assert_true(len(set(_ip.user_ns['In'])) == 1)
248
248
249 def test_reset_dhist():
249 def test_reset_dhist():
250 "Test '%reset dhist' magic"
250 "Test '%reset dhist' magic"
251 _ip.run_cell("tmp = [d for d in _dh]") # copy before clearing
251 _ip.run_cell("tmp = [d for d in _dh]") # copy before clearing
252 _ip.magic('cd ' + os.path.dirname(nt.__file__))
252 _ip.magic('cd ' + os.path.dirname(nt.__file__))
253 _ip.magic('cd -')
253 _ip.magic('cd -')
254 nt.assert_true(len(_ip.user_ns['_dh']) > 0)
254 nt.assert_true(len(_ip.user_ns['_dh']) > 0)
255 _ip.magic('reset -f dhist')
255 _ip.magic('reset -f dhist')
256 nt.assert_true(len(_ip.user_ns['_dh']) == 0)
256 nt.assert_true(len(_ip.user_ns['_dh']) == 0)
257 _ip.run_cell("_dh = [d for d in tmp]") #restore
257 _ip.run_cell("_dh = [d for d in tmp]") #restore
258
258
259 def test_reset_in_length():
259 def test_reset_in_length():
260 "Test that '%reset in' preserves In[] length"
260 "Test that '%reset in' preserves In[] length"
261 _ip.run_cell("print 'foo'")
261 _ip.run_cell("print 'foo'")
262 _ip.run_cell("reset -f in")
262 _ip.run_cell("reset -f in")
263 nt.assert_true(len(_ip.user_ns['In']) == _ip.displayhook.prompt_count+1)
263 nt.assert_true(len(_ip.user_ns['In']) == _ip.displayhook.prompt_count+1)
264
264
265 def test_time():
265 def test_time():
266 _ip.magic('time None')
266 _ip.magic('time None')
267
267
268 def test_tb_syntaxerror():
268 def test_tb_syntaxerror():
269 """test %tb after a SyntaxError"""
269 """test %tb after a SyntaxError"""
270 ip = get_ipython()
270 ip = get_ipython()
271 ip.run_cell("for")
271 ip.run_cell("for")
272
272
273 # trap and validate stdout
273 # trap and validate stdout
274 save_stdout = sys.stdout
274 save_stdout = sys.stdout
275 try:
275 try:
276 sys.stdout = StringIO()
276 sys.stdout = StringIO()
277 ip.run_cell("%tb")
277 ip.run_cell("%tb")
278 out = sys.stdout.getvalue()
278 out = sys.stdout.getvalue()
279 finally:
279 finally:
280 sys.stdout = save_stdout
280 sys.stdout = save_stdout
281 # trim output, and only check the last line
281 # trim output, and only check the last line
282 last_line = out.rstrip().splitlines()[-1].strip()
282 last_line = out.rstrip().splitlines()[-1].strip()
283 nt.assert_equal(last_line, "SyntaxError: invalid syntax")
283 nt.assert_equal(last_line, "SyntaxError: invalid syntax")
284
284
285
285
286 def test_time():
286 def test_time():
287 ip = get_ipython()
287 ip = get_ipython()
288
288
289 with tt.AssertPrints("CPU times: user 0.00 s, sys: 0.00 s, total: 0.00 s"):
289 with tt.AssertPrints("CPU times: user 0.00 s, sys: 0.00 s, total: 0.00 s"):
290 ip.run_cell("%time None")
290 ip.run_cell("%time None")
291
291
292 ip.run_cell("def f(kmjy):\n"
292 ip.run_cell("def f(kmjy):\n"
293 " %time print (2*kmjy)")
293 " %time print (2*kmjy)")
294
294
295 with tt.AssertPrints("CPU times: user 0.00 s, sys: 0.00 s, total: 0.00 s"):
295 with tt.AssertPrints("CPU times: user 0.00 s, sys: 0.00 s, total: 0.00 s"):
296 with tt.AssertPrints("hihi", suppress=False):
296 with tt.AssertPrints("hihi", suppress=False):
297 ip.run_cell("f('hi')")
297 ip.run_cell("f('hi')")
298
298
299 def test_doctest_mode():
299 def test_doctest_mode():
300 "Toggle doctest_mode twice, it should be a no-op and run without error"
300 "Toggle doctest_mode twice, it should be a no-op and run without error"
301 _ip.magic('doctest_mode')
301 _ip.magic('doctest_mode')
302 _ip.magic('doctest_mode')
302 _ip.magic('doctest_mode')
303
303
304
304
305 def test_parse_options():
305 def test_parse_options():
306 """Tests for basic options parsing in magics."""
306 """Tests for basic options parsing in magics."""
307 # These are only the most minimal of tests, more should be added later. At
307 # These are only the most minimal of tests, more should be added later. At
308 # the very least we check that basic text/unicode calls work OK.
308 # the very least we check that basic text/unicode calls work OK.
309 m = DummyMagics(_ip)
309 m = DummyMagics(_ip)
310 nt.assert_equal(m.parse_options('foo', '')[1], 'foo')
310 nt.assert_equal(m.parse_options('foo', '')[1], 'foo')
311 nt.assert_equal(m.parse_options(u'foo', '')[1], u'foo')
311 nt.assert_equal(m.parse_options(u'foo', '')[1], u'foo')
312
312
313
313
314 def test_dirops():
314 def test_dirops():
315 """Test various directory handling operations."""
315 """Test various directory handling operations."""
316 # curpath = lambda :os.path.splitdrive(os.getcwdu())[1].replace('\\','/')
316 # curpath = lambda :os.path.splitdrive(os.getcwdu())[1].replace('\\','/')
317 curpath = os.getcwdu
317 curpath = os.getcwdu
318 startdir = os.getcwdu()
318 startdir = os.getcwdu()
319 ipdir = os.path.realpath(_ip.ipython_dir)
319 ipdir = os.path.realpath(_ip.ipython_dir)
320 try:
320 try:
321 _ip.magic('cd "%s"' % ipdir)
321 _ip.magic('cd "%s"' % ipdir)
322 nt.assert_equal(curpath(), ipdir)
322 nt.assert_equal(curpath(), ipdir)
323 _ip.magic('cd -')
323 _ip.magic('cd -')
324 nt.assert_equal(curpath(), startdir)
324 nt.assert_equal(curpath(), startdir)
325 _ip.magic('pushd "%s"' % ipdir)
325 _ip.magic('pushd "%s"' % ipdir)
326 nt.assert_equal(curpath(), ipdir)
326 nt.assert_equal(curpath(), ipdir)
327 _ip.magic('popd')
327 _ip.magic('popd')
328 nt.assert_equal(curpath(), startdir)
328 nt.assert_equal(curpath(), startdir)
329 finally:
329 finally:
330 os.chdir(startdir)
330 os.chdir(startdir)
331
331
332
332
333 def test_xmode():
333 def test_xmode():
334 # Calling xmode three times should be a no-op
334 # Calling xmode three times should be a no-op
335 xmode = _ip.InteractiveTB.mode
335 xmode = _ip.InteractiveTB.mode
336 for i in range(3):
336 for i in range(3):
337 _ip.magic("xmode")
337 _ip.magic("xmode")
338 nt.assert_equal(_ip.InteractiveTB.mode, xmode)
338 nt.assert_equal(_ip.InteractiveTB.mode, xmode)
339
339
340 def test_reset_hard():
340 def test_reset_hard():
341 monitor = []
341 monitor = []
342 class A(object):
342 class A(object):
343 def __del__(self):
343 def __del__(self):
344 monitor.append(1)
344 monitor.append(1)
345 def __repr__(self):
345 def __repr__(self):
346 return "<A instance>"
346 return "<A instance>"
347
347
348 _ip.user_ns["a"] = A()
348 _ip.user_ns["a"] = A()
349 _ip.run_cell("a")
349 _ip.run_cell("a")
350
350
351 nt.assert_equal(monitor, [])
351 nt.assert_equal(monitor, [])
352 _ip.magic("reset -f")
352 _ip.magic("reset -f")
353 nt.assert_equal(monitor, [1])
353 nt.assert_equal(monitor, [1])
354
354
355 class TestXdel(tt.TempFileMixin):
355 class TestXdel(tt.TempFileMixin):
356 def test_xdel(self):
356 def test_xdel(self):
357 """Test that references from %run are cleared by xdel."""
357 """Test that references from %run are cleared by xdel."""
358 src = ("class A(object):\n"
358 src = ("class A(object):\n"
359 " monitor = []\n"
359 " monitor = []\n"
360 " def __del__(self):\n"
360 " def __del__(self):\n"
361 " self.monitor.append(1)\n"
361 " self.monitor.append(1)\n"
362 "a = A()\n")
362 "a = A()\n")
363 self.mktmp(src)
363 self.mktmp(src)
364 # %run creates some hidden references...
364 # %run creates some hidden references...
365 _ip.magic("run %s" % self.fname)
365 _ip.magic("run %s" % self.fname)
366 # ... as does the displayhook.
366 # ... as does the displayhook.
367 _ip.run_cell("a")
367 _ip.run_cell("a")
368
368
369 monitor = _ip.user_ns["A"].monitor
369 monitor = _ip.user_ns["A"].monitor
370 nt.assert_equal(monitor, [])
370 nt.assert_equal(monitor, [])
371
371
372 _ip.magic("xdel a")
372 _ip.magic("xdel a")
373
373
374 # Check that a's __del__ method has been called.
374 # Check that a's __del__ method has been called.
375 nt.assert_equal(monitor, [1])
375 nt.assert_equal(monitor, [1])
376
376
377 def doctest_who():
377 def doctest_who():
378 """doctest for %who
378 """doctest for %who
379
379
380 In [1]: %reset -f
380 In [1]: %reset -f
381
381
382 In [2]: alpha = 123
382 In [2]: alpha = 123
383
383
384 In [3]: beta = 'beta'
384 In [3]: beta = 'beta'
385
385
386 In [4]: %who int
386 In [4]: %who int
387 alpha
387 alpha
388
388
389 In [5]: %who str
389 In [5]: %who str
390 beta
390 beta
391
391
392 In [6]: %whos
392 In [6]: %whos
393 Variable Type Data/Info
393 Variable Type Data/Info
394 ----------------------------
394 ----------------------------
395 alpha int 123
395 alpha int 123
396 beta str beta
396 beta str beta
397
397
398 In [7]: %who_ls
398 In [7]: %who_ls
399 Out[7]: ['alpha', 'beta']
399 Out[7]: ['alpha', 'beta']
400 """
400 """
401
401
402 def test_whos():
402 def test_whos():
403 """Check that whos is protected against objects where repr() fails."""
403 """Check that whos is protected against objects where repr() fails."""
404 class A(object):
404 class A(object):
405 def __repr__(self):
405 def __repr__(self):
406 raise Exception()
406 raise Exception()
407 _ip.user_ns['a'] = A()
407 _ip.user_ns['a'] = A()
408 _ip.magic("whos")
408 _ip.magic("whos")
409
409
410 @py3compat.u_format
410 @py3compat.u_format
411 def doctest_precision():
411 def doctest_precision():
412 """doctest for %precision
412 """doctest for %precision
413
413
414 In [1]: f = get_ipython().display_formatter.formatters['text/plain']
414 In [1]: f = get_ipython().display_formatter.formatters['text/plain']
415
415
416 In [2]: %precision 5
416 In [2]: %precision 5
417 Out[2]: {u}'%.5f'
417 Out[2]: {u}'%.5f'
418
418
419 In [3]: f.float_format
419 In [3]: f.float_format
420 Out[3]: {u}'%.5f'
420 Out[3]: {u}'%.5f'
421
421
422 In [4]: %precision %e
422 In [4]: %precision %e
423 Out[4]: {u}'%e'
423 Out[4]: {u}'%e'
424
424
425 In [5]: f(3.1415927)
425 In [5]: f(3.1415927)
426 Out[5]: {u}'3.141593e+00'
426 Out[5]: {u}'3.141593e+00'
427 """
427 """
428
428
429 def test_psearch():
429 def test_psearch():
430 with tt.AssertPrints("dict.fromkeys"):
430 with tt.AssertPrints("dict.fromkeys"):
431 _ip.run_cell("dict.fr*?")
431 _ip.run_cell("dict.fr*?")
432
432
433 def test_timeit_shlex():
433 def test_timeit_shlex():
434 """test shlex issues with timeit (#1109)"""
434 """test shlex issues with timeit (#1109)"""
435 _ip.ex("def f(*a,**kw): pass")
435 _ip.ex("def f(*a,**kw): pass")
436 _ip.magic('timeit -n1 "this is a bug".count(" ")')
436 _ip.magic('timeit -n1 "this is a bug".count(" ")')
437 _ip.magic('timeit -r1 -n1 f(" ", 1)')
437 _ip.magic('timeit -r1 -n1 f(" ", 1)')
438 _ip.magic('timeit -r1 -n1 f(" ", 1, " ", 2, " ")')
438 _ip.magic('timeit -r1 -n1 f(" ", 1, " ", 2, " ")')
439 _ip.magic('timeit -r1 -n1 ("a " + "b")')
439 _ip.magic('timeit -r1 -n1 ("a " + "b")')
440 _ip.magic('timeit -r1 -n1 f("a " + "b")')
440 _ip.magic('timeit -r1 -n1 f("a " + "b")')
441 _ip.magic('timeit -r1 -n1 f("a " + "b ")')
441 _ip.magic('timeit -r1 -n1 f("a " + "b ")')
442
442
443
443
444 def test_timeit_arguments():
444 def test_timeit_arguments():
445 "Test valid timeit arguments, should not cause SyntaxError (GH #1269)"
445 "Test valid timeit arguments, should not cause SyntaxError (GH #1269)"
446 _ip.magic("timeit ('#')")
446 _ip.magic("timeit ('#')")
447
447
448
448
449 def test_timeit_special_syntax():
449 def test_timeit_special_syntax():
450 "Test %%timeit with IPython special syntax"
450 "Test %%timeit with IPython special syntax"
451 from IPython.core.magic import register_line_magic
451 from IPython.core.magic import register_line_magic
452
452
453 @register_line_magic
453 @register_line_magic
454 def lmagic(line):
454 def lmagic(line):
455 ip = get_ipython()
455 ip = get_ipython()
456 ip.user_ns['lmagic_out'] = line
456 ip.user_ns['lmagic_out'] = line
457
457
458 # line mode test
458 # line mode test
459 _ip.run_line_magic('timeit', '-n1 -r1 %lmagic my line')
459 _ip.run_line_magic('timeit', '-n1 -r1 %lmagic my line')
460 nt.assert_equal(_ip.user_ns['lmagic_out'], 'my line')
460 nt.assert_equal(_ip.user_ns['lmagic_out'], 'my line')
461 # cell mode test
461 # cell mode test
462 _ip.run_cell_magic('timeit', '-n1 -r1', '%lmagic my line2')
462 _ip.run_cell_magic('timeit', '-n1 -r1', '%lmagic my line2')
463 nt.assert_equal(_ip.user_ns['lmagic_out'], 'my line2')
463 nt.assert_equal(_ip.user_ns['lmagic_out'], 'my line2')
464
464
465
465
466 @dec.skipif(execution.profile is None)
466 @dec.skipif(execution.profile is None)
467 def test_prun_quotes():
467 def test_prun_quotes():
468 "Test that prun does not clobber string escapes (GH #1302)"
468 "Test that prun does not clobber string escapes (GH #1302)"
469 _ip.magic(r"prun -q x = '\t'")
469 _ip.magic(r"prun -q x = '\t'")
470 nt.assert_equal(_ip.user_ns['x'], '\t')
470 nt.assert_equal(_ip.user_ns['x'], '\t')
471
471
472 def test_extension():
472 def test_extension():
473 tmpdir = TemporaryDirectory()
473 tmpdir = TemporaryDirectory()
474 orig_ipython_dir = _ip.ipython_dir
474 orig_ipython_dir = _ip.ipython_dir
475 try:
475 try:
476 _ip.ipython_dir = tmpdir.name
476 _ip.ipython_dir = tmpdir.name
477 nt.assert_raises(ImportError, _ip.magic, "load_ext daft_extension")
477 nt.assert_raises(ImportError, _ip.magic, "load_ext daft_extension")
478 url = os.path.join(os.path.dirname(__file__), "daft_extension.py")
478 url = os.path.join(os.path.dirname(__file__), "daft_extension.py")
479 _ip.magic("install_ext %s" % url)
479 _ip.magic("install_ext %s" % url)
480 _ip.user_ns.pop('arq', None)
480 _ip.user_ns.pop('arq', None)
481 invalidate_caches() # Clear import caches
481 invalidate_caches() # Clear import caches
482 _ip.magic("load_ext daft_extension")
482 _ip.magic("load_ext daft_extension")
483 nt.assert_equal(_ip.user_ns['arq'], 185)
483 nt.assert_equal(_ip.user_ns['arq'], 185)
484 _ip.magic("unload_ext daft_extension")
484 _ip.magic("unload_ext daft_extension")
485 assert 'arq' not in _ip.user_ns
485 assert 'arq' not in _ip.user_ns
486 finally:
486 finally:
487 _ip.ipython_dir = orig_ipython_dir
487 _ip.ipython_dir = orig_ipython_dir
488 tmpdir.cleanup()
488 tmpdir.cleanup()
489
489
490 def test_notebook_export_json():
490 def test_notebook_export_json():
491 with TemporaryDirectory() as td:
491 with TemporaryDirectory() as td:
492 outfile = os.path.join(td, "nb.ipynb")
492 outfile = os.path.join(td, "nb.ipynb")
493 _ip.ex(py3compat.u_format(u"u = {u}'hΓ©llo'"))
493 _ip.ex(py3compat.u_format(u"u = {u}'hΓ©llo'"))
494 _ip.magic("notebook -e %s" % outfile)
494 _ip.magic("notebook -e %s" % outfile)
495
495
496 def test_notebook_export_py():
496 def test_notebook_export_py():
497 with TemporaryDirectory() as td:
497 with TemporaryDirectory() as td:
498 outfile = os.path.join(td, "nb.py")
498 outfile = os.path.join(td, "nb.py")
499 _ip.ex(py3compat.u_format(u"u = {u}'hΓ©llo'"))
499 _ip.ex(py3compat.u_format(u"u = {u}'hΓ©llo'"))
500 _ip.magic("notebook -e %s" % outfile)
500 _ip.magic("notebook -e %s" % outfile)
501
501
502 def test_notebook_reformat_py():
502 def test_notebook_reformat_py():
503 with TemporaryDirectory() as td:
503 with TemporaryDirectory() as td:
504 infile = os.path.join(td, "nb.ipynb")
504 infile = os.path.join(td, "nb.ipynb")
505 with io.open(infile, 'w', encoding='utf-8') as f:
505 with io.open(infile, 'w', encoding='utf-8') as f:
506 current.write(nb0, f, 'json')
506 current.write(nb0, f, 'json')
507
507
508 _ip.ex(py3compat.u_format(u"u = {u}'hΓ©llo'"))
508 _ip.ex(py3compat.u_format(u"u = {u}'hΓ©llo'"))
509 _ip.magic("notebook -f py %s" % infile)
509 _ip.magic("notebook -f py %s" % infile)
510
510
511 def test_notebook_reformat_json():
511 def test_notebook_reformat_json():
512 with TemporaryDirectory() as td:
512 with TemporaryDirectory() as td:
513 infile = os.path.join(td, "nb.py")
513 infile = os.path.join(td, "nb.py")
514 with io.open(infile, 'w', encoding='utf-8') as f:
514 with io.open(infile, 'w', encoding='utf-8') as f:
515 current.write(nb0, f, 'py')
515 current.write(nb0, f, 'py')
516
516
517 _ip.ex(py3compat.u_format(u"u = {u}'hΓ©llo'"))
517 _ip.ex(py3compat.u_format(u"u = {u}'hΓ©llo'"))
518 _ip.magic("notebook -f ipynb %s" % infile)
518 _ip.magic("notebook -f ipynb %s" % infile)
519 _ip.magic("notebook -f json %s" % infile)
519 _ip.magic("notebook -f json %s" % infile)
520
520
521 def test_env():
521 def test_env():
522 env = _ip.magic("env")
522 env = _ip.magic("env")
523 assert isinstance(env, dict), type(env)
523 assert isinstance(env, dict), type(env)
524
524
525
525
526 class CellMagicTestCase(TestCase):
526 class CellMagicTestCase(TestCase):
527
527
528 def check_ident(self, magic):
528 def check_ident(self, magic):
529 # Manually called, we get the result
529 # Manually called, we get the result
530 out = _ip.run_cell_magic(magic, 'a', 'b')
530 out = _ip.run_cell_magic(magic, 'a', 'b')
531 nt.assert_equal(out, ('a','b'))
531 nt.assert_equal(out, ('a','b'))
532 # Via run_cell, it goes into the user's namespace via displayhook
532 # Via run_cell, it goes into the user's namespace via displayhook
533 _ip.run_cell('%%' + magic +' c\nd')
533 _ip.run_cell('%%' + magic +' c\nd')
534 nt.assert_equal(_ip.user_ns['_'], ('c','d'))
534 nt.assert_equal(_ip.user_ns['_'], ('c','d'))
535
535
536 def test_cell_magic_func_deco(self):
536 def test_cell_magic_func_deco(self):
537 "Cell magic using simple decorator"
537 "Cell magic using simple decorator"
538 @register_cell_magic
538 @register_cell_magic
539 def cellm(line, cell):
539 def cellm(line, cell):
540 return line, cell
540 return line, cell
541
541
542 self.check_ident('cellm')
542 self.check_ident('cellm')
543
543
544 def test_cell_magic_reg(self):
544 def test_cell_magic_reg(self):
545 "Cell magic manually registered"
545 "Cell magic manually registered"
546 def cellm(line, cell):
546 def cellm(line, cell):
547 return line, cell
547 return line, cell
548
548
549 _ip.register_magic_function(cellm, 'cell', 'cellm2')
549 _ip.register_magic_function(cellm, 'cell', 'cellm2')
550 self.check_ident('cellm2')
550 self.check_ident('cellm2')
551
551
552 def test_cell_magic_class(self):
552 def test_cell_magic_class(self):
553 "Cell magics declared via a class"
553 "Cell magics declared via a class"
554 @magics_class
554 @magics_class
555 class MyMagics(Magics):
555 class MyMagics(Magics):
556
556
557 @cell_magic
557 @cell_magic
558 def cellm3(self, line, cell):
558 def cellm3(self, line, cell):
559 return line, cell
559 return line, cell
560
560
561 _ip.register_magics(MyMagics)
561 _ip.register_magics(MyMagics)
562 self.check_ident('cellm3')
562 self.check_ident('cellm3')
563
563
564 def test_cell_magic_class2(self):
564 def test_cell_magic_class2(self):
565 "Cell magics declared via a class, #2"
565 "Cell magics declared via a class, #2"
566 @magics_class
566 @magics_class
567 class MyMagics2(Magics):
567 class MyMagics2(Magics):
568
568
569 @cell_magic('cellm4')
569 @cell_magic('cellm4')
570 def cellm33(self, line, cell):
570 def cellm33(self, line, cell):
571 return line, cell
571 return line, cell
572
572
573 _ip.register_magics(MyMagics2)
573 _ip.register_magics(MyMagics2)
574 self.check_ident('cellm4')
574 self.check_ident('cellm4')
575 # Check that nothing is registered as 'cellm33'
575 # Check that nothing is registered as 'cellm33'
576 c33 = _ip.find_cell_magic('cellm33')
576 c33 = _ip.find_cell_magic('cellm33')
577 nt.assert_equal(c33, None)
577 nt.assert_equal(c33, None)
578
578
579 def test_file():
579 def test_file():
580 """Basic %%file"""
580 """Basic %%file"""
581 ip = get_ipython()
581 ip = get_ipython()
582 with TemporaryDirectory() as td:
582 with TemporaryDirectory() as td:
583 fname = os.path.join(td, 'file1')
583 fname = os.path.join(td, 'file1')
584 ip.run_cell_magic("file", fname, u'\n'.join([
584 ip.run_cell_magic("file", fname, u'\n'.join([
585 'line1',
585 'line1',
586 'line2',
586 'line2',
587 ]))
587 ]))
588 with open(fname) as f:
588 with open(fname) as f:
589 s = f.read()
589 s = f.read()
590 nt.assert_in('line1\n', s)
590 nt.assert_in('line1\n', s)
591 nt.assert_in('line2', s)
591 nt.assert_in('line2', s)
592
592
593 def test_file_var_expand():
593 def test_file_var_expand():
594 """%%file $filename"""
594 """%%file $filename"""
595 ip = get_ipython()
595 ip = get_ipython()
596 with TemporaryDirectory() as td:
596 with TemporaryDirectory() as td:
597 fname = os.path.join(td, 'file1')
597 fname = os.path.join(td, 'file1')
598 ip.user_ns['filename'] = fname
598 ip.user_ns['filename'] = fname
599 ip.run_cell_magic("file", '$filename', u'\n'.join([
599 ip.run_cell_magic("file", '$filename', u'\n'.join([
600 'line1',
600 'line1',
601 'line2',
601 'line2',
602 ]))
602 ]))
603 with open(fname) as f:
603 with open(fname) as f:
604 s = f.read()
604 s = f.read()
605 nt.assert_in('line1\n', s)
605 nt.assert_in('line1\n', s)
606 nt.assert_in('line2', s)
606 nt.assert_in('line2', s)
607
607
608 def test_file_unicode():
608 def test_file_unicode():
609 """%%file with unicode cell"""
609 """%%file with unicode cell"""
610 ip = get_ipython()
610 ip = get_ipython()
611 with TemporaryDirectory() as td:
611 with TemporaryDirectory() as td:
612 fname = os.path.join(td, 'file1')
612 fname = os.path.join(td, 'file1')
613 ip.run_cell_magic("file", fname, u'\n'.join([
613 ip.run_cell_magic("file", fname, u'\n'.join([
614 u'linΓ©1',
614 u'linΓ©1',
615 u'linΓ©2',
615 u'linΓ©2',
616 ]))
616 ]))
617 with io.open(fname, encoding='utf-8') as f:
617 with io.open(fname, encoding='utf-8') as f:
618 s = f.read()
618 s = f.read()
619 nt.assert_in(u'linΓ©1\n', s)
619 nt.assert_in(u'linΓ©1\n', s)
620 nt.assert_in(u'linΓ©2', s)
620 nt.assert_in(u'linΓ©2', s)
621
621
622 def test_file_amend():
622 def test_file_amend():
623 """%%file -a amends files"""
623 """%%file -a amends files"""
624 ip = get_ipython()
624 ip = get_ipython()
625 with TemporaryDirectory() as td:
625 with TemporaryDirectory() as td:
626 fname = os.path.join(td, 'file2')
626 fname = os.path.join(td, 'file2')
627 ip.run_cell_magic("file", fname, u'\n'.join([
627 ip.run_cell_magic("file", fname, u'\n'.join([
628 'line1',
628 'line1',
629 'line2',
629 'line2',
630 ]))
630 ]))
631 ip.run_cell_magic("file", "-a %s" % fname, u'\n'.join([
631 ip.run_cell_magic("file", "-a %s" % fname, u'\n'.join([
632 'line3',
632 'line3',
633 'line4',
633 'line4',
634 ]))
634 ]))
635 with open(fname) as f:
635 with open(fname) as f:
636 s = f.read()
636 s = f.read()
637 nt.assert_in('line1\n', s)
637 nt.assert_in('line1\n', s)
638 nt.assert_in('line3\n', s)
638 nt.assert_in('line3\n', s)
639
639
640
640
641 def test_script_config():
641 def test_script_config():
642 ip = get_ipython()
642 ip = get_ipython()
643 ip.config.ScriptMagics.script_magics = ['whoda']
643 ip.config.ScriptMagics.script_magics = ['whoda']
644 sm = script.ScriptMagics(shell=ip)
644 sm = script.ScriptMagics(shell=ip)
645 nt.assert_in('whoda', sm.magics['cell'])
645 nt.assert_in('whoda', sm.magics['cell'])
646
646
647 @dec.skip_win32
647 @dec.skip_win32
648 def test_script_out():
648 def test_script_out():
649 ip = get_ipython()
649 ip = get_ipython()
650 ip.run_cell_magic("script", "--out output sh", "echo 'hi'")
650 ip.run_cell_magic("script", "--out output sh", "echo 'hi'")
651 nt.assert_equal(ip.user_ns['output'], 'hi\n')
651 nt.assert_equal(ip.user_ns['output'], 'hi\n')
652
652
653 @dec.skip_win32
653 @dec.skip_win32
654 def test_script_err():
654 def test_script_err():
655 ip = get_ipython()
655 ip = get_ipython()
656 ip.run_cell_magic("script", "--err error sh", "echo 'hello' >&2")
656 ip.run_cell_magic("script", "--err error sh", "echo 'hello' >&2")
657 nt.assert_equal(ip.user_ns['error'], 'hello\n')
657 nt.assert_equal(ip.user_ns['error'], 'hello\n')
658
658
659 @dec.skip_win32
659 @dec.skip_win32
660 def test_script_out_err():
660 def test_script_out_err():
661 ip = get_ipython()
661 ip = get_ipython()
662 ip.run_cell_magic("script", "--out output --err error sh", "echo 'hi'\necho 'hello' >&2")
662 ip.run_cell_magic("script", "--out output --err error sh", "echo 'hi'\necho 'hello' >&2")
663 nt.assert_equal(ip.user_ns['output'], 'hi\n')
663 nt.assert_equal(ip.user_ns['output'], 'hi\n')
664 nt.assert_equal(ip.user_ns['error'], 'hello\n')
664 nt.assert_equal(ip.user_ns['error'], 'hello\n')
665
665
666 @dec.skip_win32
666 @dec.skip_win32
667 def test_script_bg_out():
667 def test_script_bg_out():
668 ip = get_ipython()
668 ip = get_ipython()
669 ip.run_cell_magic("script", "--bg --out output sh", "echo 'hi'")
669 ip.run_cell_magic("script", "--bg --out output sh", "echo 'hi'")
670 nt.assert_equal(ip.user_ns['output'].read(), b'hi\n')
670 nt.assert_equal(ip.user_ns['output'].read(), b'hi\n')
671
671
672 @dec.skip_win32
672 @dec.skip_win32
673 def test_script_bg_err():
673 def test_script_bg_err():
674 ip = get_ipython()
674 ip = get_ipython()
675 ip.run_cell_magic("script", "--bg --err error sh", "echo 'hello' >&2")
675 ip.run_cell_magic("script", "--bg --err error sh", "echo 'hello' >&2")
676 nt.assert_equal(ip.user_ns['error'].read(), b'hello\n')
676 nt.assert_equal(ip.user_ns['error'].read(), b'hello\n')
677
677
678 @dec.skip_win32
678 @dec.skip_win32
679 def test_script_bg_out_err():
679 def test_script_bg_out_err():
680 ip = get_ipython()
680 ip = get_ipython()
681 ip.run_cell_magic("script", "--bg --out output --err error sh", "echo 'hi'\necho 'hello' >&2")
681 ip.run_cell_magic("script", "--bg --out output --err error sh", "echo 'hi'\necho 'hello' >&2")
682 nt.assert_equal(ip.user_ns['output'].read(), b'hi\n')
682 nt.assert_equal(ip.user_ns['output'].read(), b'hi\n')
683 nt.assert_equal(ip.user_ns['error'].read(), b'hello\n')
683 nt.assert_equal(ip.user_ns['error'].read(), b'hello\n')
684
684
685 def test_script_defaults():
685 def test_script_defaults():
686 ip = get_ipython()
686 ip = get_ipython()
687 for cmd in ['sh', 'bash', 'perl', 'ruby']:
687 for cmd in ['sh', 'bash', 'perl', 'ruby']:
688 try:
688 try:
689 find_cmd(cmd)
689 find_cmd(cmd)
690 except Exception:
690 except Exception:
691 pass
691 pass
692 else:
692 else:
693 nt.assert_in(cmd, ip.magics_manager.magics['cell'])
693 nt.assert_in(cmd, ip.magics_manager.magics['cell'])
694
694
695
695
696 @magics_class
696 @magics_class
697 class FooFoo(Magics):
697 class FooFoo(Magics):
698 """class with both %foo and %%foo magics"""
698 """class with both %foo and %%foo magics"""
699 @line_magic('foo')
699 @line_magic('foo')
700 def line_foo(self, line):
700 def line_foo(self, line):
701 "I am line foo"
701 "I am line foo"
702 pass
702 pass
703
703
704 @cell_magic("foo")
704 @cell_magic("foo")
705 def cell_foo(self, line, cell):
705 def cell_foo(self, line, cell):
706 "I am cell foo, not line foo"
706 "I am cell foo, not line foo"
707 pass
707 pass
708
708
709 def test_line_cell_info():
709 def test_line_cell_info():
710 """%%foo and %foo magics are distinguishable to inspect"""
710 """%%foo and %foo magics are distinguishable to inspect"""
711 ip = get_ipython()
711 ip = get_ipython()
712 ip.magics_manager.register(FooFoo)
712 ip.magics_manager.register(FooFoo)
713 oinfo = ip.object_inspect('foo')
713 oinfo = ip.object_inspect('foo')
714 nt.assert_true(oinfo['found'])
714 nt.assert_true(oinfo['found'])
715 nt.assert_true(oinfo['ismagic'])
715 nt.assert_true(oinfo['ismagic'])
716
716
717 oinfo = ip.object_inspect('%%foo')
717 oinfo = ip.object_inspect('%%foo')
718 nt.assert_true(oinfo['found'])
718 nt.assert_true(oinfo['found'])
719 nt.assert_true(oinfo['ismagic'])
719 nt.assert_true(oinfo['ismagic'])
720 nt.assert_equal(oinfo['docstring'], FooFoo.cell_foo.__doc__)
720 nt.assert_equal(oinfo['docstring'], FooFoo.cell_foo.__doc__)
721
721
722 oinfo = ip.object_inspect('%foo')
722 oinfo = ip.object_inspect('%foo')
723 nt.assert_true(oinfo['found'])
723 nt.assert_true(oinfo['found'])
724 nt.assert_true(oinfo['ismagic'])
724 nt.assert_true(oinfo['ismagic'])
725 nt.assert_equal(oinfo['docstring'], FooFoo.line_foo.__doc__)
725 nt.assert_equal(oinfo['docstring'], FooFoo.line_foo.__doc__)
726
726
727 def test_multiple_magics():
727 def test_multiple_magics():
728 ip = get_ipython()
728 ip = get_ipython()
729 foo1 = FooFoo(ip)
729 foo1 = FooFoo(ip)
730 foo2 = FooFoo(ip)
730 foo2 = FooFoo(ip)
731 mm = ip.magics_manager
731 mm = ip.magics_manager
732 mm.register(foo1)
732 mm.register(foo1)
733 nt.assert_true(mm.magics['line']['foo'].im_self is foo1)
733 nt.assert_true(mm.magics['line']['foo'].im_self is foo1)
734 mm.register(foo2)
734 mm.register(foo2)
735 nt.assert_true(mm.magics['line']['foo'].im_self is foo2)
735 nt.assert_true(mm.magics['line']['foo'].im_self is foo2)
736
736
737 def test_alias_magic():
737 def test_alias_magic():
738 """Test %alias_magic."""
738 """Test %alias_magic."""
739 ip = get_ipython()
739 ip = get_ipython()
740 mm = ip.magics_manager
740 mm = ip.magics_manager
741
741
742 # Basic operation: both cell and line magics are created, if possible.
742 # Basic operation: both cell and line magics are created, if possible.
743 ip.run_line_magic('alias_magic', 'timeit_alias timeit')
743 ip.run_line_magic('alias_magic', 'timeit_alias timeit')
744 nt.assert_true('timeit_alias' in mm.magics['line'])
744 nt.assert_true('timeit_alias' in mm.magics['line'])
745 nt.assert_true('timeit_alias' in mm.magics['cell'])
745 nt.assert_true('timeit_alias' in mm.magics['cell'])
746
746
747 # --cell is specified, line magic not created.
747 # --cell is specified, line magic not created.
748 ip.run_line_magic('alias_magic', '--cell timeit_cell_alias timeit')
748 ip.run_line_magic('alias_magic', '--cell timeit_cell_alias timeit')
749 nt.assert_false('timeit_cell_alias' in mm.magics['line'])
749 nt.assert_false('timeit_cell_alias' in mm.magics['line'])
750 nt.assert_true('timeit_cell_alias' in mm.magics['cell'])
750 nt.assert_true('timeit_cell_alias' in mm.magics['cell'])
751
751
752 # Test that line alias is created successfully.
752 # Test that line alias is created successfully.
753 ip.run_line_magic('alias_magic', '--line env_alias env')
753 ip.run_line_magic('alias_magic', '--line env_alias env')
754 nt.assert_equal(ip.run_line_magic('env', ''),
754 nt.assert_equal(ip.run_line_magic('env', ''),
755 ip.run_line_magic('env_alias', ''))
755 ip.run_line_magic('env_alias', ''))
756
756
757 def test_save():
757 def test_save():
758 """Test %save."""
758 """Test %save."""
759 ip = get_ipython()
759 ip = get_ipython()
760 ip.history_manager.reset() # Clear any existing history.
760 ip.history_manager.reset() # Clear any existing history.
761 cmds = [u"a=1", u"def b():\n return a**2", u"print(a, b())"]
761 cmds = [u"a=1", u"def b():\n return a**2", u"print(a, b())"]
762 for i, cmd in enumerate(cmds, start=1):
762 for i, cmd in enumerate(cmds, start=1):
763 ip.history_manager.store_inputs(i, cmd)
763 ip.history_manager.store_inputs(i, cmd)
764 with TemporaryDirectory() as tmpdir:
764 with TemporaryDirectory() as tmpdir:
765 file = os.path.join(tmpdir, "testsave.py")
765 file = os.path.join(tmpdir, "testsave.py")
766 ip.run_line_magic("save", "%s 1-10" % file)
766 ip.run_line_magic("save", "%s 1-10" % file)
767 with open(file) as f:
767 with open(file) as f:
768 content = f.read()
768 content = f.read()
769 nt.assert_equal(content.count(cmds[0]), 1)
769 nt.assert_equal(content.count(cmds[0]), 1)
770 nt.assert_true('coding: utf-8' in content)
770 nt.assert_true('coding: utf-8' in content)
771 ip.run_line_magic("save", "-a %s 1-10" % file)
771 ip.run_line_magic("save", "-a %s 1-10" % file)
772 with open(file) as f:
772 with open(file) as f:
773 content = f.read()
773 content = f.read()
774 nt.assert_equal(content.count(cmds[0]), 2)
774 nt.assert_equal(content.count(cmds[0]), 2)
775 nt.assert_true('coding: utf-8' in content)
775 nt.assert_true('coding: utf-8' in content)
776
776
777
777
778 def test_store():
778 def test_store():
779 """Test %store."""
779 """Test %store."""
780 ip = get_ipython()
780 ip = get_ipython()
781 ip.run_line_magic('load_ext', 'storemagic')
781 ip.run_line_magic('load_ext', 'storemagic')
782
782
783 # make sure the storage is empty
783 # make sure the storage is empty
784 ip.run_line_magic('store', '-z')
784 ip.run_line_magic('store', '-z')
785 ip.user_ns['var'] = 42
785 ip.user_ns['var'] = 42
786 ip.run_line_magic('store', 'var')
786 ip.run_line_magic('store', 'var')
787 ip.user_ns['var'] = 39
787 ip.user_ns['var'] = 39
788 ip.run_line_magic('store', '-r')
788 ip.run_line_magic('store', '-r')
789 nt.assert_equal(ip.user_ns['var'], 42)
789 nt.assert_equal(ip.user_ns['var'], 42)
790
790
791 ip.run_line_magic('store', '-d var')
791 ip.run_line_magic('store', '-d var')
792 ip.user_ns['var'] = 39
792 ip.user_ns['var'] = 39
793 ip.run_line_magic('store' , '-r')
793 ip.run_line_magic('store' , '-r')
794 nt.assert_equal(ip.user_ns['var'], 39)
794 nt.assert_equal(ip.user_ns['var'], 39)
795
795
796
796
797 def _run_edit_test(arg_s, exp_filename=None,
797 def _run_edit_test(arg_s, exp_filename=None,
798 exp_lineno=-1,
798 exp_lineno=-1,
799 exp_contents=None,
799 exp_contents=None,
800 exp_is_temp=None):
800 exp_is_temp=None):
801 ip = get_ipython()
801 ip = get_ipython()
802 M = code.CodeMagics(ip)
802 M = code.CodeMagics(ip)
803 last_call = ['','']
803 last_call = ['','']
804 opts,args = M.parse_options(arg_s,'prxn:')
804 opts,args = M.parse_options(arg_s,'prxn:')
805 filename, lineno, is_temp = M._find_edit_target(ip, args, opts, last_call)
805 filename, lineno, is_temp = M._find_edit_target(ip, args, opts, last_call)
806
806
807 if exp_filename is not None:
807 if exp_filename is not None:
808 nt.assert_equal(exp_filename, filename)
808 nt.assert_equal(exp_filename, filename)
809 if exp_contents is not None:
809 if exp_contents is not None:
810 with io.open(filename, 'r') as f:
810 with io.open(filename, 'r') as f:
811 contents = f.read()
811 contents = f.read()
812 nt.assert_equal(exp_contents, contents)
812 nt.assert_equal(exp_contents, contents)
813 if exp_lineno != -1:
813 if exp_lineno != -1:
814 nt.assert_equal(exp_lineno, lineno)
814 nt.assert_equal(exp_lineno, lineno)
815 if exp_is_temp is not None:
815 if exp_is_temp is not None:
816 nt.assert_equal(exp_is_temp, is_temp)
816 nt.assert_equal(exp_is_temp, is_temp)
817
817
818
818
819 def test_edit_interactive():
819 def test_edit_interactive():
820 """%edit on interactively defined objects"""
820 """%edit on interactively defined objects"""
821 ip = get_ipython()
821 ip = get_ipython()
822 n = ip.execution_count
822 n = ip.execution_count
823 ip.run_cell(u"def foo(): return 1", store_history=True)
823 ip.run_cell(u"def foo(): return 1", store_history=True)
824
824
825 try:
825 try:
826 _run_edit_test("foo")
826 _run_edit_test("foo")
827 except code.InteractivelyDefined as e:
827 except code.InteractivelyDefined as e:
828 nt.assert_equal(e.index, n)
828 nt.assert_equal(e.index, n)
829 else:
829 else:
830 nt.fail("Should have raised InteractivelyDefined")
830 raise AssertionError("Should have raised InteractivelyDefined")
831
831
832
832
833 def test_edit_cell():
833 def test_edit_cell():
834 """%edit [cell id]"""
834 """%edit [cell id]"""
835 ip = get_ipython()
835 ip = get_ipython()
836
836
837 ip.run_cell(u"def foo(): return 1", store_history=True)
837 ip.run_cell(u"def foo(): return 1", store_history=True)
838
838
839 # test
839 # test
840 _run_edit_test("1", exp_contents=ip.user_ns['In'][1], exp_is_temp=True)
840 _run_edit_test("1", exp_contents=ip.user_ns['In'][1], exp_is_temp=True)
General Comments 0
You need to be logged in to leave comments. Login now