# Provides various anonymous type constructs

## Macros

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

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

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

let x = r#struct! {
    color: "Red".to_owned(),
    // move the `items` variable to the struct
    items
};

assert_eq!(x.color, "Red");
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!("Red".to_owned(), items);

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

* [`join!`] and [`join_cyclic!`]: join multiple futures. Require `future` feature.

```rust
use anony::join;

assert_eq!(join!(async { 2 }, async { "123" }).await, (2, "123"));
```

* [`try_join!`] and [`try_join_cyclic!`]: join multiple futures and short-circuit on "break" value. Require `future` feature.

```rust
use anony::try_join;

assert_eq!(try_join!(async { Some(2) }, async { Some("123") }).await, Some((2, "123")));
assert_eq!(try_join!(async { Some(2) }, async { None::<i32> }).await, None);
```

## Example Macro Expansions

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

## Features

* `serde`: derives [`Serialize`] for anonymous structs and tuples. [serde] crate must exist in your crate.
* `future`: enables [`Future`] anonymous types, such as [`join!`].

## Disclaimer

All macros in this crate are 100% hygienic.

[`struct!`]: https://docs.rs/anony/latest/anony/macro.struct.html
[`tuple!`]: https://docs.rs/anony/latest/anony/macro.tuple.html
[`join!`]: https://docs.rs/anony/latest/anony/macro.join.html
[`join_cyclic!`]: https://docs.rs/anony/latest/anony/macro.join_cyclic.html
[`try_join!`]: https://docs.rs/anony/latest/anony/macro.try_join.html
[`try_join_cyclic!`]: https://docs.rs/anony/latest/anony/macro.try_join_cyclic.html
[`Serialize`]: https://docs.rs/serde/latest/serde/ser/trait.Serialize.html
[`Future`]: https://doc.rust-lang.org/core/future/trait.Future.html
[serde]: https://docs.rs/serde/latest/serde/index.html