New recipe to access venv in Jupyter

Author: amorison

Makefile

@@ -14,6 +14,7 @@ VERSION=$(shell git describe --exact-match HEAD 2>/dev/null)
 
 .PHONY: all install clean uninstall again release
 .PHONY: info infopath infozsh infobash
+.PHONY: notebook-kernel
 
 all: install
 
@@ -31,6 +32,10 @@ $(STAGPY): setup.py
 	$(VPIP) install -e .
 	@$(STAGPY) version
 
+notebook-kernel: $(STAGPY)
+	$(VPIP) install -U ipykernel
+	$(VPY) -m ipykernel install --user --name=stagpy-git
+
 info: infopath infozsh infobash
 
 infopath:

docs/sources/developers.rst

@@ -86,3 +86,20 @@ directory of the repository and run::
 
 This should create a PDF file showing a plot of the temperature field with
 streamlines.
+
+Use as a Jupyter notebook kernel
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+If you want to access the virtual environment - and therefore the development
+version of StagPy - in a Jupyter notebook, run
+::
+
+    % make notebook-kernel
+
+This will create a new Jupyter kernel named ``stagpy-git`` you can use to
+access the virtual environment in a notebook.
+
+To remove that kernel, run
+::
+
+    % jupyter kernelspec uninstall stagpy-git