jgre-rfeedparser

= Universal Feed Parser http://rfeedparser.rubyforge.org Original Python code Copyright (c) 2002-5 by Mark Pilgrim Ruby port by Jeff Hodges.

== Description

Parse nearly any RSS and Atom feeds in Ruby. 3000 unit tests. Open source.

== Installation

For Debian-based systems:

$ sudo apt-get install libxml-ruby1.8 # or libxml-parser-ruby1.8

TODO: dependency installation instructions for other platforms.

And then:

$ sudo gem install rfeedparser

Or for the latest development version:

$ git clone git://github.com/technomancy/rfeedparser.git

Dependencies on other gems are handled by rubygems, but rfeedparser also relies on having bindings to a native XML parsing library. The recommended choice is libxml, which is installable with the libxml-ruby1.8 package in Debian-based systems. But it can also fall back to expat (the libxml-parser-ruby1.8 Debian package) if libxml is not installed.

== Usage

require 'rubygems' # may omit if installed manually require 'rfeedparser'

feed = FeedParser.parse("some-feed-stream-filepath-or-url")

feed.entries.each do |e| puts e.title puts e.content puts e.published puts '----' end

== Contributing

Clone the git repository at git://github.com/jmhodges/rfeedparser.git and which has a webpage at http://github.com/jmhodges/rfeedparser/tree/master.