# Configuration file for ipython.12#------------------------------------------------------------------------------3# Configurable configuration4#------------------------------------------------------------------------------56#------------------------------------------------------------------------------7# InteractiveShellApp configuration8#------------------------------------------------------------------------------910# A Mixin for applications that start InteractiveShell instances.11#12# Provides configurables for loading extensions and executing files as part of13# configuring a Shell environment.14#15# The following methods should be called by the :meth:`initialize` method of the16# subclass:17#18# - :meth:`init_path`19# - :meth:`init_shell` (to be implemented by the subclass)20# - :meth:`init_gui_pylab`21# - :meth:`init_extensions`22# - :meth:`init_code`2324# Execute the given command string.25# c.InteractiveShellApp.code_to_run = ''2627# Reraise exceptions encountered loading IPython extensions?28# c.InteractiveShellApp.reraise_ipython_extension_failures = False2930# Run the file referenced by the PYTHONSTARTUP environment variable at IPython31# startup.32# c.InteractiveShellApp.exec_PYTHONSTARTUP = True3334# lines of code to run at IPython startup.35# c.InteractiveShellApp.exec_lines = traitlets.Undefined3637# Enable GUI event loop integration with any of ('glut', 'gtk', 'gtk3', 'osx',38# 'pyglet', 'qt', 'qt5', 'tk', 'wx').39# c.InteractiveShellApp.gui = None4041# Pre-load matplotlib and numpy for interactive use, selecting a particular42# matplotlib backend and loop integration.43# c.InteractiveShellApp.pylab = None4445# Configure matplotlib for interactive use with the default matplotlib backend.46# c.InteractiveShellApp.matplotlib = None4748# If true, IPython will populate the user namespace with numpy, pylab, etc. and49# an ``import *`` is done from numpy and pylab, when using pylab mode.50#51# When False, pylab mode should not import any names into the user namespace.52# c.InteractiveShellApp.pylab_import_all = True5354# A list of dotted module names of IPython extensions to load.55# c.InteractiveShellApp.extensions = traitlets.Undefined5657# Run the module as a script.58# c.InteractiveShellApp.module_to_run = ''5960# Should variables loaded at startup (by startup files, exec_lines, etc.) be61# hidden from tools like %who?62# c.InteractiveShellApp.hide_initial_ns = True6364# dotted module name of an IPython extension to load.65# c.InteractiveShellApp.extra_extension = ''6667# List of files to run at IPython startup.68# c.InteractiveShellApp.exec_files = traitlets.Undefined6970# A file to be run71# c.InteractiveShellApp.file_to_run = ''7273#------------------------------------------------------------------------------74# SingletonConfigurable configuration75#------------------------------------------------------------------------------7677# A configurable that only allows one instance.78#79# This class is for classes that should only have one instance of itself or80# *any* subclass. To create and retrieve such a class use the81# :meth:`SingletonConfigurable.instance` method.8283#------------------------------------------------------------------------------84# Application configuration85#------------------------------------------------------------------------------8687# This is an application.8889# The date format used by logging formatters for %(asctime)s90# c.Application.log_datefmt = '%Y-%m-%d %H:%M:%S'9192# The Logging format template93# c.Application.log_format = '[%(name)s]%(highlevel)s %(message)s'9495# Set the log level by value or name.96# c.Application.log_level = 309798#------------------------------------------------------------------------------99# BaseIPythonApplication configuration100#------------------------------------------------------------------------------101102# IPython: an enhanced interactive Python shell.103104# The IPython profile to use.105# c.BaseIPythonApplication.profile = u'default'106107# Path to an extra config file to load.108#109# If specified, load this config file in addition to any other IPython config.110# c.BaseIPythonApplication.extra_config_file = u''111112# Create a massive crash report when IPython encounters what may be an internal113# error. The default is to append a short message to the usual traceback114# c.BaseIPythonApplication.verbose_crash = False115116# The name of the IPython directory. This directory is used for logging117# configuration (through profiles), history storage, etc. The default is usually118# $HOME/.ipython. This option can also be specified through the environment119# variable IPYTHONDIR.120# c.BaseIPythonApplication.ipython_dir = u''121122# Whether to install the default config files into the profile dir. If a new123# profile is being created, and IPython contains config files for that profile,124# then they will be staged into the new directory. Otherwise, default config125# files will be automatically generated.126# c.BaseIPythonApplication.copy_config_files = False127128# Whether to create profile dir if it doesn't exist129# c.BaseIPythonApplication.auto_create = False130131# Whether to overwrite existing config files when copying132# c.BaseIPythonApplication.overwrite = False133134#------------------------------------------------------------------------------135# TerminalIPythonApp configuration136#------------------------------------------------------------------------------137138# If a command or file is given via the command-line, e.g. 'ipython foo.py',139# start an interactive shell after executing the file or command.140# c.TerminalIPythonApp.force_interact = False141142# Whether to display a banner upon starting IPython.143# c.TerminalIPythonApp.display_banner = True144145# Start IPython quickly by skipping the loading of config files.146# c.TerminalIPythonApp.quick = False147148#------------------------------------------------------------------------------149# InteractiveShell configuration150#------------------------------------------------------------------------------151152# An enhanced, interactive shell for Python.153154# Use colors for displaying information about objects. Because this information155# is passed through a pager (like 'less'), and some pagers get confused with156# color codes, this capability can be turned off.157# c.InteractiveShell.color_info = True158159# A list of ast.NodeTransformer subclass instances, which will be applied to160# user input before code is run.161# c.InteractiveShell.ast_transformers = traitlets.Undefined162163#164# c.InteractiveShell.history_length = 10000165166# Don't call post-execute functions that have failed in the past.167# c.InteractiveShell.disable_failing_post_execute = False168169# Show rewritten input, e.g. for autocall.170# c.InteractiveShell.show_rewritten_input = True171172# Set the color scheme (NoColor, Linux, or LightBG).173# c.InteractiveShell.colors = 'Linux'174175# If True, anything that would be passed to the pager will be displayed as176# regular output instead.177# c.InteractiveShell.display_page = False178179# Autoindent IPython code entered interactively.180# c.InteractiveShell.autoindent = True181182#183# c.InteractiveShell.separate_in = '\n'184185#186# c.InteractiveShell.xmode = 'Context'187188# Enable magic commands to be called without the leading %.189# c.InteractiveShell.automagic = True190191# Deprecated, use PromptManager.in2_template192# c.InteractiveShell.prompt_in2 = ' .\\D.: '193194#195# c.InteractiveShell.separate_out = ''196197# Deprecated, use PromptManager.in_template198# c.InteractiveShell.prompt_in1 = 'In [\\#]: '199200# **Deprecated**201#202# Enable deep (recursive) reloading by default. IPython can use the deep_reload203# module which reloads changes in modules recursively (it replaces the reload()204# function, so you don't need to change anything to use it). `deep_reload`205# forces a full reload of modules whose code may have changed, which the default206# reload() function does not. When deep_reload is off, IPython will use the207# normal reload(), but deep_reload will still be available as dreload().208# c.InteractiveShell.deep_reload = False209210# The number of saved history entries to be loaded into the readline buffer at211# startup.212# c.InteractiveShell.history_load_length = 1000213214#215# c.InteractiveShell.separate_out2 = ''216217# Deprecated, use PromptManager.justify218# c.InteractiveShell.prompts_pad_left = True219220# The part of the banner to be printed before the profile221# c.InteractiveShell.banner1 = 'Python 2.7.9 (default, Sep 22 2015, 12:04:36) \nType "copyright", "credits" or "license" for more information.\n\nIPython 4.0.0 -- An enhanced Interactive Python.\n? -> Introduction and overview of IPython\'s features.\n%quickref -> Quick reference.\nhelp -> Python\'s own help system.\nobject? -> Details about \'object\', use \'object??\' for extra details.\n'222223#224# c.InteractiveShell.readline_parse_and_bind = traitlets.Undefined225226#print c.InteractiveShell.readline_parse_and_bind227228c.InteractiveShell.readline_parse_and_bind = ['tab:complete']229#c.InteractiveShell.readline_parse_and_bind = ['tab:menu-complete']230231# The part of the banner to be printed after the profile232# c.InteractiveShell.banner2 = ''233234# Set the size of the output cache. The default is 1000, you can change it235# permanently in your config file. Setting it to 0 completely disables the236# caching system, and the minimum value accepted is 20 (if you provide a value237# less than 20, it is reset to 0 and a warning is issued). This limit is238# defined because otherwise you'll spend more time re-flushing a too small cache239# than working240# c.InteractiveShell.cache_size = 1000241242#243# c.InteractiveShell.object_info_string_level = 0244245#246# c.InteractiveShell.ipython_dir = ''247248#249# c.InteractiveShell.readline_remove_delims = '-/~'250251# Start logging to the default log file in overwrite mode. Use `logappend` to252# specify a log file to **append** logs to.253# c.InteractiveShell.logstart = False254255# The name of the logfile to use.256# c.InteractiveShell.logfile = ''257258#259# c.InteractiveShell.wildcards_case_sensitive = True260261# Save multi-line entries as one entry in readline history262# c.InteractiveShell.multiline_history = True263264#265# c.InteractiveShell.readline_use = True266267# Start logging to the given file in append mode. Use `logfile` to specify a log268# file to **overwrite** logs to.269# c.InteractiveShell.logappend = ''270271# Make IPython automatically call any callable object even if you didn't type272# explicit parentheses. For example, 'str 43' becomes 'str(43)' automatically.273# The value can be '0' to disable the feature, '1' for 'smart' autocall, where274# it is not applied if there are no more arguments on the line, and '2' for275# 'full' autocall, where all callable objects are automatically called (even if276# no arguments are present).277# c.InteractiveShell.autocall = 0278279#280# c.InteractiveShell.quiet = False281282# Deprecated, use PromptManager.out_template283# c.InteractiveShell.prompt_out = 'Out[\\#]: '284285#286# c.InteractiveShell.debug = False287288# 'all', 'last', 'last_expr' or 'none', specifying which nodes should be run289# interactively (displaying output from expressions).290# c.InteractiveShell.ast_node_interactivity = 'last_expr'291292# Automatically call the pdb debugger after every exception.293# c.InteractiveShell.pdb = False294295#------------------------------------------------------------------------------296# TerminalInteractiveShell configuration297#------------------------------------------------------------------------------298299# auto editing of files with syntax errors.300# c.TerminalInteractiveShell.autoedit_syntax = False301302# Number of lines of your screen, used to control printing of very long strings.303# Strings longer than this number of lines will be sent through a pager instead304# of directly printed. The default value for this is 0, which means IPython305# will auto-detect your screen size every time it needs to print certain306# potentially long strings (this doesn't change the behavior of the 'print'307# keyword, it's only triggered internally). If for some reason this isn't308# working well (it needs curses support), specify it yourself. Otherwise don't309# change the default.310# c.TerminalInteractiveShell.screen_length = 0311312# Enable auto setting the terminal title.313# c.TerminalInteractiveShell.term_title = False314315# Set to confirm when you try to exit IPython with an EOF (Control-D in Unix,316# Control-Z/Enter in Windows). By typing 'exit' or 'quit', you can force a317# direct exit without any confirmation.318# c.TerminalInteractiveShell.confirm_exit = True319320# Set the editor used by IPython (default to $EDITOR/vi/notepad).321# c.TerminalInteractiveShell.editor = 'vi'322323# The shell program to be used for paging.324# c.TerminalInteractiveShell.pager = 'less'325326#------------------------------------------------------------------------------327# PromptManager configuration328#------------------------------------------------------------------------------329330# This is the primary interface for producing IPython's prompts.331332# Output prompt. '\#' will be transformed to the prompt number333# c.PromptManager.out_template = 'Out[\\#]: '334335# Continuation prompt.336# c.PromptManager.in2_template = ' .\\D.: '337338#339# c.PromptManager.color_scheme = 'Linux'340341# Input prompt. '\#' will be transformed to the prompt number342# c.PromptManager.in_template = 'Foo [\\#]: '343344# If True (default), each prompt will be right-aligned with the preceding one.345# c.PromptManager.justify = True346347#------------------------------------------------------------------------------348# HistoryAccessorBase configuration349#------------------------------------------------------------------------------350351# An abstract class for History Accessors352353#------------------------------------------------------------------------------354# HistoryAccessor configuration355#------------------------------------------------------------------------------356357# Access the history database without adding to it.358#359# This is intended for use by standalone history tools. IPython shells use360# HistoryManager, below, which is a subclass of this.361362# Path to file to use for SQLite history database.363#364# By default, IPython will put the history database in the IPython profile365# directory. If you would rather share one history among profiles, you can set366# this value in each, so that they are consistent.367#368# Due to an issue with fcntl, SQLite is known to misbehave on some NFS mounts.369# If you see IPython hanging, try setting this to something on a local disk,370# e.g::371#372# ipython --HistoryManager.hist_file=/tmp/ipython_hist.sqlite373# c.HistoryAccessor.hist_file = u''374375# enable the SQLite history376#377# set enabled=False to disable the SQLite history, in which case there will be378# no stored history, no SQLite connection, and no background saving thread.379# This may be necessary in some threaded environments where IPython is embedded.380# c.HistoryAccessor.enabled = True381382# Options for configuring the SQLite connection383#384# These options are passed as keyword args to sqlite3.connect when establishing385# database conenctions.386# c.HistoryAccessor.connection_options = traitlets.Undefined387388#------------------------------------------------------------------------------389# HistoryManager configuration390#------------------------------------------------------------------------------391392# A class to organize all history-related functionality in one place.393394# Should the history database include output? (default: no)395# c.HistoryManager.db_log_output = False396397# Write to database every x commands (higher values save disk access & power).398# Values of 1 or less effectively disable caching.399# c.HistoryManager.db_cache_size = 0400401#------------------------------------------------------------------------------402# LoggingConfigurable configuration403#------------------------------------------------------------------------------404405# A parent class for Configurables that log.406#407# Subclasses have a log trait, and the default behavior is to get the logger408# from the currently running Application.409410#------------------------------------------------------------------------------411# ProfileDir configuration412#------------------------------------------------------------------------------413414# An object to manage the profile directory and its resources.415#416# The profile directory is used by all IPython applications, to manage417# configuration, logging and security.418#419# This object knows how to find, create and manage these directories. This420# should be used by any code that wants to handle profiles.421422# Set the profile location directly. This overrides the logic used by the423# `profile` option.424# c.ProfileDir.location = u''425426#------------------------------------------------------------------------------427# BaseFormatter configuration428#------------------------------------------------------------------------------429430# A base formatter class that is configurable.431#432# This formatter should usually be used as the base class of all formatters. It433# is a traited :class:`Configurable` class and includes an extensible API for434# users to determine how their objects are formatted. The following logic is435# used to find a function to format an given object.436#437# 1. The object is introspected to see if it has a method with the name438# :attr:`print_method`. If is does, that object is passed to that method439# for formatting.440# 2. If no print method is found, three internal dictionaries are consulted441# to find print method: :attr:`singleton_printers`, :attr:`type_printers`442# and :attr:`deferred_printers`.443#444# Users should use these dictionaries to register functions that will be used to445# compute the format data for their objects (if those objects don't have the446# special print methods). The easiest way of using these dictionaries is through447# the :meth:`for_type` and :meth:`for_type_by_name` methods.448#449# If no function/callable is found to compute the format data, ``None`` is450# returned and this format type is not used.451452#453# c.BaseFormatter.type_printers = traitlets.Undefined454455#456# c.BaseFormatter.deferred_printers = traitlets.Undefined457458#459# c.BaseFormatter.enabled = True460461#462# c.BaseFormatter.singleton_printers = traitlets.Undefined463464#------------------------------------------------------------------------------465# PlainTextFormatter configuration466#------------------------------------------------------------------------------467468# The default pretty-printer.469#470# This uses :mod:`IPython.lib.pretty` to compute the format data of the object.471# If the object cannot be pretty printed, :func:`repr` is used. See the472# documentation of :mod:`IPython.lib.pretty` for details on how to write pretty473# printers. Here is a simple example::474#475# def dtype_pprinter(obj, p, cycle):476# if cycle:477# return p.text('dtype(...)')478# if hasattr(obj, 'fields'):479# if obj.fields is None:480# p.text(repr(obj))481# else:482# p.begin_group(7, 'dtype([')483# for i, field in enumerate(obj.descr):484# if i > 0:485# p.text(',')486# p.breakable()487# p.pretty(field)488# p.end_group(7, '])')489490#491# c.PlainTextFormatter.newline = '\n'492493#494# c.PlainTextFormatter.float_precision = ''495496#497# c.PlainTextFormatter.verbose = False498499# Truncate large collections (lists, dicts, tuples, sets) to this size.500#501# Set to 0 to disable truncation.502# c.PlainTextFormatter.max_seq_length = 1000503504#505# c.PlainTextFormatter.max_width = 79506507#508# c.PlainTextFormatter.pprint = True509510#------------------------------------------------------------------------------511# Completer configuration512#------------------------------------------------------------------------------513514# Activate greedy completion515#516# This will enable completion on elements of lists, results of function calls,517# etc., but can be unsafe because the code is actually evaluated on TAB.518# c.Completer.greedy = False519520#------------------------------------------------------------------------------521# IPCompleter configuration522#------------------------------------------------------------------------------523524# Extension of the completer class with IPython-specific features525526# Instruct the completer to omit private method names527#528# Specifically, when completing on ``object.<tab>``.529#530# When 2 [default]: all names that start with '_' will be excluded.531#532# When 1: all 'magic' names (``__foo__``) will be excluded.533#534# When 0: nothing will be excluded.535# c.IPCompleter.omit__names = 2536537# Whether to merge completion results into a single list538#539# If False, only the completion results from the first non-empty completer will540# be returned.541# c.IPCompleter.merge_completions = True542543# Instruct the completer to use __all__ for the completion544#545# Specifically, when completing on ``object.<tab>``.546#547# When True: only those names in obj.__all__ will be included.548#549# When False [default]: the __all__ attribute is ignored550# c.IPCompleter.limit_to__all__ = False551552#------------------------------------------------------------------------------553# Magics configuration554#------------------------------------------------------------------------------555556# Base class for implementing magic functions.557#558# Shell functions which can be reached as %function_name. All magic functions559# should accept a string, which they can parse for their own needs. This can560# make some functions easier to type, eg `%cd ../` vs. `%cd("../")`561#562# Classes providing magic functions need to subclass this class, and they MUST:563#564# - Use the method decorators `@line_magic` and `@cell_magic` to decorate565# individual methods as magic functions, AND566#567# - Use the class decorator `@magics_class` to ensure that the magic568# methods are properly registered at the instance level upon instance569# initialization.570#571# See :mod:`magic_functions` for examples of actual implementation classes.572573#------------------------------------------------------------------------------574# ScriptMagics configuration575#------------------------------------------------------------------------------576577# Magics for talking to scripts578#579# This defines a base `%%script` cell magic for running a cell with a program in580# a subprocess, and registers a few top-level magics that call %%script with581# common interpreters.582583# Extra script cell magics to define584#585# This generates simple wrappers of `%%script foo` as `%%foo`.586#587# If you want to add script magics that aren't on your path, specify them in588# script_paths589# c.ScriptMagics.script_magics = traitlets.Undefined590591# Dict mapping short 'ruby' names to full paths, such as '/opt/secret/bin/ruby'592#593# Only necessary for items in script_magics where the default path will not find594# the right interpreter.595# c.ScriptMagics.script_paths = traitlets.Undefined596597#------------------------------------------------------------------------------598# StoreMagics configuration599#------------------------------------------------------------------------------600601# Lightweight persistence for python variables.602#603# Provides the %store magic.604605# If True, any %store-d variables will be automatically restored when IPython606# starts.607# c.StoreMagics.autorestore = False608609610