Quick and Dirty Literate Programming

Posted on October 14, 2010 in python

Docco is a tiny, ~100-line literate-programming-style documentation generator that renders prose on the left and implementation code on the right.

I just stumbled upon docco, the quick-and-dirty, hundred-line-long, literate-programming-style documentation generator. I really like the concept of having the documentation on the left side and the implementation code on the right side.

The following example is an implementation of the gnome sort algorithm in python:

There are ports to other languages as well:

• rocco written in ruby
• shocco written in shell script
• pycco written in python, currently supports python, coffee-script, javascript, ruby, scheme and lua. Pycoo uses pygments to format the code, so it is very easy to add support for other languages.