Module: core.application — IPython 5.3.0 documentation

# Module: `core.application`

An application for IPython.

All top-level applications should use the classes in this module for handling configuration and creating configurables.

The job of an `Application` is to create the master configuration object and then create the configurable objects, passing the config to them.

## 2 Classes

class `IPython.core.application.` `ProfileAwareConfigLoader`(filename, path=None, **kw)

  Bases: `traitlets.config.loader.PyFileConfigLoader`

  A Python file config loader that is aware of IPython profiles.

class `IPython.core.application.` `BaseIPythonApplication`(**kwargs)

  Bases: `traitlets.config.application.Application`

  `__init__`(**kwargs)
  `excepthook`(etype, evalue, tb)

    this is sys.excepthook after init_crashhandler

    set self.verbose_crash=True to use our full crashhandler, instead of a regular traceback with a short message (crash_handler_lite)

  `init_config_files`()

    [optionally] copy default config files into profile dir.

  `init_crash_handler`()

    Create a crash handler, typically setting sys.excepthook to it.

  `init_profile_dir`()

    initialize the profile dir

  `load_config_file`(suppress_errors=None)

    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.

    `supress_errors` default value is to be `None` in which case the behavior default to the one of `traitlets.Application`.

    The default value can be set :
      - to `False` by setting ‘IPYTHON_SUPPRESS_CONFIG_ERRORS’ environment variable to ‘0’, or ‘false’ (case insensitive).
      - to `True` by setting ‘IPYTHON_SUPPRESS_CONFIG_ERRORS’ environment variable to ‘1’ or ‘true’ (case insensitive).
      - to `None` by setting ‘IPYTHON_SUPPRESS_CONFIG_ERRORS’ environment variable to ‘’ (empty string) or leaving it unset.

    Any other value are invalid, and will make IPython exit with a non-zero return code.

  `python_config_loader_class`

    alias of `ProfileAwareConfigLoader`

  `stage_default_config_file`()

    auto generate default config file, and stage it into the profile.