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!");
    })
}

Modules

future

Combinators for the Future trait.

iostd

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.

Traits

AsyncBufRead

Read bytes asynchronously.

AsyncBufReadExt

Extension trait for AsyncBufRead.

AsyncRead

Read bytes asynchronously.

AsyncReadExt

Extension trait for AsyncRead.

AsyncSeek

Seek bytes asynchronously.

AsyncSeekExt

Extension trait for AsyncSeek.

AsyncWrite

Write bytes asynchronously.

AsyncWriteExt

Extension trait for AsyncWrite.

Future

A future represents an asynchronous computation obtained by use of async.

FutureExt

Extension trait for Future.

Stream

A stream of values produced asynchronously.

StreamExt

Extension trait for Stream.