#futures #async #future #derive #enum

macro futures-enum

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

8 releases

✓ Uses Rust 2018 edition

0.1.7 May 15, 2019
0.1.6 Apr 16, 2019
0.1.5 Mar 4, 2019
0.1.4 Feb 21, 2019

#115 in Asynchronous

47 downloads per month

Apache-2.0/MIT

14KB
197 lines

futures-enum

Build Status version documentation license

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

Usage

Add this to your Cargo.toml:

[dependencies]
futures-enum = "0.1.7"

The current version of futures-enum requires Rust nightly 2019-05-09 or later.

Examples

use futures::future::{self, Future};
use futures_enum::*;

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

fn foo(x: i32) -> impl Future<Output = i32> {
    if x < 0 {
        Either::A(future::lazy(|_| 1))
    } else {
        Either::B(future::ready(x))
    }
}

See auto_enums for how to automate patterns like this.

In futures-enum 0.1.3 or later, it works well even if the dependency contains only sub-crates such as futures-core, futures-util, etc.

Supported traits

See this issue for other 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

~1.5MB
~30K SLoC