Content-driven handbook for Python CLI teams

Python CLI Toolcraft

A practical handbook for building, testing, packaging, and shipping production-ready Python command-line applications.

toolcraft --ship

$ uv init cli-tool
# create a reliable package layout
$ typer run app.py -- --help
# validate commands before release
$ python -m pytest
# ship predictable terminal software

Browse the knowledge base

Three core tracks for modern Python CLI work

Each track maps directly to a top-level directory under `content/`.

Topic track

Project Setup & Dependency Management

Build a dependable foundation with packaging, dependency resolution, versioning, virtual environments, and release workflows for Python CLI projects.

pyproject.tomluv and PoetryPre-commit and release hygiene

Explore project setup

Topic track

Modern Python CLI Frameworks & Architecture

Choose frameworks, structure command trees, and design extensible, testable command-line systems that can scale with your product or team.

Typer vs ClickMulti-command structurePlugin systems and performance

Explore architecture

Topic track

Advanced Input Parsing & User Experience

Improve validation, config loading, terminal rendering, and interactive workflows so Python CLIs stay predictable for both humans and automation.

Argument validationConfig precedenceRich-based terminal UX

Explore input and UX

Why this site shape works

Optimized for long-form technical reference

Content-first routing

URLs come straight from the markdown tree, so section landing pages and deep articles stay predictable as the library grows.

Built-in accessibility

Semantic sections, skip navigation, route announcements, and clear contrast pair well with the installed accessibility module.

Static deployment ready

The site can be generated to `.output/public`, making it a good fit for docs hosting and lightweight content delivery.