Skip to content

Run the README, as printed - #12

Merged
tamnd merged 1 commit into
mainfrom
readme-runs
Aug 19, 2026
Merged

tamnd merged 1 commit into
mainfrom
readme-runs

Conversation

@tamnd

@tamnd tamnd commented Aug 19, 2026

Copy link
Copy Markdown
Owner

The block at the top of the page is the most read and least executed code this package has. It is copied by hand, and it goes wrong quietly: a renamed option, a return type that used to be an array, a statement the grammar stopped taking. By the time anybody notices, it has already cost somebody their first five minutes.

So it runs now, character for character, in a directory of its own with this package linked into node_modules the way npm links it. The import is the one a reader types and the database lands where a reader would find it. Node erases the types on the way in, which is why the block can stay TypeScript, which is what a reader of a typed client copies.

A block is a whole program when its first line imports this package and nothing in it calls require. The page has one of those and six fragments, and the count is asserted, so a block that changes which kind it is fails here rather than falling out of the check.

Bun and Deno skip the two tests that spawn a runtime and run the one that reads the page. The link is a junction rather than a symbolic link, which is what npm makes on Windows, because a symbolic link to a directory needs a privilege there that a test runner does not have.

This is the quickstart line of the practice scorecard, which zu-python already holds.

The block at the top of the page is the most read and least
executed code this package has. It is copied by hand, and it goes
wrong quietly: a renamed option, a return type that used to be an
array, a statement the grammar stopped taking. By the time anybody
notices, it has already cost somebody their first five minutes.

So it runs now, character for character, in a directory of its own
with this package linked into node_modules the way npm links it.
The import is the one a reader types and the database lands where
a reader would find it. Node erases the types on the way in, which
is why the block can stay TypeScript, which is what a reader of a
typed client copies.

A block is a whole program when its first line imports this package
and nothing in it calls require. The page has one of those and six
fragments, and the count is asserted, so a block that changes which
kind it is fails here rather than falling out of the check.

Bun and Deno skip the two tests that spawn a runtime, and run the
one that reads the page. What is being asked about is the
characters on the page, and one runtime answers it.
@tamnd
tamnd merged commit aa62dc7 into main Aug 19, 2026
24 of 26 checks passed
@tamnd
tamnd deleted the readme-runs branch August 19, 2026 04:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant