#feed #rss #atom #json #jsonfeed

feed-rs

A unified feed parser that handles Atom, RSS 2.0, RSS 1.0, RSS 0.x and JSON Feed

17 releases (1 stable)

1.0.0 Sep 13, 2021
0.6.1 May 28, 2021
0.6.0 Apr 10, 2021
0.5.1 Feb 6, 2021
0.1.3 Jul 7, 2017

#30 in Parser implementations

Download history 132/week @ 2021-06-06 323/week @ 2021-06-13 169/week @ 2021-06-20 196/week @ 2021-06-27 170/week @ 2021-07-04 200/week @ 2021-07-11 236/week @ 2021-07-18 221/week @ 2021-07-25 213/week @ 2021-08-01 255/week @ 2021-08-08 317/week @ 2021-08-15 209/week @ 2021-08-22 158/week @ 2021-08-29 352/week @ 2021-09-05 336/week @ 2021-09-12 143/week @ 2021-09-19

946 downloads per month
Used in less than 8 crates

MIT license

210KB
3.5K SLoC

feed-rs

Build Status Crates.io Status

Library for parsing various forms of feeds such as Atom, RSS and JSON Feed. It also supports extensions such as iTunes, Dublin Core and Media RSS.

Documentation

Usage

Add the dependency to your Cargo.toml.

[dependencies]
feed-rs = "1.0"

Reading

A feed can be parsed from any object that implements the Read trait.

use feed_rs::parser;
let xml = r#"
<feed>
   <title type="text">sample feed</title>
   <updated>2005-07-31T12:29:29Z</updated>
   <id>feed1</id>
   <entry>
       <title>sample entry</title>
       <id>entry1</id>
   </entry>
</feed>
"#;
let feed = parser::parse(xml.as_bytes()).unwrap();

The parser will automatically detect XML vs. JSON so parsing JSON Feed content works the same way.

use feed_rs::parser;
let json = r#"
{
  "version": "https://jsonfeed.org/version/1",
  "title": "JSON Feed",
  "description": "JSON Feed is a pragmatic syndication format for blogs, microblogs, and other time-based content.",
  "home_page_url": "https://jsonfeed.org/",
  "feed_url": "https://jsonfeed.org/feed.json",
  "author": {
    "name": "Brent Simmons and Manton Reece",
    "url": "https://jsonfeed.org/"
  },
  "items": [
    {
      "title": "Announcing JSON Feed",
      "date_published": "2017-05-17T08:02:12-07:00",
      "id": "https://jsonfeed.org/2017/05/17/announcing_json_feed",
      "url": "https://jsonfeed.org/2017/05/17/announcing_json_feed",
      "content_html": "<p>We — Manton Reece and Brent Simmons — have noticed that JSON...</p>"
    }
  ]
}"#;
let feed = parser::parse(json.as_bytes()).unwrap();

License

MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

Contribution

Any contribution intentionally submitted for inclusion in the work by you, shall be licensed as above, without any additional terms or conditions.

Dependencies

~9.5MB
~279K SLoC