variter 0.2.0

Declarative macro-derivable trait for iterating over field-less enum type variants
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
63
64
65
66
67
68
69
70
71
72
73

# VarIter

![Crates.io](https://img.shields.io/crates/v/variter)
[![unsafe forbidden](https://img.shields.io/badge/unsafe-forbidden-success.svg)](https://github.com/rust-secure-code/safety-dance/)

`variter` is a Rust crate that exports some simple tools for iterating
over `enum` types with zero or more variants that have no fields.

```rust
use variter::{VarIter, derive_var_iter};
derive_var_iter! {
    #[derive(Debug)]
    enum Greeting {
        Hello,
        Hola,
        Bonjour,
    }
}

fn main() {
    for greeting in Greeting::ALL_VARIANTS {
        println!("{:?}", greeting);
    }
}
```

If you're familiar with the Swift language, it's similar to using the
compiler-synthesized `CaseIterable` protocol conformance.

See the [module documentation](src/lib.rs) for more information!

## Usage

Add `variter` as a dependency in your `Cargo.toml` file:

```toml
[dependencies]
# ...
variter = "0.2"
```

## Features

- `foreign_impls` (default): include implementions of `VarIter` on stable `core` types.
- `std` (default): if `foreign_impls` is turned on, `VarIter` implementations are included for stable `std` types.

## `no_std` Support

Given the simplicity of the crate, `no_std` support can be toggled through the
`default-features = false` flag in your `Cargo.toml` dependency table.

```toml
[dependencies]
# ...
variter = { version = "0.2", default-features = false }
```

## License

Licensed under either of

- Apache License, Version 2.0
  ([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>)
- MIT license
  ([LICENSE-MIT](LICENSE-MIT) or <http://opensource.org/licenses/MIT>)

at your option.

## Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.