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 …
more ...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:
Here's the code.
def get_categories(file):
"""
Get categories.
"""
verify_file(file)
categories = set()
with open(file, "r") as cat_file:
while line := cat_file.readline().rstrip():
categories.add(line)
return categories
To me this was terrible. truly and deeply horrifying. Let me count the ways.
It may help to read Python is a Bad Programming Language, but it's not very useful.
I shouldn't be tempted by click-bait headlines. But. I am drawn in by bad articles on Python.
In particular, any post claiming Python is deficient causes me to look for the concrete PEP's that …
more ...In Static Site Blues I was wringing my hands over ways to convert a ton of content from a two different proprietary tools (the very old iWeb, and the merely old Sandvox) into something I could work with.
After a bit of fiddling around, I'm delighted with Pelican.
First, of …
more ...I have a very large, static site with 10+ years of stuff about my boat. Most of it is pretty boring. http://www.itmaybeahack.com/TeamRedCruising/
I started with iWeb. It was very -- well -- 2000-ish look and feel. Too many pastels and lines and borders.
In 2012, I switched to …
more ...I've been an on-and-off user of LaTeX since the very, very beginning. Back in the dark days when the one laser printer that could render the images was in a closely-guarded secret location to prevent everyone from using it and exhausting the (expensive) toner cartridges.
A consequence of this is …
more ...I was asked to review code that -- well -- was evil.
Not like "shabby" or "non-pythonic". Nothing so simple as that.
We'll get to the evil in a moment. First, we have to suffer two horrible indignities.
We'll beat all three issues to death separately, starting with …
more ...Looking at code. Came to a 20-line block of code that did exactly this.
sorted(Path.cwd().glob("some_pattern[1-9]*.*"), reverse=True)
Twenty lines. Seriously.
To be fair, 8 of the 20 lines were comments. 3 were blank. Which leaves 9 lines of code to perform the task of a …
more ...