Skip to main content

kafka_client_engine/config/
group_consumer_operations.rs

1//! Raw hosted-group operation durations validated before registration.
2
3use std::time::Duration;
4
5/// Seek and explicit-close durations fixed for one hosted group consumer.
6#[derive(Clone, Copy, Debug, Eq, PartialEq)]
7pub struct EngineGroupConsumerOperationConfig {
8    seek_timeout: Duration,
9    close_timeout: Duration,
10}
11
12impl EngineGroupConsumerOperationConfig {
13    /// Creates one explicit hosted-group operation policy.
14    pub const fn new(seek_timeout: Duration, close_timeout: Duration) -> Self {
15        Self {
16            seek_timeout,
17            close_timeout,
18        }
19    }
20
21    /// Returns the end-to-end duration for one group seek.
22    pub const fn seek_timeout(self) -> Duration {
23        self.seek_timeout
24    }
25
26    /// Returns the end-to-end duration for explicit or requested group close.
27    pub const fn close_timeout(self) -> Duration {
28        self.close_timeout
29    }
30
31    pub(crate) fn validate(
32        self,
33    ) -> Result<ValidatedGroupConsumerOperationConfig, GroupConsumerOperationConfigError> {
34        validate_duration(self.seek_timeout)
35            .ok_or(GroupConsumerOperationConfigError::SeekTimeout)?;
36        validate_duration(self.close_timeout)
37            .ok_or(GroupConsumerOperationConfigError::CloseTimeout)?;
38        Ok(ValidatedGroupConsumerOperationConfig {
39            seek_timeout: self.seek_timeout,
40            close_timeout: self.close_timeout,
41        })
42    }
43}
44
45impl Default for EngineGroupConsumerOperationConfig {
46    fn default() -> Self {
47        Self::new(Duration::from_secs(30), Duration::from_secs(30))
48    }
49}
50
51#[derive(Clone, Copy, Debug, Eq, PartialEq)]
52pub(crate) struct ValidatedGroupConsumerOperationConfig {
53    seek_timeout: Duration,
54    close_timeout: Duration,
55}
56
57impl ValidatedGroupConsumerOperationConfig {
58    pub(crate) const fn seek_timeout(self) -> Duration {
59        self.seek_timeout
60    }
61
62    pub(crate) const fn close_timeout(self) -> Duration {
63        self.close_timeout
64    }
65}
66
67#[derive(Clone, Copy, Debug, Eq, PartialEq)]
68pub(crate) enum GroupConsumerOperationConfigError {
69    SeekTimeout,
70    CloseTimeout,
71}
72
73fn validate_duration(duration: Duration) -> Option<u64> {
74    if duration.is_zero() {
75        return None;
76    }
77    u64::try_from(duration.as_nanos()).ok()
78}