rustvello 0.1.6

Distributed task library for Rust, inspired by pynenc
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

//! Runner implementations for Rustvello.
//!
//! This module provides multiple runner types for executing tasks:
//!
//! - [`PersistentTokioRunner`]: Persistent worker pool using tokio tasks (default).
//! - [`PerInvocationTokioRunner`]: Spawns a new tokio task per invocation.
//! - [`RayonRunner`]: Uses rayon thread pool for CPU-bound tasks (feature-gated).
//! - [`SpawnBlockingRunner`]: Spawns a blocking thread per invocation for isolation.
//!
//! # Backward Compatibility
//!
//! The [`TaskRunner`] type alias points to [`PersistentTokioRunner`] for
//! backward compatibility with existing code.

use std::sync::Arc;
use std::time::Duration;

use rustvello_core::observability::EventEmitter;
use rustvello_proto::identifiers::{InvocationId, RunnerId, TaskId};

pub(crate) mod executor_common;
mod per_invocation_tokio;
mod persistent_tokio;
mod process_runner;
#[cfg(feature = "rayon")]
mod rayon_runner;

pub use per_invocation_tokio::PerInvocationTokioRunner;
pub use persistent_tokio::PersistentTokioRunner;
pub use process_runner::SpawnBlockingRunner;
#[cfg(feature = "rayon")]
pub use rayon_runner::RayonRunner;

/// Backward-compatible alias for `PersistentTokioRunner`.
pub type TaskRunner = PersistentTokioRunner;

/// Backward-compatible alias for the renamed `SpawnBlockingRunner`.
#[deprecated(since = "0.1.0", note = "renamed to SpawnBlockingRunner")]
pub type ProcessRunner = SpawnBlockingRunner;

/// Wrapper that delegates all events to an inner `Arc<dyn EventEmitter>`.
///
/// Used by runners to chain their own `CompositeEmitter` on top of a
/// user-provided emitter.
pub(crate) struct PrevEmitterWrapper(pub(crate) Arc<dyn EventEmitter>);

impl EventEmitter for PrevEmitterWrapper {
    fn on_worker_started(&self, r: &RunnerId) {
        self.0.on_worker_started(r);
    }
    fn on_worker_shutdown(&self, r: &RunnerId) {
        self.0.on_worker_shutdown(r);
    }
    fn on_task_submitted(&self, t: &TaskId, i: &InvocationId) {
        self.0.on_task_submitted(t, i);
    }
    fn on_task_started(&self, t: &TaskId, i: &InvocationId) {
        self.0.on_task_started(t, i);
    }
    fn on_task_succeeded(&self, t: &TaskId, i: &InvocationId, d: Duration) {
        self.0.on_task_succeeded(t, i, d);
    }
    fn on_task_failed(&self, t: &TaskId, i: &InvocationId, e: &str, d: Duration) {
        self.0.on_task_failed(t, i, e, d);
    }
    fn on_task_retried(&self, t: &TaskId, i: &InvocationId, a: u32) {
        self.0.on_task_retried(t, i, a);
    }
    fn on_queue_depth(&self, q: &str, d: usize) {
        self.0.on_queue_depth(q, d);
    }
    fn on_cc_rejected(&self, t: &TaskId) {
        self.0.on_cc_rejected(t);
    }
}