Skip to content
An async/await executor for Rust
Rust Makefile
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
executor-macros
executor
.gitignore
LICENSE-APACHE
LICENSE-MIT
README.md

README.md

executor

docs.rs docs

[dependencies]
executor = "0.6"

Features

  • #![no_std] + alloc
  • global executor for easy spawning
  • simple enough to learn from! (~ 100 lines)
  • simple macros for async entry functions

Example

A web assembly example

#[no_mangle]
#[executor::entry]
pub fn main() {
    console_log("Hello");
    set_timeout(1000).await;
    console_log("World!");
}

fn set_timeout(milliseconds:u32) -> TimeoutFuture {
   // create a timeout future and store globally
}

#[no_mangle]
pub fn timeout_complete() -> () {
    // find your timeout future and wake it's waker
}

async-std

Want to use async-std?

use async_std::task::sleep;
use std::time::Duration;

#[executor::main]
async fn main() {
    println!("hello");
    sleep(Duration::from_secs(1)).await;
    println!("world!");
}

Want to replace the global executor?

Write your own with this trait

pub trait GlobalExecutor {
    fn spawn(&mut self, future: Box<dyn Future<Output = ()> + 'static + Send + Unpin>);
}
executor::set_global_executor(MY_EXECUTOR);

License

This project is licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in executor by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

You can’t perform that action at this time.