1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
//! Parses web feeds according to the RSS and Atom specifications and constructs
//! [`Blog`]s and [`Post`](crate::blog::Post)s.
use quick_xml::de::from_str;
use crate::blog::Blog;
use self::{atom::AtomFeed, error::ParserError, rss::RssFeed, traits::WebFeed};
pub mod atom;
pub mod error;
pub mod rss;
mod traits;
/// Turns an XML feed into a `Blog` if possible.
///
/// First tries to parse it into an [`RssFeed`]. If that fails,
/// it then tries to parse it into an [`AtomFeed`]. If both fail,
/// the error is set to `Error1. Error2`.
pub fn parse_web_feed(xml: &str) -> Result<Blog, ParserError> {
from_str::<RssFeed>(xml).into_blog().or_else(|e1| {
from_str::<AtomFeed>(xml)
.into_blog()
.map_err(|e2| ParserError::Parse(format!("{e1}\n{e2}")))
})
}
/// Limits the description to the amount of specified characters
/// and postpends `...`.
fn limit_description(desc: &str, limit: usize) -> String {
let mut res = desc.chars().take(limit).collect::<String>();
if desc.chars().count() >= limit {
res += "...";
}
res
}