Crate async_global_executor

A global executor built on top of async-executor and async_io

The global executor is lazily spawned on first use. It spawns as many threads as the number of cpus by default. You can override this using the ASYNC_GLOBAL_EXECUTOR_THREADS environment variable.

Examples

// spawn a task on the multi-threaded executor
let task1 = async_global_executor::spawn(async {
    1 + 2
});
// spawn a task on the local executor (same thread)
let task2 = async_global_executor::spawn_local(async {
    3 + 4
});
let task = future::zip(task1, task2);

// run the executor
async_global_executor::block_on(async {
    assert_eq!(task.await, (3, 7));
});

Structs

GlobalExecutorConfig	Configuration to init the thread pool for the multi-threaded global executor.
Task	A spawned task.

Functions

block_on	Runs the global and the local executor on the current thread
init	Init the global executor, spawning as many threads as the number or cpus or the value specified by the ASYNC_GLOBAL_EXECUTOR_THREADS environment variable if specified.
init_with_config	Init the global executor, spawning as many threads as specified or the value specified by the specified environment variable.
spawn	Spawns a task onto the multi-threaded global executor.
spawn_blocking	Runs blocking code on a thread pool.
spawn_local	Spawns a task onto the local executor.
spawn_more_threads	Spawn more executor threads, up to configured max value.
stop_current_thread	Stop the current executor thread, if we exceed the configured min value
stop_thread	Stop one of the executor threads, down to configured min value