Struct GuardSets 

pub(crate) struct GuardSets {
    pub(crate) active_set: GuardSetSelector,
    pub(crate) default: GuardSet,
    pub(crate) restricted: GuardSet,
    pub(crate) bridges: GuardSet,
    pub(crate) remaining: HashMap<String, JsonValue>,
}

Persistent state for a guard manager, as serialized to disk.

Fields

active_set: GuardSetSelector

Which set of guards is currently in use?

default: GuardSet

The default set of guards to use.

We use this one when there is no filter, or the filter permits most of the guards on the network.

restricted: GuardSet

A guard set to use when we have a restrictive filter.

bridges: GuardSet

A guard set sampled from our configured bridges.

remaining: HashMap<String, JsonValue>

Unrecognized fields, including (possibly) other guard sets.

Implementations

impl GuardSets

pub(crate) fn active_guards(&self) -> &GuardSet

Return a reference to the currently active set of guards.

(That’s easy enough for now, since there is never more than one set of guards. But eventually that will change, as we add support for more complex filter types, and for bridge relays. Those will use separate GuardSet instances, and this accessor will choose the right one.)

pub(crate) fn guards(&self, selector: &GuardSetSelector) -> &GuardSet

Return the set of guards corresponding to the provided selector.

pub(crate) fn active_guards_mut(&mut self) -> &mut GuardSet

Return a mutable reference to the currently active set of guards.

pub(crate) fn guards_mut( &mut self, selector: &GuardSetSelector, ) -> &mut GuardSet

Return a mutable reference to the set of guards corresponding to the provided selector.

pub(crate) fn copy_status_from(&mut self, other: GuardSets)

Update all non-persistent state for the guards in this object with the state in other.

Trait Implementations

impl Clone for GuardSets

fn clone(&self) -> GuardSets

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GuardSets

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GuardSets

fn default() -> GuardSets

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GuardSets

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GuardSets

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.