pytest-ipynb

Plugin for pytest to run IPython notebooks as unit tests, relies on runipy to interface with the Notebook.

Define unit tests in IPython notebook cells (see example on nbviewer):

Run py.test to execute them:

Example

See the examples/ folder or a preview on nbviewer.

Discover files named test*.ipynb
Run each cell of the notebook as a unit test (just use assert)
First line of each cell is the test name, either as docstring, comment or function name
A cell named fixture* or setup* is run before each of the following unit tests as a fixture
Add SKIPCI to a cell description to skip the test on Travis-CI (checks if the CI environment variable is defined)
IPython notebook kernel is restarted after each test
Each notebook is executed in the folder where the .ipynb file is located

$ pip install pytest-ipynb