Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 

Build Status GitHub Actions Status: CI DOI

blackbook

Black for Jupyter notebooks.

How?

$ pip install blackbook
$ blackbook .
2019-01-28 17:15:10.857 | INFO     | blackbook.__main__:main:31 - All done! 📖
2019-01-28 17:15:10.857 | INFO     | blackbook.__main__:main:33 - 1 notebooks reformatted. 1 left unchanged.

You can also run blackbook over a single notebook

$ blackbook unformatted.ipynb
2019-01-28 17:15:12.663 | INFO     | blackbook.__main__:main:31 - All done! 📖
2019-01-28 17:15:12.663 | INFO     | blackbook.__main__:main:33 - 1 notebooks reformatted. 0 left unchanged.

Why?

From black:

Black is the uncompromising Python code formatter. By using it, you agree to cede control over minutiae of hand-formatting. In return, Black gives you speed, determinism, and freedom from pycodestyle nagging about formatting. You will save time and mental energy for more important matters.

There are two black implementations for Jupyter notebooks:

These both work in a given notebook session, blackbook will search a directory tree and reformat the notebooks in an uncompromising way.