hedwig 7.2.0

A simple message bus for Rust
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

//! Types, traits, and functions necessary to publish messages using hedwig

use futures_util::sink;
use std::{
    pin::Pin,
    task::{Context, Poll},
};

pub use hedwig_core::message::EncodableMessage;

/// Message publishers.
///
/// Message publishers validate, encode, and deliver messages to an endpoint, possibly a remote
/// one. Message publishers may also additionally validate a message for publisher-specific
/// requirements (e.g.  size).
pub trait Publisher<M: EncodableMessage, S: sink::Sink<M> = Drain<M>> {
    /// The error type that may be encountered when publishing a message
    type PublishError;
    /// The [`Sink`](futures_util::sink::Sink) type provided by the publisher to accept messages,
    /// validate them, then publish them to the destination.
    type PublishSink: sink::Sink<M, Error = Self::PublishError>;

    /// Create a new sink to accept messages.
    ///
    /// The sink will use the given validator to validate and/or encode messages, possibly batch
    /// them together, then publish them to their destination. The details of the internal encoding
    /// and batching may vary by `Publisher` implementation.
    fn publish_sink(self, validator: M::Validator) -> Self::PublishSink
    where
        Self: Sized,
        S: Default,
    {
        self.publish_sink_with_responses(validator, S::default())
    }

    /// Create a new sink to accept messages.
    ///
    /// This creates a sink like [`publish_sink`](Publisher::publish_sink) while additionally
    /// listening for successful responses; after a message has been successfully published, it
    /// will be passed to the given response sink to complete any necessary work (e.g.
    /// acknowledging success or collecting metrics)
    fn publish_sink_with_responses(
        self,
        validator: M::Validator,
        response_sink: S,
    ) -> Self::PublishSink;
}

/// Like [`futures_util::sink::Drain`] but implements `Default`
#[derive(Debug)]
pub struct Drain<T>(std::marker::PhantomData<T>);

impl<T> Default for Drain<T> {
    fn default() -> Self {
        Self(std::marker::PhantomData)
    }
}

impl<T> sink::Sink<T> for Drain<T> {
    type Error = futures_util::never::Never;

    fn poll_ready(self: Pin<&mut Self>, _: &mut Context) -> Poll<Result<(), Self::Error>> {
        Poll::Ready(Ok(()))
    }
    fn start_send(self: Pin<&mut Self>, _: T) -> Result<(), Self::Error> {
        Ok(())
    }
    fn poll_flush(self: Pin<&mut Self>, _: &mut Context) -> Poll<Result<(), Self::Error>> {
        Poll::Ready(Ok(()))
    }
    fn poll_close(self: Pin<&mut Self>, _: &mut Context) -> Poll<Result<(), Self::Error>> {
        Poll::Ready(Ok(()))
    }
}