Struct NewDescEvent 

pub struct NewDescEvent {
    pub relays: Vec<(String, Option<String>)>,
    /* private fields */
}

Event indicating that new relay descriptors are available.

This event is emitted when Tor receives new server descriptors for relays in the network. It provides a list of relays whose descriptors have been updated.

Relay Identification

Each relay is identified by its fingerprint and optionally its nickname. The relays field contains (fingerprint, nickname) tuples.

Example

use stem_rs::events::NewDescEvent;

fn handle_newdesc(event: &NewDescEvent) {
    println!("Received {} new descriptors:", event.relays.len());
    for (fingerprint, nickname) in &event.relays {
        match nickname {
            Some(nick) => println!("  {} ({})", fingerprint, nick),
            None => println!("  {}", fingerprint),
        }
    }
}

Fields

relays: Vec<(String, Option<String>)>

List of relays with new descriptors as (fingerprint, nickname) tuples.

Implementations

impl NewDescEvent

pub fn parse(content: &str) -> Result<Self, Error>

Parses a new descriptor event from raw control protocol content.

Arguments

• content - The event content after the event type

Event Format

Relay1 [Relay2 ...]

Where each relay is either a fingerprint or fingerprint=nickname.

Errors

This method currently does not return errors but returns Result for API consistency.

Trait Implementations

impl Clone for NewDescEvent

fn clone(&self) -> NewDescEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NewDescEvent

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

Formats the value using the given formatter.

impl Event for NewDescEvent

fn event_type(&self) -> EventType

Returns the type of this event.

fn raw_content(&self) -> &str

Returns the raw, unparsed content of the event.

fn arrived_at(&self) -> Instant

Returns the instant when this event was received.