Type:
Module
Constants:
CONTENT_PREFIX : 'content'
CONTENT_URI : "http://purl.org/rss/1.0/modules/content/"
DC_PREFIX : 'dc'
DC_URI : "http://purl.org/dc/elements/1.1/"
DublincoreModel : DublinCoreModel

For backward compatibility

IMAGE_PREFIX : 'image'
IMAGE_URI : 'http://purl.org/rss/1.0/modules/image/'
IMAGE_ELEMENTS : []
ITUNES_PREFIX : 'itunes'
ITUNES_URI : 'http://www.itunes.com/dtds/podcast-1.0.dtd'
AVAILABLE_PARSER_LIBRARIES : [ ["rss/xmlparser", :XMLParserParser], ["rss/xmlscanner", :XMLScanParser], ["rss/rexmlparser", :REXMLParser], ]
AVAILABLE_PARSERS : []
VERSION : "0.2.7"
URI : "http://purl.org/rss/1.0/"
DEBUG : false
NotExceptedTagError : NotExpectedTagError

Raised when an unexpected tag is encountered.

UnknownConvertMethod : UnknownConversionMethodError

Raised when an unknown conversion error occurs.

SLASH_PREFIX : 'slash'
SLASH_URI : "http://purl.org/rss/1.0/modules/slash/"
SY_PREFIX : 'sy'
SY_URI : "http://purl.org/rss/1.0/modules/syndication/"
TAXO_PREFIX : "taxo"
TAXO_URI : "http://purl.org/rss/1.0/modules/taxonomy/"
TAXO_ELEMENTS : []
TRACKBACK_PREFIX : 'trackback'
TRACKBACK_URI : 'http://madskills.com/public/xml/rss/module/trackback/'

RSS reading and writing

Really Simple Syndication (RSS) is a family of formats that describe 'feeds,' specially constructed XML documents that allow an interested person to subscribe and receive updates from a particular web service. This portion of the standard library provides tooling to read and create these feeds.

The standard library supports RSS 0.91, 1.0, 2.0, and Atom, a related format. Here are some links to the standards documents for these formats:

Consuming RSS

If you'd like to read someone's RSS feed with your Ruby code, you've come to the right place. It's really easy to do this, but we'll need the help of open-uri:

require 'rss'
require 'open-uri'

url = 'http://www.ruby-lang.org/en/feeds/news.rss'
open(url) do |rss|
  feed = RSS::Parser.parse(rss)
  puts "Title: #{feed.channel.title}"
  feed.items.each do |item|
    puts "Item: #{item.title}"
  end
end

As you can see, the workhorse is RSS::Parser#parse, which takes the source of the feed and a parameter that performs validation on the feed. We get back an object that has all of the data from our feed, accessible through methods. This example shows getting the title out of the channel element, and looping through the list of items.

Producing RSS

Producing our own RSS feeds is easy as well. Let's make a very basic feed:

require "rss"

rss = RSS::Maker.make("atom") do |maker|
  maker.channel.author = "matz"
  maker.channel.updated = Time.now.to_s
  maker.channel.about = "http://www.ruby-lang.org/en/feeds/news.rss"
  maker.channel.title = "Example Feed"

  maker.items.new_item do |item|
    item.link = "http://www.ruby-lang.org/en/news/2010/12/25/ruby-1-9-2-p136-is-released/"
    item.title = "Ruby 1.9.2-p136 is released"
    item.updated = Time.now.to_s
  end
end

puts rss

As you can see, this is a very Builder-like DSL. This code will spit out an Atom feed with one item. If we needed a second item, we'd make another block with maker.items.new_item and build a second one.

Copyright

Copyright © 2003-2007 Kouhei Sutou <kou@cozmixng.org>

You can redistribute it and/or modify it under the same terms as Ruby.

There is an additional tutorial by the author of RSS at: www.cozmixng.org/~rwiki/?cmd=view;name=RSS+Parser%3A%3ATutorial.en

to_feed
  • References/Ruby on Rails/Ruby/Classes/RSS/RSS::Maker/RSS::Maker::ITunesChannelModel/RSS::Maker::ITunesChannelModel::ITunesCategoriesBase/RSS::Maker::ITunesChannelModel::ITunesCategoriesBase::ITunesCategoryBase

to_feed(feed, current) Instance Public methods Also aliased as:

2025-01-10 15:47:30
uri_registered?
  • References/Ruby on Rails/Ruby/Classes/RSS/RSS::BaseListener

uri_registered?(uri, name) Class Public methods test if this uri is registered

2025-01-10 15:47:30
full_name
  • References/Ruby on Rails/Ruby/Classes/RSS/RSS::TrackBackModel20/RSS::TrackBackModel20::TrackBackPing

full_name() Instance Public methods

2025-01-10 15:47:30
validate_for_stream
  • References/Ruby on Rails/Ruby/Classes/RSS/RSS::Element

validate_for_stream(tags, ignore_unknown_element=true) Instance Public methods

2025-01-10 15:47:30
new
  • References/Ruby on Rails/Ruby/Classes/RSS/RSS::Maker/RSS::Maker::RSS092

new(feed_version="0.92") Class Public methods

2025-01-10 15:47:30
full_name
  • References/Ruby on Rails/Ruby/Classes/RSS/RSS::RDF/RSS::RDF::Seq

full_name() Instance Public methods

2025-01-10 15:47:30
inline_other_xml?
  • References/Ruby on Rails/Ruby/Classes/RSS/RSS::Maker/RSS::Maker::ItemsBase/RSS::Maker::ItemsBase::ItemBase/RSS::Maker::ItemsBase::ItemBase::ContentBase

inline_other_xml?() Instance Public methods

2025-01-10 15:47:30
out_of_line?
  • References/Ruby on Rails/Ruby/Classes/RSS/RSS::Atom/RSS::Atom::Feed/RSS::Atom::Feed::Entry/RSS::Atom::Feed::Entry::Content

out_of_line?() Instance Public methods

2025-01-10 15:47:30
raise_for_undefined_entity?
  • References/Ruby on Rails/Ruby/Classes/RSS/RSS::BaseParser

raise_for_undefined_entity?() Class Public methods

2025-01-10 15:47:30
required_prefix
  • References/Ruby on Rails/Ruby/Classes/RSS/RSS::TrackBackModel10/RSS::TrackBackModel10::TrackBackPing

required_prefix() Class Public methods

2025-01-10 15:47:30