#426 Committing to Formatted Markdown

Python Bytes

Content provided by Michael Kennedy and Brian Okken. All podcast content including episodes, graphics, and podcast descriptions are uploaded and provided directly by Michael Kennedy and Brian Okken or their podcast platform partner. If you believe someone is using your copyrighted work without your permission, you can follow the process outlined here https://podcastplayer.com/legal.

1M ago 29:18

MP3•Episode home

Topics covered in this episode:

mdformat
pre-commit-uv
PEP 758 and 781
Serie: rich git commit graph in your terminal, like magic
Extras
Joke

Watch on YouTube
About the show

Sponsored by Posit Connect Cloud: pythonbytes.fm/connect-cloud

Connect with the hosts

Michael: @[email protected] / @mkennedy.codes (bsky)
Brian: @[email protected] / @brianokken.bsky.social
Show: @[email protected] / @pythonbytes.fm (bsky)

Join us on YouTube at pythonbytes.fm/live to be part of the audience. Usually Monday at 10am PT. Older video versions available there too.

Finally, if you want an artisanal, hand-crafted digest of every week of the show notes in email form? Add your name and email to our friends of the show list, we'll never share it.

Brian #1: mdformat

Suggested by Matthias Schöttle
Last episode Michael covered blacken-docs, and I mentioned it’d be nice to have an autoformatter for text markdown.
Matthias delivered with suggesting mdformat
“Mdformat is an opinionated Markdown formatter that can be used to enforce a consistent style in Markdown files.”
A python project that can be run on the command line.
Uses a style guide I mostly agree with.
- I’m not a huge fan of numbered list items all being “1.”, but that can be turned off with --number, so I’m happy.
- Converts underlined headings to #, ##, etc. headings.
- Lots of other sane conventions.
- The numbering thing is also sane, I just think it also makes the raw markdown hard to read.
Has a plugin system to format code blocks

Michael #2: pre-commit-uv

via Ben Falk
Use uv to create virtual environments and install packages for pre-commit.

Brian #3: PEP 758 and 781

PEP 758 – Allow except and except* expressions without parentheses
- accepted
PEP 781 – Make TYPE_CHECKING a built-in constant
- draft status
Also, PEP Index by Category kinda rocks

Michael #4: Serie: rich git commit graph in your terminal, like magic

While some users prefer to use Git via CLI, they often rely on a GUI or feature-rich TUI to view commit logs.
Others may find git log --graph sufficient.
Goals
- Provide a rich git log --graph experience in the terminal.
- Offer commit graph-centric browsing of Git repositories.

Extras

Michael:

Joke: Wishing for wishes

435 episodes

#Python #Prog Languages #Michael Kennedy #Brian Okken #Tech #News #Tech News #Open Source