Skip to main content

Pytest plugin for testing notebooks

Project description

nbmake

codecov PyPI versions PyPI versions Slack

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

  1. Executes notebooks using pytest and nbclient, allowing parallel notebook testing
  2. Optionally writes back to the repo, allowing faster building of nbsphinx or jupyter book docs
  3. 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

HTML Report

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nbmake-0.2.tar.gz (10.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nbmake-0.2-py3-none-any.whl (11.2 kB view details)

Uploaded Python 3

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

Hashes for nbmake-0.2.tar.gz
Algorithm Hash digest
SHA256 9c368c1eb310208240918a13a49d16076edc337e6cac527a030b4152523b1be5
MD5 d9ef97c43e64d6689320d658abaec29b
BLAKE2b-256 dd32ceed0d2ac2a716d75bfc4f250956f26be51ee4a2f64b70a0b8a3eed45ea3

See more details on using hashes here.

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

Hashes for nbmake-0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 fe9f03b6631dee852156aeb15434dd822ab1bead29e665a5af09c17c401ad076
MD5 a3acf3a7571d1f1b72346299b2396635
BLAKE2b-256 ea703a59fbfa819696b8d7ddcf89df735bb35ccd705da98dc746aae2d7cebbf2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page