Enum DescriptorError 

pub enum DescriptorError {
    Consensus(ConsensusError),
    ServerDescriptor(ServerDescriptorError),
    Microdescriptor(MicrodescriptorError),
    ExtraInfo(ExtraInfoError),
    HiddenService(HiddenServiceDescriptorError),
    KeyCertificate(KeyCertificateError),
    BandwidthFile(BandwidthFileError),
    TorDNSEL(TorDNSELError),
    UnsupportedCompression(String),
    DecompressionFailed(String),
    InvalidUtf8(FromUtf8Error),
}

Unified error type for all descriptor parsing operations.

This enum wraps all descriptor-specific error types, providing a single error type that can represent failures from any descriptor parser.

Design

Following the library-rs reference implementation, this uses transparent error forwarding with #[error(transparent)] to preserve the underlying error’s Display implementation and source chain.

Example

use stem_rs::descriptor::DescriptorError;

fn handle_descriptor_error(err: DescriptorError) {
    match err {
        DescriptorError::Consensus(e) => {
            eprintln!("Consensus error: {}", e);
        }
        DescriptorError::ServerDescriptor(e) => {
            eprintln!("Server descriptor error: {}", e);
        }
        DescriptorError::UnsupportedCompression(format) => {
            eprintln!("Unsupported compression: {}", format);
        }
        _ => eprintln!("Descriptor error: {}", err),
    }
}

Variants

Consensus(ConsensusError)

Error parsing network status consensus document.

ServerDescriptor(ServerDescriptorError)

Error parsing server descriptor.

Microdescriptor(MicrodescriptorError)

Error parsing microdescriptor.

ExtraInfo(ExtraInfoError)

Error parsing extra-info descriptor.

HiddenService(HiddenServiceDescriptorError)

Error parsing hidden service descriptor.

KeyCertificate(KeyCertificateError)

Error parsing directory key certificate.

BandwidthFile(BandwidthFileError)

Error parsing bandwidth measurement file.

TorDNSEL(TorDNSELError)

Error parsing TorDNSEL exit list.

UnsupportedCompression(String)

Compression format is not supported.

DecompressionFailed(String)

Decompression failed.

InvalidUtf8(FromUtf8Error)

Descriptor contains invalid UTF-8.

Trait Implementations

impl Debug for DescriptorError

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

Formats the value using the given formatter.

impl Display for DescriptorError

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

Formats the value using the given formatter.

impl Error for DescriptorError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<BandwidthFileError> for DescriptorError

fn from(source: BandwidthFileError) -> Self

Converts to this type from the input type.

impl From<ConsensusError> for DescriptorError

fn from(source: ConsensusError) -> Self

Converts to this type from the input type.

impl From<DescriptorError> for Error

fn from(source: DescriptorError) -> Self

Converts to this type from the input type.

impl From<ExtraInfoError> for DescriptorError

fn from(source: ExtraInfoError) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for DescriptorError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<HiddenServiceDescriptorError> for DescriptorError

fn from(source: HiddenServiceDescriptorError) -> Self

Converts to this type from the input type.

impl From<KeyCertificateError> for DescriptorError

fn from(source: KeyCertificateError) -> Self

Converts to this type from the input type.

impl From<MicrodescriptorError> for DescriptorError

fn from(source: MicrodescriptorError) -> Self

Converts to this type from the input type.

impl From<ServerDescriptorError> for DescriptorError

fn from(source: ServerDescriptorError) -> Self

Converts to this type from the input type.

impl From<TorDNSELError> for DescriptorError

fn from(source: TorDNSELError) -> Self

Converts to this type from the input type.