Skip to main content

kafka_client_engine/admin/describe_topic_partitions/
observer.rs

1//! Named runtime-neutral observation of one Admin `DescribeTopicPartitions` page.
2
3use std::{
4    fmt,
5    future::Future,
6    pin::Pin,
7    task::{Context, Poll},
8};
9
10use kafka_client_core::DescribeTopicPartitionsTerminal;
11
12use crate::completion::{CompletionObserver, CompletionObserverError};
13
14use super::{
15    AdminDescribeTopicPartitionsObserverError, AdminDescribeTopicPartitionsOutcome,
16    outcome::translate_terminal,
17};
18
19/// Single observer for one accepted explicit page request.
20#[must_use = "dropping abandons observation without cancelling accepted admin work"]
21pub struct AdminDescribeTopicPartitionsObserver {
22    inner: CompletionObserver<DescribeTopicPartitionsTerminal>,
23}
24
25impl AdminDescribeTopicPartitionsObserver {
26    pub(crate) const fn from_completion(
27        inner: CompletionObserver<DescribeTopicPartitionsTerminal>,
28    ) -> Self {
29        Self { inner }
30    }
31
32    /// Blocks on the same terminal cell used by `Future::poll`.
33    pub fn wait(
34        self,
35    ) -> Result<AdminDescribeTopicPartitionsOutcome, AdminDescribeTopicPartitionsObserverError>
36    {
37        self.inner
38            .wait()
39            .map(translate_terminal)
40            .map_err(observer_error)
41    }
42}
43
44impl Future for AdminDescribeTopicPartitionsObserver {
45    type Output =
46        Result<AdminDescribeTopicPartitionsOutcome, AdminDescribeTopicPartitionsObserverError>;
47
48    fn poll(self: Pin<&mut Self>, context: &mut Context<'_>) -> Poll<Self::Output> {
49        let this = self.get_mut();
50        Pin::new(&mut this.inner)
51            .poll(context)
52            .map(|result| result.map(translate_terminal).map_err(observer_error))
53    }
54}
55
56impl fmt::Debug for AdminDescribeTopicPartitionsObserver {
57    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
58        formatter
59            .debug_struct("AdminDescribeTopicPartitionsObserver")
60            .finish_non_exhaustive()
61    }
62}
63
64const fn observer_error(
65    error: CompletionObserverError,
66) -> AdminDescribeTopicPartitionsObserverError {
67    match error {
68        CompletionObserverError::AlreadyObserved => {
69            AdminDescribeTopicPartitionsObserverError::AlreadyObserved
70        }
71        CompletionObserverError::Stale => AdminDescribeTopicPartitionsObserverError::Stale,
72    }
73}