Repository files navigation

Atom, RSS and JSON feed parser for Python 3.

Install Atoma with pip:

pip install atoma

Load and parse an Atom XML file:

>>>importatoma>>>feed=atoma.parse_atom_feed('atom-feed.xml')>>>feed.description'The blog relating the daily life of web agency developers'>>>len(feed.items)5

A small change is needed if you are dealing with an RSS XML file:

>>>feed=atoma.parse_rss_feed('rss-feed.xml')

Parsing feeds from the Internet is easy as well:

>>>importatoma,requests>>>response=requests.get('http://lucumr.pocoo.org/feed.atom')>>>feed=atoma.parse_atom_bytes(response.content)>>>feed.title.value"Armin Ronacher's Thoughts and Writings"

• RSS 2.0 -RSS 2.0 Specification
• Atom Syndication Format v1 -RFC4287
• JSON Feed v1 -JSON Feed specification
• OPML 2.0, to share lists of feeds -OPML 2.0
• Typed: feeds decomposed into meaningful Python objects
• Secure: uses defusedxml to load untrusted feeds
• Compatible with Python 3.6+

If you use this library to display content from feeds in a web page, you NEEDto clean the HTML contained in the feeds to preventCross-site scripting (XSS). Thebleach library is recommended for cleaning feeds.

To use this library a basic understanding of feeds is required. For Atom, theIntroduction to Atom is a mustread. TheRFC 4287 can help lift someambiguities. Finally thefeed validator isgreat to test hand-crafted feeds.

For RSS, theRSS specification andrssboard.org have a ton of information andexamples.

For OPML, theOPML specification has a paragraph dedicatedto its usage for syndication

Some seldom used features are not implemented:

• XML signature and encryption
• Some Atom and RSS extensions
• Atom content other thantext,html andxhtml

MIT