Crate futures_lite

Futures, streams, and async I/O combinators.

This crate is a subset of futures that compiles an order of magnitude faster, fixes minor warts in its API, fills in some obvious gaps, and removes almost all unsafe code from it.

In short, this crate aims to be more enjoyable than futures but still fully compatible with it.

The API for this crate is intentionally constrained. Please consult the features list for APIs that are occluded from this crate.

Examples

use futures_lite::future;

fn main() {
    future::block_on(async {
        println!("Hello world!");
    })
}

Re-exports

pub use crate::io::AsyncBufRead;

pub use crate::io::AsyncBufReadExt;

pub use crate::io::AsyncRead;

pub use crate::io::AsyncReadExt;

pub use crate::io::AsyncSeek;

pub use crate::io::AsyncSeekExt;

pub use crate::io::AsyncWrite;

pub use crate::io::AsyncWriteExt;

pub use crate::future::Future;

pub use crate::future::FutureExt;

pub use crate::stream::Stream;

pub use crate::stream::StreamExt;

Modules

future

Combinators for the Future trait.

io

Tools and combinators for I/O.

prelude

Traits Future, Stream, AsyncRead, AsyncWrite, AsyncBufRead, AsyncSeek, and their extensions.

stream

Combinators for the Stream trait.

Macros

pin

Pins a variable of type T on the stack and rebinds it as Pin<&mut T>.

ready

Unwraps Poll<T> or returns Pending.