ExampleCode

Building

Building entries and feeds is simple:

#!ruby
require "atom/feed"

e = Atom::Entry.new
e.title = "a new entry"

e.content = "some <em>boring</em> HTML"
e.content.type = "html"

e.categories.new :term => "Test Entry"

feed = Atom::Feed.new

feed << e
feed.to_s
# => "<feed xmlns='http://www.w3.org/2005/Atom'><entry><title>a new entry</title><content type='html'>some &lt;em&gt;boring&lt;/em&gt; HTML</content><category term='Test Entry'/></entry></feed>"

atom-tools won’t complain if you’ve forgotten to include all the bits you need, so you should run the final product through the Feed Validator before you publish.

Parsing

#!ruby
require "atom/feed"

f = Atom::Feed.new("http://www.tbray.org/ongoing/ongoing.atom")

f.entries
# => []

f.update!
f.entries
# => [#<Atom::Entry>, ...]

f.entries.first.title.to_s
# => "Tag Scheme?"

More Complex Things

• Simon Rozet has written several simple Atom Publishing Protocol servers
• atom-tools/bin/atom-cp — an Atom Publishing Protocol client that can copy entries from one feed to another
• VoxApi — faking the Atom API
• HtmlToXhtml — convert @type=‘html’ to @type=‘xhtml’