tq - Rust Grimoire companion code

This repository contains the working code for every chapter of Rust Grimoire - a hands-on guide to Rust built around a single artifact, tq, that grows from an empty project into a CLI tool with a REST API, persistence, logging, and integration tests.

Each folder corresponds to one chapter. The code inside is the complete, compilable state of tq at the end of that chapter - not a snippet, the whole thing.

Structure

tq/
  0-the-workshop/
    02-the-first-incantation/   ← chapter 0.2
    ...
  1-a-task/
    01-giving-shape-to-nothing/ ← chapter 1.1
    ...
  9-shippable/
    03-forged/                  ← chapter 9.3, final state

Milestones 0-4 are single-crate packages. Starting from milestone 5, each folder is a Cargo workspace with multiple crates (tq-core, tq-cli, tq-api, tq-tests).

Usage

Any chapter folder builds independently:

cd 9-shippable/03-forged
cargo build

To run the full CI check (build + tests + clippy) for a chapter that has a Makefile:

make ci

The book

The chapters that explain what this code does and why are at thegrimoire.dev.