Enum Feed 

pub enum Feed {
    Rss2(Rss2Feed),
    Atom(AtomFeed),
}

Available on crate features http and rss only.

A feed in either RSS 2.0 or Atom 1.0 format.

Variants

Rss2(Rss2Feed)

Atom(AtomFeed)

Implementations

impl Feed

pub async fn from_body(body: Body) -> Result<Feed, FeedParseError>

Parse a feed from a Body by draining a FeedStream. This is the convenience “collect” adapter — fine for the typical “give me the whole document” client / proxy case, but it does buffer every item / entry into memory.

Use FeedStream::from_body directly if you want to process items incrementally (e.g. filter podcast episodes as they stream in, or stop after the first N items).

For defence-in-depth on untrusted feeds, apply a BodyLimit layer upstream — the streaming reader is bounded-memory per item but does not cap the total document size on its own.

pub async fn from_body_strict(body: Body) -> Result<Feed, FeedParseError>

Strict variant of Self::from_body. Collapses the super::FeedCollectError from the underlying FeedStream::collect into just its FeedParseError; if you need the partial feed on a mid-stream error, drain a FeedStream yourself.

pub fn is_rss2(&self) -> bool

Returns true if this is an RSS 2.0 feed.

pub fn is_atom(&self) -> bool

Returns true if this is an Atom feed.

pub fn as_rss2(&self) -> Option<&Rss2Feed>

Returns the inner RSS 2.0 feed, if this is one.

pub fn as_atom(&self) -> Option<&AtomFeed>

Returns the inner Atom feed, if this is one.

pub fn title(&self) -> &str

Feed title (Atom requires; RSS technically requires too — empty if a malformed feed lacks it).

pub fn description(&self) -> Option<&str>

RSS <description> (required) | Atom <subtitle> (optional).

pub fn link(&self) -> Option<&str>

Human-readable home URL of the feed. RSS <link> | Atom <link rel="alternate"> (or first link without rel, since Atom defaults rel to "alternate").

pub fn self_link(&self) -> Option<&str>

Canonical URL of the feed document itself. RSS <atom:link rel="self"> | Atom <link rel="self">.

pub fn id(&self) -> Option<&str>

Atom <id> (required). RSS has no equivalent — always None for RSS.

pub fn language(&self) -> Option<&str>

RSS <language> | Atom currently None (xml:lang on the root isn’t captured yet).

pub fn copyright(&self) -> Option<&str>

RSS <copyright> | Atom <rights>.

pub fn generator(&self) -> Option<&str>

Generator string. RSS <generator> | Atom <generator> value (the uri/version attributes are dropped — use the per-format type to keep them).

pub fn image_url(&self) -> Option<&str>

RSS <image><url> | Atom <logo>.

pub fn icon_url(&self) -> Option<&str>

Atom <icon> | RSS has no equivalent.

pub fn published(&self) -> Option<Timestamp>

RSS <pubDate> | Atom has no feed-level “first published” — None.

pub fn updated(&self) -> Option<Timestamp>

RSS <lastBuildDate> | Atom <updated> (required).

pub fn authors(&self) -> impl Iterator<Item = &str>

Feed-level authors. RSS yields [managingEditor, webMaster] (filtered, in declaration order). Atom yields the <author> Person list (names).

pub fn categories(&self) -> impl Iterator<Item = &str>

Feed-level category names (RSS <category> names / Atom <category> terms).

Trait Implementations

impl Clone for Feed

fn clone(&self) -> Feed

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Feed

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

Formats the value using the given formatter.

impl From<AtomFeed> for Feed

fn from(f: AtomFeed) -> Feed

Converts to this type from the input type.

impl From<Rss2Feed> for Feed

fn from(f: Rss2Feed) -> Feed

Converts to this type from the input type.

impl IntoResponse for Feed

fn into_response(self) -> Response

Create a response.

impl PartialEq for Feed

fn eq(&self, other: &Feed) -> 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 StructuralPartialEq for Feed