Topics covered in this episode:

Architecture Decision Records (ADRs)
narwhals: extremely lightweight compatibility layer between dataframes
Microsoft wants Three Mile Island to fuel its AI power needs
zsh-in-docker
Extras
Joke

Watch on YouTube

About the show

Sponsored by ScoutAPM: pythonbytes.fm/scout

Connect with the hosts

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: Architecture Decision Records (ADRs)

Suggested by Christian Gesell
Documenting Architecture Decisions
- Mychael Nygard
- Original article from 2011
Why you should be using architecture decision records to document your project
- Red Hat
- Includes a quick overview and links to some templates
Notes so far
- Writing this out helps me solidify my thinking about a problem.
- I’m doing this both before starting, and while implementing a first draft
- GitHub and GitLab render markdown so well that generating a docs site is unnecessary, just throwing these files in something like docs/adr is enough.
- The lightweight process is enough but not too much.
- I’ve already filled out None for lots of sections, like “options considered”
- I’m still playing with what level of decision should have an ADR.
My template that I’ve been using so far
- Saved in 000-adr-template.md
- For easy copy/paste/modify for new records.
File name is something like 001-some-change.md

Michael #2: narwhals: extremely lightweight compatibility layer between dataframes

Recently had Marco on Talk Python to discuss
Primarily for library creators who want to support interacting with multiple data frame libraries (.e.g. Pandas & Polars)
Just use a subset of the Polars API

Brian #3: Microsoft wants Three Mile Island to fuel its AI power needs

Michael #4: zsh-in-docker

Install Zsh, Oh My Zsh and plugins inside a Docker container with one line!
Yes docker containers should be light, but also, think of how painful it can be when you run into trouble.
With Oh My ZSH, you get a nice experience when you have to result to docker exec -it CONTAINER zsh

Just enter a single command in your docker file:

RUN sh -c "$(wget -O- https://github.com/deluan/zsh-in-docker/releases/download/v1.2.0/zsh-in-docker.sh)" -- \
  -t robbyrussell

Extras

Michael:

self-hosting mkennedy.codes
Loren's journey to developer
It’s time to stop using Python 3.8
Sonoma → Sequoia → Sonoma (yikes!)
Passkeys, maybe they will work out if we don’t let them become lock-in (bitwarden’s support)

Joke:

How to Monetize a Blog
- Don’t forget to click on the bottom link: Credits / how this was made

#402 How to monetize your blog

Python Bytes