http-derive-impl 0.1.2

Derive macro for implementing `Into<http::StatusCode>` for your enums using the standard http types.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

# 🦀 http-derive

Derive macro for implementing `Into<http::StatusCode>` for your enums using the standard http types.

## Why?

* It uses the commonly-used `http::StatusCode`.
* Selects `http` 0.2 and/or 1.0 using feature flags.
* Works well with other libraries like `thiserror`.
* Easier to define as part of an error `enum` instead of manually `impl From<X> for http::StatusCode`.

## Inspiration

* [as_status_code](https://crates.io/crates/as_http_status_code)
* [actix-web-error](https://crates.io/crates/actix-web-error)

## Features

**By default this crate enables no features**. This is to allow selecting which `http` crate/s are selected.

If your crate has to enable `http` support conditionally you can leave the `[#derive(HttpStatus)]` in place and turn on one or more of the features below depending on your crate's feature flags.

* `http-1` enables `http = "1"`
* `http-02` enables `http = "0.2"`

For example, in `Cargo.toml` add:

```toml
http-derive = { version = "0.1.0", features = ["http-1"] }
```

## Examples

```rust
use http_derive::HttpStatus;

#[derive(Debug, HttpStatus, thiserror::Error)]
pub enum MyError {
    #[error("This is not supported")]
    #[http(status = "BAD_REQUEST")]
    Unsupported,

    #[error("Try again")]
    #[http(status = "SERVICE_UNAVAILABLE")]
    TryAgain,

    #[error(transparent)]
    #[http(transparent)]
    Sub(MySubError),
}

#[derive(Debug, HttpStatus, thiserror::Error)]
pub enum MySubError {
    #[error("Unauthorized")]
    #[http(status = "UNAUTHORIZED")]
    Unauthorized,

    #[error("Unauthorized")]
    #[http(status = "UNAUTHORIZED")]
    EvenMoreUnauthorized,
}
```