https://github.com/apmem/simple-rss
Library to read and write valid rss
https://github.com/apmem/simple-rss
c-sharp rss-feed rss-generator rss-reader
Last synced: 6 months ago
JSON representation
Library to read and write valid rss
- Host: GitHub
- URL: https://github.com/apmem/simple-rss
- Owner: ApmeM
- License: mit
- Created: 2011-07-18T12:41:46.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2022-10-22T20:41:58.000Z (about 3 years ago)
- Last Synced: 2025-03-27T07:03:47.350Z (10 months ago)
- Topics: c-sharp, rss-feed, rss-generator, rss-reader
- Language: C#
- Homepage:
- Size: 39.1 KB
- Stars: 6
- Watchers: 3
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Simple RSS
## Introduction
Easy to use library to create simple rss feeds and read foreign rss feeds.
All processes are based on XmlSerializer and can be used as an example of how to use XmlSerializer :)
## Usage example
To create rss feed you need to fill necessary fields in `Rss` object and call `RSSHelper.WriteRSS` to any Stream you wish.
MemoryStream ms = new MemoryStream();
Rss rss = GetFullRSS();
RSSHelper.WriteRSS(rss, ms);
var result = Encoding.UTF8.GetString(ms.GetBuffer()).Trim('\0');
Assert.AreEqual(GetFullRSSText(), result);
To read foreign rss feed you need to get stream with rss data and call `RSSHelper.ReadRSS`
var request = WebRequest.Create("http://example.org/rss/");
var response = request.GetResponse();
var stream = response.GetResponseStream();
Rss rss = RSSHelper.ReadRSS(stream);
Assert.AreEqual("Example", rss.Channel.Title);
### RSS object creating example
Complete rss object will looks like this:
return new Rss
{
Channel =
new RssChannel
{
AtomLink = new RssLink { Href = new RssUrl("http://atomlink.com"), Rel = Rel.self, Type = "text/plain" },
Category = "category",
Cloud =
new RssCloud
{
Domain = "domain",
Path = "path",
Port = 1234,
Protocol = Protocol.xmlrpc,
RegisterProcedure = "registerProcedure"
},
Copyright = "copyrignt (c)",
Description = "long description",
Image =
new RssImage
{
Description = "Image Description",
Height = 100,
Width = 100,
Link = new RssUrl("http://image.link.url.com"),
Title = "title",
Url = new RssUrl("http://image.url.com")
},
Language = new CultureInfo("en"),
LastBuildDate = new DateTime(2011, 7, 17, 15, 55, 41),
Link = new RssUrl("http://channel.url.com"),
ManagingEditor = new RssEmail("managingEditor@mail.com (manager)"),
PubDate = new DateTime(2011, 7, 17, 15, 55, 41),
Rating = "rating",
SkipDays = new List { Day.Thursday, Day.Wednesday },
SkipHours = new List { new Hour(22), new Hour(15), new Hour(4) },
TextInput =
new RssTextInput
{
Description = "text input desctiption",
Link = new RssUrl("http://text.input.link.com"),
Name = "text input name",
Title = "text input title"
},
Title = "channel title",
TTL = 10,
WebMaster = new RssEmail("webmaster@mail.ru (webmaster)"),
Item =
new List
{
new RssItem
{
Author = new RssEmail("item.author@mail.ru (author)"),
Category =
new RssCategory
{
Domain = "category domain value",
Text = "category text value"
},
Comments = new RssUrl("http://rss.item.comment.url.com"),
Description = "item description",
Enclosure =
new RssEnclosure
{
Length = 1234,
Type = "text/plain",
Url = new RssUrl("http://rss.item.enclosure.type.url.com")
},
Link = new RssUrl("http://rss.item.link.url.com"),
PubDate = new DateTime(2011, 7, 17, 15, 55, 41),
Title = "item title",
Guid = new RssGuid { IsPermaLink = false, Value = "guid value" },
Source = new RssSource { Url = new RssUrl("http://rss.item.source.url.com") }
}
}
}
};
## Features
Resulted rss are valid for w3c rss validator located at http://validator.w3.org/feed/