~/talk

Building human-first and machine-friendly CLI applications

Talkat PyCon US 2023 · 2023-04-19..04-27· [developer-experience]
links:none on file
slides:none on file

Builds a CLI catalogue of PyCon talks using clig.dev guidelines and scaffolds the project with Cookiecutter plus poetry, implements commands with typer and Rich. Project uses SQLite with a configurable dev DB env var, generates about 20 starter tests, supports interactive prompts vs noninteractive CI use, offers shell completion (occasionally flaky), prints rich tables plus plain and JSON, keeps headers on stderr so pipelines can wc -l, enforces zero/nonzero exit codes, and adds YouTube links; most features work with minor install hiccups.

AI-written summary · about

  1. 0:00CLI design introduction
  2. 10:00Generating projects with Cookie Cutter
  3. 29:31Exploring generated CLI
  4. 50:17CLI Guidelines overview
  5. 1:00:13Human vs machine-friendly CLI
  6. 1:18:28Error handling in CLI tools
  7. 1:38:05Testing CLI applications
  8. 1:58:15Output formatting with Rich
  9. 2:08:11Interactive CLI features
  10. 2:15:20CLI design best practices
~/search
type to search 6,249 conferences, 138,987 speakers and 185,172 talks
~/help
cmdctrl k
search every conference, speaker and series
/
focus the filter search
h
home
c
conferences
s
speakers
e
series
t
light / dark — the status bar button does the same
?
this help
esc
close this, then clear every filter — or just the search, while you are typing in it

Ignored while you are typing. Pages without a filter rail have no search to focus.