IPython Documentation

Table Of Contents

Previous topic

Module: html.notebook.handlers

Next topic

Module: html.services.clusters.clustermanager

This Page

Note

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

Module: html.notebookapp

A tornado based IPython notebook server.

3 Classes

class IPython.html.notebookapp.NotebookWebApplication(ipython_app, kernel_manager, contents_manager, cluster_manager, session_manager, kernel_spec_manager, log, base_url, default_url, settings_overrides, jinja_env_options)

Bases: tornado.web.Application

__init__(ipython_app, kernel_manager, contents_manager, cluster_manager, session_manager, kernel_spec_manager, log, base_url, default_url, settings_overrides, jinja_env_options)
init_handlers(settings)

Load the (URL pattern, handler) tuples for each component.

class IPython.html.notebookapp.NbserverListApp(**kwargs)

Bases: IPython.core.application.BaseIPythonApplication

class IPython.html.notebookapp.NotebookApp(**kwargs)

Bases: IPython.core.application.BaseIPythonApplication

cleanup_kernels()

Shutdown all kernels.

The kernels will shutdown themselves when this process no longer exists, but explicit shutdown allows the KernelManagers to cleanup the connection files.

init_components()

Check the components submodule, and warn if it’s unclean

init_kernel_argv()

add the profile-dir to arguments to be passed to IPython kernels

init_webapp()

initialize tornado webapp and httpserver

notebook_info()

Return the current working directory and the server url information

remove_server_info_file()

Remove the nbserver-<pid>.json file created for this server.

Ignores the error raised when the file has already been removed.

server_info()

Return a JSONable dict of information about this server.

start()

Start the IPython Notebook server app, after initialization

This method takes no arguments so all configuration and initialization must be done prior to calling this method.

static_file_path

return extra paths + the default location

template_file_path

return extra paths + the default locations

write_server_info_file()

Write the result of server_info() to the JSON file info_file.

3 Functions

IPython.html.notebookapp.random_ports(port, n)

Generate a list of n random ports near the given port.

The first 5 ports will be sequential, and the remaining n-5 will be randomly selected in the range [port-2*n, port+2*n].

IPython.html.notebookapp.load_handlers(name)

Load the (URL pattern, handler) tuples for each component.

IPython.html.notebookapp.list_running_servers(profile='default')

Iterate over the server info files of running notebook servers.

Given a profile name, find nbserver-* files in the security directory of that profile, and yield dicts of their information, each one pertaining to a currently running notebook server instance.