facebook_wall 1.0.0

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+
+.DS_Store
+doc/

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in facebook_wall.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,66 @@
+= facebook_wall
+
+facebook_wall is a very simple library that fetches the latest wall-posts for a Facebook page without having to log in -
+wall posts are taken from the page's RSS feed.  The markup in posts is filtered to help ensure standards-compliance and
+prevent errors when inserted into your own Web pages.
+
+== Requirements
+
+facebook_wall was written and tested on Ruby 1.9.2 but is likely to work on other versions.  It requires no 3rd-party
+libraries - it uses the open-uri and RSS libs from the Standard Library.
+
+== Installation
+
+Using Bundler:
+
+  gem 'facebook_wall'
+
+or:
+
+  gem 'facebook_wall', :git => 'git://github.com/archaichorizon/ruby-facebook-wall.git'
+
+== Usage
+
+The following example prints the latest wall-post from
+{Archaic Horizon's Facebook page}[http://www.facebook.com/archaichorizon].
+
+  require 'facebook_wall'
+
+  facebook_wall_posts = FacebookWall::posts_by 260041833284
+  latest_wall_post = facebook_wall_posts.first
+
+  puts latest_wall_post.description
+
+<tt>FacebookWall::posts_by</tt> returns an <tt>Array</tt> containing instances of <tt>FacebookWall::Post</tt>.
+<tt>FacebookWall::Post</tt> decorates <tt>RSS::Rss::Channel::Item</tt>, which means you can easily access all
+sub-elements of <tt>item</tt>s published in a page's feed.
+For example:
+
+  post.title        # => A title automatically generated by Facebook
+  post.link         # => The URL of the wall post
+  post.description  # => The content of the wall post
+  post.pubDate      # => The date the post was published
+  post.author       # => The author of the post
+
+== Filters
+
+The library applies two filters to each item in the feed:
+
+* <tt>FacebookWall::FeedEntryFilters::LinkRewriter</tt> completely rewrites HTML links in items, removing superfluous
+  attributes added by Facebook.
+* <tt>FacebookWall::FeedEntryFilters::Paragraphizer</tt> wraps 'plain' paragraphs with <tt>P</tt> tags to create
+  semantically-correct HTML.
+
+You can insert your own filters into the chain by adding subclasses of
+<tt>FacebookWall::FeedEntryFilters::FeedEntryFilter</tt> to the <tt>FacebookWall::FeedEntryFilters</tt> module.  The
+following filter, for example, would append the word "foo" to the description of each item.
+
+  module FacebookWall
+    module FeedEntryFilters
+      class CustomFilter < FeedEntryFilter
+        def apply!(feed_entry)
+          feed_entry.description << 'foo'
+        end
+      end
+    end
+  end

data/Rakefile

@@ -0,0 +1,18 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+task :default => :test
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = Dir.glob("#{File.dirname(__FILE__)}/test/**/*_test.rb").sort
+  t.warning = true
+  t.verbose = true
+end
+
+Rake::RDocTask.new do |rd|
+  rd.main = 'README.rdoc'
+  rd.rdoc_files.include 'README.rdoc', 'lib/**/*.rb'
+  rd.rdoc_dir = 'doc'
+end

data/facebook_wall.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "facebook_wall/version"
+
+Gem::Specification.new do |s|
+  s.name        = "facebook_wall"
+  s.version     = FacebookWall::VERSION
+  s.authors     = ["Dan Bettles"]
+  s.email       = ["dan@archaichorizon.com"]
+  s.homepage    = "http://www.archaichorizon.com/"
+  s.summary     = %q{facebook_wall is a very simple library that fetches the latest wall-posts for a Facebook page without having to log in - wall posts are taken from the page's RSS feed.}
+  s.description = %q{facebook_wall is a very simple library that fetches the latest wall-posts for a Facebook page without having to log in - wall posts are taken from the page's RSS feed.  The markup in posts is filtered to help ensure standards-compliance and prevent errors when inserted into your own Web pages.}
+
+  s.rubyforge_project = "facebook_wall"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  #s.add_runtime_dependency 'feedzirra', '~> 0.1.3'
+end

data/lib/facebook_wall.rb

@@ -0,0 +1,12 @@
+require 'open-uri'
+require 'rss/2.0'
+
+require 'facebook_wall/std_lib_ext'
+require 'facebook_wall/version'
+require 'facebook_wall/methods'
+require 'facebook_wall/post'
+require 'facebook_wall/feed_entry_filters/feed_entry_filter'
+require 'facebook_wall/feed_entry_filters/paragraphizer'
+require 'facebook_wall/feed_entry_filters/link_rewriter'
+require 'facebook_wall/feed_entry_filters/chain'
+require 'facebook_wall/factories/methods'

data/lib/facebook_wall/factories/methods.rb

@@ -0,0 +1,34 @@
+module FacebookWall
+  module Factories
+    #Creates a filter chain containing instances of all feed-entry filters (subclasses of
+    #FacebookWall::FeedEntryFilters::FeedEntryFilter) in FacebookWall::FeedEntryFilters.
+    #=== Returns
+    #FacebookWall::FeedEntryFilters::Chain
+    def self.create_feed_entry_filter_chain
+      feed_entry_filters_module = FacebookWall::FeedEntryFilters
+
+      chain = feed_entry_filters_module::Chain.new
+
+      feed_entry_filters_module.constants.each do |name|
+        constant = feed_entry_filters_module.const_get name
+        chain << constant.new if constant < feed_entry_filters_module::FeedEntryFilter
+      end
+
+      chain
+    end
+
+    #Creates wall posts from the <tt>item</tt>s in the specified RSS feed.
+    #=== Parameters
+    #[feed - RSS::Rss] A RSS feed
+    #[feed_entry_filter_chain - FacebookWall::FeedEntryFilters::Chain] A filter chain
+    #=== Returns
+    #Array of FacebookWall::Post objects
+    def self.create_posts(feed, feed_entry_filter_chain)
+      feed.items.collect do |entry|
+        entry_clone = entry.clone  #TODO Remove this?
+        feed_entry_filter_chain.apply_filters_to! entry_clone
+        FacebookWall::Post.new entry_clone
+      end
+    end
+  end
+end

data/lib/facebook_wall/feed_entry_filters/chain.rb

@@ -0,0 +1,14 @@
+module FacebookWall
+  module FeedEntryFilters
+    class Chain < Array
+      #Applies the filters in the chain to the specified RSS item.
+      #=== Parameters
+      #[feed_entry - RSS::Rss::Channel::Item] A RSS item 
+      def apply_filters_to!(feed_entry)
+        each do |feed_entry_filter|
+          feed_entry_filter.apply! feed_entry
+        end
+      end
+    end
+  end
+end

data/lib/facebook_wall/feed_entry_filters/feed_entry_filter.rb

@@ -0,0 +1,10 @@
+module FacebookWall
+  module FeedEntryFilters
+    class FeedEntryFilter
+      #Applies the filter to the specified RSS item.  This method should be overridden in subclasses.
+      #=== Parameters
+      #[feed_entry - RSS::Rss::Channel::Item] A RSS item 
+      def apply!(feed_entry); end
+    end
+  end
+end

data/lib/facebook_wall/feed_entry_filters/link_rewriter.rb

@@ -0,0 +1,16 @@
+module FacebookWall
+  module FeedEntryFilters
+    #Completely rewrites HTML links in <tt>item</tt>s, removing superfluous attributes added by Facebook.  For example,
+    #  <a href="http://example.com" target="_blank" onmousedown="doSomething()" rel="nofollow" id="link">example.com</a>
+    #would be replaced with: 
+    #  <a href="http://example.com">example.com</a>
+    class LinkRewriter < FeedEntryFilter
+      def apply!(feed_entry)
+        feed_entry.description.scan(/<a\s+[^>]+>/).each do |link_tag|
+          href_matches = link_tag.match(/\s+(href="[^"]*")/)
+          feed_entry.description.gsub! link_tag, "<a #{href_matches[1]}>" if href_matches
+        end
+      end
+    end
+  end
+end

data/lib/facebook_wall/feed_entry_filters/paragraphizer.rb

@@ -0,0 +1,21 @@
+module FacebookWall
+  module FeedEntryFilters
+    #Builds HTML paragraphs from groups of text separated by multiple +BR+ tags.  For example:
+    #  First paragraph<br /> <br /> Second paragraph<br/><br/><br/>Something inserted<br/>by Facebook
+    #would be replaced with:
+    #  <p>First paragraph</p><p>Second paragraph</p><p>Something inserted<br/>by Facebook</p>
+    class Paragraphizer < FeedEntryFilter
+      def apply!(feed_entry)
+        plain_paragraphs = Paragraphizer.normalize_line_breaks(feed_entry.description).split(/(?:<br\/>\s*){2,}/)
+        paragraphized = plain_paragraphs.collect{|plain_paragraph| "<p>#{plain_paragraph}</p>"}.join
+        feed_entry.description = paragraphized
+      end
+
+      private
+  
+      def self.normalize_line_breaks(str)
+        str.gsub(/<br\s*\/>/, '<br/>')
+      end
+    end
+  end
+end

data/lib/facebook_wall/methods.rb

@@ -0,0 +1,21 @@
+module FacebookWall
+  #Returns the URL of the RSS feed for the specified Facebook page's wall.
+  #=== Parameters
+  #[id - Fixnum] The ID of the Facebook page
+  #=== Returns
+  #String
+  def self.feed_url(id)
+    "http://www.facebook.com/feeds/page.php?id=#{id.to_s}&format=rss20"
+  end
+
+  #Returns the most recent posts from the specified Facebook page's wall.
+  #=== Parameters
+  #[id - Fixnum] The ID of the Facebook page
+  #=== Returns
+  #Array of FacebookWall::Post objects
+  def self.posts_by(id)
+    feed = RSS::Parser.fetch_and_parse feed_url id
+    feed_entry_filter_chain = Factories::create_feed_entry_filter_chain
+    Factories::create_posts feed, feed_entry_filter_chain 
+  end
+end

data/lib/facebook_wall/post.rb

@@ -0,0 +1,23 @@
+module FacebookWall
+  #A Facebook wall post.
+  #
+  #FacebookWall::Post decorates RSS::Rss::Channel::Item, which means you can easily access all sub-elements of
+  #<tt>item</tt>s published in a page's feed.  For example:
+  #
+  #  post.title        # => A title automatically generated by Facebook
+  #  post.link         # => The URL of the wall post
+  #  post.description  # => The content of the wall post
+  #  post.pubDate      # => The date the post was published
+  #  post.author       # => The author of the post
+  class Post
+    attr_reader :feed_entry
+
+    def initialize(feed_entry)
+      @feed_entry = feed_entry
+    end
+
+    def method_missing(method_id)  #:nodoc:
+      feed_entry.send method_id.id2name
+    end
+  end
+end

data/lib/facebook_wall/std_lib_ext.rb

@@ -0,0 +1 @@
+require 'facebook_wall/std_lib_ext/rss/parser'

data/lib/facebook_wall/std_lib_ext/rss/parser.rb

@@ -0,0 +1,15 @@
+#TODO Blog post
+module RSS
+  class Parser
+    #Fetches, and then parses, the RSS feed at the specified URL
+    #=== Parameters
+    #[url - String] The URL of the RSS feed
+    #=== Returns
+    #RSS::Rss
+    def self.fetch_and_parse(url)
+      open url do |http|
+        RSS::Parser.parse http.read
+      end
+    end
+  end
+end

data/lib/facebook_wall/version.rb

@@ -0,0 +1,3 @@
+module FacebookWall
+  VERSION = "1.0.0"
+end

data/test/abstract_unit.rb

@@ -0,0 +1,33 @@
+require 'test/unit'
+
+lib = File.expand_path("#{File.dirname(__FILE__)}/../../lib")
+$:.unshift(lib) unless $:.include?('lib') || $:.include?(lib)
+
+require 'facebook_wall'
+
+def create_feed(xml)
+  RSS::Parser.parse xml
+end
+
+def create_feed_entry(attributes = {})
+  feed_entry = RSS::Rss::Channel::Item.new
+
+  attributes.each do |name, value|
+    feed_entry.send("#{name}=", value)
+  end
+
+  feed_entry
+end
+
+module FacebookWall
+  class Post
+    def eql?(other)
+      #This will hold for as long as the feed entry is the only source of data
+      other.instance_of?(self.class) && feed_entry.to_s.eql?(other.feed_entry.to_s)
+    end
+  end
+end
+
+def create_post(attributes)
+  FacebookWall::Post.new create_feed_entry(attributes)
+end

data/test/facebook_wall_test.rb

@@ -0,0 +1,14 @@
+require 'abstract_unit'
+
+class FacebookWallTest < Test::Unit::TestCase
+  def test_feed_url_returns_the_url_of_the_wall_feed_for_the_specified_page
+    assert_equal 'http://www.facebook.com/feeds/page.php?id=260041833284&format=rss20', FacebookWall::feed_url(260041833284)
+  end
+
+  def test_posts_returns_an_array_of_posts
+    posts = FacebookWall::posts_by 260041833284
+    assert posts.instance_of?(Array)
+    assert posts.length > 0
+    assert posts.first.instance_of?(FacebookWall::Post)
+  end
+end

data/test/factories/factories_test.rb

@@ -0,0 +1,112 @@
+require 'abstract_unit'
+
+class FactoriesTest < Test::Unit::TestCase
+  def test_create_feed_entry_filter_chain_creates_a_chain_containing_all_filters_in_the_feed_entry_filters_module
+    feed_entry_filters_module = FacebookWall::FeedEntryFilters
+
+    feed_entry_filter_chain = FacebookWall::Factories::create_feed_entry_filter_chain
+
+    assert feed_entry_filter_chain.instance_of?(feed_entry_filters_module::Chain)
+    assert_equal 2, feed_entry_filter_chain.length
+
+    expected_classes = [feed_entry_filters_module::Paragraphizer, feed_entry_filters_module::LinkRewriter]
+
+    feed_entry_filter_chain.each{|feed_entry_filter| assert expected_classes.include?(feed_entry_filter.class)}
+  end
+
+  def test_create_posts_creates_an_array_containing_posts
+    feed_xml = <<END
+<?xml version="1.0" encoding="utf-8"?>
+<rss version="2.0">
+  <channel>
+    <title>Channel title</title>
+    <link>http://example.com/</link>
+    <description>Channel description</description>
+    <item>
+      <title><![CDATA[Item 1 title]]></title>
+      <link>http://example.com/blog_posts/1</link>
+      <description><![CDATA[Item 1 description]]></description>
+    </item>
+    <item>
+      <title><![CDATA[Item 2 title]]></title>
+      <link>http://example.com/blog_posts/2</link>
+      <description><![CDATA[Item 2 description]]></description>
+    </item>
+  </channel>
+</rss>
+END
+
+    feed = create_feed feed_xml
+    feed_entry_filter_chain = FacebookWall::FeedEntryFilters::Chain.new
+    posts = FacebookWall::Factories::create_posts feed, feed_entry_filter_chain
+
+    assert posts.instance_of?(Array)
+    assert_equal 2, posts.length
+    posts.each{|post| assert post.instance_of?(FacebookWall::Post)}
+
+    assert posts.first.eql?(create_post('title' => 'Item 1 title', 'link' => 'http://example.com/blog_posts/1', 'description' => 'Item 1 description'))
+    assert posts.last.eql?(create_post('title' => 'Item 2 title', 'link' => 'http://example.com/blog_posts/2', 'description' => 'Item 2 description'))
+
+    feed = create_feed feed_xml
+    feed_entry_filter_chain = FacebookWall::FeedEntryFilters::Chain.new
+    feed_entry_filter_chain << FactoriesTestDoubles::FeedEntryFilter01.new()
+    feed_entry_filter_chain << FactoriesTestDoubles::FeedEntryFilter02.new()
+    posts = FacebookWall::Factories::create_posts feed, feed_entry_filter_chain
+
+    assert posts.instance_of?(Array)
+    assert_equal 2, posts.length
+    posts.each{|post| assert post.instance_of?(FacebookWall::Post)}
+
+    assert posts.first.eql?(create_post('title' => 'Item 1 title', 'link' => 'http://example.com/blog_posts/1', 'description' => 'Item 1 description foo bar'))
+    assert posts.last.eql?(create_post('title' => 'Item 2 title', 'link' => 'http://example.com/blog_posts/2', 'description' => 'Item 2 description foo bar'))
+
+    feed_xml = <<END
+<?xml version="1.0" encoding="utf-8"?>
+<rss version="2.0">
+  <channel>
+    <title>Archaic Horizon&apos;s Facebook Wall</title>
+    <link>http://www.facebook.com/</link>
+    <description>Archaic Horizon&apos;s Facebook Wall</description>
+    <item>
+      <title><![CDATA[ More of Jeremy Morgan&#039;s work here: http://jphmorgan.com]]></title>
+      <link>http://www.facebook.com/archaichorizon/posts/262512677162510</link>
+      <description><![CDATA[More of Jeremy Morgan&#039;s work here: <a href="http://jphmorgan.com/" target="_blank" rel="nofollow nofollow" onmousedown="UntrustedLink.bootstrap($(this), &quot;4AQEEBrT_&quot;, event, bagof(&#123;&#125;));">http://jphmorgan.com/</a><br/><br/><a href="http://27.media.tumblr.com/tumblr_m09mfxU8kE1qdrgo9o9_r8_500.jpg" id="" title="" target="" onclick="" style="" onmousedown="UntrustedLink.bootstrap($(this), &quot;PAQGoceG_&quot;, event, bagof(&#123;&#125;));" rel="nofollow"><img class="img" src="http://external.ak.fbcdn.net/safe_image.php?d=AQDzaFjOqqk40sEl&amp;w=90&amp;h=90&amp;url=http%3A%2F%2F27.media.tumblr.com%2Ftumblr_m09mfxU8kE1qdrgo9o9_r8_500.jpg" alt="" /></a><br/><a href="http://27.media.tumblr.com/tumblr_m09mfxU8kE1qdrgo9o9_r8_500.jpg" id="" target="_blank" style="" onmousedown="UntrustedLink.bootstrap($(this), &quot;eAQE2srCn&quot;, event, bagof(&#123;&#125;));" rel="nofollow"><a href="http://27.media.tumblr.com/tumblr_m09mfxU8kE1qdrgo9o9_r8_500.jpg" target="_blank" rel="nofollow nofollow" onmousedown="UntrustedLink.bootstrap($(this), &quot;yAQFp-Snl&quot;, event, bagof(&#123;&#125;));">http://27.media.tumblr.com/tumblr_m09mfxU8kE1qdrgo9o9_r8_500.jpg</a></a><br/>27.media.tumblr.com]]></description>
+    </item>
+    <item>
+      <title><![CDATA[ A generative ambient sound instrument created by Batuhan Bozkurt, a sound artist...]]></title>
+      <link>http://www.facebook.com/archaichorizon/posts/377150222297415</link>
+      <description><![CDATA[A generative ambient sound instrument created by Batuhan Bozkurt, a sound artist, computer programmer, performer and overall a curious person currently living in Istanbul, Turkey.<br /> <br /> <a href="http://www.earslap.com/projectslab/circuli?q=2608v4564v1o_2o66564k1k7_2o4o063442262o" target="_blank" rel="nofollow nofollow" onmousedown="UntrustedLink.bootstrap($(this), &quot;CAQHV5LbD&quot;, event, bagof(&#123;&#125;));">http://www.earslap.com/projectslab/circuli?q=2608v4564v1o_2o66564k1k7_2o4o063442262o</a><br/><br/><br/><a href="http://www.earslap.com/projectslab/circuli?q=2608v4564v1o_2o66564k1k7_2o4o063442262o" id="" target="_blank" style="" onmousedown="UntrustedLink.bootstrap($(this), &quot;mAQGmvWic&quot;, event, bagof(&#123;&#125;));" rel="nofollow">Circuli</a><br/>www.earslap.com]]></description>
+    </item>
+  </channel>
+</rss>
+END
+
+    feed = create_feed feed_xml
+    feed_entry_filter_chain = FacebookWall::Factories::create_feed_entry_filter_chain
+    posts = FacebookWall::Factories::create_posts feed, feed_entry_filter_chain
+
+    assert_equal(
+      '<p>More of Jeremy Morgan&#039;s work here: <a href="http://jphmorgan.com/">http://jphmorgan.com/</a></p><p><a href="http://27.media.tumblr.com/tumblr_m09mfxU8kE1qdrgo9o9_r8_500.jpg"><img class="img" src="http://external.ak.fbcdn.net/safe_image.php?d=AQDzaFjOqqk40sEl&amp;w=90&amp;h=90&amp;url=http%3A%2F%2F27.media.tumblr.com%2Ftumblr_m09mfxU8kE1qdrgo9o9_r8_500.jpg" alt="" /></a><br/><a href="http://27.media.tumblr.com/tumblr_m09mfxU8kE1qdrgo9o9_r8_500.jpg"><a href="http://27.media.tumblr.com/tumblr_m09mfxU8kE1qdrgo9o9_r8_500.jpg">http://27.media.tumblr.com/tumblr_m09mfxU8kE1qdrgo9o9_r8_500.jpg</a></a><br/>27.media.tumblr.com</p>',
+      posts.first.description
+    )
+
+    assert_equal(
+      '<p>A generative ambient sound instrument created by Batuhan Bozkurt, a sound artist, computer programmer, performer and overall a curious person currently living in Istanbul, Turkey.</p><p><a href="http://www.earslap.com/projectslab/circuli?q=2608v4564v1o_2o66564k1k7_2o4o063442262o">http://www.earslap.com/projectslab/circuli?q=2608v4564v1o_2o66564k1k7_2o4o063442262o</a></p><p><a href="http://www.earslap.com/projectslab/circuli?q=2608v4564v1o_2o66564k1k7_2o4o063442262o">Circuli</a><br/>www.earslap.com</p>',
+      posts.last.description
+    )
+  end
+end
+
+module FactoriesTestDoubles
+  class FeedEntryFilter01 < FacebookWall::FeedEntryFilters::FeedEntryFilter
+    def apply!(feed_entry)
+      feed_entry.description << ' foo'
+    end
+  end
+  
+  class FeedEntryFilter02 < FacebookWall::FeedEntryFilters::FeedEntryFilter
+    def apply!(feed_entry)
+      feed_entry.description << ' bar'
+    end
+  end
+end

data/test/feed_entry_filters/chain_test.rb

@@ -0,0 +1,38 @@
+require 'abstract_unit'
+
+class ChainTest < Test::Unit::TestCase
+  def test_is_an_array
+    assert FacebookWall::FeedEntryFilters::Chain < Array
+  end
+
+  def test_apply_filters_to_applies_the_filters_to_the_specified_feed_entry
+    feed_entry_filter_chain = FacebookWall::FeedEntryFilters::Chain.new
+    feed_entry = create_feed_entry 'description' => 'Description'
+    feed_entry_filter_chain.apply_filters_to! feed_entry
+
+    assert_equal 'Description', feed_entry.description
+
+    feed_entry_filter_chain = FacebookWall::FeedEntryFilters::Chain.new
+    feed_entry_filter_chain << ChainTestDoubles::FeedEntryFilter01.new
+    feed_entry_filter_chain << ChainTestDoubles::FeedEntryFilter02.new
+    feed_entry = create_feed_entry 'description' => 'Description'
+    feed_entry_filter_chain.apply_filters_to! feed_entry
+
+    assert_equal 'Description foo bar', feed_entry.description
+  end
+end
+
+#TODO Blog post
+module ChainTestDoubles
+  class FeedEntryFilter01 < FacebookWall::FeedEntryFilters::FeedEntryFilter
+    def apply!(feed_entry)
+      feed_entry.description << ' foo'
+    end
+  end
+  
+  class FeedEntryFilter02 < FacebookWall::FeedEntryFilters::FeedEntryFilter
+    def apply!(feed_entry)
+      feed_entry.description << ' bar'
+    end
+  end
+end

data/test/feed_entry_filters/feed_entry_filter_test.rb

@@ -0,0 +1,7 @@
+require 'abstract_unit'
+
+class FeedEntryFilterTest < Test::Unit::TestCase
+  def test_has_an_instance_method_called_apply
+    assert FacebookWall::FeedEntryFilters::FeedEntryFilter.new.respond_to?(:apply!)
+  end
+end

data/test/feed_entry_filters/link_rewriter_test.rb

@@ -0,0 +1,20 @@
+require 'abstract_unit'
+
+class LinkRewriterTest < Test::Unit::TestCase
+  def test_is_a_feed_entry_filter
+    assert FacebookWall::FeedEntryFilters::LinkRewriter < FacebookWall::FeedEntryFilters::FeedEntryFilter
+  end
+
+  def test_apply_rewrites_links_in_the_description_in_the_feed_entry
+    expected_description = '<a href="http://example.com">example.com</a>'
+  
+    feed_entry = create_feed_entry(
+      'description' => '<a href="http://example.com" target="_blank" onmousedown="doSomething()" rel="nofollow" id="link">example.com</a>'
+    )
+  
+    link_rewriter = FacebookWall::FeedEntryFilters::LinkRewriter.new
+    link_rewriter.apply! feed_entry
+
+    assert_equal expected_description, feed_entry.description
+  end
+end

data/test/feed_entry_filters/paragraphizer_test.rb

@@ -0,0 +1,20 @@
+require 'abstract_unit'
+
+class ParagraphizerTest < Test::Unit::TestCase
+  def test_is_a_feed_entry_filter
+    assert FacebookWall::FeedEntryFilters::Paragraphizer < FacebookWall::FeedEntryFilters::FeedEntryFilter
+  end
+
+  def test_apply_paragraphizes_the_description_in_the_feed_entry
+    expected_description = '<p>First paragraph</p><p>Second paragraph</p><p>Something inserted<br/>by Facebook</p>'
+
+    rss_entry = create_feed_entry(
+      'description' => 'First paragraph<br /> <br /> Second paragraph<br/><br/><br/>Something inserted<br/>by Facebook'
+    )
+
+    paragraphizer = FacebookWall::FeedEntryFilters::Paragraphizer.new
+    paragraphizer.apply! rss_entry
+
+    assert_equal expected_description, rss_entry.description
+  end
+end

data/test/post_test.rb

@@ -0,0 +1,39 @@
+require 'abstract_unit'
+
+class PostTest < Test::Unit::TestCase
+  def test_is_initialized_with_a_feed_entry
+    feed_entry = create_feed_entry
+    post = FacebookWall::Post.new feed_entry
+
+    assert_same feed_entry, post.feed_entry
+  end
+
+  def test_decorates_the_feed_entry
+    feed_entry = create_feed_entry 'title' => 'Foo', 'description' => 'Bar baz bip'
+    post = FacebookWall::Post.new feed_entry
+
+    assert_same feed_entry.title, post.title
+    assert_same feed_entry.description, post.description
+  end
+
+  #eql?() is added, for testing purposes only, by abstract_unit
+  def test_eql_returns_true_if_the_specified_object_is_a_post_with_the_same_value
+    attributes = {'title' => 'Item 1 title', 'link' => 'http://example.com/blog_posts/1', 'description' => 'Item 1 description'}
+
+    post = FacebookWall::Post.new create_feed_entry(attributes)
+    another_post = FacebookWall::Post.new create_feed_entry(attributes)
+
+    assert post.eql?(another_post)
+
+    almost_a_feed_entry = "<item>\n  <title>Item 1 title</title>\n  <link>http://example.com/blog_posts/1</link>\n  <description>Item 1 description</description>\n</item>"
+    post = FacebookWall::Post.new create_feed_entry(attributes)
+    
+    assert_equal almost_a_feed_entry, post.feed_entry.to_s
+    assert ! post.eql?(almost_a_feed_entry)
+    
+    not_a_post = 123
+    post = FacebookWall::Post.new create_feed_entry(attributes)
+    
+    assert ! post.eql?(not_a_post)
+  end
+end

data/test/std_lib_ext/rss/parser_test.rb

@@ -0,0 +1,9 @@
+require 'abstract_unit'
+
+class ParserTest < Test::Unit::TestCase
+  def test_fetch_and_parse_fetches_and_parses_the_feed_at_the_specified_url
+    feed = RSS::Parser.fetch_and_parse 'http://www.facebook.com/feeds/page.php?id=260041833284&format=rss20'
+    assert feed.instance_of?(RSS::Rss)
+    assert feed.items.length > 0
+  end
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification
+name: facebook_wall
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Dan Bettles
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-20 00:00:00.000000000Z
+dependencies: []
+description: facebook_wall is a very simple library that fetches the latest wall-posts
+  for a Facebook page without having to log in - wall posts are taken from the page's
+  RSS feed.  The markup in posts is filtered to help ensure standards-compliance and
+  prevent errors when inserted into your own Web pages.
+email:
+- dan@archaichorizon.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- facebook_wall.gemspec
+- lib/facebook_wall.rb
+- lib/facebook_wall/factories/methods.rb
+- lib/facebook_wall/feed_entry_filters/chain.rb
+- lib/facebook_wall/feed_entry_filters/feed_entry_filter.rb
+- lib/facebook_wall/feed_entry_filters/link_rewriter.rb
+- lib/facebook_wall/feed_entry_filters/paragraphizer.rb
+- lib/facebook_wall/methods.rb
+- lib/facebook_wall/post.rb
+- lib/facebook_wall/std_lib_ext.rb
+- lib/facebook_wall/std_lib_ext/rss/parser.rb
+- lib/facebook_wall/version.rb
+- test/abstract_unit.rb
+- test/facebook_wall_test.rb
+- test/factories/factories_test.rb
+- test/feed_entry_filters/chain_test.rb
+- test/feed_entry_filters/feed_entry_filter_test.rb
+- test/feed_entry_filters/link_rewriter_test.rb
+- test/feed_entry_filters/paragraphizer_test.rb
+- test/post_test.rb
+- test/std_lib_ext/rss/parser_test.rb
+homepage: http://www.archaichorizon.com/
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: facebook_wall
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: facebook_wall is a very simple library that fetches the latest wall-posts
+  for a Facebook page without having to log in - wall posts are taken from the page's
+  RSS feed.
+test_files:
+- test/abstract_unit.rb
+- test/facebook_wall_test.rb
+- test/factories/factories_test.rb
+- test/feed_entry_filters/chain_test.rb
+- test/feed_entry_filters/feed_entry_filter_test.rb
+- test/feed_entry_filters/link_rewriter_test.rb
+- test/feed_entry_filters/paragraphizer_test.rb
+- test/post_test.rb
+- test/std_lib_ext/rss/parser_test.rb