7 releases

0.3.3 Oct 6, 2022
0.3.2 Oct 4, 2022
0.3.0 Sep 29, 2022
0.2.1 Sep 20, 2022
0.1.1 Sep 7, 2022

#1247 in Asynchronous

MIT/Apache

80KB
2.5K SLoC

Task Executor

English | 简体中文

Task Executor Task executors that control the number of parallel executions. Usually, ordinary asynchronous tasks can be executed directly using Tokio or async-std; however, in some special business scenarios, we need to perform a certain type of tasks in batches, and control the number of concurrent tasks of this type. Using spawn() directly can easily lead to excessive load and exhaustion of resources such as CPU or memory. this executor was developed to solve such problems.

Features

  • Execute the tasks;
  • Execute the tasks and return results;
  • Control the number of concurrently executed tasks;
  • Support task queue;
  • The same grouped tasks are executed sequentially;
  • Support Local tasks

Plan

Examples

  • quick start
fn main() {
    use async_std::task::spawn;
    use rust_box::task_executor::{init_default, default, SpawnDefaultExt};

    let task_runner = init_default();
    let global = async move{
        spawn(async {
            //start executor
            task_runner.await;
        });
        //execute future ...
        let _ = async {
            println!("hello world!");
        }.spawn().await;

        default().flush().await;
    };
    async_std::task::block_on(global);
}

  • execute and return result
fn main() {
    use async_std::task::spawn;
    use rust_box::task_executor::{Builder, SpawnExt};
    let (exec, task_runner) = Builder::default().workers(10).queue_max(100).build();
    let global = async move{
        spawn(async {
            //start executor
            task_runner.await;
        });
        //execute future and return result...
        let res = async {
            "hello world!"
        }.spawn(&exec).result().await;
        println!("return result: {:?}", res.ok());

        exec.flush().await;
    };
    async_std::task::block_on(global);
}

  • sequential execution
fn main() {
    use async_std::task::spawn;
    use rust_box::task_executor::{Builder, SpawnExt};

    let (exec, task_runner) =
        Builder::default().workers(10).queue_max(100).group().build::<&str>();
    
    let global = async move {
        spawn(async {
            //start executor
            task_runner.await;
        });

        //execute future ...
        let _res = async move {
            println!("hello world!");
        }.spawn(&exec).group("g1").await;

        let res = async move {
            "hello world!"
        }.spawn(&exec).group("g1").result().await;
        println!("result: {:?}", res.ok());

        exec.flush().await;
        println!("exec.actives: {}, waitings: {}, completeds: {}", exec.active_count(), exec.waiting_count(), exec.completed_count());
    };
    async_std::task::block_on(global);
}

More Examples

Dependencies

~3–10MB
~73K SLoC