obzenflow_runtime 0.1.2

Runtime services for ObzenFlow - execution and coordination business logic
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

// SPDX-License-Identifier: MIT OR Apache-2.0
// SPDX-FileCopyrightText: 2025-2026 ObzenFlow Contributors
// https://obzenflow.dev

use std::time::Duration;

/// Simple exponential idle backoff with a hard cap.
///
/// Intended for event loops that may legitimately observe long stretches of "no work"
/// while polling synchronous sources (FLOWIP-086i).
#[derive(Debug, Clone)]
pub(crate) struct IdleBackoff {
    current: Duration,
    initial: Duration,
    max: Duration,
}

impl IdleBackoff {
    pub(crate) fn exponential_with_cap(initial: Duration, max: Duration) -> Self {
        Self {
            current: Duration::ZERO,
            initial,
            max,
        }
    }

    pub(crate) fn reset(&mut self) {
        self.current = Duration::ZERO;
    }

    pub(crate) fn next_delay(&mut self) -> Duration {
        if self.current == Duration::ZERO {
            self.current = self.initial;
            return self.current;
        }

        let doubled = self.current.checked_mul(2).unwrap_or(self.max);
        self.current = std::cmp::min(doubled, self.max);
        self.current
    }
}