public
Fork of cradle/feedtools
Description: Feed Tools
Homepage: http://rubyforge.org/projects/feedtools
Clone URL: git://github.com/caironoleto/feedtools.git
caironoleto (author)
Sat Apr 18 10:14:03 -0700 2009
commit  409b24d2203d5100ea3b482f04a2d183429ebb7d
tree    95f29768abb3fa458b30fedde46d626c53865737
parent  3d25d9170a74f587012fd0fefb18a77650807134
name age message
file CHANGELOG Tue Mar 25 17:27:28 -0700 2008 Fixed UTF-8 encoding bug in content [sgeo]
file README Fri Jan 27 12:05:33 -0800 2006 Updated formatting of the README file. [sporkmonger]
directory db/ Tue Jul 25 12:32:46 -0700 2006 Added schema changes, full IRI support, some mo... [sporkmonger]
file feedtools.gemspec Loading commit data...
file install.rb Mon Jan 23 15:33:17 -0800 2006 Initial import. [sporkmonger]
directory lib/
file rakefile Tue Mar 25 16:43:43 -0700 2008 Swapped out HTree for html5lib [sporkmonger]
directory test/ Tue Mar 25 17:27:28 -0700 2008 Fixed UTF-8 encoding bug in content [sgeo]
README
FeedTools was designed to be a simple XML feed parser, generator, and
translator with a built-in caching system.

== Example
  require 'feed_tools'
  
  slashdot_feed = FeedTools::Feed.open('http://www.slashdot.org/index.rss')
  slashdot_feed.title
  => "Slashdot"
  slashdot_feed.description
  => "News for nerds, stuff that matters"
  slashdot_feed.link       
  => "http://slashdot.org/"
  slashdot_feed.items.first.find_node("slash:hitparade/text()").to_s
  => "43,37,28,23,11,3,1"

== Installation
You can install FeedTools as a gem:
  gem install feedtools
  
Or you can install it from the tarball or zip packages on the download page
and then extract it to your vendors directory as you would with any other
Ruby library.
 
After installation, you will either need to run in non-caching mode or set
up a caching mechanism.  The database feed cache system currently included
with FeedTools is the most common caching method.  To set up the database
feed cache, you will first need to create the appropriate database schema.
Schema files for MySQL, PostgreSQL, and SQLite have been included, but the
preferred method of creating the schema within the Rails environment is with
a migration file.  A migration file has been supplied with FeedTools and can
be found in the db directory.  Run
<tt>script/generate migration add_feed_tools_tables</tt> and then copy and
paste the contents of db/migration.rb into your new migration file.