PyLit

Literate Programming with reStructuredText

The idea is that you do not document programs (after the fact), but write documents that contain the programs. [1]

Features

PyLit (Python Literate) provides a plain but efficient tool for literate programming: a bidirectional text/code converter.

• Features
  • Dual Source
  • Simplicity
  • Markup with reStructuredText
  • Python Doctest Support

Documentation

• Usage
• Tutorial
• Examples
• Literate Programming
• Finding a Filename Extension for Literate Sources
• Updates

Download

• Requirements
• Download
• Installation

Project page

The PyLit3 project is hosted on GitHub.

https://github.com/slott56/PyLit-3

Legacy

The original PyLit project was hosted at BerliOS.

Changes

The PyLit source has change history and chapter on open questions and ideas.

Copyright

Copyright

© 2005, 2009 Günter Milde.

License

PyLit is free software, released under the GNU General Public License (GPL)

PyLit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

I am using PyLit in my daily work for more than two years now without major problems. It works for me, but your mileage might vary.

Remember to back up your data. A version control system is recommended.

About this site

The PyLit site is created from reStructuredText sources with Sphinx. (Earlier versions used the rest2web site builder.)

It is located at https://github.com/slott56/PyLit-3. Documentation is located at http://slott56.github.io/PyLit-3/.

[1]	John Max Skaller in a Charming Python interview