Reviews and Ratings
Elegant.
written over 12 years ago
PyLit is an elegant approach to literate programming.
The older and more complex tools -- like the original Web and Weave -- all suffer from a common problem. They provide what amounts to a "poor man's object-oriented programming."
Some LP tools provide macros to support code reuse that's better done through inheritance. Some LP tools provide code reordering because some compilers impose a code order that's not conducive to a tidy explanation.
Modern OO languages (like Python) don't require elaborate workarounds in the LP tool. PyLit and Python hit the sweet spot of "easy-to-explain" code. Part of this is Python. Part of this is RST markup. And part of this is the power of Sphinx.