See https://github.com/slott56/py-web-tool

And https://pypi.org/project/py-web-lp/

I finally made the PyWeb LP tool installable from PyPI.

I need to fix the name of the GitHub repo (some day) to make it also say py-web-lp. I should also fixup my tag cloud to say pyweblp …

I almost made a terrible blunder.

See https://github.com/slott56/py-web-tool for some background. This is a "Literate Programming" tool. I started fooling around with this kind of thing back in '05 (maybe even earlier.) This is not the blunder. The whole idea of literate programming is not very …

My literate programming tool, pyWeb, has moved to version 3.1 -- supporting modern Python.

Next up, version 3.2. This is a massive reworking of the data structures involved. The rework lets me use Jinja2 for templates. There's a lot of fiddliness to getting the end-of-line spacing right. Jinja has …

As noted in My Shifting Understanding and A Terrible Design Mistake, I had a design that focused on serialization instead of proper modeling of the objects in question.

Specifically, I didn't start with a suitable abstract syntax tree (AST) structure. I started with an algorithmic view of "weaving" and "tangling …

I've been fascinated by Literate Programming forever.

I have two utterly divergent takes on this.

See https://github.com/slott56/PyLit-3 for one.

See https://github.com/slott56/py-web-tool for another.

And yet, I've still done a really bad design job. Before we get to the design, a little bit …

When writing about code in LaTeX, the essential strategy is to use an environment to format the code so it stands out from surrounding text. There are a few of these environments available as LaTeX add-on packages. The three popular ones are:

• verbatim. I think this is built-in to LaTeX …

The PyLit tool dates from 2009. Here's a historical reference: http://wiki.c2.com/?PyLit It was Python 2. It had some minor problems. I forked it and cleaned it up for Python 3. Then I set it aside for a few years (six or so.) Dusting it off. Rearranging …

Or "When is it time to move?"

I've got https://sourceforge.net/projects/stingrayreader/ which has been on SourceForge since forever.

Really since about 2014. Not that long. But. Maybe long enough?

The velocity of change is relatively slow.

However.

(And this is a big however.) SourceForge seems kind of …

The question is a deep one. What is the Literate Programming Life Cycle? Why is it so difficult? What are the three barriers and how do we cross them?

Here's most of the original question.

"Last week I threw together an F# script to parse markdown-style text into one or …