An open API service indexing awesome lists of open source software.

https://github.com/furechan/nbcheck

Utility to check the validity of jupyter notebook files
https://github.com/furechan/nbcheck

Last synced: 4 months ago
JSON representation

Utility to check the validity of jupyter notebook files

Awesome Lists containing this project

README

        

# 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

```console
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

```console
> 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`

```console
pipx install git+ssh://[email protected]/furechan/nbcheck.git
```

## Related Resources
- [The Jupyter Notebook Format](https://nbformat.readthedocs.io/en/latest/)
- [nbfornat API](https://nbformat.readthedocs.io/en/latest/api.html)