Skip to main content

Verify that notebooks are runnable.

Project description

Runs Jupyter notebooks in parallel to verify that they are not raising any exceptions.

What for?

When managing a data science project you need to confidently be able to refactor your shared code and notebook dependencies. Validating that all of your notebooks are still runnable helps gain confidence that they are still intact after such changes.

This script can be fired from a CI tool like Travis to ensure that future pull requests does not break your notebooks.

How to use?

The script searches recursively for .ipynb within the specified path. Use --timeout to limit the maximum time a notebook are allowed to run. For example nbrun --timeout 60 ./notebooks will run all notebooks found in the folder, but will timeout if any of the notebooks did not terminate after one minute.

Sometimes you don’t want to run nbrun on specific notebooks. Suffixing notebook file names with a _ will cause nbrun to skip this notebook file. For example notebook_.ipynb will not be ignored.

Project details


Download files

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

Files for nbrun, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size nbrun-0.1.0.tar.gz (2.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page