Skip to main content

Apply black to all code cells in a jupyter notebook.

Project description


black-nb applies black to the code cells of Jupyter notebooks. It can be called with a list of files or directories and will search for all files ending with '.ipynb', excluding paths containing '.ipynb_checkpoints'. Additional exclusions can be added using one or more -x options (wildcards not supported), line length can be configured with -l.

Non-code cells and cells with cell magic (anything starting with '%%') will be excluded. Line magic ('%') will be treated as a comment and restored after reformatting.

Notebooks are modified inplace.


pip install git+git://

nb-black requires Python 3.6 or later.


To apply black with a line length of 88 to all notebooks under the current directory, excluding anything with 'example' in its path and 'messy.ipynb' in the current directory:

black-nb . -l 88 -x example -x ./messy.ipynb


Copyright © 2019 Tom Catling.

black-nb is distributed under the terms of the ISC licence.

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

black-nb-0.0.1.tar.gz (3.7 kB view hashes)

Uploaded Source

Built Distribution

black_nb-0.0.1-py3-none-any.whl (4.0 kB view hashes)

Uploaded Python 3

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