Deprecate in favor of annotate-snippets-rs?

[kevinmehall]

I noticed that rustc is breaking out its error formatting into a reusable library called annotate-snippets-rs.

The API seems slightly lower level (e.g. explicitly choosing what portion of the source to display), but the code is much more readable.

I'm not sure it makes sense to continue maintaining a fork of rustc's old error formatting code if they're replacing it with an external library.

[Lymia]

It looks like this library is enough to cover the same use cases as codemap-diagnostic, yeah. A convenience layer over it and codemap might still be useful, but #7 is probably unnecessary then. (Since it isn't too big of a deal to implement your own at that point.)

[kevinmehall]

2023 update:

• Annotate-snippets-rs is included in rustc behind a non-default flag, but there doesn't seem to be much movement towards it replacing rustc's emitter.rs as the default.
• I've switched my signalspec project to use codespan-reporting so I'm no longer using this crate myself
  • codespan-reporting itself seems slightly under-maintained, but is much simpler, more readable code, has tests, and more widely used than codemap-diagnostic. So if I'm going to maintain something it's probably better for me to help out there.
• A few new contenders have appeared for diagnostic reporting that look good
  • https://github.com/zesterer/ariadne
  • https://github.com/zkat/miette

So I'm inclined to recommend any of those instead. I'm releasing v0.1.2 with a few accumulated fixes and a deprecation message.