Enum RssError

#[non_exhaustive]
pub enum RssError {
    XmlWriteError(Error),
    XmlParseError(Error),
    Utf8Error(FromUtf8Error),
    MissingField(String),
    DateParseError(String),
    IoError(Error),
    InvalidInput(String),
    InvalidUrl(String),
    UnknownElement(String),
    ValidationErrors(Vec<String>),
    DateSortError(Vec<DateSortError>),
    ItemValidationError(String),
    UnknownField(String),
    Custom(String),
    InvalidRssVersion(String),
}

Errors that can occur when generating or parsing RSS feeds.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

XmlWriteError(Error)

Error occurred while writing XML.

XmlParseError(Error)

Error occurred during XML parsing.

Utf8Error(FromUtf8Error)

Error occurred during UTF-8 conversion.

MissingField(String)

Error indicating a required field is missing.

DateParseError(String)

Error indicating a date parsing failure.

IoError(Error)

General I/O error.

InvalidInput(String)

Error for invalid input data.

InvalidUrl(String)

Error for invalid URL provided.

UnknownElement(String)

Error for unknown XML elements encountered during parsing.

ValidationErrors(Vec<String>)

Error for validation errors.

DateSortError(Vec<DateSortError>)

Error for date sort errors.

ItemValidationError(String)

Error for item validation errors.

UnknownField(String)

Error for unknown field encountered during parsing.

Custom(String)

Custom error for unforeseen scenarios.

InvalidRssVersion(String)

Error for invalid RSS version.

Implementations

impl RssError

pub fn missing_field<S: Into<String>>(field_name: S) -> Self

Creates a new RssError::MissingField error.

Arguments

• field_name - The name of the missing field.

Returns

Returns a new RssError::MissingField instance.

pub fn date_sort_error<S: Into<String>>( index: usize, message: S, ) -> DateSortError

Creates a new DateSortError.

Arguments

• index - The index of the item with the date sort error.
• message - The error message.

Returns

Returns a new DateSortError instance.

pub fn invalid_input<S: Into<String>>(message: S) -> Self

Creates a new RssError::InvalidInput error.

Arguments

• message - A description of why the input is invalid.

Returns

Returns a new RssError::InvalidInput instance.

pub fn custom<S: Into<String>>(message: S) -> Self

Creates a new RssError::Custom error.

Arguments

• message - A custom error message.

Returns

Returns a new RssError::Custom instance.

pub fn log(&self)

Logs the error using the log crate.

This method logs the error at the error level. It uses the log crate, so the application using this library should configure a logger.

pub fn to_http_status(&self) -> u16

Converts the RssError into an appropriate HTTP status code.

This method is useful when the library is used in web services.

Returns

Returns a u16 representing an HTTP status code.

Trait Implementations

impl Debug for RssError

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

Formats the value using the given formatter.

impl Display for RssError

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

Formats the value using the given formatter.

impl Error for RssError

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<Error> for RssError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for RssError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for RssError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.