I made two releases of litpd yesterday, the first focused on moving away from lua/shell for orchestration to python and the second one simplified the tangling process and packaged litpd for deployment on PyPI.
litpd is a tool for literate programming with Pandoc: write a program and its explanation in one Markdown document, then generate both documentation and source files. Learn more at the litpd site.
litpd itself is written as a literate program in pandoc markdown, and its documentation and code are generated using litpd itself via a bootstrapping process
The latest release is v0.3.1b0
PyPI distribution
- litpd can now be installed with with
pipx install litpd(orpython3 -m pip install litpd). - The installed package contains the litpd command and its Pandoc Lua filter.
- Pandoc remains the only external runtime dependency.
Simpler tangling
- Replaced the older two-filter, temporary-file workflow with one in-memory Lua filter.
- This eliminates intermediate code_id fragment files while preserving the literate-programming workflow.
Small language improvement
- code_id references can now include underscores, making fragment names clearer.
Better documentation styling
- Refined the documentation’s responsive styling and reading layout.
This release of litpd makes it more accessible, and easier to use. Please try
it out for writing your next program and do let me know what you think.