poldercast 1.1.1

Peer to Peer topology management
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

mod cyclon;
mod rings;
mod vicinity;

pub use self::{cyclon::Cyclon, rings::Rings, vicinity::Vicinity};
use crate::{InterestLevel, PriorityMap, Profile, Topic};
use keynesis::key::ed25519;
use std::collections::HashSet;

pub trait Layer: Send {
    fn name(&self) -> &'static str;

    fn view(&mut self, builder: &mut ViewBuilder);

    fn remove(&mut self, id: &ed25519::PublicKey);
    fn reset(&mut self);

    fn subscribe(&mut self, topic: Topic);
    fn unsubscribe(&mut self, topic: &Topic);
    fn subscriptions(&self, output: &mut PriorityMap<InterestLevel, Topic>);

    fn populate(&mut self, our_profile: &Profile, new_profile: &Profile);
}

pub trait LayerBuilder {
    fn build_for_view(&self) -> Vec<Box<dyn Layer>>;
    fn build_for_gossip(&self) -> Vec<Box<dyn Layer>>;
}

#[derive(Debug, Copy, Clone, PartialEq, Eq)]
pub enum Selection {
    Topic { topic: Topic },
    Any,
}

#[doc(hidden)]
pub struct ViewBuilder {
    event_origin: Option<ed25519::PublicKey>,

    selection: Selection,

    view: HashSet<ed25519::PublicKey>,
}

impl ViewBuilder {
    pub fn new(selection: Selection) -> Self {
        Self {
            event_origin: None,
            selection,
            view: HashSet::new(),
        }
    }

    pub fn with_origin(&mut self, origin: ed25519::PublicKey) -> &Self {
        self.event_origin = Some(origin);
        self
    }

    pub fn origin(&self) -> Option<&ed25519::PublicKey> {
        self.event_origin.as_ref()
    }

    pub fn selection(&self) -> Selection {
        self.selection
    }

    pub fn add(&mut self, node: &ed25519::PublicKey) {
        self.view.insert(*node);
    }

    pub(crate) fn build(self) -> HashSet<ed25519::PublicKey> {
        self.view
    }
}