error-kind 0.0.2

Separate `Error` from `ErrorKind` with convenient derive macros!
Documentation
Attach context automatically at the end of a failing function.

A common operation in error handling is to want to attach some common context when returning from a failing function. Often, this is handled by attaching the context at the call-site.

However, in some cases, we always want to attach the same kind of context regardless of the call-site. For example, when we're and reading a file, we may wish to attach the filename.

# Examples

```rust
# use std::path::Path;
# #[derive(Clone, Copy, Debug, error_kind::ErrorKind)]
# enum MyErrorKind { Variant }
# #[derive(Clone, Copy, Debug, error_kind::Error)]
# struct MyError(MyErrorKind);
use error_kind::{error, ResultExt};

#[error("while attempting to read '{file:?}'")]
fn read_file(file: &Path) -> Result<String, MyError> {
    // Capture the filesystem error as context as well.
    Result::capture(MyErrorKind::Variant, std::fs::read_to_string(file))
}
```

The above is equivalent to this:

```rust
# use std::path::Path;
# #[derive(Clone, Copy, Debug, error_kind::ErrorKind)]
# enum MyErrorKind { Variant }
# #[derive(Clone, Copy, Debug, error_kind::Error)]
# struct MyError(MyErrorKind);
use error_kind::{error, ResultExt};

fn read_file(file: &Path) -> Result<String, MyError> {
    let body = || {
        Result::capture(MyErrorKind::Variant, std::fs::read_to_string(file))
    };
    let result: Result<String, MyError> = body();
    result.with_context(|| format!("while attempting to read '{file:?}'"))
}
```