anony 0.6.2

Anonymous struct
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

# anony

Provides various constructs for anonymous types.

## Macros

* [`struct!`]: Creates an instance of an anonymous struct.

```rust
use anony::r#struct;

let items = vec![1, 3, 5];

let x = r#struct! {
    name: "anony".to_owned(),
    // Move the `items` variable into the struct
    items,
};

assert_eq!(x.name, "anony");
assert_eq!(x.items, [1, 3, 5]);
```

* [`tuple!`]: Creates an instance of an anonymous tuple.

```rust
use anony::tuple;

let items = vec![1, 3, 5];

let x = tuple!("anony".to_owned(), items);

assert_eq!(x.0, "anony");
assert_eq!(x.1, [1, 3, 5]);
```

* [`combine_futures!`] and [`combine_futures_cyclic!`]:
  General-purpose future concurrency combinators. Requires the `future` feature.

```rust
let mut s = String::new();

let fut = combine_futures! {
    let ten = async { 10 } => continue {
        s.write_fmt(format_args!("{ten}"));
        ten
    }
    let zero = async { "0" } => continue s.push_str(zero),
};

assert_eq!(fut.await, (10, ()));
assert_eq!(s, "100");
```

```rust
let mut x = 2;

let fut = combine_futures_cyclic! {
    move
    match async { Some(1) } {
        Some(x) if x % 2 == 0 => continue,
        _ => break {
            x += 1;
            x
        }
    }
    continue async {},
    |_, _| -1
};

assert_eq!(fut.await, 3);
assert_eq!(x, 2);
```

## Example Macro Expansions

<https://github.com/discreaminant2809/anony/tree/master/examples/expansions>

## Features

* `serde`: Derives [`Serialize`] for anonymous structs and tuples.
  The [serde] crate must be included in your dependencies.
* `future`: Enables [`Future`] anonymous types, such as [`combine_futures!`].

## Nightly

Add this to your dependencies:

```toml
anony = { git = "https://github.com/discreaminant2809/anony.git", branch = "nightly" }
```

[`Future`]: https://doc.rust-lang.org/core/future/trait.Future.html
[`Serialize`]: https://docs.rs/serde/latest/serde/ser/trait.Serialize.html
[serde]: https://docs.rs/serde/latest/serde/index.html

[`struct!`]: https://docs.rs/anony/latest/anony/macro.struct.html
[`tuple!`]: https://docs.rs/anony/latest/anony/macro.tuple.html
[`combine_futures!`]: https://docs.rs/anony/latest/anony/macro.combine_futures.html
[`combine_futures_cyclic!`]: https://docs.rs/anony/latest/anony/macro.combine_futures_cyclic.html