# zesterer/ariadne

[Ariadne has moved to Codeberg!] A fancy diagnostics & error reporting crate

Repository: https://github.com/zesterer/ariadne
Canonical: https://ross.abutalabs.com/products/zesterer-ariadne
Homepage: https://codeberg.org/zesterer/ariadne
Language: Rust
License: MIT
License Family: permissive
Topics: rust, diagnostics, compiler, parser, error-reporting, error-messages, error
Archived: true
Last push: 2026-03-23T06:54:13+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 73, release rhythm 35, longevity 100
- inputs: {"age_days": 1877, "days_push": 163, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2157, forks 101 (observed 2026-08-28T04:06:19.756056+00:00)

## What it is
Ariadne is a Rust crate for producing fancy, colored compiler diagnostics and error reports with inline and multi-line labels, multi-file errors, and customizable output. It is a sister project of the Chumsky parser library and is now hosted on Codeberg.

## Use cases
- report compiler errors with pretty source snippets
- show multi-line error spans in a Rust compiler
- print colored diagnostics to stderr for a parser
- generate multi-file error reports for an interpreter
- add nice error messages to a DSL toolchain
- write linter output with labeled source highlights

## When to choose
- you are building a compiler, interpreter, parser, or linter in Rust and want high-quality error output
- you need multi-line and multi-file diagnostic labels with color support
- you want a generic diagnostics crate that works with custom span and cache types

## When to avoid
- your project is not written in Rust
- you only need simple logging rather than source-annotated diagnostics
- you need diagnostics for a language with an existing mature tooling ecosystem

## Facets
- artifact type: library
- maturity: active
- function: error-handling, developer-tools
- domain: developer-tools, compilers, parsers
- platform: rust, cross-platform
- tags: diagnostics, error-reporting, compiler-diagnostics, pretty-errors, cli-output

## Member repositories
- zesterer/ariadne (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:19.756056+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:50:26.624189+00:00, confidence not recorded.
  - readme: https://github.com/zesterer/ariadne (fetched 2026-08-28T04:06:19.756056+00:00, sha 094f2c57e539)
  - homepage: https://codeberg.org/zesterer/ariadne (fetched 2026-08-29T10:30:39.279411+00:00, sha 1cdc9c5f0a16)
  - site_page: https://docs.codeberg.org/getting-started/what-is-codeberg (fetched 2026-08-29T10:30:39.288919+00:00, sha fe3047f34c81)
  - site_page: https://docs.codeberg.org/getting-started/faq (fetched 2026-08-29T10:30:39.290979+00:00, sha 7ffd1ab1d66b)
  - site_page: https://docs.codeberg.org (fetched 2026-08-29T10:30:39.298727+00:00, sha 3c642f9d47c9)
  - registry_crates: https://crates.io/api/v1/crates/ariadne (fetched 2026-08-29T10:30:39.300249+00:00, sha 835d41e66aa8)
  - site_page: https://codeberg.org/zesterer/ariadne/src/branch/main/CHANGELOG.md (fetched 2026-08-29T10:30:39.295718+00:00, sha b1e458d5b059)
  - site_page: https://codeberg.org/zesterer/ariadne/commit/afeff531d1571316cbe23cf41cc23be0a117be8e (fetched 2026-08-29T10:30:39.297133+00:00, sha b1e458d5b059)
  - site_page: https://codeberg.org/zesterer/ariadne/releases (fetched 2026-08-29T10:30:39.292906+00:00, sha f3c38cd5aa27)
  - site_page: https://codeberg.org/zesterer/ariadne/commit/c007e639a2e43fb3c2790dc6135b9e0b2d60a114 (fetched 2026-08-29T10:30:39.294327+00:00, sha b1e458d5b059)
- Data as of 2026-08-30T08:39:29.467469+00:00.
