rs-zero 0.2.3

Rust-first microservice framework inspired by go-zero engineering practices
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
75
76
77
78

use tonic::transport::{Channel, Endpoint};

use crate::rpc::RpcClientConfig;
#[cfg(feature = "discovery")]
use crate::rpc::{
    balancer::{RpcEndpoint, RpcEndpointSelector},
    discovery::resolve_service_endpoint,
};

/// Errors returned while resolving and connecting RPC clients.
#[cfg(feature = "discovery")]
#[derive(Debug, thiserror::Error)]
pub enum RpcConnectError {
    /// Discovery returned no usable endpoint or failed.
    #[error(transparent)]
    Discovery(#[from] crate::discovery::DiscoveryError),
    /// Tonic transport failed to build or connect the endpoint.
    #[error(transparent)]
    Transport(#[from] tonic::transport::Error),
}

/// Builds a tonic endpoint from rs-zero client config.
pub fn endpoint_from_config(config: &RpcClientConfig) -> Result<Endpoint, tonic::transport::Error> {
    Endpoint::from_shared(config.endpoint.clone()).map(|endpoint| {
        endpoint
            .connect_timeout(config.connect_timeout)
            .timeout(config.request_timeout)
    })
}

/// Connects a tonic channel from rs-zero client config.
pub async fn connect_channel(config: &RpcClientConfig) -> Result<Channel, tonic::transport::Error> {
    endpoint_from_config(config)?.connect().await
}

/// Builds a tonic endpoint from a discovered RPC endpoint.
#[cfg(feature = "discovery")]
pub fn endpoint_from_rpc_endpoint(
    endpoint: &RpcEndpoint,
    config: &RpcClientConfig,
) -> Result<Endpoint, tonic::transport::Error> {
    Endpoint::from_shared(endpoint.uri.clone()).map(|endpoint| {
        endpoint
            .connect_timeout(config.connect_timeout)
            .timeout(config.request_timeout)
    })
}

/// Resolves one endpoint through discovery and connects a tonic channel.
#[cfg(feature = "discovery")]
pub async fn connect_discovered_channel<D, S>(
    discovery: &D,
    selector: &S,
    service: &str,
    config: &RpcClientConfig,
) -> Result<Channel, RpcConnectError>
where
    D: crate::discovery::Discovery + ?Sized,
    S: RpcEndpointSelector + ?Sized,
{
    let endpoint = resolve_service_endpoint(discovery, selector, service).await?;
    Ok(endpoint_from_rpc_endpoint(&endpoint, config)?
        .connect()
        .await?)
}

#[cfg(test)]
mod tests {
    use super::endpoint_from_config;
    use crate::rpc::RpcClientConfig;

    #[test]
    fn endpoint_accepts_http_uri() {
        let config = RpcClientConfig::new("http://127.0.0.1:50051");

        assert!(endpoint_from_config(&config).is_ok());
    }
}