Teaching Programming

[Ed Keith]

--- On Tue, 5/4/10, Stefan Behnel <stefan_ml at behnel.de> wrote:

> From: Stefan Behnel <stefan_ml at behnel.de>
> Subject: Re: Teaching Programming
> To: python-list at python.org
> Date: Tuesday, May 4, 2010, 8:40 AM
> Ed Keith, 04.05.2010 14:15:
> > I wrote AsciiLitProg (http://asciilitprog.berlios.de/) in Python. It is
> > a literate programming tool. It generates code from a
> document. It can
> > generate code in any language the author wants. It
> would have been a LOT
> > easier to write if it did not generate Python code.
> > 
> > Python is a great language to write in (although I do
> wish it did a
> > better job with closures). But it is a PITA to
> generate code for!
> 
> Interesting. Could you elaborate a bit? Could you give a
> short example of what kind of document text you translate
> into what kind of Python code, and what the problems were
> that you faced in doing so?
> 
> Stefan
> 
> -- http://mail.python.org/mailman/listinfo/python-list
> 

The program is written using itself. If you click on the link above you will see an HTML file that fully describes the program. That HTML is generated from an AcsiiDoc (http://www.methods.co.nz/asciidoc/) document. The same document is used to generate the python code that it describes.
The source document, and the generated HTML and Python code are all avalable at BerliOS (http://developer.berlios.de/projects/asciilitprog/).

For more information on Literate Programming in general see the following links.

    http://www.literateprogramming.com/
    http://en.wikipedia.org/wiki/Literate_programming
    http://en.literateprograms.org/LiteratePrograms:Welcome


   -EdK

Ed Keith
e_d_k at yahoo.com

Blog: edkeith.blogspot.com