A package that does some stuff]: A simple extension for Jupyter Notebook and Jupyter Lab to beautify Python code automatically using Black. Fork of dnanhkhoa/nb_black.
Project description
jupyter-black
A simple extension for Jupyter Notebook and Jupyter Lab to beautify Python code automatically using Black. Fork of dnanhkhoa/nb_black with a few minor modifications:
Features
Once loaded, automatically format syntactically correct jupyter
cells with
black
once then are run.
Enhancements compared to dnanhkhoa/nb_black:
- Configurability:
- Try to read black config from
pyproject.toml
if available - Override settings such as line length and
black.TargetVersion
if desired
- Try to read black config from
- Uses
black.format_cell
to greatly simplify the codebase - Adds tests
- Slightly more responsive (no longer requires
setTimeout
and a delay) - Free software: MIT
Introduction
black
is an extremely popular python formatter. Jupyter is an
awesome way to run python. This extension helps you automatically black
en
your jupyter
.
Dependencies
- Python >= 3.7
- See
setup.cfg
Quickstart
python3 -m venv .venv && source ./.venv/bin/activate
python3 -m pip install --upgrade pip
python3 -m pip install jupyter-black jupyter
python3 -m jupyter notebook
From here, there are two ways to load the extension:
Configurable (recommended):
import jupyter_black
jupyter_black.load()
To look at configuration options:
jupyter_black.load??
For example:
import black
import jupyter_black
jupyter_black.load(
lab=False,
line_length=79,
verbosity="DEBUG",
target_version=black.TargetVersion.PY39,
)
The other way:
%load_ext jupyter_black
This will load the extension using your defaults from pyproject.toml
if
available, or use the black
defaults.
Development Setup
- Clone the repo:
git clone https://github.com/n8henrie/jupyter-black && cd jupyter-black
- Make a virtualenv:
python3 -m venv .venv
- Activate venv, update pip, and install editable test/dev version:
$ source ./.venv/bin/activate
$ ./.venv/bin/python -m pip install --upgrade pip
$ ./.venv/bin/python -m pip install -e .[test,dev]
Notes:
- Tests use playwright
- You'll need to run this command (once) prior to running the tests:
python -m playwright install --with-deps firefox
tox
will automatically run these installation steps (helpful for CI)- If desired, pass the
--no-headless
flag topytest
for local debugging
TODO
Contribution ideas:
- More tests, currently very basic
- Ensure config is overridden in unsurprising ways
- Ensure other config options are properly passed to
black
- Ensure that
pyproject.toml
is searched for properly
- Write tests for jupyter lab, currently only tested for notebook
- I think the fixture could easily be modularized to also work for
lab
, but haven't done the work yet
- I think the fixture could easily be modularized to also work for
Contributing
Please see CONTRIBUTING.md
and TODO
.
Troubleshooting / FAQ
- How can I install an older / specific version of jupyter black?
- Install from a tag:
- pip install git+git://github.com/n8henrie/jupyter-black.git@v0.1.0
- Install from a specific commit:
- pip install git+git://github.com/n8henrie/jupyter-black.git@aabc123def456ghi789
- Install from a tag:
Acknowledgements
Many thanks to dnanhkhoa/nb_black for the original version!
And of course many thanks to the black and jupyter teams.
Also, after establishing the repo and reserving the name on PyPI, I noticed
there is another library of the same name:
drillan/jupyter-black. It looks
like there have been no commits in the last 2 years, and it was never put in
PyPI, so I think at this point I'll continue with this name. Sorry if this
causes any trouble or confusion. I'll note that @drillan's library probably
does things the right way by installing as an nbextension
.
Buy Me a Coffee
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
Built Distribution
Hashes for jupyter_black-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c72cda36a0fbd5059bb1e5fe761d54060dcdb47dccf5476898b48f3cd3ac59b5 |
|
MD5 | 90fba71a42f6d9ffe3306069e7963baf |
|
BLAKE2b-256 | 466754cdc72484d2f4a042f458fc0be53b132c5c044e99fb85aa2ad331d41ba3 |