Note

This documentation is for a development version of IPython. There may be significant differences from the latest stable release (1.2.1).

Module: kernel.manager

Base class to manage a running kernel

1 Class

class IPython.kernel.manager.KernelManager(**kwargs)

Bases: IPython.config.configurable.LoggingConfigurable, IPython.kernel.connect.ConnectionFileMixin

Manages a single kernel in a subprocess on this host.

This version starts kernels with Popen.

add_restart_callback(callback, event='restart')

register a callback to be called when a kernel is restarted

client(**kwargs)

Create a client configured to connect to our kernel

format_kernel_cmd(**kw)

replace templated args (e.g. {connection_file})

has_kernel

Has a kernel been started that we are managing.

interrupt_kernel()

Interrupts the kernel by sending it a signal.

Unlike signal_kernel, this operation is well supported on all platforms.

is_alive()

Is the kernel process still running?

remove_restart_callback(callback, event='restart')

unregister a callback to be called when a kernel is restarted

restart_kernel(now=False, **kw)

Restarts a kernel with the arguments that were used to launch it.

If the old kernel was launched with random ports, the same ports will be used for the new kernel. The same connection file is used again.

Parameters:

now : bool, optional

If True, the kernel is forcefully restarted immediately, without having a chance to do any cleanup action. Otherwise the kernel is given 1s to clean up before a forceful restart is issued.

In all cases the kernel is restarted, the only difference is whether it is given a chance to perform a clean shutdown or not.

**kw : optional

Any options specified here will overwrite those used to launch the kernel.

shutdown_kernel(now=False, restart=False)

Attempts to the stop the kernel process cleanly.

This attempts to shutdown the kernels cleanly by:

1. Sending it a shutdown message over the shell channel.
2. If that fails, the kernel is shutdown forcibly by sending it a signal.

Parameters:

now : bool

Should the kernel be forcible killed now. This skips the first, nice shutdown attempt.

restart: bool

Will this kernel be restarted after it is shutdown. When this is True, connection files will not be cleaned up.

signal_kernel(signum)

Sends a signal to the kernel.

Note that since only SIGTERM is supported on Windows, this function is only useful on Unix systems.

start_kernel(**kw)

Starts a kernel on this host in a separate process.

If random ports (port=0) are being used, this method must be called before the channels are created.

Parameters:

**kw : optional

keyword arguments that are passed down to build the kernel_cmd and launching the kernel (e.g. Popen kwargs).