furechan / nbcheck

Utility to check the validity of jupyter notebook files

Notebook format validation utility

This project is a simple utility wrapper around nbformat to check the validity of notebook files. The utility will return a non zero return code if any of the notebooks has validations errors. This may be useful in pre-commit scripts to detect problematic notebooks.

Usage

Usage: nbcheck [OPTIONS] [PATH]...

  Check notebooks for validation errors

Options:
  -r, --recurse  Recurse to sub directories
  -v, --verbose  Print validation errors
  --help         Show this message and exit.

Example

> nbcheck extras
pass extras/valid-notebook.ipynb
fail extras/broken-notebook.ipynb
fail extras/nbformat-read.ipynb

Installation

You can install the latest version of this module with pip or pipx

pipx install git+ssh://[e-mail]/furechan/nbcheck.git

Related Resources

• The Jupyter Notebook Format
• nbfornat API