Skip to main content

kafka_client_engine/admin/partitions/
error.rs

1//! Stable immediate `CreatePartitions` admission failures.
2
3use core::fmt;
4
5/// Stable category for a request that never crossed admission.
6#[derive(Clone, Copy, Debug, Eq, PartialEq)]
7pub enum CreatePartitionsAdmissionErrorKind {
8    /// The request violates deterministic validation.
9    InvalidRequest,
10    /// The requested timeout cannot become an absolute deadline.
11    InvalidDeadline,
12    /// The concrete shard is briefly owned by another turn.
13    Contended,
14    /// Admin admission has closed.
15    Closed,
16    /// Bounded terminal capacity is full.
17    Capacity,
18    /// The request exceeds retained-byte capacity.
19    RetainedBytes,
20    /// Stable operation identities are exhausted.
21    IdentityExhausted,
22    /// The host completion mechanism is unavailable.
23    HostUnavailable,
24}
25
26/// Immediate definitely-unsent `CreatePartitions` rejection.
27#[derive(Clone, Copy, Debug, Eq, PartialEq)]
28pub struct CreatePartitionsAdmissionError {
29    kind: CreatePartitionsAdmissionErrorKind,
30}
31
32impl CreatePartitionsAdmissionError {
33    pub(crate) const fn new(kind: CreatePartitionsAdmissionErrorKind) -> Self {
34        Self { kind }
35    }
36
37    /// Returns the stable rejection category.
38    pub const fn kind(self) -> CreatePartitionsAdmissionErrorKind {
39        self.kind
40    }
41}
42
43impl fmt::Display for CreatePartitionsAdmissionError {
44    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
45        write!(
46            formatter,
47            "CreatePartitions admission failed: {:?}",
48            self.kind
49        )
50    }
51}
52
53impl std::error::Error for CreatePartitionsAdmissionError {}