lightweight ipython notebook diffing tool
Project description
The lightweight ipython notebook diffing tool
Purpose
To turn ipython/jupyter notebooks into something that can be diffed by a human. No diff or merge GUI, nothing fancy here. This tool just exports data from the notebook to git diff, which can be read by the user, or piped to less(1), or written to a file.
Export data
Running ndb exports the following data from a notebook:
Python Format (the Ins)
RST Format (the Outs)
Resources (e.g. PNGs)
Requirements
Python >= 2.6
nbconvert
pandoc
git
Usage
Help:
nbd -h
Example usage:
nbd modified_notebook.ipynb
Works with less(1) for big diffs:
nbd massively_modified_notebook.ipynb | less
Build
Source distribution:
python setup.py sdist
Install
Build first, then install with pip:
pip install dist/nbd-1.0.0.dev1.tar.gz
NOTE: If you have not already pip-installed nbconvert, running the above command will install it for you.
Tutorial
See the tutorial in the demo/ directory: demo tutorial.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.