black + nbconvert
Tired of having to think about formatting in Jupyter notebooks? Look no further! This script will correctly format your Jupyter notebooks for you using black.
Warning: This project will overwrite your notebooks in place. It shouldn't change anything except the format, but use at your own risk!
Installation & Usage
pip install black_nbconvert
To check a notebook:
black_nbconvert --check /path/to/a/notebook.ipynb
To fix the formatting in a notebook (in place):
If you pass a directory instead of a notebook file, notebooks will be found recursively below that directory. For example:
will fix the formatting for all notebooks in the current directory and (recursively) below.
Configuration: Configuration for
black in a
pyproject.toml file above the target files will be respected.
Version control integration
repos: - repo: https://github.com/dfm/black_nbconvert rev: stable hooks: - id: black_nbconvert
pre-commit install and you're ready to go.