Announcing the Textual Cookbook

[edward-jazzhands]

I've just released the very first starting version of a new repository called The Textual Cookbook.

The idea is I'm trying to amalgamate all the many example apps that have been made over the past couple years by many great Textual creators into one repository, and then make it easy to run and try them all out. So in order to achieve this goal, I've built a system that:

1. Gathers many Textual examples and organizes them into categories/folders
2. Dynamically loads all examples into Pytest and creates a different test for each one
3. Runs this Pytest suite against numerous versions of Textual using Nox
4. Creates reports to tell us which examples work on which versions of Textual
5. Makes these examples available to see online
6. Provides a "Recipe runner" app that comes with the repo when you clone it.

There's a Github actions workflow that runs the Nox environment testing in CI on PRs and then saves the new reports on pushes to main. I'm hoping this will make it really convenient for anyone to PR examples. You only have to PR a single working example app in one file, and the CI workflow will handle the entire process of testing it and figuring out how far back it can go for compatibility with older Textuals.

I also made a fancy index page for the reports. Because why not? You can view it here:

https://ttygroup.github.io/textual-cookbook/reports/

Here's a demo video of what I have so far. Almost all the examples are by me at the moment since I haven't started adding other people's yet (And I'd prefer to have them PR'ed of course). But you can see what I'm going for so far.

EDIT: This is now also on PyPI:

uvx textual-cookbook

Repo

https://github.com/ttygroup/textual-cookbook

Video

textual-cookbook-prerelease.mp4