rs-zero 0.2.6

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

use std::collections::BTreeMap;

use async_trait::async_trait;

use crate::discovery::{Discovery, DiscoveryError, DiscoveryResult, ServiceInstance};

/// Discovery adapter backed by a static service map.
#[derive(Debug, Clone, Default)]
pub struct StaticDiscovery {
    services: BTreeMap<String, Vec<ServiceInstance>>,
}

impl StaticDiscovery {
    /// Creates an empty static discovery map.
    pub fn new() -> Self {
        Self::default()
    }

    /// Adds an instance and returns the updated map.
    pub fn with_instance(mut self, instance: ServiceInstance) -> Self {
        self.services
            .entry(instance.service.clone())
            .or_default()
            .push(instance);
        self
    }
}

#[async_trait]
impl Discovery for StaticDiscovery {
    async fn discover(&self, service: &str) -> DiscoveryResult<Vec<ServiceInstance>> {
        let instances = self
            .services
            .get(service)
            .map(|items| {
                items
                    .iter()
                    .filter(|instance| instance.healthy)
                    .cloned()
                    .collect::<Vec<_>>()
            })
            .unwrap_or_default();
        if instances.is_empty() {
            Err(DiscoveryError::NoInstances {
                service: service.to_string(),
            })
        } else {
            Ok(instances)
        }
    }
}

#[cfg(test)]
mod tests {
    use super::{Discovery, StaticDiscovery};
    use crate::discovery::{InstanceEndpoint, ServiceInstance};

    #[tokio::test]
    async fn static_discovery_filters_unhealthy_instances() {
        let endpoint = InstanceEndpoint::new("127.0.0.1", 8080).expect("endpoint");
        let discovery = StaticDiscovery::new()
            .with_instance(ServiceInstance::new("api", "api-1", endpoint.clone()))
            .with_instance(ServiceInstance::new("api", "api-2", endpoint).with_health(false));

        let instances = discovery.discover("api").await.expect("instances");
        assert_eq!(instances.len(), 1);
        assert_eq!(instances[0].id, "api-1");
    }
}