|
|
# encoding: utf-8
|
|
|
"""
|
|
|
An application for IPython.
|
|
|
|
|
|
All top-level applications should use the classes in this module for
|
|
|
handling configuration and creating componenets.
|
|
|
|
|
|
The job of an :class:`Application` is to create the master configuration
|
|
|
object and then create the configurable objects, passing the config to them.
|
|
|
|
|
|
Authors:
|
|
|
|
|
|
* Brian Granger
|
|
|
* Fernando Perez
|
|
|
* Min RK
|
|
|
|
|
|
"""
|
|
|
|
|
|
#-----------------------------------------------------------------------------
|
|
|
# Copyright (C) 2008-2011 The IPython Development Team
|
|
|
#
|
|
|
# Distributed under the terms of the BSD License. The full license is in
|
|
|
# the file COPYING, distributed as part of this software.
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
|
|
#-----------------------------------------------------------------------------
|
|
|
# Imports
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
|
|
import logging
|
|
|
import os
|
|
|
import shutil
|
|
|
import sys
|
|
|
|
|
|
from IPython.config.application import Application
|
|
|
from IPython.config.configurable import Configurable
|
|
|
from IPython.config.loader import Config
|
|
|
from IPython.core import release, crashhandler
|
|
|
from IPython.core.profiledir import ProfileDir, ProfileDirError
|
|
|
from IPython.utils.path import get_ipython_dir, get_ipython_package_dir
|
|
|
from IPython.utils.traitlets import List, Unicode, Type, Bool, Dict
|
|
|
|
|
|
#-----------------------------------------------------------------------------
|
|
|
# Classes and functions
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
#-----------------------------------------------------------------------------
|
|
|
# Base Application Class
|
|
|
#-----------------------------------------------------------------------------
|
|
|
|
|
|
# aliases and flags
|
|
|
|
|
|
base_aliases = dict(
|
|
|
profile='BaseIPythonApplication.profile',
|
|
|
ipython_dir='BaseIPythonApplication.ipython_dir',
|
|
|
)
|
|
|
|
|
|
base_flags = dict(
|
|
|
debug = ({'Application' : {'log_level' : logging.DEBUG}},
|
|
|
"set log level to logging.DEBUG (maximize logging output)"),
|
|
|
quiet = ({'Application' : {'log_level' : logging.CRITICAL}},
|
|
|
"set log level to logging.CRITICAL (minimize logging output)"),
|
|
|
init = ({'BaseIPythonApplication' : {
|
|
|
'copy_config_files' : True,
|
|
|
'auto_create' : True}
|
|
|
}, "Initialize profile with default config files")
|
|
|
)
|
|
|
|
|
|
|
|
|
class BaseIPythonApplication(Application):
|
|
|
|
|
|
name = Unicode(u'ipython')
|
|
|
description = Unicode(u'IPython: an enhanced interactive Python shell.')
|
|
|
version = Unicode(release.version)
|
|
|
|
|
|
aliases = Dict(base_aliases)
|
|
|
flags = Dict(base_flags)
|
|
|
|
|
|
# Track whether the config_file has changed,
|
|
|
# because some logic happens only if we aren't using the default.
|
|
|
config_file_specified = Bool(False)
|
|
|
|
|
|
config_file_name = Unicode(u'ipython_config.py')
|
|
|
def _config_file_name_changed(self, name, old, new):
|
|
|
if new != old:
|
|
|
self.config_file_specified = True
|
|
|
|
|
|
# The directory that contains IPython's builtin profiles.
|
|
|
builtin_profile_dir = Unicode(
|
|
|
os.path.join(get_ipython_package_dir(), u'config', u'profile', u'default')
|
|
|
)
|
|
|
|
|
|
config_file_paths = List(Unicode)
|
|
|
def _config_file_paths_default(self):
|
|
|
return [os.getcwdu()]
|
|
|
|
|
|
profile = Unicode(u'default', config=True,
|
|
|
help="""The IPython profile to use."""
|
|
|
)
|
|
|
def _profile_changed(self, name, old, new):
|
|
|
self.builtin_profile_dir = os.path.join(
|
|
|
get_ipython_package_dir(), u'config', u'profile', new
|
|
|
)
|
|
|
|
|
|
|
|
|
ipython_dir = Unicode(get_ipython_dir(), config=True,
|
|
|
help="""
|
|
|
The name of the IPython directory. This directory is used for logging
|
|
|
configuration (through profiles), history storage, etc. The default
|
|
|
is usually $HOME/.ipython. This options can also be specified through
|
|
|
the environment variable IPYTHON_DIR.
|
|
|
"""
|
|
|
)
|
|
|
|
|
|
overwrite = Bool(False, config=True,
|
|
|
help="""Whether to overwrite existing config files when copying""")
|
|
|
auto_create = Bool(False, config=True,
|
|
|
help="""Whether to create profile dir if it doesn't exist""")
|
|
|
|
|
|
config_files = List(Unicode)
|
|
|
def _config_files_default(self):
|
|
|
return [u'ipython_config.py']
|
|
|
|
|
|
copy_config_files = Bool(False, config=True,
|
|
|
help="""Whether to copy the default config files into the profile dir.""")
|
|
|
|
|
|
# The class to use as the crash handler.
|
|
|
crash_handler_class = Type(crashhandler.CrashHandler)
|
|
|
|
|
|
def __init__(self, **kwargs):
|
|
|
super(BaseIPythonApplication, self).__init__(**kwargs)
|
|
|
# ensure even default IPYTHON_DIR exists
|
|
|
if not os.path.exists(self.ipython_dir):
|
|
|
self._ipython_dir_changed('ipython_dir', self.ipython_dir, self.ipython_dir)
|
|
|
|
|
|
#-------------------------------------------------------------------------
|
|
|
# Various stages of Application creation
|
|
|
#-------------------------------------------------------------------------
|
|
|
|
|
|
def init_crash_handler(self):
|
|
|
"""Create a crash handler, typically setting sys.excepthook to it."""
|
|
|
self.crash_handler = self.crash_handler_class(self)
|
|
|
sys.excepthook = self.crash_handler
|
|
|
|
|
|
def _ipython_dir_changed(self, name, old, new):
|
|
|
if old in sys.path:
|
|
|
sys.path.remove(old)
|
|
|
sys.path.append(os.path.abspath(new))
|
|
|
if not os.path.isdir(new):
|
|
|
os.makedirs(new, mode=0777)
|
|
|
readme = os.path.join(new, 'README')
|
|
|
if not os.path.exists(readme):
|
|
|
path = os.path.join(get_ipython_package_dir(), u'config', u'profile')
|
|
|
shutil.copy(os.path.join(path, 'README'), readme)
|
|
|
self.log.debug("IPYTHON_DIR set to: %s" % new)
|
|
|
|
|
|
def load_config_file(self, suppress_errors=True):
|
|
|
"""Load the config file.
|
|
|
|
|
|
By default, errors in loading config are handled, and a warning
|
|
|
printed on screen. For testing, the suppress_errors option is set
|
|
|
to False, so errors will make tests fail.
|
|
|
"""
|
|
|
self.log.debug("Attempting to load config file: %s" %
|
|
|
self.config_file_name)
|
|
|
try:
|
|
|
Application.load_config_file(
|
|
|
self,
|
|
|
self.config_file_name,
|
|
|
path=self.config_file_paths
|
|
|
)
|
|
|
except IOError:
|
|
|
# Only warn if the default config file was NOT being used.
|
|
|
if self.config_file_specified:
|
|
|
self.log.warn("Config file not found, skipping: %s" %
|
|
|
self.config_file_name)
|
|
|
except:
|
|
|
# For testing purposes.
|
|
|
if not suppress_errors:
|
|
|
raise
|
|
|
self.log.warn("Error loading config file: %s" %
|
|
|
self.config_file_name, exc_info=True)
|
|
|
|
|
|
def init_profile_dir(self):
|
|
|
"""initialize the profile dir"""
|
|
|
try:
|
|
|
# location explicitly specified:
|
|
|
location = self.config.ProfileDir.location
|
|
|
except AttributeError:
|
|
|
# location not specified, find by profile name
|
|
|
try:
|
|
|
p = ProfileDir.find_profile_dir_by_name(self.ipython_dir, self.profile, self.config)
|
|
|
except ProfileDirError:
|
|
|
# not found, maybe create it (always create default profile)
|
|
|
if self.auto_create or self.profile=='default':
|
|
|
try:
|
|
|
p = ProfileDir.create_profile_dir_by_name(self.ipython_dir, self.profile, self.config)
|
|
|
except ProfileDirError:
|
|
|
self.log.fatal("Could not create profile: %r"%self.profile)
|
|
|
self.exit(1)
|
|
|
else:
|
|
|
self.log.info("Created profile dir: %r"%p.location)
|
|
|
else:
|
|
|
self.log.fatal("Profile %r not found."%self.profile)
|
|
|
self.exit(1)
|
|
|
else:
|
|
|
self.log.info("Using existing profile dir: %r"%p.location)
|
|
|
else:
|
|
|
# location is fully specified
|
|
|
try:
|
|
|
p = ProfileDir.find_profile_dir(location, self.config)
|
|
|
except ProfileDirError:
|
|
|
# not found, maybe create it
|
|
|
if self.auto_create:
|
|
|
try:
|
|
|
p = ProfileDir.create_profile_dir(location, self.config)
|
|
|
except ProfileDirError:
|
|
|
self.log.fatal("Could not create profile directory: %r"%location)
|
|
|
self.exit(1)
|
|
|
else:
|
|
|
self.log.info("Creating new profile dir: %r"%location)
|
|
|
else:
|
|
|
self.log.fatal("Profile directory %r not found."%location)
|
|
|
self.exit(1)
|
|
|
else:
|
|
|
self.log.info("Using existing profile dir: %r"%location)
|
|
|
|
|
|
self.profile_dir = p
|
|
|
self.config_file_paths.append(p.location)
|
|
|
|
|
|
def init_config_files(self):
|
|
|
"""[optionally] copy default config files into profile dir."""
|
|
|
# copy config files
|
|
|
if self.copy_config_files:
|
|
|
path = self.builtin_profile_dir
|
|
|
src = self.profile
|
|
|
if not os.path.exists(path):
|
|
|
# use default if new profile doesn't have a preset
|
|
|
path = None
|
|
|
src = 'default'
|
|
|
|
|
|
self.log.debug("Staging %s config files into %r [overwrite=%s]"%(
|
|
|
src, self.profile_dir.location, self.overwrite)
|
|
|
)
|
|
|
|
|
|
for cfg in self.config_files:
|
|
|
self.profile_dir.copy_config_file(cfg, path=path, overwrite=self.overwrite)
|
|
|
|
|
|
def initialize(self, argv=None):
|
|
|
self.init_crash_handler()
|
|
|
self.parse_command_line(argv)
|
|
|
cl_config = self.config
|
|
|
self.init_profile_dir()
|
|
|
self.init_config_files()
|
|
|
self.load_config_file()
|
|
|
# enforce cl-opts override configfile opts:
|
|
|
self.update_config(cl_config)
|
|
|
|
|
|
|
