#diagnostics #syn #wrapper #pretty #messages #error #miette

syn-miette

A syn::Error wrapper that provides pretty diagnostic messages using miette

3 releases (breaking)

0.3.0 Apr 8, 2024
0.2.0 Mar 17, 2024
0.1.0 Oct 4, 2023

#1 in #miette

Download history 1/week @ 2024-02-16 10/week @ 2024-02-23 8/week @ 2024-03-01 7/week @ 2024-03-08 126/week @ 2024-03-15 14/week @ 2024-03-22 34/week @ 2024-03-29 102/week @ 2024-04-05

277 downloads per month
Used in 2 crates

MIT/Apache

15KB
245 lines

A syn::Error wrapper that provides pretty diagnostic messages using miette.

Usage

let source = r"
pub struct {
    num_yaks: usize
}";

let error = syn::parse_str::<syn::DeriveInput>(source).unwrap_err();
let error = syn_miette::Error::new(error, source);

assert_eq!(
    error.render(), // only with `--feature render`
"  × expected identifier
   ╭─[2:12]
 1 │
 2 │ pub struct {
   ·            ┬
   ·            ╰── expected identifier
 3 │     num_yaks: usize
   ╰────
"
);

Notably, Error properly renders children that have been syn::Error::combine-ed:

  × duplicate definition of `Foo`
   ╭─[1:8]
 1 │ struct Foo;
   ·        ─┬─
   ·         ╰── initial definition here
 2 │ enum Bar {}
 3 │ union Foo {}
   ·       ─┬─
   ·        ╰── duplicate definition of `Foo`
   ╰────

Dependencies

~0.7–1.7MB
~37K SLoC