either_trait_macro 0.1.1

An attribute-like macro to implement traits for Either.
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

# either_trait_macro

An attribute-like macro to implement traits for `Either` (defined in [`either`](https://crates.io/crates/either) crate). If your trait is implemented for both type `A` and `B`, then it is automatically implemented for `Either<A, B>`.

## Usage

When defining a trait, add the attribute `#[either_trait]`.

## Example

```rust
use either::Either;
use either_trait_macro::either_trait;

#[either_trait]
/// Apply a function `n` times.
trait Apply {
    fn times<T, F>(&self, t: T, f: F) -> T
    where
        F: Fn(T) -> T;
}

struct Once;

impl Apply for Once {
    fn times<T, F>(&self, t: T, f: F) -> T
    where
        F: Fn(T) -> T,
    {
        f(t)
    }
}

impl Apply for u32 {
    fn times<T, F>(&self, t: T, f: F) -> T
    where
        F: Fn(T) -> T,
    {
        let mut t = t;
        for _ in 0..*self {
            t = f(t);
        }
        t
    }
}

let either: Either<Once, u32> = Either::Left(Once);
assert_eq!(either.times(1, |x| x + 2), 3);
```

## Limitations

This macro only supports traits without any associated constant or associated type. The first parameter of a trait method must be `self`, `&self` or `&mut self`. The types of other parameters and the return type must not contain `Self`.