You can clone with
simple example script for running notebooks and reporting exceptions.
Usage: `checkipnb.py foo.ipynb [bar.ipynb [...]]`
Each cell is submitted to the kernel, and checked for errors.
from Queue import Empty
from IPython.kernel import KernelManager
from IPython.zmq.blockingkernelmanager import BlockingKernelManager as KernelManager
from IPython.nbformat.current import reads, NotebookNode
km = KernelManager()
kc = km.client()
kc = km
shell = kc.shell_channel
# simple ping:
cells = 0
failures = 0
for ws in nb.worksheets:
for cell in ws.cells:
if cell.cell_type != 'code':
# wait for finish, maximum 20s
reply = shell.get_msg(timeout=20)['content']
if reply['status'] == 'error':
failures += 1
cells += 1
print "ran notebook %s" % nb.metadata.name
print " ran %3i cells" % cells
print " %3i cells raised exceptions" % failures
if __name__ == '__main__':
for ipynb in sys.argv[1:]:
print "running %s" % ipynb
with open(ipynb) as f:
nb = reads(f.read(), 'json')
If I have a notebook that has cells ready to be run (say they produce plots form an experiment), and I run this on that notebook, when I open the notebook, the output is still note created. Is it possible to run the notebook offline, and then overwrite the nb with the newly run version?
@hugadams I had the same question, and I discovered this: https://pypi.python.org/pypi/runipy
Neither the above code, nor runipy, seem to run actually run an IPython notebook as the notebook itself runs it: if I have a "%load" directive in a notebook, and I run all the cells via the interactive menu, the "%load" magic loads the code in a new cell, and this cell is then executed. On the opposite, the various headless runners that I have found just skip the new cell.
It would be really useful to be able to run notebook headless. Currently it is hard to do quality assurance on notebooks.
@minrk would it be possible to update this script for IPython 3?