This page was generated from doc/api.jupyter. Interactive online version: .

This notebook contains mostly “raw” cells in reStructuredText format, which are used to auto-generate the …

API Documentation

jupyter_format.generate_lines(nb)

Generator yielding lines to be written to .jupyter files.

Each of the lines has a line separator at the end, therefore it can e.g. be used in writelines().

Parameters:

nb (nbformat.NotebookNode) – A notebook node.

jupyter_format.serialize(nb)

Convert a Jupyter notebook to a string in .jupyter format.

Parameters:

nb (nbformat.NotebookNode) – A notebook node.

Returns:

.jupyter file content.

Return type:

str

jupyter_format.deserialize(source)

Convert .jupyter string representation to Jupyter notebook.

Lines have to be terminated with '\n' (a.k.a. universal newlines mode).

If source is an iterable, line terminators may be omitted.

Parameters:

source (str or iterable of str) – Content of .jupyter file.

Returns:

A notebook node.

Return type:

nbformat.NotebookNode

exception jupyter_format.ParseError

Exception that is thrown on errors during reading.

This reports the line number where the error occured.

Contents Manager

Exporters for nbconvert

class jupyter_format.exporters.JupyterImportMixin

Allow *.jupyter files as input to exporters.

This is used in all exporters as a “mixin” class.

from_file(file, resources=None, jupyter_format=None, **kw)

from_filename(filename, resources=None, **kw)

class jupyter_format.exporters.JupyterExporter(**kwargs: Any)

Convert Jupyter notebooks to .jupyter format.

from_notebook_node(nb, resources=None, **kw)

The rest of the exporters are just the ones from nbconvert.exporters, enhanced with the JupyterImportMixin.

class jupyter_format.exporters.ASCIIDocExporter(**kwargs: Any)

class jupyter_format.exporters.HTMLExporter(**kwargs: Any)

See nbconvert.exporters.HTMLExporter.

class jupyter_format.exporters.LatexExporter(**kwargs: Any)

See nbconvert.exporters.LatexExporter.

class jupyter_format.exporters.MarkdownExporter(**kwargs: Any)

See nbconvert.exporters.MarkdownExporter.

class jupyter_format.exporters.NotebookExporter(**kwargs: Any)

See nbconvert.exporters.NotebookExporter.

class jupyter_format.exporters.PDFExporter(**kwargs: Any)

See nbconvert.exporters.PDFExporter.

class jupyter_format.exporters.PythonExporter(**kwargs: Any)

See nbconvert.exporters.PythonExporter.

class jupyter_format.exporters.RSTExporter(**kwargs: Any)

See nbconvert.exporters.RSTExporter.

class jupyter_format.exporters.ScriptExporter(**kwargs: Any)

class jupyter_format.exporters.SlidesExporter(**kwargs: Any)

See nbconvert.exporters.SlidesExporter.

class jupyter_format.exporters.TemplateExporter(**kwargs: Any)

See nbconvert.exporters.TemplateExporter.

Batch Conversion with replace_all

Script to recursively replace .ipynb with .jupyter files.

Usage:

python3 -m jupyter_format.replace_all --recursive --yes

WARNING: This deletes all original files!

Usage to apply this to the whole history of a Git branch:

git filter-branch --tree-filter "python3 -m jupyter_format.replace_all --recursive --yes"

jupyter_format.replace_all.ipynb_to_jupyter(path)

Replace given .ipynb file with a .jupyter file.

WARNING: This deletes the original file!

Parameters:

path (os.PathLike or str) – Path to .ipynb file.

jupyter_format.replace_all.replace_all_recursive(start_dir, mapfunction=<class 'map'>)

Replace all .ipynb files recursively.

WARNING: This deletes all original files!

Parameters:

• path (os.PathLike or str) – Starting directory.

• mapfunction – map()-like function that can be provided in order to enable parallelization.