asynchron 0.1.1

Asynchronize blocking operation.
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

# Asynchron


[![Crates.io](https://img.shields.io/crates/v/asynchron.svg)](https://crates.io/crates/asynchron)
[![Asynchron documentation](https://docs.rs/asynchron/badge.svg)](https://docs.rs/asynchron)
[![Rust](https://github.com/Ar37-rs/asynchron/actions/workflows/rust.yml/badge.svg)](https://github.com/Ar37-rs/asynchron/actions/workflows/rust.yml)

Asynchronize blocking operation.

## Example


```rust
use asynchron::{Futurize, Futurized};
use std::time::{Duration, Instant};

fn main() {
    let instant1: Instant = Instant::now();
    let mut task1_approx_dur = Duration::from_millis(400);
    let task1 = Futurize::task(move || -> Futurized<Vec<u32>, String> {
        std::thread::sleep(task1_approx_dur);
        let elapsed_content = format!(
            "instant 1 enlapsed by now {}",
            instant1.elapsed().subsec_millis()
        );
        // for OnError demo, change the line above like so: (will return error)
        // let elapsed_content = format!("notsparatedbyspace{}", instant1.elapsed().subsec_millis();
        let mut vec_ui32 = Vec::new();
        elapsed_content
            .split(" ")
            .for_each(|ch| match ch.trim().parse::<u32>() {
                Ok(ui32) => vec_ui32.push(ui32),
                _ => (),
            });
        if vec_ui32.len() > 0 {
            return Futurized::OnComplete(vec_ui32);
        } else {
            return Futurized::OnError(
                "On task 1 there's an error occured:
                there's no valid u32 in elapsed_content
                at futurize/src/example.rs line 136\n"
                    .to_string(),
            );
        }
    });
    task1.try_wake();

    let mut task2_approx_dur = Duration::from_millis(600);
    let instant2: Instant = Instant::now();
    let task2 = Futurize::task(move || -> Futurized<u32, ()> {
        std::thread::sleep(task2_approx_dur);
        return Futurized::OnComplete(instant2.elapsed().subsec_millis());
    });
    task2.try_wake();

    loop {
        if task1.awake() {
            match task1.try_get() {
                Futurized::OnComplete(value) => {
                    task1_approx_dur = instant1.elapsed();
                    println!(
                        "task 1 completed at: {:?} has value: {:?}\n",
                        task1_approx_dur, value
                    );
                }
                Futurized::OnProgress => println!("waiting the task 1 to complete\n"),
                Futurized::OnError(e) => println!("{}", e),
            }
        }

        if task2.awake() {
            match task2.try_get() {
                Futurized::OnComplete(value) => {
                    task2_approx_dur = instant2.elapsed();
                    println!(
                        "task 2 completed at: {:?} has value: {:?}\n",
                        task2_approx_dur, value
                    );
                    break;
                }
                Futurized::OnProgress => println!("waiting the task 2 to complete\n"),
                _ => (),
            }
        }
        std::thread::sleep(Duration::from_millis(100));
    }
    let all_approxed_durs = task2_approx_dur + task1_approx_dur;
    println!(
        "all the tasks are completed {:?} earlier.\n\nOk",
        all_approxed_durs - task2_approx_dur
    )
}
```