Preparing teaching materials

[grkuntzmd at gmail.com]

I am considering teaching a beginning programming course using Python.
I would like to prepare my class handouts in such a way that I can
import the Python code from real ".py" files directly into the
documents. This way I can run real unit tests on the code to confirm
that they work as expected.

I am considering using LaTeX to write the handouts and then converting
them to PDF files. I will probably use a Makefile to convert the LaTeX
with embedded Python code into the PDF files using pdflatex.

I will probably organize my directory structure into sub-directories
py-src, py-test, doc-src, and doc-dist.

I will be starting out using Windows Vista/cygwin and hopefully switch
to a Macbook this summer.

Any thoughts?