Autogenerate .py or .ipynb files

[serin-delaunay]

Keeping IPython notebooks and Python scripts in sync is probably not a maintainable situation in the long-term; sooner or later there will be contributors who don't use Jupyter.

Wangview has two purposes:

1. To allow Wangscape users to see output tiles in context. This is best served by .py files or packaged executables.
2. To allow developers to see how Wangscape output should be used in their own applications. This is best served by .ipynb files or notebooks rendered to static HTML.

Conversions in both directions are possible, using nbconvert (1, 2), or PY2NB.

Probably the .py files should be made primary, as there are still Python users who don't have IPython. Then notebooks could be generated along with documentation using a command like make doc. A separate command may be necessary to generate notebooks in the development folders.

[hryniuk]

I wonder if it is really necessary... Couldn't we just import code from Python files with a bit of magic, i.e.:

%load filename.py

?

[serin-delaunay]

Importing code from .py files isn't a problem; the .ipynb and .py files both do so already using plain import statements.