Pytest plugin for testing notebooks
Project description
nbmake
What? Pytest plugin for testing and releasing notebook documentation
Why? To raise the quality of scientific material through better automation
Who is this for? Research/Machine Learning Software Engineers who maintain packages/teaching materials with documentation written in notebooks.
Functionality
- Executes notebooks using pytest and nbclient, allowing parallel notebook testing
- Optionally writes back to the repo, allowing faster building of nbsphinx or jupyter book docs
- Optionally builds an HTML report using jupyter-book of the test run which can be uploaded to hosting providers such as Netlify.
See docs to get started.
See Also
HTML Report Example
Developing
Install local package
poetry install -E html
Activate shell
poetry shell
Run static checks
pre-commit run --all-files
pre-commit install
Run tests
pytest
Project details
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nbmake-0.2.tar.gz.
File metadata
- Download URL: nbmake-0.2.tar.gz
- Upload date:
- Size: 10.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.8.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9c368c1eb310208240918a13a49d16076edc337e6cac527a030b4152523b1be5
|
|
| MD5 |
d9ef97c43e64d6689320d658abaec29b
|
|
| BLAKE2b-256 |
dd32ceed0d2ac2a716d75bfc4f250956f26be51ee4a2f64b70a0b8a3eed45ea3
|
File details
Details for the file nbmake-0.2-py3-none-any.whl.
File metadata
- Download URL: nbmake-0.2-py3-none-any.whl
- Upload date:
- Size: 11.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/53.0.0 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.8.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fe9f03b6631dee852156aeb15434dd822ab1bead29e665a5af09c17c401ad076
|
|
| MD5 |
a3acf3a7571d1f1b72346299b2396635
|
|
| BLAKE2b-256 |
ea703a59fbfa819696b8d7ddcf89df735bb35ccd705da98dc746aae2d7cebbf2
|