Expand description
Library for serializing the RSS web content syndication format.
Reading
From a Reader
A channel can be read from any object that implements the BufRead
trait.
use std::fs::File;
use std::io::BufReader;
use rss::Channel;
let file = File::open("example.xml").unwrap();
let channel = Channel::read_from(BufReader::new(file)).unwrap();
From a URL
A channel can also be read from a URL.
Note: This requires enabling the from_url
feature.
ⓘ
use rss::Channel;
let channel = Channel::from_url("http://example.com/feed.xml").unwrap();
Writing
A channel can be written to any object that implements the Write
trait or converted to an
XML string using the ToString
trait.
Note: Writing a channel does not perform any escaping of XML entities.
use rss::Channel;
let channel = Channel::default();
channel.write_to(::std::io::sink()).unwrap(); // write to the channel to a writer
let string = channel.to_string(); // convert the channel to a string
Creation
Builder methods are provided to assist in the creation of channels.
use rss::ChannelBuilder;
let channel = ChannelBuilder::default()
.title("Channel Title")
.link("http://example.com")
.description("An RSS feed.")
.build()
.unwrap();
Validation
Validation methods are provided to validate the contents of a channel against the RSS specification.
Note: This requires enabling the validation
feature.
ⓘ
use rss::Channel;
use rss::validation::Validate;
let channel = Channel::default();
channel.validate().unwrap();
Modules
Types and methods for namespaced extensions.
Structs
Represents a category in an RSS feed.
Builder for
Category
.Represents the channel of an RSS feed.
Builder for
Channel
.Represents a cloud in an RSS feed.
Builder for
Cloud
.Represents an enclosure in an RSS item.
Builder for
Enclosure
.Represents the GUID of an RSS item.
Builder for
Guid
.Represents an image in an RSS feed.
Builder for
Image
.Represents an item in an RSS feed.
Builder for
Item
.Represents the source of an RSS item.
Builder for
Source
.Represents a text input for an RSS channel.
Builder for
TextInput
.Enums
Errors that occur during parsing.