Crate rss_gen

RSS Gen

rss-gen is a comprehensive Rust library for generating, parsing, serializing, and deserializing RSS feeds. It supports multiple RSS versions, providing flexibility for creating and handling feeds across different formats.

Features

• Support for RSS versions 0.90, 0.91, 0.92, 1.0, and 2.0
• Generation of RSS feeds from structured data
• Parsing of existing RSS feeds into structured data
• Serialization and deserialization of RSS data
• Extensible elements for managing standard and optional RSS fields
• Atom link support for modern syndication compatibility
• Image embedding for RSS 2.0 feeds

Examples

Generating an RSS 2.0 feed

use rss_gen::{RssData, RssVersion, generate_rss};

let rss_data = RssData::new(Some(RssVersion::RSS2_0))
    .title("My Rust Blog")
    .link("https://myrustblog.com")
    .description("A blog about Rust programming and tutorials.");

match generate_rss(&rss_data) {
    Ok(rss_feed) => println!("Generated RSS feed: {}", rss_feed),
    Err(e) => eprintln!("Error generating RSS feed: {}", e),
}

Parsing an existing RSS feed

use rss_gen::parse_rss;

let rss_content = r#"
    <?xml version="1.0" encoding="UTF-8"?>
    <rss version="2.0">
        <channel>
            <title>My Rust Blog</title>
            <link>https://myrustblog.com</link>
            <description>A blog about Rust programming and tutorials.</description>
        </channel>
    </rss>
"#;

match parse_rss(rss_content) {
    Ok(parsed_data) => println!("Parsed RSS data: {:?}", parsed_data),
    Err(e) => eprintln!("Error parsing RSS feed: {}", e),
}

Re-exports

• pub use data::RssData;
• pub use data::RssItem;
• pub use data::RssVersion;
• pub use error::Result;
• pub use error::RssError;
• pub use generator::generate_rss;
• pub use parser::parse_rss;

Modules

• data
  Contains the main types and data structures used to represent RSS feeds.
• error
  Defines error types used throughout the library.
• generator
  Implements RSS feed generation functionality.
• macros
  Provides procedural macros for simplifying RSS operations. This module provides macros for generating RSS feeds and setting fields for RSS data.
• parser
  Implements RSS feed parsing functionality.
• validator
  Provides utilities for validating RSS feeds.

Macros

• macro_generate_rss
  Generates an RSS feed from the given RssData struct.
• macro_get_args
  macro_get_args Macro
• macro_metadata_option
  macro_metadata_option Macro
• macro_set_rss_data_fields
  Sets fields of the RssData struct.
• macro_write_element
  Writes an XML element with the given name and content.

Constants

• VERSION
  The current version of the rss-gen crate.

Functions

• quick_rss
  A convenience function to generate a minimal valid RSS 2.0 feed.