Skip to main content

Diff and merge of Jupyter Notebooks

Project description

Installation | Documentation | Contributing | Development Install | Testing | License | Getting help

nbdime Jupyter Notebook Diff and Merge tools

Build Status codecov.io Documentation Status Google Group

nbdime provides tools for diffing and merging of Jupyter Notebooks.

  • nbdiff compare notebooks in a terminal-friendly way
  • nbmerge three-way merge of notebooks with automatic conflict resolution
  • nbdiff-web shows you a rich rendered diff of notebooks
  • nbmerge-web gives you a web-based three-way merge tool for notebooks
  • nbshow present a single notebook in a terminal-friendly way

Diffing notebooks in the terminal:

terminal-diff

Merging notebooks in a browser:

web-merge

Installation

Install nbdime with pip:

pip install nbdime

See the installation docs for more installation details and development installation instructions.

Documentation

See the latest documentation at https://nbdime.readthedocs.io.

See also description and discussion in the Jupyter Enhancement Proposal.

Contributing

If you would like to contribute to the project, please read our contributor documentation and the CONTRIBUTING.md.

Development Install

To install a development version of nbdime, you will need npm installed and available on your PATH while installing.

For a development install, enter on the command line:

pip install -e git+https://github.com/jupyter/nbdime#egg=nbdime

See installation documentation for additional detail, particularly related to performing a dev install for working on the browser script code.

Testing

Install the test requirements:

pip install nbdime[test]

To run Python tests locally, enter on the command line: pytest

To run Javascript tests locally, enter: npm test

Install the codecov browser extension to view test coverage in the source browser on github.

See testing documentation for additional detail.

License

We use a shared copyright model that enables all contributors to maintain the copyright on their contributions.

All code is licensed under the terms of the revised BSD license.

Getting help

We encourage you to ask questions on the mailing list.

Resources

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nbdime-2.1.1.tar.gz (7.6 MB view details)

Uploaded Source

Built Distribution

nbdime-2.1.1-py2.py3-none-any.whl (5.1 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file nbdime-2.1.1.tar.gz.

File metadata

  • Download URL: nbdime-2.1.1.tar.gz
  • Upload date:
  • Size: 7.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.1

File hashes

Hashes for nbdime-2.1.1.tar.gz
Algorithm Hash digest
SHA256 92dcefc207a05b72a9934693cd0449c7cab914a73b4de10600fdc308d0a90293
MD5 1ba6019735718316ceba16e30e7f3e06
BLAKE2b-256 0c5253da537c12ed4056ddf3889533cde74a9d5706486ff3404104ff72df42a9

See more details on using hashes here.

Provenance

File details

Details for the file nbdime-2.1.1-py2.py3-none-any.whl.

File metadata

  • Download URL: nbdime-2.1.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 5.1 MB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.1

File hashes

Hashes for nbdime-2.1.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 bc2a2449a9d5f6252b844ca1b75097b3236ae674470e26b5b3a5cdcb13b2ffd2
MD5 53a688f176daec64bbcf1df1e57df149
BLAKE2b-256 97ce4076992c2fb9f397e3b8befd54c0363d2868da4905c4e5e3acb4d95ab12b

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page