##// END OF EJS Templates
Add mechanism to have extensions always loaded.
Thomas Kluyver -
Show More
@@ -1,291 +1,292 b''
1 1 # encoding: utf-8
2 2 """
3 3 A mixin for :class:`~IPython.core.application.Application` classes that
4 4 launch InteractiveShell instances, load extensions, etc.
5 5
6 6 Authors
7 7 -------
8 8
9 9 * Min Ragan-Kelley
10 10 """
11 11
12 12 #-----------------------------------------------------------------------------
13 13 # Copyright (C) 2008-2011 The IPython Development Team
14 14 #
15 15 # Distributed under the terms of the BSD License. The full license is in
16 16 # the file COPYING, distributed as part of this software.
17 17 #-----------------------------------------------------------------------------
18 18
19 19 #-----------------------------------------------------------------------------
20 20 # Imports
21 21 #-----------------------------------------------------------------------------
22 22
23 23 from __future__ import absolute_import
24 24
25 25 import glob
26 26 import os
27 27 import sys
28 28
29 29 from IPython.config.application import boolean_flag
30 30 from IPython.config.configurable import Configurable
31 31 from IPython.config.loader import Config
32 32 from IPython.utils import py3compat
33 33 from IPython.utils.path import filefind
34 34 from IPython.utils.traitlets import Unicode, Instance, List, Bool
35 35
36 36 #-----------------------------------------------------------------------------
37 37 # Aliases and Flags
38 38 #-----------------------------------------------------------------------------
39 39
40 40 shell_flags = {}
41 41
42 42 addflag = lambda *args: shell_flags.update(boolean_flag(*args))
43 43 addflag('autoindent', 'InteractiveShell.autoindent',
44 44 'Turn on autoindenting.', 'Turn off autoindenting.'
45 45 )
46 46 addflag('automagic', 'InteractiveShell.automagic',
47 47 """Turn on the auto calling of magic commands. Type %%magic at the
48 48 IPython prompt for more information.""",
49 49 'Turn off the auto calling of magic commands.'
50 50 )
51 51 addflag('pdb', 'InteractiveShell.pdb',
52 52 "Enable auto calling the pdb debugger after every exception.",
53 53 "Disable auto calling the pdb debugger after every exception."
54 54 )
55 55 # pydb flag doesn't do any config, as core.debugger switches on import,
56 56 # which is before parsing. This just allows the flag to be passed.
57 57 shell_flags.update(dict(
58 58 pydb = ({},
59 59 """"Use the third party 'pydb' package as debugger, instead of pdb.
60 60 Requires that pydb is installed."""
61 61 )
62 62 ))
63 63 addflag('pprint', 'PlainTextFormatter.pprint',
64 64 "Enable auto pretty printing of results.",
65 65 "Disable auto auto pretty printing of results."
66 66 )
67 67 addflag('color-info', 'InteractiveShell.color_info',
68 68 """IPython can display information about objects via a set of func-
69 69 tions, and optionally can use colors for this, syntax highlighting
70 70 source code and various other elements. However, because this
71 71 information is passed through a pager (like 'less') and many pagers get
72 72 confused with color codes, this option is off by default. You can test
73 73 it and turn it on permanently in your ipython_config.py file if it
74 74 works for you. Test it and turn it on permanently if it works with
75 75 your system. The magic function %%color_info allows you to toggle this
76 76 interactively for testing.""",
77 77 "Disable using colors for info related things."
78 78 )
79 79 addflag('deep-reload', 'InteractiveShell.deep_reload',
80 80 """Enable deep (recursive) reloading by default. IPython can use the
81 81 deep_reload module which reloads changes in modules recursively (it
82 82 replaces the reload() function, so you don't need to change anything to
83 83 use it). deep_reload() forces a full reload of modules whose code may
84 84 have changed, which the default reload() function does not. When
85 85 deep_reload is off, IPython will use the normal reload(), but
86 86 deep_reload will still be available as dreload(). This feature is off
87 87 by default [which means that you have both normal reload() and
88 88 dreload()].""",
89 89 "Disable deep (recursive) reloading by default."
90 90 )
91 91 nosep_config = Config()
92 92 nosep_config.InteractiveShell.separate_in = ''
93 93 nosep_config.InteractiveShell.separate_out = ''
94 94 nosep_config.InteractiveShell.separate_out2 = ''
95 95
96 96 shell_flags['nosep']=(nosep_config, "Eliminate all spacing between prompts.")
97 97
98 98
99 99 # it's possible we don't want short aliases for *all* of these:
100 100 shell_aliases = dict(
101 101 autocall='InteractiveShell.autocall',
102 102 colors='InteractiveShell.colors',
103 103 logfile='InteractiveShell.logfile',
104 104 logappend='InteractiveShell.logappend',
105 105 c='InteractiveShellApp.code_to_run',
106 106 ext='InteractiveShellApp.extra_extension',
107 107 )
108 108 shell_aliases['cache-size'] = 'InteractiveShell.cache_size'
109 109
110 110 #-----------------------------------------------------------------------------
111 111 # Main classes and functions
112 112 #-----------------------------------------------------------------------------
113 113
114 114 class InteractiveShellApp(Configurable):
115 115 """A Mixin for applications that start InteractiveShell instances.
116 116
117 117 Provides configurables for loading extensions and executing files
118 118 as part of configuring a Shell environment.
119 119
120 120 Provides init_extensions() and init_code() methods, to be called
121 121 after init_shell(), which must be implemented by subclasses.
122 122 """
123 123 extensions = List(Unicode, config=True,
124 124 help="A list of dotted module names of IPython extensions to load."
125 125 )
126 126 extra_extension = Unicode('', config=True,
127 127 help="dotted module name of an IPython extension to load."
128 128 )
129 129 def _extra_extension_changed(self, name, old, new):
130 130 if new:
131 131 # add to self.extensions
132 132 self.extensions.append(new)
133
134 # Extensions that are always loaded (not configurable)
135 default_extensions = List(Unicode, [u'storemagic'], config=False)
133 136
134 137 exec_files = List(Unicode, config=True,
135 138 help="""List of files to run at IPython startup."""
136 139 )
137 140 file_to_run = Unicode('', config=True,
138 141 help="""A file to be run""")
139 142
140 143 exec_lines = List(Unicode, config=True,
141 144 help="""lines of code to run at IPython startup."""
142 145 )
143 146 code_to_run = Unicode('', config=True,
144 147 help="Execute the given command string."
145 148 )
146 149 pylab_import_all = Bool(True, config=True,
147 150 help="""If true, an 'import *' is done from numpy and pylab,
148 151 when using pylab"""
149 152 )
150 153 shell = Instance('IPython.core.interactiveshell.InteractiveShellABC')
151 154
152 155 def init_shell(self):
153 156 raise NotImplementedError("Override in subclasses")
154 157
155 158 def init_extensions(self):
156 159 """Load all IPython extensions in IPythonApp.extensions.
157 160
158 161 This uses the :meth:`ExtensionManager.load_extensions` to load all
159 162 the extensions listed in ``self.extensions``.
160 163 """
161 if not self.extensions:
162 return
163 164 try:
164 165 self.log.debug("Loading IPython extensions...")
165 extensions = self.extensions
166 extensions = self.default_extensions + self.extensions
166 167 for ext in extensions:
167 168 try:
168 169 self.log.info("Loading IPython extension: %s" % ext)
169 170 self.shell.extension_manager.load_extension(ext)
170 171 except:
171 172 self.log.warn("Error in loading extension: %s" % ext +
172 173 "\nCheck your config files in %s" % self.profile_dir.location
173 174 )
174 175 self.shell.showtraceback()
175 176 except:
176 177 self.log.warn("Unknown error in loading extensions:")
177 178 self.shell.showtraceback()
178 179
179 180 def init_code(self):
180 181 """run the pre-flight code, specified via exec_lines"""
181 182 self._run_startup_files()
182 183 self._run_exec_lines()
183 184 self._run_exec_files()
184 185 self._run_cmd_line_code()
185 186
186 187 # Hide variables defined here from %who etc.
187 188 self.shell.user_ns_hidden.update(self.shell.user_ns)
188 189
189 190 def _run_exec_lines(self):
190 191 """Run lines of code in IPythonApp.exec_lines in the user's namespace."""
191 192 if not self.exec_lines:
192 193 return
193 194 try:
194 195 self.log.debug("Running code from IPythonApp.exec_lines...")
195 196 for line in self.exec_lines:
196 197 try:
197 198 self.log.info("Running code in user namespace: %s" %
198 199 line)
199 200 self.shell.run_cell(line, store_history=False)
200 201 except:
201 202 self.log.warn("Error in executing line in user "
202 203 "namespace: %s" % line)
203 204 self.shell.showtraceback()
204 205 except:
205 206 self.log.warn("Unknown error in handling IPythonApp.exec_lines:")
206 207 self.shell.showtraceback()
207 208
208 209 def _exec_file(self, fname):
209 210 try:
210 211 full_filename = filefind(fname, [u'.', self.ipython_dir])
211 212 except IOError as e:
212 213 self.log.warn("File not found: %r"%fname)
213 214 return
214 215 # Make sure that the running script gets a proper sys.argv as if it
215 216 # were run from a system shell.
216 217 save_argv = sys.argv
217 218 sys.argv = [full_filename] + self.extra_args[1:]
218 219 # protect sys.argv from potential unicode strings on Python 2:
219 220 if not py3compat.PY3:
220 221 sys.argv = [ py3compat.cast_bytes(a) for a in sys.argv ]
221 222 try:
222 223 if os.path.isfile(full_filename):
223 224 if full_filename.endswith('.ipy'):
224 225 self.log.info("Running file in user namespace: %s" %
225 226 full_filename)
226 227 self.shell.safe_execfile_ipy(full_filename)
227 228 else:
228 229 # default to python, even without extension
229 230 self.log.info("Running file in user namespace: %s" %
230 231 full_filename)
231 232 # Ensure that __file__ is always defined to match Python behavior
232 233 self.shell.user_ns['__file__'] = fname
233 234 try:
234 235 self.shell.safe_execfile(full_filename, self.shell.user_ns)
235 236 finally:
236 237 del self.shell.user_ns['__file__']
237 238 finally:
238 239 sys.argv = save_argv
239 240
240 241 def _run_startup_files(self):
241 242 """Run files from profile startup directory"""
242 243 startup_dir = self.profile_dir.startup_dir
243 244 startup_files = glob.glob(os.path.join(startup_dir, '*.py'))
244 245 startup_files += glob.glob(os.path.join(startup_dir, '*.ipy'))
245 246 if not startup_files:
246 247 return
247 248
248 249 self.log.debug("Running startup files from %s...", startup_dir)
249 250 try:
250 251 for fname in sorted(startup_files):
251 252 self._exec_file(fname)
252 253 except:
253 254 self.log.warn("Unknown error in handling startup files:")
254 255 self.shell.showtraceback()
255 256
256 257 def _run_exec_files(self):
257 258 """Run files from IPythonApp.exec_files"""
258 259 if not self.exec_files:
259 260 return
260 261
261 262 self.log.debug("Running files in IPythonApp.exec_files...")
262 263 try:
263 264 for fname in self.exec_files:
264 265 self._exec_file(fname)
265 266 except:
266 267 self.log.warn("Unknown error in handling IPythonApp.exec_files:")
267 268 self.shell.showtraceback()
268 269
269 270 def _run_cmd_line_code(self):
270 271 """Run code or file specified at the command-line"""
271 272 if self.code_to_run:
272 273 line = self.code_to_run
273 274 try:
274 275 self.log.info("Running code given at command line (c=): %s" %
275 276 line)
276 277 self.shell.run_cell(line, store_history=False)
277 278 except:
278 279 self.log.warn("Error in executing line in user namespace: %s" %
279 280 line)
280 281 self.shell.showtraceback()
281 282
282 283 # Like Python itself, ignore the second if the first of these is present
283 284 elif self.file_to_run:
284 285 fname = self.file_to_run
285 286 try:
286 287 self._exec_file(fname)
287 288 except:
288 289 self.log.warn("Error in executing file in user namespace: %s" %
289 290 fname)
290 291 self.shell.showtraceback()
291 292
General Comments 0
You need to be logged in to leave comments. Login now