finds.dev

zkat/miette

Fancy extension for std::Error with pretty, detailed diagnostic printing.

View on GitHubHomepage ↗

★ 2,618RustApache-2.0updated Jun 2026

// the take

miette is a diagnostic/error-reporting library for Rust that sits on top of std::error::Error (and pairs naturally with thiserror) to produce rustc-style pretty-printed errors with source snippets, labeled spans, help text, and clickable error codes. It's aimed at Rust application authors who want anyhow/eyre-level ergonomics but with much richer, compiler-quality diagnostic output, and at library authors who want to expose structured diagnostics without forcing fancy rendering on consumers.

The Diagnostic derive macro is genuinely well designed — #[label], #[related], #[diagnostic_source], and primary/collection labels cover real-world cases (multiple errors, nested diagnostics, dynamic span counts) that most error crates don't bother with. The fancy/non-fancy split is a good architectural call: libraries depend on the lightweight core trait, only the top-level binary opts into the heavy graphical renderer, so you don't drag ANSI/terminal-detection deps into a library crate. Accessibility is a first-class feature, not an afterthought — the narratable printer kicks in automatically under NO_COLOR/CI and gives screen-reader-friendly output instead of just stripping colors. Optional syntect-based syntax highlighting for source snippets is a nice touch that most competitors (anyhow, eyre) don't attempt at all.

It's a one-person project (zkat) in practice — bus-factor risk for something you'd end up threading through every error type in an application. The graphical/fancy renderer's output format isn't really meant to be stable across versions, so if you're snapshot-testing CLI output or scraping it, upgrades can quietly break things. MSRV is 1.82, which is fairly recent and can be a blocker if you're stuck on an older toolchain in a corporate environment. It solves error *reporting*, not error *handling* — you still need thiserror or manual impls for your actual error types, and for libraries you have to be deliberate about not leaking the fancy feature's dependency weight into consumers who don't want it.

We read the README, the directory tree and a key source file in October 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
2,618
Forks
166
Language
Rust
License
Apache-2.0
Last commit
25 Jun 2026

// nearby

If miette isn't quite it.

All repos →