medea 0.2.0

Medea media server
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

//! Implementations of Control API callback clients for all protocols.

pub mod grpc;

use std::{fmt, sync::Arc};

use async_trait::async_trait;
use derive_more::{Display, From};
use futures::future::{FutureExt, LocalBoxFuture};

use crate::{
    api::control::callback::{url::CallbackUrl, CallbackRequest},
    log::prelude::*,
};

/// Shortcut for [`Result`] of methods in this module.
type CallbackResult<T = ()> = Result<T, CallbackClientError>;

/// Error of sending [`CallbackRequest`] by [`CallbackClient`].
#[derive(Debug, Display, From)]
pub enum CallbackClientError {
    /// [`tonic`] failed to send [`CallbackRequest`].
    #[display(fmt = "gRPC request failed: {}", _0)]
    Tonic(tonic::Status),

    /// Error while creating new [`CallbackClient`].
    #[display(fmt = "CallbackClientError: {}", _0)]
    TonicTransport(tonic::transport::Error),
}

#[async_trait(?Send)]
#[cfg_attr(test, mockall::automock)]
pub trait CallbackClient: fmt::Debug + Send + Sync {
    /// Sends provided [`CallbackRequest`].
    async fn send(&self, request: CallbackRequest) -> CallbackResult;
}

#[cfg(test)]
impl_debug_by_struct_name!(MockCallbackClient);

/// Factory for a [`CallbackClient`]s.
#[cfg_attr(test, mockall::automock)]
pub trait CallbackClientFactory {
    /// Creates [`CallbackClient`] basing on provided [`CallbackUrl`].
    fn build(
        url: CallbackUrl,
    ) -> LocalBoxFuture<'static, CallbackResult<Arc<dyn CallbackClient>>>;
}

#[cfg(test)]
impl_debug_by_struct_name!(MockCallbackClientFactory);

/// Implementation of the [`CallbackClientFactory`].
#[derive(Clone, Debug, Default)]
pub struct CallbackClientFactoryImpl;

impl CallbackClientFactory for CallbackClientFactoryImpl {
    #[inline]
    fn build(
        url: CallbackUrl,
    ) -> LocalBoxFuture<'static, CallbackResult<Arc<dyn CallbackClient>>> {
        info!("Creating CallbackClient for URL: {}", url);
        match url {
            CallbackUrl::Grpc(grpc_url) => async move {
                Ok(Arc::new(grpc::GrpcCallbackClient::new(&grpc_url).await?)
                    as Arc<dyn CallbackClient>)
            }
            .boxed_local(),
        }
    }
}