Run any Python code quality tool on a Jupyter Notebook!
Project description
Run any standard Python code quality tool on a Jupyter Notebook
Table of contents
๐ Installation
In your virtual environment, run one of the following:
python -m pip install -U nbqa(minimal installation)python -m pip install -U nbqa[toolchain](install supported code quality tools as well)conda install -c conda-forge nbqa(if you use conda)
๐ Examples
Command-line
Reformat your notebooks with black:
$ nbqa black my_notebook.ipynb --nbqa-mutate
reformatted my_notebook.ipynb
All done! โจ ๐ฐ โจ
1 files reformatted.
Sort your imports with isort:
$ nbqa isort my_notebook.ipynb --nbqa-mutate
Fixing my_notebook.ipynb
Upgrade your syntax with pyupgrade:
$ nbqa pyupgrade my_notebook.ipynb --py36-plus --nbqa-mutate
Rewriting my_notebook.ipynb
See command-line examples for examples involving pylint, flake8, doctest, and mypy.
Pre-commit
Here's an example of how to set up some pre-commit hooks:
-
Put this in your
pyproject.tomlfile (see configuration for details)[tool.nbqa.config] isort = "setup.cfg" black = "pyproject.toml" [tool.nbqa.mutate] isort = 1 black = 1 pyupgrade = 1 [tool.nbqa.addopts] pyupgrade = ["--py36-plus"]
-
Put this in your
.pre-commit-config.yamlfile (see usage as pre-commit hook)- repo: https://github.com/nbQA-dev/nbQA rev: 0.3.6 hooks: - id: nbqa-black - id: nbqa-pyupgrade - id: nbqa-isort
๐ฅณ Used by
Take some inspiration from their config files ๐
- PyMC3: pyproject.toml .pre-commit-config.yaml
- pandas-profiling .pre-commit-config.yaml
- alibi .pre-commit-config.yaml
- NLP Profiler: pyproject.toml .pre-commit-config.yaml
- LiuAlgoTrader: pyproject.toml .pre-commit-config.yaml
๐ฌ Testimonials
Michael Kennedy & Brian Okken, hosts of the Python Bytes podcast:
This is really cool. I think it brings so much of the code formatting and code analysis, clean up to notebooks, which I think had been really lacking
Nikita Sobolev, CTO at wemake.services:
It is amazing!
Alex Andorra, Data Scientist, ArviZ & PyMC Dev, Host of 'Learning Bayesian Statistics' Podcast:
well done on
nbqa@MarcoGorelli ! Will be super useful in CI
Girish Pasupathy, Software engineer and now core-contributor:
thanks a lot for your effort to create such a useful tool
๐ฅ Contributing
I will give write-access to anyone who contributes anything useful (e.g. pull request / bug report) - see the contributing guide for details on how to do so.
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
Release history Release notifications | RSS feed
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
File details
Details for the file nbqa-0.3.6.tar.gz.
File metadata
- Download URL: nbqa-0.3.6.tar.gz
- Upload date:
- Size: 38.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 97c90fe6f419d238d816f3e5396de3d2942ab1012894b54debe6d9368122eaf1 |
|
| MD5 | 10bc63d7fa0201db2d954d4d366977cb |
|
| BLAKE2b-256 | f9d643ae2ef26df6f52279c8e76b1c432e1b358023e9b969c0d84e609264b41c |
Provenance
File details
Details for the file nbqa-0.3.6-py3-none-any.whl.
File metadata
- Download URL: nbqa-0.3.6-py3-none-any.whl
- Upload date:
- Size: 30.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.0 requests-toolbelt/0.9.1 tqdm/4.48.0 CPython/3.8.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | fe8782750473f2f3fed4af923eabab39d9fabd9412541a793266109776d58a0c |
|
| MD5 | 6a313ac78d4900cd1487ea9aa81ce2ac |
|
| BLAKE2b-256 | ae55c0dcf5f6f0eb403382e0f22a14f09c9c05ec5d72a160f87e5e7baa737493 |
