Struct RssItem

#[non_exhaustive]
pub struct RssItem {
    pub guid: String,
    pub category: Option<String>,
    pub description: String,
    pub link: String,
    pub pub_date: String,
    pub title: String,
    pub author: String,
    pub comments: Option<String>,
    pub enclosure: Option<String>,
    pub source: Option<String>,
    pub creator: Option<String>,
    pub date: Option<String>,
}

Represents an item in the RSS feed.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

guid: String

The GUID of the RSS item (unique identifier).

category: Option<String>

The category of the RSS item.

description: String

The description of the RSS item.

link: String

The link to the RSS item.

pub_date: String

The publication date of the RSS item.

title: String

The title of the RSS item.

author: String

The author of the RSS item.

comments: Option<String>

The comments URL related to the RSS item (optional).

enclosure: Option<String>

The enclosure (typically for media like podcasts) (optional).

source: Option<String>

The source of the RSS item (optional).

creator: Option<String>

The creator of the RSS item (optional).

date: Option<String>

The date the RSS item was created (optional).

Implementations

impl RssItem

pub fn new() -> Self

Creates a new RssItem with default values.

pub fn set<T: Into<String>>(self, field: RssItemField, value: T) -> Self

Sets the value of a field and returns the RssItem instance for method chaining.

Arguments

• field - The field to set.
• value - The value to assign to the field.

Returns

The updated RssItem instance.

pub fn validate(&self) -> Result<()>

Validates the RssData to ensure that all required fields are set and valid.

Returns

• Ok(()) if the RssData is valid.
• Err(RssError) if any validation errors are found.

Errors

This function returns an Err(RssError) in the following cases:

• RssError::InvalidInput if any fields such as title, link, or description are missing or invalid.
• RssError::ValidationErrors if there are multiple validation issues found (e.g., invalid link, missing title, etc.).
• RssError::DateParseError if the pub_date cannot be parsed into a valid date.

Additionally, it can return an error if any of the custom validation rules are violated (e.g., maximum length for certain fields).

pub fn pub_date_parsed(&self) -> Result<DateTime>

Parses the pub_date string into a DateTime object.

Returns

• Ok(DateTime) if the date is valid and successfully parsed.
• Err(RssError) if the date is invalid or cannot be parsed.

Errors

This function returns an Err(RssError) if the pub_date is invalid or cannot be parsed into a DateTime object.

pub fn guid<T: Into<String>>(self, value: T) -> Self

Sets the GUID.

pub fn category<T: Into<String>>(self, value: T) -> Self

Sets the category.

pub fn description<T: Into<String>>(self, value: T) -> Self

Sets the description.

pub fn link<T: Into<String>>(self, value: T) -> Self

Sets the link.

pub fn pub_date<T: Into<String>>(self, value: T) -> Self

Sets the publication date.

pub fn title<T: Into<String>>(self, value: T) -> Self

Sets the title.

pub fn author<T: Into<String>>(self, value: T) -> Self

Sets the author.

pub fn comments<T: Into<String>>(self, value: T) -> Self

Sets the comments URL.

pub fn enclosure<T: Into<String>>(self, value: T) -> Self

Sets the enclosure.

pub fn source<T: Into<String>>(self, value: T) -> Self

Sets the source.

Trait Implementations

impl Clone for RssItem

fn clone(&self) -> RssItem

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RssItem

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

Formats the value using the given formatter.

impl Default for RssItem

fn default() -> RssItem

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RssItem

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RssItem

fn eq(&self, other: &RssItem) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RssItem

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for RssItem

impl StructuralPartialEq for RssItem