##// END OF EJS Templates
Remove shim marked for removal.
Matthias Bussonnier -
Show More
@@ -1,157 +1,146 b''
1 # encoding: utf-8
1 # encoding: utf-8
2 """
2 """
3 IPython: tools for interactive and parallel computing in Python.
3 IPython: tools for interactive and parallel computing in Python.
4
4
5 http://ipython.org
5 http://ipython.org
6 """
6 """
7 #-----------------------------------------------------------------------------
7 #-----------------------------------------------------------------------------
8 # Copyright (c) 2008-2011, IPython Development Team.
8 # Copyright (c) 2008-2011, IPython Development Team.
9 # Copyright (c) 2001-2007, Fernando Perez <fernando.perez@colorado.edu>
9 # Copyright (c) 2001-2007, Fernando Perez <fernando.perez@colorado.edu>
10 # Copyright (c) 2001, Janko Hauser <jhauser@zscout.de>
10 # Copyright (c) 2001, Janko Hauser <jhauser@zscout.de>
11 # Copyright (c) 2001, Nathaniel Gray <n8gray@caltech.edu>
11 # Copyright (c) 2001, Nathaniel Gray <n8gray@caltech.edu>
12 #
12 #
13 # Distributed under the terms of the Modified BSD License.
13 # Distributed under the terms of the Modified BSD License.
14 #
14 #
15 # The full license is in the file COPYING.txt, distributed with this software.
15 # The full license is in the file COPYING.txt, distributed with this software.
16 #-----------------------------------------------------------------------------
16 #-----------------------------------------------------------------------------
17
17
18 #-----------------------------------------------------------------------------
18 #-----------------------------------------------------------------------------
19 # Imports
19 # Imports
20 #-----------------------------------------------------------------------------
20 #-----------------------------------------------------------------------------
21 from __future__ import absolute_import
21 from __future__ import absolute_import
22
22
23 import os
23 import os
24 import sys
24 import sys
25 import warnings
25 import warnings
26
26
27 #-----------------------------------------------------------------------------
27 #-----------------------------------------------------------------------------
28 # Setup everything
28 # Setup everything
29 #-----------------------------------------------------------------------------
29 #-----------------------------------------------------------------------------
30
30
31 # Don't forget to also update setup.py when this changes!
31 # Don't forget to also update setup.py when this changes!
32 v = sys.version_info
32 v = sys.version_info
33 if v[:2] < (2,7) or (v[0] >= 3 and v[:2] < (3,3)):
33 if v[:2] < (2,7) or (v[0] >= 3 and v[:2] < (3,3)):
34 raise ImportError('IPython requires Python version 2.7 or 3.3 or above.')
34 raise ImportError('IPython requires Python version 2.7 or 3.3 or above.')
35 del v
35 del v
36
36
37 # Make it easy to import extensions - they are always directly on pythonpath.
37 # Make it easy to import extensions - they are always directly on pythonpath.
38 # Therefore, non-IPython modules can be added to extensions directory.
38 # Therefore, non-IPython modules can be added to extensions directory.
39 # This should probably be in ipapp.py.
39 # This should probably be in ipapp.py.
40 sys.path.append(os.path.join(os.path.dirname(__file__), "extensions"))
40 sys.path.append(os.path.join(os.path.dirname(__file__), "extensions"))
41
41
42 #-----------------------------------------------------------------------------
42 #-----------------------------------------------------------------------------
43 # Setup the top level names
43 # Setup the top level names
44 #-----------------------------------------------------------------------------
44 #-----------------------------------------------------------------------------
45
45
46 from .core.getipython import get_ipython
46 from .core.getipython import get_ipython
47 from .core import release
47 from .core import release
48 from .core.application import Application
48 from .core.application import Application
49 from .terminal.embed import embed
49 from .terminal.embed import embed
50
50
51 from .core.interactiveshell import InteractiveShell
51 from .core.interactiveshell import InteractiveShell
52 from .testing import test
52 from .testing import test
53 from .utils.sysinfo import sys_info
53 from .utils.sysinfo import sys_info
54 from .utils.frame import extract_module_locals
54 from .utils.frame import extract_module_locals
55
55
56 # Release data
56 # Release data
57 __author__ = '%s <%s>' % (release.author, release.author_email)
57 __author__ = '%s <%s>' % (release.author, release.author_email)
58 __license__ = release.license
58 __license__ = release.license
59 __version__ = release.version
59 __version__ = release.version
60 version_info = release.version_info
60 version_info = release.version_info
61
61
62 def embed_kernel(module=None, local_ns=None, **kwargs):
62 def embed_kernel(module=None, local_ns=None, **kwargs):
63 """Embed and start an IPython kernel in a given scope.
63 """Embed and start an IPython kernel in a given scope.
64
64
65 If you don't want the kernel to initialize the namespace
65 If you don't want the kernel to initialize the namespace
66 from the scope of the surrounding function,
66 from the scope of the surrounding function,
67 and/or you want to load full IPython configuration,
67 and/or you want to load full IPython configuration,
68 you probably want `IPython.start_kernel()` instead.
68 you probably want `IPython.start_kernel()` instead.
69
69
70 Parameters
70 Parameters
71 ----------
71 ----------
72 module : ModuleType, optional
72 module : ModuleType, optional
73 The module to load into IPython globals (default: caller)
73 The module to load into IPython globals (default: caller)
74 local_ns : dict, optional
74 local_ns : dict, optional
75 The namespace to load into IPython user namespace (default: caller)
75 The namespace to load into IPython user namespace (default: caller)
76
76
77 kwargs : various, optional
77 kwargs : various, optional
78 Further keyword args are relayed to the IPKernelApp constructor,
78 Further keyword args are relayed to the IPKernelApp constructor,
79 allowing configuration of the Kernel. Will only have an effect
79 allowing configuration of the Kernel. Will only have an effect
80 on the first embed_kernel call for a given process.
80 on the first embed_kernel call for a given process.
81 """
81 """
82
82
83 (caller_module, caller_locals) = extract_module_locals(1)
83 (caller_module, caller_locals) = extract_module_locals(1)
84 if module is None:
84 if module is None:
85 module = caller_module
85 module = caller_module
86 if local_ns is None:
86 if local_ns is None:
87 local_ns = caller_locals
87 local_ns = caller_locals
88
88
89 # Only import .zmq when we really need it
89 # Only import .zmq when we really need it
90 from ipykernel.embed import embed_kernel as real_embed_kernel
90 from ipykernel.embed import embed_kernel as real_embed_kernel
91 real_embed_kernel(module=module, local_ns=local_ns, **kwargs)
91 real_embed_kernel(module=module, local_ns=local_ns, **kwargs)
92
92
93 def start_ipython(argv=None, **kwargs):
93 def start_ipython(argv=None, **kwargs):
94 """Launch a normal IPython instance (as opposed to embedded)
94 """Launch a normal IPython instance (as opposed to embedded)
95
95
96 `IPython.embed()` puts a shell in a particular calling scope,
96 `IPython.embed()` puts a shell in a particular calling scope,
97 such as a function or method for debugging purposes,
97 such as a function or method for debugging purposes,
98 which is often not desirable.
98 which is often not desirable.
99
99
100 `start_ipython()` does full, regular IPython initialization,
100 `start_ipython()` does full, regular IPython initialization,
101 including loading startup files, configuration, etc.
101 including loading startup files, configuration, etc.
102 much of which is skipped by `embed()`.
102 much of which is skipped by `embed()`.
103
103
104 This is a public API method, and will survive implementation changes.
104 This is a public API method, and will survive implementation changes.
105
105
106 Parameters
106 Parameters
107 ----------
107 ----------
108
108
109 argv : list or None, optional
109 argv : list or None, optional
110 If unspecified or None, IPython will parse command-line options from sys.argv.
110 If unspecified or None, IPython will parse command-line options from sys.argv.
111 To prevent any command-line parsing, pass an empty list: `argv=[]`.
111 To prevent any command-line parsing, pass an empty list: `argv=[]`.
112 user_ns : dict, optional
112 user_ns : dict, optional
113 specify this dictionary to initialize the IPython user namespace with particular values.
113 specify this dictionary to initialize the IPython user namespace with particular values.
114 kwargs : various, optional
114 kwargs : various, optional
115 Any other kwargs will be passed to the Application constructor,
115 Any other kwargs will be passed to the Application constructor,
116 such as `config`.
116 such as `config`.
117 """
117 """
118 from IPython.terminal.ipapp import launch_new_instance
118 from IPython.terminal.ipapp import launch_new_instance
119 return launch_new_instance(argv=argv, **kwargs)
119 return launch_new_instance(argv=argv, **kwargs)
120
120
121 def start_kernel(argv=None, **kwargs):
121 def start_kernel(argv=None, **kwargs):
122 """Launch a normal IPython kernel instance (as opposed to embedded)
122 """Launch a normal IPython kernel instance (as opposed to embedded)
123
123
124 `IPython.embed_kernel()` puts a shell in a particular calling scope,
124 `IPython.embed_kernel()` puts a shell in a particular calling scope,
125 such as a function or method for debugging purposes,
125 such as a function or method for debugging purposes,
126 which is often not desirable.
126 which is often not desirable.
127
127
128 `start_kernel()` does full, regular IPython initialization,
128 `start_kernel()` does full, regular IPython initialization,
129 including loading startup files, configuration, etc.
129 including loading startup files, configuration, etc.
130 much of which is skipped by `embed()`.
130 much of which is skipped by `embed()`.
131
131
132 Parameters
132 Parameters
133 ----------
133 ----------
134
134
135 argv : list or None, optional
135 argv : list or None, optional
136 If unspecified or None, IPython will parse command-line options from sys.argv.
136 If unspecified or None, IPython will parse command-line options from sys.argv.
137 To prevent any command-line parsing, pass an empty list: `argv=[]`.
137 To prevent any command-line parsing, pass an empty list: `argv=[]`.
138 user_ns : dict, optional
138 user_ns : dict, optional
139 specify this dictionary to initialize the IPython user namespace with particular values.
139 specify this dictionary to initialize the IPython user namespace with particular values.
140 kwargs : various, optional
140 kwargs : various, optional
141 Any other kwargs will be passed to the Application constructor,
141 Any other kwargs will be passed to the Application constructor,
142 such as `config`.
142 such as `config`.
143 """
143 """
144 from IPython.kernel.zmq.kernelapp import launch_new_instance
144 from IPython.kernel.zmq.kernelapp import launch_new_instance
145 return launch_new_instance(argv=argv, **kwargs)
145 return launch_new_instance(argv=argv, **kwargs)
146
146
147 # deprecated shim for IPython.Config
148 import traitlets.config
149 class Config(traitlets.config.Config):
150 def __init__(self, *args, **kwargs):
151 warnings.warn(
152 "IPython.Config is deprecated and will be removed in IPython 5."
153 " Use traitlets.config.Config.",
154 DeprecationWarning, stacklevel=2,
155 )
156 super(Config, self).__init__(*args, **kwargs)
157
General Comments 0
You need to be logged in to leave comments. Login now