https://github.com/arctic-hen7/fmterr

Sane, all-in-one error management and reporting.
https://github.com/arctic-hen7/fmterr

error-reporting rust

Last synced: 24 days ago
JSON representation

Sane, all-in-one error management and reporting.

• Host: GitHub
• URL: https://github.com/arctic-hen7/fmterr
• Owner: arctic-hen7
• License: mit
• Created: 2021-09-28T03:41:54.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2021-09-28T04:48:49.000Z (about 3 years ago)
• Last Synced: 2024-08-10T23:43:29.936Z (3 months ago)
• Topics: error-reporting, rust
• Language: Rust
• Homepage:
• Size: 16.6 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# `fmterr`

[![API Docs](https://img.shields.io/docsrs/fmterr?label=API%20Docs&style=for-the-badge)](https://docs.rs/fmterr)

[![Crate Page](https://img.shields.io/crates/v/fmterr?style=for-the-badge)](https://crates.io/crates/fmterr)

[![Top Language](https://img.shields.io/github/languages/top/arctic-hen7/fmterr?style=for-the-badge)]()

`fmterr` (pronounced _fumpterr_ obviously!) is a tiny error reporting tool for Rust! If you have an error with a chain of sources and you want to display it to the user without bringing in something like [`anyhow`](https://github.com/dtolnay/anyhow), `fmterr` is for you! Just run `fmt_err(&err)` and you'll get a string error message that displays the source chain nicely for end users.

## Usage

You can use `fmterr` to format any error that implements `std::error::Error` (basically any error worth its salt) like so:

```rust

use fmterr::fmt_err;

// Imagine this is a super-complex error with a nested source

let err = std::io::Error::from(std::io::ErrorKind::NotFound);

let err_str = fmt_err(&err);

println!("{}", err_str);

```

That'll produce the following if you use a complex error:

```

Error: first error message

Caused by:

    second error message

    Caused by:

        third error message

```

Or just this if you use something without a source (with an `io::ErrorKind::NotFound`):

```

Error: entity not found

```

## `fmterr` vs `anyhow`

Most library applications will use [`thiserror`](https://github.com/dtolnay/thiserror) or the like to create their errors, and then they'll sometimes need a formatting tool. If you use [`anyhow`](https://github.com/dtolnay/anyhow) as a formatting tool, you're basically using a sledgehammer to fix a dent, you just don't need it all! That said, [`anyhow`](https://github.com/dtolnay/anyhow) is fantastic for applications where the rest of its features are needed.

## Contributing

We appreciate all kinds of contributions, check out our [contributing guidelines](./CONTRIBUTING.md) for more information! Also, please be sure to follow our [code of conduct](./CODE_OF_CONDUCT.md).

## License

See [`LICENSE`](./LICENSE).