= 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

And then:

  $ sudo gem install rfeedparser

Or for the latest development version:

  $ git clone git://github.com/jmhodges/rfeedparser.git
  $ cd rfeedparser
  $ sudo rake setup
  $ rake gem
  $ sudo gem install pkg/rfeedparser-$VERSION.gem

Dependencies on other gems are handled by rubygems, but rfeedparser
works better if it has 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 use
expat (the libxml-parser-ruby1.8 Debian package). In general libxml is
more robust and up-to-date, so you should use it unless you have a
specific reason to use expat.

== 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.

== Todo

- Dependency installation instructions for other platforms.
- Use hoe.
- Publish RDoc; unify README and rubyforge home page.