superss 0.1.2

RSS parsing with batteries included

superss ====== RSS parsing with batteries included

feedparser is great, but sometimes it doesn’t put things in the same place. superss fixes this by finding all known candidates for urls, content, images, tags, dates, and authors and intelligently picks the best candidate. It also does some other cool things like author parsing with lauteur, url reconciliation with siegfried, and pulling links and images out of the article html.

Another problem with RSS parsing is that feeds sometimes only include a summary of the article. superss can also extract the article’s full text from the page itself using particle and merges this data with the data from the feed.

Finally, some sites don’t even have RSS feeds. In this case we combine pageone and particle to create a feed of articles from article urls on a site’s homepage.

Install

pip install superss

Test

Requires nose. (only currently tests full_text rss feeds.)

nosetests

Usage

Grab full-text feeds:

from superss import SupeRSS

s = SupeRSS('http://feeds.feedburner.com/publici_rss')
for entry in s.run():
  print entry

Grab non-full-text feeds. You must install particle to run this.

from superss import SupeRSS

s = SupeRSS('http://feeds.feedburner.com/publici_rss', is_full_text = False)
for entry in s.run():
  print entry

Experimental: Build a feed from a homepage. You must install pageone and particle to run this.

from superss import SupeRSS

s = SupeRSS(homepage = 'http://nytimes.com/')
for entry in s.run():
  print entry

Optionally pass in a list of urls to ignore. This option is for the purposes of depuplicating when we’re polling a feed on an ongoing basis.

s = SupeRSS('http://feeds.feedburner.com/publici_rss', ignore_urls=[])
for entry in s.run():
  print entry

TODO

• [ ] Add optional concurrency with gevent