# zkat/miette

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

Repository: https://github.com/zkat/miette
Canonical: https://ross.abutalabs.com/products/miette
Homepage: https://docs.rs/miette
Language: Rust
License: Apache-2.0
License Family: permissive
Topics: error-handling, error-reporting, hacktoberfest, hacktoberfest2021, rust
Last push: 2026-06-25T18:33:54+00:00

## Health v2 (maintenance only)
Score: 63/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 89, release rhythm 8, longevity 100
- inputs: {"age_days": 1857, "days_push": 69, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2601, forks 165 (observed 2026-08-28T04:07:03.362539+00:00)

## What it is
miette is a Rust diagnostic library that extends std::error::Error with a Diagnostic protocol, derive macros, and pretty, detailed error report printing including source snippets, error codes, and help text. It offers fancy terminal output as well as screen-reader-friendly and customizable printers.

## Use cases
- print pretty error diagnostics in a rust cli
- add source code snippets to rust error messages
- define error types with error codes and help text
- replace anyhow with richer error reporting
- make cli errors accessible with screen-reader-friendly output
- attach labels and highlights to source spans in errors

## When to choose
- you want compiler-quality, fancy error output for your Rust application or CLI
- you need structured diagnostics with codes, URLs, snippets, and related errors
- you want an ergonomic derive macro and anyhow/eyre-style error handling

## When to avoid
- you need minimal dependencies in a small library (the fancy feature pulls in many deps)
- you only need simple error messages without source snippets or styling
- you are not writing Rust

## Facets
- artifact type: library
- maturity: stable
- function: error-handling, logging, developer-tools
- domain: developer-tools, programming-languages
- platform: rust, cross-platform, cli
- tags: diagnostics, error-reporting, derive-macro, source-snippets, terminal-output, command-line

## Member repositories
- zkat/miette (main) score 63

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:03.362539+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:21:16.586876+00:00, confidence not recorded.
  - readme: https://github.com/zkat/miette (fetched 2026-08-28T04:07:03.362539+00:00, sha a7d1f9dc836c)
  - homepage: https://docs.rs/miette (fetched 2026-08-29T10:04:17.832204+00:00, sha e087b1c4269b)
  - site_page: https://docs.rs/ (fetched 2026-08-29T10:04:17.835335+00:00, sha 0aa25b04e401)
  - site_page: https://docs.rs/crate/miette/latest (fetched 2026-08-29T10:04:17.837355+00:00, sha 3bdfe0a3f115)
  - site_page: https://docs.rs/crate/miette/latest/features (fetched 2026-08-29T10:04:17.840291+00:00, sha bc7da8dfb7a9)
  - site_page: https://docs.rs/about (fetched 2026-08-29T10:04:17.842167+00:00, sha 29ab7986fbf5)
  - site_page: https://docs.rs/about/badges (fetched 2026-08-29T10:04:17.843717+00:00, sha 6588cac258af)
  - site_page: https://docs.rs/about/builds (fetched 2026-08-29T10:04:17.845327+00:00, sha 811231ca4680)
  - site_page: https://docs.rs/about/metadata (fetched 2026-08-29T10:04:17.847010+00:00, sha 0dcdccb2b2b2)
  - site_page: https://docs.rs/about/redirections (fetched 2026-08-29T10:04:17.848530+00:00, sha 1b1efd93105f)
- Data as of 2026-08-30T08:39:29.467469+00:00.