This documentation is for an old version of IPython. You can find docs for newer versions here.

Module: nbformat.v3.rwbase

Base classes and utilities for readers and writers.

2 Classes

class IPython.nbformat.v3.rwbase.NotebookReader

Bases: object

A class for reading notebooks.

read(fp, **kwargs)

Read a notebook from a file like object

reads(s, **kwargs)

Read a notebook from a string.

class IPython.nbformat.v3.rwbase.NotebookWriter

Bases: object

A class for writing notebooks.

write(nb, fp, **kwargs)

Write a notebook to a file like object

writes(nb, **kwargs)

Write a notebook to a string.

6 Functions


Restore bytes of image data from unicode-only formats.

Base64 encoding is handled elsewhere. Bytes objects in the notebook are always b64-encoded. We DO NOT encode/decode around file formats.

Note: this is never used


rejoin multiline text into strings

For reversing effects of split_lines(nb).

This only rejoins lines that have been split, so if text objects were not split they will pass through unchanged.

Used when reading JSON files that may have been passed through split_lines.


split likely multiline text into lists of strings

For file output more friendly to line-based VCS. rejoin_lines(nb) will reverse the effects of split_lines(nb).

Used when writing JSON files.


Restore all bytes objects in the notebook from base64-encoded strings.

Note: This is never used


Base64 encode all bytes objects in the notebook.

These will be b64-encoded unicode strings

Note: This is never used


Strip transient values that shouldn’t be stored in files.

This should be called in both read and write.