#futures #async #future #derive #enum

macro futures-enum

#[derive(Future, Stream, Sink, AsyncRead, AsyncWrite, AsyncSeek, AsyncBufRead)] for enums

13 releases

✓ Uses Rust 2018 edition

0.1.12 Nov 6, 2019
0.1.10 Aug 14, 2019
0.1.9 Jul 4, 2019
0.1.5 Mar 4, 2019

#128 in Asynchronous

Download history 2/week @ 2019-10-08 12/week @ 2019-10-15 133/week @ 2019-10-22 15/week @ 2019-10-29 30/week @ 2019-11-05 16/week @ 2019-11-12 17/week @ 2019-11-19 15/week @ 2019-11-26 39/week @ 2019-12-03 285/week @ 2019-12-10 13/week @ 2019-12-24 2/week @ 2019-12-31 144/week @ 2020-01-07 39/week @ 2020-01-14

212 downloads per month

Apache-2.0 OR MIT

17KB
286 lines

futures-enum

crates-badge docs-badge license-badge rustc-badge

#[derive(Future, Stream, Sink, AsyncRead, AsyncWrite, AsyncSeek, AsyncBufRead)] for enums.

Usage

Add this to your Cargo.toml:

[dependencies]
futures-enum = "0.1.12"
futures = "0.3"

The current futures-enum requires Rust 1.36 or later.

Examples

use futures_enum::*;
use std::future::Future;

#[derive(Future, Stream, Sink, AsyncRead, AsyncWrite, AsyncSeek, AsyncBufRead)]
enum Either<A, B> {
    A(A),
    B(B),
}

fn foo(x: i32) -> impl Future<Output = i32> {
    if x < 0 {
        Either::A(async { 1 })
    } else {
        Either::B(async move { x })
    }
}

futures-enum works well even if the dependency contains only sub-crates such as futures-core, futures-io, futures-sink, etc.

See auto_enums crate for how to automate patterns like this.

Supported traits

License

Licensed under either of

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.

Dependencies

~0.5–1MB
~21K SLoC