when2task 0.3.1

high-performance library for executing async tasks with automatic dependency resolution and optimal parallelization.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

use crate::{Dependency, TaskId};
use derive_getters::Getters;
use std::future::Future;
use std::pin::Pin;

pub type UnitTask<'a, T, E> = Pin<Box<dyn Future<Output = Result<T, E>> + Send + 'a>>;

#[derive(Getters)]
pub struct Task<'a, T, E> {
    id: TaskId,
    #[getter(skip)]
    task: UnitTask<'a, T, E>,
    dependencies: Dependency,
}

impl<'a, T, E> Task<'a, T, E> {
    pub fn new<F: Future<Output = Result<T, E>> + Send + 'a>(
        task: F,
        dependencies: impl Into<Dependency>,
    ) -> Self {
        let id = TaskId::generate();

        Self {
            id,
            task: Box::pin(task),
            dependencies: dependencies.into(),
        }
    }

    /// Convenience method to create a task with no dependencies
    pub fn new_independent<F: Future<Output = Result<T, E>> + Send + 'a>(task: F) -> Self {
        Self::new(task, [])
    }
    pub(crate) fn into_task(self) -> UnitTask<'a, T, E> {
        self.task
    }
}