Important

This documentation covers IPython versions 6.0 and higher. Beginning with version 6.0, IPython stopped supporting compatibility with Python versions lower than 3.3 including all versions of Python 2.7.

If you are looking for an IPython version compatible with Python 2.7, please use the IPython 5.x LTS release and refer to its documentation (LTS is the long term support release).

Module: core.logger

Logger class for IPython’s logging facilities.

1 Class

class IPython.core.logger.Logger(home_dir, logfname='Logger.log', loghead='', logmode='over')

Bases: object

A Logfile class with different policies for file creation

__init__(home_dir, logfname='Logger.log', loghead='', logmode='over')
close_log()

Fully stop logging and close log file.

In order to start logging again, a new logstart() call needs to be made, possibly (though not necessarily) with a new filename, mode and other options.

log(line_mod, line_ori)

Write the sources to a log.

Inputs:

  • line_mod: possibly modified input, such as the transformations made by input prefilters or input handlers of various kinds. This should always be valid Python.

  • line_ori: unmodified input line from the user. This is not necessarily valid Python.

log_write(data, kind='input')

Write data to the log file, if active

logstart(logfname=None, loghead=None, logmode=None, log_output=False, timestamp=False, log_raw_input=False)

Generate a new log-file with a default header.

Raises RuntimeError if the log has already been started

logstate()

Print a status message about the logger.

logstop()

Fully stop logging and close log file.

In order to start logging again, a new logstart() call needs to be made, possibly (though not necessarily) with a new filename, mode and other options.

switch_log(val)

Switch logging on/off. val should be ONLY a boolean.