{"id":15412244,"url":"https://github.com/robthree/simplefeedreader","last_synced_at":"2025-04-19T04:15:05.293Z","repository":{"id":16097775,"uuid":"18842630","full_name":"RobThree/SimpleFeedReader","owner":"RobThree","description":"Easy to use, simple, Syndication feed reader","archived":false,"fork":false,"pushed_at":"2025-03-07T21:44:24.000Z","size":1853,"stargazers_count":33,"open_issues_count":0,"forks_count":12,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-16T03:55:39.145Z","etag":null,"topics":["atom-feed-parser","c-sharp","dotnet","rss-feed-parser","syndication"],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RobThree.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["RobThree"],"custom":["https://paypal.me/robiii"]}},"created_at":"2014-04-16T14:28:26.000Z","updated_at":"2025-04-15T19:05:57.000Z","dependencies_parsed_at":"2025-04-16T03:33:22.910Z","dependency_job_id":"de6b8537-8efe-45c0-bf99-ad637fa5365c","html_url":"https://github.com/RobThree/SimpleFeedReader","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThree%2FSimpleFeedReader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThree%2FSimpleFeedReader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThree%2FSimpleFeedReader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThree%2FSimpleFeedReader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RobThree","download_url":"https://codeload.github.com/RobThree/SimpleFeedReader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249604083,"owners_count":21298420,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atom-feed-parser","c-sharp","dotnet","rss-feed-parser","syndication"],"created_at":"2024-10-01T16:51:57.184Z","updated_at":"2025-04-19T04:15:05.283Z","avatar_url":"https://github.com/RobThree.png","language":"C#","readme":"#  ![Logo](https://raw.githubusercontent.com/RobThree/SimpleFeedReader/master/SimpleFeedReader/icon.png) SimpleFeedReader\n\nEasy to use, simple, Syndication feed reader (Atom / RSS). Available as [Nuget Package](https://www.nuget.org/packages/SimpleFeedReader/).\n\n## Usage\n\n```c#\nvar reader = new FeedReader();\nvar items = await reader.RetrieveFeedAsync(\"http://www.nytimes.com/services/xml/rss/nyt/International.xml\");\n\nforeach (var i in items)\n    Console.WriteLine($\"{i.Date.ToString(\"g\")}\\t{i.Title}\");\n````\nOutput:\n\n```\n4/16/2014  4:27 AM     Growth Rose 7.4% in First Quarter, China Reports\n4/16/2014 12:29 AM     Milan Court Gives Berlusconi a Year of Community Service\n4/15/2014 12:34 PM     Desalination Plant Said to Be Planned for Thirsty Beijing\n4/15/2014  7:24 PM     After Prank by Dutch Girl on Twitter, Real Trouble\n4/15/2014  4:33 PM     Afghanistan Says NATO Airstrike in East Killed Civilians\n4/16/2014 12:49 AM     Iran Escalates Dispute Over U.N. Envoy\n...\n````\n\n## Notes\n\nBy default the `FeedReader` suppresses exceptions (since feeds tend to go down occasionally, they contain invalid XML from time-to-time and have all other sorts of problems). However, you can tell the `FeedReader` to throw exceptions simply by setting the `throwOnError` argument of the `FeedReader`'s constructor to true.\n\nThe `FeedReader` also accepts an optional `FeedNormalizer` (needs to implement the `IFeedItemNormalizer` interface). This \"normalizer\" can transform or otherwise affect the way [`SyndicationItem`](http://msdn.microsoft.com/en-us/library/system.servicemodel.syndication.syndicationitem.aspx)s are transformed into `FeedItem`s. The `FeedItem` is the basic object retrieved from feeds and, for simplicity, contains only a few simple properties and methods. It has `Title`, `Summary`, `Content`, `Uri` , `PublishDate`, `LastUpdatedDate`, `Images` and `Categories` properties and that's about it. The default `DefaultFeedItemNormalizer` strips and decodes any HTML in the `Title`, `Summary`, `Content` to (try to) reliably return plain text only. The `Date` property will be populated with whatever the `SyndicationItem`'s latest date is: the `PublishDate` or `LastUpdatedTime`.\n\nYou can implement your own `IFeedItemNormalizer` (see the [UnitTest project](https://github.com/RobThree/SimpleFeedReader/tree/master/SimpleFeedReaderTests) for examples) to handle 'normalization' differently to your desire. The `FeedReader` has some convienience methods like `RetrieveFeedsAsync()` that retrieve more than one feed.\n\nThe project is aimed at easy, don't-make-me-think, retrieval of syndication feeds' entries. It is by no means intended as full-fledged feedreader. It is, however, easily extensible for your purposes (again, see the [UnitTest project](https://github.com/RobThree/SimpleFeedReader/tree/master/SimpleFeedReaderTests) for examples; the `ExtendedFeedItem` and `ExtendedFeedItemNormalizer` are nice concrete examples of this idea).\n\n![Build Status](https://img.shields.io/github/actions/workflow/status/RobThree/SimpleFeedReader/test.yml?branch=master\u0026style=flat-square) [![Nuget version](https://img.shields.io/nuget/v/SimpleFeedReader.svg?style=flat-square)](https://www.nuget.org/packages/SimpleFeedReader/)\n","funding_links":["https://github.com/sponsors/RobThree","https://paypal.me/robiii"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobthree%2Fsimplefeedreader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobthree%2Fsimplefeedreader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobthree%2Fsimplefeedreader/lists"}