Python Bytes is a weekly podcast hosted by Michael Kennedy and Brian Okken. The show is a short discussion on the headlines and noteworthy news in the Python, developer, and data science space.
#426 Committing to Formatted Markdown
- mdformat
- pre-commit-uv
- PEP 758 and 781
- Serie: rich git commit graph in your terminal, like magic
- Extras
- Joke
About the show
Sponsored by Posit Connect Cloud: pythonbytes.fm/connect-cloud
Connect with the hosts
- Michael: @mkennedy@fosstodon.org / @mkennedy.codes (bsky)
- Brian: @brianokken@fosstodon.org / @brianokken.bsky.social
- Show: @pythonbytes@fosstodon.org / @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