HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
codyd51
penpal
Python2023–2023
codyd51 / penpal

penpal

Literate programming preprocessor

2Distinct people
2Mentions
0Explicit recommenders
6GitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

Literate programming preprocessor

GitHub

Where it is used

No documented product use has been verified yet.

What people are saying

No recommendation phrase was found in the indexed comments.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

No other repository is repeatedly linked in the same discussions.

This week on Hacker News

Nov 7–Nov 14 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/14/2026, 3:56:07 PM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by hour2 dated mentions

Observed mentions: 2023-07-04 17:56:29 UTC to 2023-07-04 21:52:14 UTC.

012023-07-04 17:00:00 UTC to 2023-07-04 18:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 commentsJul 4, 17:002023-07-04 18:00:00 UTC to 2023-07-04 19:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 comments2023-07-04 19:00:00 UTC to 2023-07-04 20:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 commentsJul 4, 19:002023-07-04 20:00:00 UTC to 2023-07-04 21:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 comments2023-07-04 21:00:00 UTC to 2023-07-04 22:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 commentsJul 4, 21:00

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
Jul 4, 17:002023-07-04 17:00:00 UTC2023-07-04 18:00:00 UTC101
Jul 4, 18:002023-07-04 18:00:00 UTC2023-07-04 19:00:00 UTC000
Jul 4, 19:002023-07-04 19:00:00 UTC2023-07-04 20:00:00 UTC000
Jul 4, 20:002023-07-04 20:00:00 UTC2023-07-04 21:00:00 UTC000
Jul 4, 21:002023-07-04 21:00:00 UTC2023-07-04 22:00:00 UTC101

What Hacker News says

2 sources
You're right, thank you for the thoughtful feedback. It's true that the blog post skims over the meaning of `generate` when introducing it, and that I'm doing a bit of extra work under the covers in this post. I thought keeping things light and interactive would help easing into the details, but it's true that the reader has to wait quite a long time to see what the preprocessor is doing exactly, and it's not clear until the end what exactly is going on. I'll add something in to signpost this a bit better. To answer your questions, the post is trailing the repo. I've uploaded the full source comprising this post here: https://github.com/codyd51/penpal-blog-post-preprocessed. The code blocks link back to the Github source via a custom Hugo shortcode, and I currently need to maintain this by hand. While wrapping up this blog post, I added s
Read the rest
upport for generating this shortcode via an extension to the `show` command. Here's what the penpal command to render a hotlinked code block looks like, in the source code of this blog post: https://github.com/codyd51/penpal-blog-post-preprocessed/blo... Here's what the shortcode generation for this looks like in penpal: https://github.com/codyd51/penpal/blob/release/penpal/render... I think it'd be really nice to maintain all of this automagically - it seems reasonable that the technical content being built up would frequently be hosted in a finished state somewhere!
In Writing about writing about programming
A few questions/notes from reading the post and looking at the repo: 1. Is the post trailing the repo, or vice-versa? This line in the README describes a different command format and seems to suggest that {{}} caused trouble? https://github.com/codyd51/penpal/blob/4ff061b045aa447ac8976... 2. Some of the code blocks, like the first `src/main.rs` block, link to divergent GH source. Is that coming from penpal in some way, or are you grafting that back on after somehow? (And if it's built in, is there a way to avoid/manage this divergence?) 3. The post and repo contradict on what `generate` does, and the post lets us dangle for a really long time before resolving it. The post says: "Let’s generate an executable representing our (tiny!) source tree so far." (and then shows a single-line code block with `{{generate}}`) The repo says: "When the
Read the rest
`generate` command is used, the current state of every snippet is rendered into a source code tree." The last section of the article finally clarifies, but it'd be kind to be clear that generate creates only the source tree and note that you're grafting on a compile step separately that's outside of penpal's scope.
In Writing about writing about programming

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.