Show More
@@ -1,486 +1,486 b'' | |||||
1 | # encoding: utf-8 |
|
1 | # encoding: utf-8 | |
2 | """ |
|
2 | """ | |
3 | An application for IPython. |
|
3 | An application for IPython. | |
4 |
|
4 | |||
5 | All top-level applications should use the classes in this module for |
|
5 | All top-level applications should use the classes in this module for | |
6 | handling configuration and creating configurables. |
|
6 | handling configuration and creating configurables. | |
7 |
|
7 | |||
8 | The job of an :class:`Application` is to create the master configuration |
|
8 | The job of an :class:`Application` is to create the master configuration | |
9 | object and then create the configurable objects, passing the config to them. |
|
9 | object and then create the configurable objects, passing the config to them. | |
10 | """ |
|
10 | """ | |
11 |
|
11 | |||
12 | # Copyright (c) IPython Development Team. |
|
12 | # Copyright (c) IPython Development Team. | |
13 | # Distributed under the terms of the Modified BSD License. |
|
13 | # Distributed under the terms of the Modified BSD License. | |
14 |
|
14 | |||
15 | import atexit |
|
15 | import atexit | |
16 | from copy import deepcopy |
|
16 | from copy import deepcopy | |
17 | import glob |
|
17 | import glob | |
18 | import logging |
|
18 | import logging | |
19 | import os |
|
19 | import os | |
20 | import shutil |
|
20 | import shutil | |
21 | import sys |
|
21 | import sys | |
22 |
|
22 | |||
23 | from pathlib import Path |
|
23 | from pathlib import Path | |
24 |
|
24 | |||
25 | from traitlets.config.application import Application, catch_config_error |
|
25 | from traitlets.config.application import Application, catch_config_error | |
26 | from traitlets.config.loader import ConfigFileNotFound, PyFileConfigLoader |
|
26 | from traitlets.config.loader import ConfigFileNotFound, PyFileConfigLoader | |
27 | from IPython.core import release, crashhandler |
|
27 | from IPython.core import release, crashhandler | |
28 | from IPython.core.profiledir import ProfileDir, ProfileDirError |
|
28 | from IPython.core.profiledir import ProfileDir, ProfileDirError | |
29 | from IPython.paths import get_ipython_dir, get_ipython_package_dir |
|
29 | from IPython.paths import get_ipython_dir, get_ipython_package_dir | |
30 | from IPython.utils.path import ensure_dir_exists |
|
30 | from IPython.utils.path import ensure_dir_exists | |
31 | from traitlets import ( |
|
31 | from traitlets import ( | |
32 | List, Unicode, Type, Bool, Set, Instance, Undefined, |
|
32 | List, Unicode, Type, Bool, Set, Instance, Undefined, | |
33 | default, observe, |
|
33 | default, observe, | |
34 | ) |
|
34 | ) | |
35 |
|
35 | |||
36 | if os.name == "nt": |
|
36 | if os.name == "nt": | |
37 | programdata = Path(os.environ.get("PROGRAMDATA", None)) |
|
37 | programdata = Path(os.environ.get("PROGRAMDATA", None)) | |
38 | if programdata: |
|
38 | if programdata: | |
39 | SYSTEM_CONFIG_DIRS = [str(programdata / "ipython")] |
|
39 | SYSTEM_CONFIG_DIRS = [str(programdata / "ipython")] | |
40 | else: # PROGRAMDATA is not defined by default on XP. |
|
40 | else: # PROGRAMDATA is not defined by default on XP. | |
41 | SYSTEM_CONFIG_DIRS = [] |
|
41 | SYSTEM_CONFIG_DIRS = [] | |
42 | else: |
|
42 | else: | |
43 | SYSTEM_CONFIG_DIRS = [ |
|
43 | SYSTEM_CONFIG_DIRS = [ | |
44 | "/usr/local/etc/ipython", |
|
44 | "/usr/local/etc/ipython", | |
45 | "/etc/ipython", |
|
45 | "/etc/ipython", | |
46 | ] |
|
46 | ] | |
47 |
|
47 | |||
48 |
|
48 | |||
49 | ENV_CONFIG_DIRS = [] |
|
49 | ENV_CONFIG_DIRS = [] | |
50 | _env_config_dir = os.path.join(sys.prefix, 'etc', 'ipython') |
|
50 | _env_config_dir = os.path.join(sys.prefix, 'etc', 'ipython') | |
51 | if _env_config_dir not in SYSTEM_CONFIG_DIRS: |
|
51 | if _env_config_dir not in SYSTEM_CONFIG_DIRS: | |
52 | # only add ENV_CONFIG if sys.prefix is not already included |
|
52 | # only add ENV_CONFIG if sys.prefix is not already included | |
53 | ENV_CONFIG_DIRS.append(_env_config_dir) |
|
53 | ENV_CONFIG_DIRS.append(_env_config_dir) | |
54 |
|
54 | |||
55 |
|
55 | |||
56 | _envvar = os.environ.get('IPYTHON_SUPPRESS_CONFIG_ERRORS') |
|
56 | _envvar = os.environ.get('IPYTHON_SUPPRESS_CONFIG_ERRORS') | |
57 | if _envvar in {None, ''}: |
|
57 | if _envvar in {None, ''}: | |
58 | IPYTHON_SUPPRESS_CONFIG_ERRORS = None |
|
58 | IPYTHON_SUPPRESS_CONFIG_ERRORS = None | |
59 | else: |
|
59 | else: | |
60 | if _envvar.lower() in {'1','true'}: |
|
60 | if _envvar.lower() in {'1','true'}: | |
61 | IPYTHON_SUPPRESS_CONFIG_ERRORS = True |
|
61 | IPYTHON_SUPPRESS_CONFIG_ERRORS = True | |
62 | elif _envvar.lower() in {'0','false'} : |
|
62 | elif _envvar.lower() in {'0','false'} : | |
63 | IPYTHON_SUPPRESS_CONFIG_ERRORS = False |
|
63 | IPYTHON_SUPPRESS_CONFIG_ERRORS = False | |
64 | else: |
|
64 | else: | |
65 | sys.exit("Unsupported value for environment variable: 'IPYTHON_SUPPRESS_CONFIG_ERRORS' is set to '%s' which is none of {'0', '1', 'false', 'true', ''}."% _envvar ) |
|
65 | sys.exit("Unsupported value for environment variable: 'IPYTHON_SUPPRESS_CONFIG_ERRORS' is set to '%s' which is none of {'0', '1', 'false', 'true', ''}."% _envvar ) | |
66 |
|
66 | |||
67 | # aliases and flags |
|
67 | # aliases and flags | |
68 |
|
68 | |||
69 | base_aliases = {} |
|
69 | base_aliases = {} | |
70 | if isinstance(Application.aliases, dict): |
|
70 | if isinstance(Application.aliases, dict): | |
71 | # traitlets 5 |
|
71 | # traitlets 5 | |
72 | base_aliases.update(Application.aliases) |
|
72 | base_aliases.update(Application.aliases) | |
73 | base_aliases.update( |
|
73 | base_aliases.update( | |
74 | { |
|
74 | { | |
75 | "profile-dir": "ProfileDir.location", |
|
75 | "profile-dir": "ProfileDir.location", | |
76 | "profile": "BaseIPythonApplication.profile", |
|
76 | "profile": "BaseIPythonApplication.profile", | |
77 | "ipython-dir": "BaseIPythonApplication.ipython_dir", |
|
77 | "ipython-dir": "BaseIPythonApplication.ipython_dir", | |
78 | "log-level": "Application.log_level", |
|
78 | "log-level": "Application.log_level", | |
79 | "config": "BaseIPythonApplication.extra_config_file", |
|
79 | "config": "BaseIPythonApplication.extra_config_file", | |
80 | } |
|
80 | } | |
81 | ) |
|
81 | ) | |
82 |
|
82 | |||
83 | base_flags = dict() |
|
83 | base_flags = dict() | |
84 | if isinstance(Application.flags, dict): |
|
84 | if isinstance(Application.flags, dict): | |
85 | # traitlets 5 |
|
85 | # traitlets 5 | |
86 | base_flags.update(Application.flags) |
|
86 | base_flags.update(Application.flags) | |
87 | base_flags.update( |
|
87 | base_flags.update( | |
88 | dict( |
|
88 | dict( | |
89 | debug=( |
|
89 | debug=( | |
90 | {"Application": {"log_level": logging.DEBUG}}, |
|
90 | {"Application": {"log_level": logging.DEBUG}}, | |
91 | "set log level to logging.DEBUG (maximize logging output)", |
|
91 | "set log level to logging.DEBUG (maximize logging output)", | |
92 | ), |
|
92 | ), | |
93 | quiet=( |
|
93 | quiet=( | |
94 | {"Application": {"log_level": logging.CRITICAL}}, |
|
94 | {"Application": {"log_level": logging.CRITICAL}}, | |
95 | "set log level to logging.CRITICAL (minimize logging output)", |
|
95 | "set log level to logging.CRITICAL (minimize logging output)", | |
96 | ), |
|
96 | ), | |
97 | init=( |
|
97 | init=( | |
98 | { |
|
98 | { | |
99 | "BaseIPythonApplication": { |
|
99 | "BaseIPythonApplication": { | |
100 | "copy_config_files": True, |
|
100 | "copy_config_files": True, | |
101 | "auto_create": True, |
|
101 | "auto_create": True, | |
102 | } |
|
102 | } | |
103 | }, |
|
103 | }, | |
104 | """Initialize profile with default config files. This is equivalent |
|
104 | """Initialize profile with default config files. This is equivalent | |
105 | to running `ipython profile create <profile>` prior to startup. |
|
105 | to running `ipython profile create <profile>` prior to startup. | |
106 | """, |
|
106 | """, | |
107 | ), |
|
107 | ), | |
108 | ) |
|
108 | ) | |
109 | ) |
|
109 | ) | |
110 |
|
110 | |||
111 |
|
111 | |||
112 | class ProfileAwareConfigLoader(PyFileConfigLoader): |
|
112 | class ProfileAwareConfigLoader(PyFileConfigLoader): | |
113 | """A Python file config loader that is aware of IPython profiles.""" |
|
113 | """A Python file config loader that is aware of IPython profiles.""" | |
114 | def load_subconfig(self, fname, path=None, profile=None): |
|
114 | def load_subconfig(self, fname, path=None, profile=None): | |
115 | if profile is not None: |
|
115 | if profile is not None: | |
116 | try: |
|
116 | try: | |
117 | profile_dir = ProfileDir.find_profile_dir_by_name( |
|
117 | profile_dir = ProfileDir.find_profile_dir_by_name( | |
118 | get_ipython_dir(), |
|
118 | get_ipython_dir(), | |
119 | profile, |
|
119 | profile, | |
120 | ) |
|
120 | ) | |
121 | except ProfileDirError: |
|
121 | except ProfileDirError: | |
122 | return |
|
122 | return | |
123 | path = profile_dir.location |
|
123 | path = profile_dir.location | |
124 | return super(ProfileAwareConfigLoader, self).load_subconfig(fname, path=path) |
|
124 | return super(ProfileAwareConfigLoader, self).load_subconfig(fname, path=path) | |
125 |
|
125 | |||
126 | class BaseIPythonApplication(Application): |
|
126 | class BaseIPythonApplication(Application): | |
127 |
|
127 | |||
128 | name = u'ipython' |
|
128 | name = u'ipython' | |
129 | description = Unicode(u'IPython: an enhanced interactive Python shell.') |
|
129 | description = Unicode(u'IPython: an enhanced interactive Python shell.') | |
130 | version = Unicode(release.version) |
|
130 | version = Unicode(release.version) | |
131 |
|
131 | |||
132 | aliases = base_aliases |
|
132 | aliases = base_aliases | |
133 | flags = base_flags |
|
133 | flags = base_flags | |
134 | classes = List([ProfileDir]) |
|
134 | classes = List([ProfileDir]) | |
135 |
|
135 | |||
136 | # enable `load_subconfig('cfg.py', profile='name')` |
|
136 | # enable `load_subconfig('cfg.py', profile='name')` | |
137 | python_config_loader_class = ProfileAwareConfigLoader |
|
137 | python_config_loader_class = ProfileAwareConfigLoader | |
138 |
|
138 | |||
139 | # Track whether the config_file has changed, |
|
139 | # Track whether the config_file has changed, | |
140 | # because some logic happens only if we aren't using the default. |
|
140 | # because some logic happens only if we aren't using the default. | |
141 | config_file_specified = Set() |
|
141 | config_file_specified = Set() | |
142 |
|
142 | |||
143 | config_file_name = Unicode() |
|
143 | config_file_name = Unicode() | |
144 | @default('config_file_name') |
|
144 | @default('config_file_name') | |
145 | def _config_file_name_default(self): |
|
145 | def _config_file_name_default(self): | |
146 | return self.name.replace('-','_') + u'_config.py' |
|
146 | return self.name.replace('-','_') + u'_config.py' | |
147 | @observe('config_file_name') |
|
147 | @observe('config_file_name') | |
148 | def _config_file_name_changed(self, change): |
|
148 | def _config_file_name_changed(self, change): | |
149 | if change['new'] != change['old']: |
|
149 | if change['new'] != change['old']: | |
150 | self.config_file_specified.add(change['new']) |
|
150 | self.config_file_specified.add(change['new']) | |
151 |
|
151 | |||
152 | # The directory that contains IPython's builtin profiles. |
|
152 | # The directory that contains IPython's builtin profiles. | |
153 | builtin_profile_dir = Unicode( |
|
153 | builtin_profile_dir = Unicode( | |
154 | os.path.join(get_ipython_package_dir(), u'config', u'profile', u'default') |
|
154 | os.path.join(get_ipython_package_dir(), u'config', u'profile', u'default') | |
155 | ) |
|
155 | ) | |
156 |
|
156 | |||
157 | config_file_paths = List(Unicode()) |
|
157 | config_file_paths = List(Unicode()) | |
158 | @default('config_file_paths') |
|
158 | @default('config_file_paths') | |
159 | def _config_file_paths_default(self): |
|
159 | def _config_file_paths_default(self): | |
160 | return [os.getcwd()] |
|
160 | return [os.getcwd()] | |
161 |
|
161 | |||
162 | extra_config_file = Unicode( |
|
162 | extra_config_file = Unicode( | |
163 | help="""Path to an extra config file to load. |
|
163 | help="""Path to an extra config file to load. | |
164 |
|
164 | |||
165 | If specified, load this config file in addition to any other IPython config. |
|
165 | If specified, load this config file in addition to any other IPython config. | |
166 | """).tag(config=True) |
|
166 | """).tag(config=True) | |
167 | @observe('extra_config_file') |
|
167 | @observe('extra_config_file') | |
168 | def _extra_config_file_changed(self, change): |
|
168 | def _extra_config_file_changed(self, change): | |
169 | old = change['old'] |
|
169 | old = change['old'] | |
170 | new = change['new'] |
|
170 | new = change['new'] | |
171 | try: |
|
171 | try: | |
172 | self.config_files.remove(old) |
|
172 | self.config_files.remove(old) | |
173 | except ValueError: |
|
173 | except ValueError: | |
174 | pass |
|
174 | pass | |
175 | self.config_file_specified.add(new) |
|
175 | self.config_file_specified.add(new) | |
176 | self.config_files.append(new) |
|
176 | self.config_files.append(new) | |
177 |
|
177 | |||
178 | profile = Unicode(u'default', |
|
178 | profile = Unicode(u'default', | |
179 | help="""The IPython profile to use.""" |
|
179 | help="""The IPython profile to use.""" | |
180 | ).tag(config=True) |
|
180 | ).tag(config=True) | |
181 |
|
181 | |||
182 | @observe('profile') |
|
182 | @observe('profile') | |
183 | def _profile_changed(self, change): |
|
183 | def _profile_changed(self, change): | |
184 | self.builtin_profile_dir = os.path.join( |
|
184 | self.builtin_profile_dir = os.path.join( | |
185 | get_ipython_package_dir(), u'config', u'profile', change['new'] |
|
185 | get_ipython_package_dir(), u'config', u'profile', change['new'] | |
186 | ) |
|
186 | ) | |
187 |
|
187 | |||
188 | ipython_dir = Unicode( |
|
188 | ipython_dir = Unicode( | |
189 | help=""" |
|
189 | help=""" | |
190 | The name of the IPython directory. This directory is used for logging |
|
190 | The name of the IPython directory. This directory is used for logging | |
191 | configuration (through profiles), history storage, etc. The default |
|
191 | configuration (through profiles), history storage, etc. The default | |
192 | is usually $HOME/.ipython. This option can also be specified through |
|
192 | is usually $HOME/.ipython. This option can also be specified through | |
193 | the environment variable IPYTHONDIR. |
|
193 | the environment variable IPYTHONDIR. | |
194 | """ |
|
194 | """ | |
195 | ).tag(config=True) |
|
195 | ).tag(config=True) | |
196 | @default('ipython_dir') |
|
196 | @default('ipython_dir') | |
197 | def _ipython_dir_default(self): |
|
197 | def _ipython_dir_default(self): | |
198 | d = get_ipython_dir() |
|
198 | d = get_ipython_dir() | |
199 | self._ipython_dir_changed({ |
|
199 | self._ipython_dir_changed({ | |
200 | 'name': 'ipython_dir', |
|
200 | 'name': 'ipython_dir', | |
201 | 'old': d, |
|
201 | 'old': d, | |
202 | 'new': d, |
|
202 | 'new': d, | |
203 | }) |
|
203 | }) | |
204 | return d |
|
204 | return d | |
205 |
|
205 | |||
206 | _in_init_profile_dir = False |
|
206 | _in_init_profile_dir = False | |
207 | profile_dir = Instance(ProfileDir, allow_none=True) |
|
207 | profile_dir = Instance(ProfileDir, allow_none=True) | |
208 | @default('profile_dir') |
|
208 | @default('profile_dir') | |
209 | def _profile_dir_default(self): |
|
209 | def _profile_dir_default(self): | |
210 | # avoid recursion |
|
210 | # avoid recursion | |
211 | if self._in_init_profile_dir: |
|
211 | if self._in_init_profile_dir: | |
212 | return |
|
212 | return | |
213 | # profile_dir requested early, force initialization |
|
213 | # profile_dir requested early, force initialization | |
214 | self.init_profile_dir() |
|
214 | self.init_profile_dir() | |
215 | return self.profile_dir |
|
215 | return self.profile_dir | |
216 |
|
216 | |||
217 | overwrite = Bool(False, |
|
217 | overwrite = Bool(False, | |
218 | help="""Whether to overwrite existing config files when copying""" |
|
218 | help="""Whether to overwrite existing config files when copying""" | |
219 | ).tag(config=True) |
|
219 | ).tag(config=True) | |
220 | auto_create = Bool(False, |
|
220 | auto_create = Bool(False, | |
221 | help="""Whether to create profile dir if it doesn't exist""" |
|
221 | help="""Whether to create profile dir if it doesn't exist""" | |
222 | ).tag(config=True) |
|
222 | ).tag(config=True) | |
223 |
|
223 | |||
224 | config_files = List(Unicode()) |
|
224 | config_files = List(Unicode()) | |
225 | @default('config_files') |
|
225 | @default('config_files') | |
226 | def _config_files_default(self): |
|
226 | def _config_files_default(self): | |
227 | return [self.config_file_name] |
|
227 | return [self.config_file_name] | |
228 |
|
228 | |||
229 | copy_config_files = Bool(False, |
|
229 | copy_config_files = Bool(False, | |
230 | help="""Whether to install the default config files into the profile dir. |
|
230 | help="""Whether to install the default config files into the profile dir. | |
231 | If a new profile is being created, and IPython contains config files for that |
|
231 | If a new profile is being created, and IPython contains config files for that | |
232 | profile, then they will be staged into the new directory. Otherwise, |
|
232 | profile, then they will be staged into the new directory. Otherwise, | |
233 | default config files will be automatically generated. |
|
233 | default config files will be automatically generated. | |
234 | """).tag(config=True) |
|
234 | """).tag(config=True) | |
235 |
|
235 | |||
236 | verbose_crash = Bool(False, |
|
236 | verbose_crash = Bool(False, | |
237 | help="""Create a massive crash report when IPython encounters what may be an |
|
237 | help="""Create a massive crash report when IPython encounters what may be an | |
238 | internal error. The default is to append a short message to the |
|
238 | internal error. The default is to append a short message to the | |
239 | usual traceback""").tag(config=True) |
|
239 | usual traceback""").tag(config=True) | |
240 |
|
240 | |||
241 | # The class to use as the crash handler. |
|
241 | # The class to use as the crash handler. | |
242 | crash_handler_class = Type(crashhandler.CrashHandler) |
|
242 | crash_handler_class = Type(crashhandler.CrashHandler) | |
243 |
|
243 | |||
244 | @catch_config_error |
|
244 | @catch_config_error | |
245 | def __init__(self, **kwargs): |
|
245 | def __init__(self, **kwargs): | |
246 | super(BaseIPythonApplication, self).__init__(**kwargs) |
|
246 | super(BaseIPythonApplication, self).__init__(**kwargs) | |
247 | # ensure current working directory exists |
|
247 | # ensure current working directory exists | |
248 | try: |
|
248 | try: | |
249 | os.getcwd() |
|
249 | os.getcwd() | |
250 | except: |
|
250 | except: | |
251 | # exit if cwd doesn't exist |
|
251 | # exit if cwd doesn't exist | |
252 | self.log.error("Current working directory doesn't exist.") |
|
252 | self.log.error("Current working directory doesn't exist.") | |
253 | self.exit(1) |
|
253 | self.exit(1) | |
254 |
|
254 | |||
255 | #------------------------------------------------------------------------- |
|
255 | #------------------------------------------------------------------------- | |
256 | # Various stages of Application creation |
|
256 | # Various stages of Application creation | |
257 | #------------------------------------------------------------------------- |
|
257 | #------------------------------------------------------------------------- | |
258 |
|
258 | |||
259 | deprecated_subcommands = {} |
|
259 | deprecated_subcommands = {} | |
260 |
|
260 | |||
261 | def initialize_subcommand(self, subc, argv=None): |
|
261 | def initialize_subcommand(self, subc, argv=None): | |
262 | if subc in self.deprecated_subcommands: |
|
262 | if subc in self.deprecated_subcommands: | |
263 | self.log.warning("Subcommand `ipython {sub}` is deprecated and will be removed " |
|
263 | self.log.warning("Subcommand `ipython {sub}` is deprecated and will be removed " | |
264 | "in future versions.".format(sub=subc)) |
|
264 | "in future versions.".format(sub=subc)) | |
265 | self.log.warning("You likely want to use `jupyter {sub}` in the " |
|
265 | self.log.warning("You likely want to use `jupyter {sub}` in the " | |
266 | "future".format(sub=subc)) |
|
266 | "future".format(sub=subc)) | |
267 | return super(BaseIPythonApplication, self).initialize_subcommand(subc, argv) |
|
267 | return super(BaseIPythonApplication, self).initialize_subcommand(subc, argv) | |
268 |
|
268 | |||
269 | def init_crash_handler(self): |
|
269 | def init_crash_handler(self): | |
270 | """Create a crash handler, typically setting sys.excepthook to it.""" |
|
270 | """Create a crash handler, typically setting sys.excepthook to it.""" | |
271 | self.crash_handler = self.crash_handler_class(self) |
|
271 | self.crash_handler = self.crash_handler_class(self) | |
272 | sys.excepthook = self.excepthook |
|
272 | sys.excepthook = self.excepthook | |
273 | def unset_crashhandler(): |
|
273 | def unset_crashhandler(): | |
274 | sys.excepthook = sys.__excepthook__ |
|
274 | sys.excepthook = sys.__excepthook__ | |
275 | atexit.register(unset_crashhandler) |
|
275 | atexit.register(unset_crashhandler) | |
276 |
|
276 | |||
277 | def excepthook(self, etype, evalue, tb): |
|
277 | def excepthook(self, etype, evalue, tb): | |
278 | """this is sys.excepthook after init_crashhandler |
|
278 | """this is sys.excepthook after init_crashhandler | |
279 |
|
279 | |||
280 | set self.verbose_crash=True to use our full crashhandler, instead of |
|
280 | set self.verbose_crash=True to use our full crashhandler, instead of | |
281 | a regular traceback with a short message (crash_handler_lite) |
|
281 | a regular traceback with a short message (crash_handler_lite) | |
282 | """ |
|
282 | """ | |
283 |
|
283 | |||
284 | if self.verbose_crash: |
|
284 | if self.verbose_crash: | |
285 | return self.crash_handler(etype, evalue, tb) |
|
285 | return self.crash_handler(etype, evalue, tb) | |
286 | else: |
|
286 | else: | |
287 | return crashhandler.crash_handler_lite(etype, evalue, tb) |
|
287 | return crashhandler.crash_handler_lite(etype, evalue, tb) | |
288 |
|
288 | |||
289 | @observe('ipython_dir') |
|
289 | @observe('ipython_dir') | |
290 | def _ipython_dir_changed(self, change): |
|
290 | def _ipython_dir_changed(self, change): | |
291 | old = change['old'] |
|
291 | old = change['old'] | |
292 | new = change['new'] |
|
292 | new = change['new'] | |
293 | if old is not Undefined: |
|
293 | if old is not Undefined: | |
294 | str_old = os.path.abspath(old) |
|
294 | str_old = os.path.abspath(old) | |
295 | if str_old in sys.path: |
|
295 | if str_old in sys.path: | |
296 | sys.path.remove(str_old) |
|
296 | sys.path.remove(str_old) | |
297 | str_path = os.path.abspath(new) |
|
297 | str_path = os.path.abspath(new) | |
298 | sys.path.append(str_path) |
|
298 | sys.path.append(str_path) | |
299 | ensure_dir_exists(new) |
|
299 | ensure_dir_exists(new) | |
300 | readme = os.path.join(new, 'README') |
|
300 | readme = os.path.join(new, 'README') | |
301 | readme_src = os.path.join(get_ipython_package_dir(), u'config', u'profile', 'README') |
|
301 | readme_src = os.path.join(get_ipython_package_dir(), u'config', u'profile', 'README') | |
302 | if not os.path.exists(readme) and os.path.exists(readme_src): |
|
302 | if not os.path.exists(readme) and os.path.exists(readme_src): | |
303 | shutil.copy(readme_src, readme) |
|
303 | shutil.copy(readme_src, readme) | |
304 | for d in ('extensions', 'nbextensions'): |
|
304 | for d in ('extensions', 'nbextensions'): | |
305 | path = os.path.join(new, d) |
|
305 | path = os.path.join(new, d) | |
306 | try: |
|
306 | try: | |
307 | ensure_dir_exists(path) |
|
307 | ensure_dir_exists(path) | |
308 | except OSError as e: |
|
308 | except OSError as e: | |
309 | # this will not be EEXIST |
|
309 | # this will not be EEXIST | |
310 | self.log.error("couldn't create path %s: %s", path, e) |
|
310 | self.log.error("couldn't create path %s: %s", path, e) | |
311 | self.log.debug("IPYTHONDIR set to: %s" % new) |
|
311 | self.log.debug("IPYTHONDIR set to: %s" % new) | |
312 |
|
312 | |||
313 | def load_config_file(self, suppress_errors=IPYTHON_SUPPRESS_CONFIG_ERRORS): |
|
313 | def load_config_file(self, suppress_errors=IPYTHON_SUPPRESS_CONFIG_ERRORS): | |
314 | """Load the config file. |
|
314 | """Load the config file. | |
315 |
|
315 | |||
316 | By default, errors in loading config are handled, and a warning |
|
316 | By default, errors in loading config are handled, and a warning | |
317 | printed on screen. For testing, the suppress_errors option is set |
|
317 | printed on screen. For testing, the suppress_errors option is set | |
318 | to False, so errors will make tests fail. |
|
318 | to False, so errors will make tests fail. | |
319 |
|
319 | |||
320 | `suppress_errors` default value is to be `None` in which case the |
|
320 | `suppress_errors` default value is to be `None` in which case the | |
321 | behavior default to the one of `traitlets.Application`. |
|
321 | behavior default to the one of `traitlets.Application`. | |
322 |
|
322 | |||
323 | The default value can be set : |
|
323 | The default value can be set : | |
324 | - to `False` by setting 'IPYTHON_SUPPRESS_CONFIG_ERRORS' environment variable to '0', or 'false' (case insensitive). |
|
324 | - to `False` by setting 'IPYTHON_SUPPRESS_CONFIG_ERRORS' environment variable to '0', or 'false' (case insensitive). | |
325 | - to `True` by setting 'IPYTHON_SUPPRESS_CONFIG_ERRORS' environment variable to '1' or 'true' (case insensitive). |
|
325 | - to `True` by setting 'IPYTHON_SUPPRESS_CONFIG_ERRORS' environment variable to '1' or 'true' (case insensitive). | |
326 | - to `None` by setting 'IPYTHON_SUPPRESS_CONFIG_ERRORS' environment variable to '' (empty string) or leaving it unset. |
|
326 | - to `None` by setting 'IPYTHON_SUPPRESS_CONFIG_ERRORS' environment variable to '' (empty string) or leaving it unset. | |
327 |
|
327 | |||
328 | Any other value are invalid, and will make IPython exit with a non-zero return code. |
|
328 | Any other value are invalid, and will make IPython exit with a non-zero return code. | |
329 | """ |
|
329 | """ | |
330 |
|
330 | |||
331 |
|
331 | |||
332 | self.log.debug("Searching path %s for config files", self.config_file_paths) |
|
332 | self.log.debug("Searching path %s for config files", self.config_file_paths) | |
333 | base_config = 'ipython_config.py' |
|
333 | base_config = 'ipython_config.py' | |
334 | self.log.debug("Attempting to load config file: %s" % |
|
334 | self.log.debug("Attempting to load config file: %s" % | |
335 | base_config) |
|
335 | base_config) | |
336 | try: |
|
336 | try: | |
337 | if suppress_errors is not None: |
|
337 | if suppress_errors is not None: | |
338 | old_value = Application.raise_config_file_errors |
|
338 | old_value = Application.raise_config_file_errors | |
339 | Application.raise_config_file_errors = not suppress_errors; |
|
339 | Application.raise_config_file_errors = not suppress_errors; | |
340 | Application.load_config_file( |
|
340 | Application.load_config_file( | |
341 | self, |
|
341 | self, | |
342 | base_config, |
|
342 | base_config, | |
343 | path=self.config_file_paths |
|
343 | path=self.config_file_paths | |
344 | ) |
|
344 | ) | |
345 | except ConfigFileNotFound: |
|
345 | except ConfigFileNotFound: | |
346 | # ignore errors loading parent |
|
346 | # ignore errors loading parent | |
347 | self.log.debug("Config file %s not found", base_config) |
|
347 | self.log.debug("Config file %s not found", base_config) | |
348 | pass |
|
348 | pass | |
349 | if suppress_errors is not None: |
|
349 | if suppress_errors is not None: | |
350 | Application.raise_config_file_errors = old_value |
|
350 | Application.raise_config_file_errors = old_value | |
351 |
|
351 | |||
352 | for config_file_name in self.config_files: |
|
352 | for config_file_name in self.config_files: | |
353 | if not config_file_name or config_file_name == base_config: |
|
353 | if not config_file_name or config_file_name == base_config: | |
354 | continue |
|
354 | continue | |
355 | self.log.debug("Attempting to load config file: %s" % |
|
355 | self.log.debug("Attempting to load config file: %s" % | |
356 | self.config_file_name) |
|
356 | self.config_file_name) | |
357 | try: |
|
357 | try: | |
358 | Application.load_config_file( |
|
358 | Application.load_config_file( | |
359 | self, |
|
359 | self, | |
360 | config_file_name, |
|
360 | config_file_name, | |
361 | path=self.config_file_paths |
|
361 | path=self.config_file_paths | |
362 | ) |
|
362 | ) | |
363 | except ConfigFileNotFound: |
|
363 | except ConfigFileNotFound: | |
364 | # Only warn if the default config file was NOT being used. |
|
364 | # Only warn if the default config file was NOT being used. | |
365 | if config_file_name in self.config_file_specified: |
|
365 | if config_file_name in self.config_file_specified: | |
366 | msg = self.log.warning |
|
366 | msg = self.log.warning | |
367 | else: |
|
367 | else: | |
368 | msg = self.log.debug |
|
368 | msg = self.log.debug | |
369 | msg("Config file not found, skipping: %s", config_file_name) |
|
369 | msg("Config file not found, skipping: %s", config_file_name) | |
370 | except Exception: |
|
370 | except Exception: | |
371 | # For testing purposes. |
|
371 | # For testing purposes. | |
372 | if not suppress_errors: |
|
372 | if not suppress_errors: | |
373 | raise |
|
373 | raise | |
374 | self.log.warning("Error loading config file: %s" % |
|
374 | self.log.warning("Error loading config file: %s" % | |
375 | self.config_file_name, exc_info=True) |
|
375 | self.config_file_name, exc_info=True) | |
376 |
|
376 | |||
377 | def init_profile_dir(self): |
|
377 | def init_profile_dir(self): | |
378 | """initialize the profile dir""" |
|
378 | """initialize the profile dir""" | |
379 | self._in_init_profile_dir = True |
|
379 | self._in_init_profile_dir = True | |
380 | if self.profile_dir is not None: |
|
380 | if self.profile_dir is not None: | |
381 | # already ran |
|
381 | # already ran | |
382 | return |
|
382 | return | |
383 | if 'ProfileDir.location' not in self.config: |
|
383 | if 'ProfileDir.location' not in self.config: | |
384 | # location not specified, find by profile name |
|
384 | # location not specified, find by profile name | |
385 | try: |
|
385 | try: | |
386 | p = ProfileDir.find_profile_dir_by_name(self.ipython_dir, self.profile, self.config) |
|
386 | p = ProfileDir.find_profile_dir_by_name(self.ipython_dir, self.profile, self.config) | |
387 | except ProfileDirError: |
|
387 | except ProfileDirError: | |
388 | # not found, maybe create it (always create default profile) |
|
388 | # not found, maybe create it (always create default profile) | |
389 | if self.auto_create or self.profile == 'default': |
|
389 | if self.auto_create or self.profile == 'default': | |
390 | try: |
|
390 | try: | |
391 | p = ProfileDir.create_profile_dir_by_name(self.ipython_dir, self.profile, self.config) |
|
391 | p = ProfileDir.create_profile_dir_by_name(self.ipython_dir, self.profile, self.config) | |
392 | except ProfileDirError: |
|
392 | except ProfileDirError: | |
393 | self.log.fatal("Could not create profile: %r"%self.profile) |
|
393 | self.log.fatal("Could not create profile: %r"%self.profile) | |
394 | self.exit(1) |
|
394 | self.exit(1) | |
395 | else: |
|
395 | else: | |
396 | self.log.info("Created profile dir: %r"%p.location) |
|
396 | self.log.info("Created profile dir: %r"%p.location) | |
397 | else: |
|
397 | else: | |
398 | self.log.fatal("Profile %r not found."%self.profile) |
|
398 | self.log.fatal("Profile %r not found."%self.profile) | |
399 | self.exit(1) |
|
399 | self.exit(1) | |
400 | else: |
|
400 | else: | |
401 |
self.log.debug("Using existing profile dir: |
|
401 | self.log.debug(f"Using existing profile dir: {p.location!r}") | |
402 | else: |
|
402 | else: | |
403 | location = self.config.ProfileDir.location |
|
403 | location = self.config.ProfileDir.location | |
404 | # location is fully specified |
|
404 | # location is fully specified | |
405 | try: |
|
405 | try: | |
406 | p = ProfileDir.find_profile_dir(location, self.config) |
|
406 | p = ProfileDir.find_profile_dir(location, self.config) | |
407 | except ProfileDirError: |
|
407 | except ProfileDirError: | |
408 | # not found, maybe create it |
|
408 | # not found, maybe create it | |
409 | if self.auto_create: |
|
409 | if self.auto_create: | |
410 | try: |
|
410 | try: | |
411 | p = ProfileDir.create_profile_dir(location, self.config) |
|
411 | p = ProfileDir.create_profile_dir(location, self.config) | |
412 | except ProfileDirError: |
|
412 | except ProfileDirError: | |
413 | self.log.fatal("Could not create profile directory: %r"%location) |
|
413 | self.log.fatal("Could not create profile directory: %r"%location) | |
414 | self.exit(1) |
|
414 | self.exit(1) | |
415 | else: |
|
415 | else: | |
416 | self.log.debug("Creating new profile dir: %r"%location) |
|
416 | self.log.debug("Creating new profile dir: %r"%location) | |
417 | else: |
|
417 | else: | |
418 | self.log.fatal("Profile directory %r not found."%location) |
|
418 | self.log.fatal("Profile directory %r not found."%location) | |
419 | self.exit(1) |
|
419 | self.exit(1) | |
420 | else: |
|
420 | else: | |
421 |
self.log. |
|
421 | self.log.debug(f"Using existing profile dir: {p.location!r}") | |
422 | # if profile_dir is specified explicitly, set profile name |
|
422 | # if profile_dir is specified explicitly, set profile name | |
423 | dir_name = os.path.basename(p.location) |
|
423 | dir_name = os.path.basename(p.location) | |
424 | if dir_name.startswith('profile_'): |
|
424 | if dir_name.startswith('profile_'): | |
425 | self.profile = dir_name[8:] |
|
425 | self.profile = dir_name[8:] | |
426 |
|
426 | |||
427 | self.profile_dir = p |
|
427 | self.profile_dir = p | |
428 | self.config_file_paths.append(p.location) |
|
428 | self.config_file_paths.append(p.location) | |
429 | self._in_init_profile_dir = False |
|
429 | self._in_init_profile_dir = False | |
430 |
|
430 | |||
431 | def init_config_files(self): |
|
431 | def init_config_files(self): | |
432 | """[optionally] copy default config files into profile dir.""" |
|
432 | """[optionally] copy default config files into profile dir.""" | |
433 | self.config_file_paths.extend(ENV_CONFIG_DIRS) |
|
433 | self.config_file_paths.extend(ENV_CONFIG_DIRS) | |
434 | self.config_file_paths.extend(SYSTEM_CONFIG_DIRS) |
|
434 | self.config_file_paths.extend(SYSTEM_CONFIG_DIRS) | |
435 | # copy config files |
|
435 | # copy config files | |
436 | path = Path(self.builtin_profile_dir) |
|
436 | path = Path(self.builtin_profile_dir) | |
437 | if self.copy_config_files: |
|
437 | if self.copy_config_files: | |
438 | src = self.profile |
|
438 | src = self.profile | |
439 |
|
439 | |||
440 | cfg = self.config_file_name |
|
440 | cfg = self.config_file_name | |
441 | if path and (path / cfg).exists(): |
|
441 | if path and (path / cfg).exists(): | |
442 | self.log.warning( |
|
442 | self.log.warning( | |
443 | "Staging %r from %s into %r [overwrite=%s]" |
|
443 | "Staging %r from %s into %r [overwrite=%s]" | |
444 | % (cfg, src, self.profile_dir.location, self.overwrite) |
|
444 | % (cfg, src, self.profile_dir.location, self.overwrite) | |
445 | ) |
|
445 | ) | |
446 | self.profile_dir.copy_config_file(cfg, path=path, overwrite=self.overwrite) |
|
446 | self.profile_dir.copy_config_file(cfg, path=path, overwrite=self.overwrite) | |
447 | else: |
|
447 | else: | |
448 | self.stage_default_config_file() |
|
448 | self.stage_default_config_file() | |
449 | else: |
|
449 | else: | |
450 | # Still stage *bundled* config files, but not generated ones |
|
450 | # Still stage *bundled* config files, but not generated ones | |
451 | # This is necessary for `ipython profile=sympy` to load the profile |
|
451 | # This is necessary for `ipython profile=sympy` to load the profile | |
452 | # on the first go |
|
452 | # on the first go | |
453 | files = path.glob("*.py") |
|
453 | files = path.glob("*.py") | |
454 | for fullpath in files: |
|
454 | for fullpath in files: | |
455 | cfg = fullpath.name |
|
455 | cfg = fullpath.name | |
456 | if self.profile_dir.copy_config_file(cfg, path=path, overwrite=False): |
|
456 | if self.profile_dir.copy_config_file(cfg, path=path, overwrite=False): | |
457 | # file was copied |
|
457 | # file was copied | |
458 | self.log.warning("Staging bundled %s from %s into %r"%( |
|
458 | self.log.warning("Staging bundled %s from %s into %r"%( | |
459 | cfg, self.profile, self.profile_dir.location) |
|
459 | cfg, self.profile, self.profile_dir.location) | |
460 | ) |
|
460 | ) | |
461 |
|
461 | |||
462 |
|
462 | |||
463 | def stage_default_config_file(self): |
|
463 | def stage_default_config_file(self): | |
464 | """auto generate default config file, and stage it into the profile.""" |
|
464 | """auto generate default config file, and stage it into the profile.""" | |
465 | s = self.generate_config_file() |
|
465 | s = self.generate_config_file() | |
466 | config_file = Path(self.profile_dir.location) / self.config_file_name |
|
466 | config_file = Path(self.profile_dir.location) / self.config_file_name | |
467 | if self.overwrite or not config_file.exists(): |
|
467 | if self.overwrite or not config_file.exists(): | |
468 | self.log.warning("Generating default config file: %r" % (config_file)) |
|
468 | self.log.warning("Generating default config file: %r" % (config_file)) | |
469 | config_file.write_text(s) |
|
469 | config_file.write_text(s) | |
470 |
|
470 | |||
471 | @catch_config_error |
|
471 | @catch_config_error | |
472 | def initialize(self, argv=None): |
|
472 | def initialize(self, argv=None): | |
473 | # don't hook up crash handler before parsing command-line |
|
473 | # don't hook up crash handler before parsing command-line | |
474 | self.parse_command_line(argv) |
|
474 | self.parse_command_line(argv) | |
475 | self.init_crash_handler() |
|
475 | self.init_crash_handler() | |
476 | if self.subapp is not None: |
|
476 | if self.subapp is not None: | |
477 | # stop here if subapp is taking over |
|
477 | # stop here if subapp is taking over | |
478 | return |
|
478 | return | |
479 | # save a copy of CLI config to re-load after config files |
|
479 | # save a copy of CLI config to re-load after config files | |
480 | # so that it has highest priority |
|
480 | # so that it has highest priority | |
481 | cl_config = deepcopy(self.config) |
|
481 | cl_config = deepcopy(self.config) | |
482 | self.init_profile_dir() |
|
482 | self.init_profile_dir() | |
483 | self.init_config_files() |
|
483 | self.init_config_files() | |
484 | self.load_config_file() |
|
484 | self.load_config_file() | |
485 | # enforce cl-opts override configfile opts: |
|
485 | # enforce cl-opts override configfile opts: | |
486 | self.update_config(cl_config) |
|
486 | self.update_config(cl_config) |
General Comments 0
You need to be logged in to leave comments.
Login now