codders-feedzirra 0.2.0.rc2

data/spec/feedzirra/feed_utilities_spec.rb

@@ -0,0 +1,150 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Feedzirra::FeedUtilities do
+  before(:each) do
+    @klass = Class.new do
+      include Feedzirra::FeedUtilities
+    end
+  end
+
+  describe "instance methods" do
+    it "should provide an updated? accessor" do
+      feed = @klass.new
+      feed.should_not be_updated
+      feed.updated = true
+      feed.should be_updated
+    end
+    
+    it "should provide a new_entries accessor" do
+      feed = @klass.new
+      feed.new_entries.should == []
+      feed.new_entries = [:foo]
+      feed.new_entries.should == [:foo]
+    end
+    
+    it "should provide an etag accessor" do
+      feed = @klass.new
+      feed.etag = "foo"
+      feed.etag.should == "foo"
+    end
+    
+    it "should provide a last_modified accessor" do
+      feed = @klass.new
+      time = Time.now
+      feed.last_modified = time  
+      feed.last_modified.should == time
+      feed.last_modified.class.should == Time
+    end
+    
+    it "should return new_entries? as true when entries are put into new_entries" do
+      feed = @klass.new
+      feed.new_entries << :foo
+      feed.should have_new_entries
+    end
+    
+    it "should return a last_modified value from the entry with the most recent published date if the last_modified date hasn't been set" do
+      feed = Feedzirra::Parser::Atom.new
+      entry =Feedzirra::Parser::AtomEntry.new
+      entry.published = Time.now.to_s
+      feed.entries << entry
+      feed.last_modified.should == entry.published
+    end
+    
+    it "should not throw an error if one of the entries has published date of nil" do
+      feed = Feedzirra::Parser::Atom.new
+      entry = Feedzirra::Parser::AtomEntry.new
+      entry.published = Time.now.to_s
+      feed.entries << entry
+      feed.entries << Feedzirra::Parser::AtomEntry.new
+      feed.last_modified.should == entry.published
+    end
+  end
+  
+  describe "#update_from_feed" do
+    describe "updating feed attributes" do
+      before(:each) do
+        # I'm using the Atom class when I know I should be using a different one. However, this update_from_feed
+        # method would only be called against a feed item.
+        @feed = Feedzirra::Parser::Atom.new
+        @feed.title    = "A title"
+        @feed.url      = "http://pauldix.net"
+        @feed.feed_url = "http://feeds.feedburner.com/PaulDixExplainsNothing"
+        @feed.updated  = false
+        @updated_feed = @feed.dup
+      end
+    
+      it "should update the title if changed" do
+        @updated_feed.title = "new title"
+        @feed.update_from_feed(@updated_feed)
+        @feed.title.should == @updated_feed.title
+        @feed.should be_updated
+      end
+    
+      it "should not update the title if the same" do
+        @feed.update_from_feed(@updated_feed)
+        @feed.should_not be_updated      
+      end
+    
+      it "should update the feed_url if changed" do
+        @updated_feed.feed_url = "a new feed url"
+        @feed.update_from_feed(@updated_feed)
+        @feed.feed_url.should == @updated_feed.feed_url
+        @feed.should be_updated
+      end
+    
+      it "should not update the feed_url if the same" do
+        @feed.update_from_feed(@updated_feed)
+        @feed.should_not be_updated
+      end
+    
+      it "should update the url if changed" do
+        @updated_feed.url = "a new url"
+        @feed.update_from_feed(@updated_feed)
+        @feed.url.should == @updated_feed.url
+      end
+    
+      it "should not update the url if not changed" do
+        @feed.update_from_feed(@updated_feed)
+        @feed.should_not be_updated
+      end
+    end
+    
+    describe "updating entries" do
+      before(:each) do
+        # I'm using the Atom class when I know I should be using a different one. However, this update_from_feed
+        # method would only be called against a feed item.
+        @feed = Feedzirra::Parser::Atom.new
+        @feed.title    = "A title"
+        @feed.url      = "http://pauldix.net"
+        @feed.feed_url = "http://feeds.feedburner.com/PaulDixExplainsNothing"
+        @feed.updated  = false
+        @updated_feed = @feed.dup
+        @old_entry = Feedzirra::Parser::AtomEntry.new
+        @old_entry.url = "http://pauldix.net/old.html"
+        @old_entry.published = Time.now.to_s
+        @new_entry = Feedzirra::Parser::AtomEntry.new    
+        @new_entry.url = "http://pauldix.net/new.html"
+        @new_entry.published = (Time.now + 10).to_s     
+        @feed.entries << @old_entry
+        @updated_feed.entries << @new_entry
+        @updated_feed.entries << @old_entry
+      end
+      
+      it "should update last-modified from the latest entry date" do
+        @feed.update_from_feed(@updated_feed)
+        @feed.last_modified.should == @new_entry.published    
+      end
+      
+      it "should put new entries into new_entries" do
+        @feed.update_from_feed(@updated_feed)
+        @feed.new_entries.should == [@new_entry]
+      end
+      
+      it "should also put new entries into the entries collection" do
+        @feed.update_from_feed(@updated_feed)
+        @feed.entries.should include(@new_entry)
+        @feed.entries.should include(@old_entry)
+      end
+    end
+  end
+end

data/spec/feedzirra/parser/atom_entry_spec.rb

@@ -0,0 +1,86 @@
+require File.join(File.dirname(__FILE__), %w[.. .. spec_helper])
+
+describe Feedzirra::Parser::AtomEntry do
+  before(:each) do
+    # I don't really like doing it this way because these unit test should only rely on AtomEntry,
+    # but this is actually how it should work. You would never just pass entry xml straight to the AtomEnry
+    @entry = Feedzirra::Parser::Atom.parse(sample_atom_feed).entries.first
+  end
+
+  it "should parse the title" do
+    @entry.title.should == "AWS Job: Architect & Designer Position in Turkey"
+  end
+
+  it "should parse the url" do
+    @entry.url.should == "http://aws.typepad.com/aws/2009/01/aws-job-architect-designer-position-in-turkey.html"
+  end
+
+  it "should parse the url even when" do
+    Feedzirra::Parser::Atom.parse(load_sample("atom_with_link_tag_for_url_unmarked.xml")).entries.first.url.should == "http://www.innoq.com/blog/phaus/2009/07/ja.html"
+  end
+
+  it "should parse the author" do
+    @entry.author.should == "AWS Editor"
+  end
+
+  it "should parse the content" do
+    @entry.content.should == sample_atom_entry_content
+  end
+
+  it "should provide a summary" do
+    @entry.summary.should == "Late last year an entrepreneur from Turkey visited me at Amazon HQ in Seattle. We talked about his plans to use AWS as part of his new social video portal startup. I won't spill any beans before he's ready to..."
+  end
+
+  it "should parse the published date" do
+    @entry.published.should == Time.parse_safely("Fri Jan 16 18:21:00 UTC 2009")
+  end
+
+  it "should parse the categories" do
+    @entry.categories.should == ['Turkey', 'Seattle']
+  end
+
+  it "should parse the updated date" do
+    @entry.updated.should == Time.parse_safely("Fri Jan 16 18:21:00 UTC 2009")
+  end
+
+  it "should parse the id" do
+    @entry.id.should == "tag:typepad.com,2003:post-61484736"
+  end
+
+  it "should support each" do
+    @entry.respond_to? :each
+  end
+
+  it "should be able to list out all fields with each" do
+    all_fields = []
+    @entry.each do |field, value|
+      all_fields << field
+    end
+    all_fields.sort == ['author', 'categories', 'content', 'id', 'published', 'summary', 'title', 'url']
+  end
+
+  it "should be able to list out all values with each" do
+    title_value = ''
+    @entry.each do |field, value|
+      title_value = value if field == 'title'
+    end
+    title_value.should == "AWS Job: Architect & Designer Position in Turkey"
+  end
+
+  it "should support checking if a field exists in the entry" do
+    @entry.include?('title') && @entry.include?('author')
+  end
+
+  it "should allow access to fields with hash syntax" do
+    @entry['title'] == @entry.title
+    @entry['title'].should == "AWS Job: Architect & Designer Position in Turkey"
+    @entry['author'] == @entry.author
+    @entry['author'].should == "AWS Editor"
+  end
+
+  it "should allow setting field values with hash syntax" do
+    @entry['title'] = "Foobar"
+    @entry.title.should == "Foobar"
+  end
+
+end

data/spec/feedzirra/parser/atom_feed_burner_entry_spec.rb

@@ -0,0 +1,47 @@
+require File.join(File.dirname(__FILE__), %w[.. .. spec_helper])
+
+describe Feedzirra::Parser::AtomFeedBurnerEntry do
+  before(:each) do
+    # I don't really like doing it this way because these unit test should only rely on AtomEntry,
+    # but this is actually how it should work. You would never just pass entry xml straight to the AtomEnry
+    @entry = Feedzirra::Parser::AtomFeedBurner.parse(sample_feedburner_atom_feed).entries.first
+  end
+  
+  it "should parse the title" do
+    @entry.title.should == "Making a Ruby C library even faster"
+  end
+  
+  it "should be able to fetch a url via the 'alternate' rel if no origLink exists" do
+    entry = Feedzirra::Parser::AtomFeedBurner.parse(File.read("#{File.dirname(__FILE__)}/../../sample_feeds/PaulDixExplainsNothingAlternate.xml")).entries.first
+    entry.url.should == 'http://feeds.feedburner.com/~r/PaulDixExplainsNothing/~3/519925023/making-a-ruby-c-library-even-faster.html'
+  end
+
+  it "should parse the url" do
+    @entry.url.should == "http://www.pauldix.net/2009/01/making-a-ruby-c-library-even-faster.html"
+  end
+  
+  it "should parse the url when there is no alternate" do
+    entry = Feedzirra::Parser::AtomFeedBurner.parse(File.read("#{File.dirname(__FILE__)}/../../sample_feeds/FeedBurnerUrlNoAlternate.xml")).entries.first
+    entry.url.should == 'http://example.com/QQQQ.html'
+  end
+
+  it "should parse the author" do
+    @entry.author.should == "Paul Dix"
+  end
+  
+  it "should parse the content" do
+    @entry.content.should == sample_feedburner_atom_entry_content
+  end
+  
+  it "should provide a summary" do
+    @entry.summary.should == "Last week I released the first version of a SAX based XML parsing library called SAX-Machine. It uses Nokogiri, which uses libxml, so it's pretty fast. However, I felt that it could be even faster. The only question was how..."
+  end
+  
+  it "should parse the published date" do
+    @entry.published.should == Time.parse_safely("Thu Jan 22 15:50:22 UTC 2009")
+  end
+
+  it "should parse the categories" do
+    @entry.categories.should == ['Ruby', 'Another Category']
+  end
+end

data/spec/feedzirra/parser/atom_feed_burner_spec.rb

@@ -0,0 +1,47 @@
+require File.join(File.dirname(__FILE__), %w[.. .. spec_helper])
+
+describe Feedzirra::Parser::AtomFeedBurner do
+  describe "#will_parse?" do
+    it "should return true for a feedburner atom feed" do
+      Feedzirra::Parser::AtomFeedBurner.should be_able_to_parse(sample_feedburner_atom_feed)
+    end
+    
+    it "should return false for an rdf feed" do
+      Feedzirra::Parser::AtomFeedBurner.should_not be_able_to_parse(sample_rdf_feed)
+    end
+    
+    it "should return false for a regular atom feed" do
+      Feedzirra::Parser::AtomFeedBurner.should_not be_able_to_parse(sample_atom_feed)
+    end
+    
+    it "should return false for an rss feedburner feed" do
+      Feedzirra::Parser::AtomFeedBurner.should_not be_able_to_parse(sample_rss_feed_burner_feed)
+    end
+  end
+
+  describe "parsing" do
+    before(:each) do
+      @feed = Feedzirra::Parser::AtomFeedBurner.parse(sample_feedburner_atom_feed)
+    end
+    
+    it "should parse the title" do
+      @feed.title.should == "Paul Dix Explains Nothing"
+    end
+
+    it "should parse the description" do
+      @feed.description.should == "Entrepreneurship, programming, software development, politics, NYC, and random thoughts."
+    end
+
+    it "should parse the url" do
+      @feed.url.should == "http://www.pauldix.net/"
+    end
+    
+    it "should parse the feed_url" do
+      @feed.feed_url.should == "http://feeds.feedburner.com/PaulDixExplainsNothing"
+    end
+    
+    it "should parse entries" do
+      @feed.entries.size.should == 5
+    end
+  end
+end

data/spec/feedzirra/parser/atom_spec.rb

@@ -0,0 +1,51 @@
+require File.join(File.dirname(__FILE__), %w[.. .. spec_helper])
+
+describe Feedzirra::Parser::Atom do
+  describe "#will_parse?" do
+    it "should return true for an atom feed" do
+      Feedzirra::Parser::Atom.should be_able_to_parse(sample_atom_feed)
+    end
+    
+    it "should return false for an rdf feed" do
+      Feedzirra::Parser::Atom.should_not be_able_to_parse(sample_rdf_feed)
+    end
+    
+    it "should return false for an rss feedburner feed" do
+      Feedzirra::Parser::Atom.should_not be_able_to_parse(sample_rss_feed_burner_feed)
+    end
+  end
+  
+  describe "parsing" do
+    before(:each) do
+      @feed = Feedzirra::Parser::Atom.parse(sample_atom_feed)
+    end
+    
+    it "should parse the title" do
+      @feed.title.should == "Amazon Web Services Blog"
+    end
+
+    it "should parse the description" do
+      @feed.description.should == "Amazon Web Services, Products, Tools, and Developer Information..."
+    end
+
+    it "should parse the url" do
+      @feed.url.should == "http://aws.typepad.com/aws/"
+    end
+    
+    it "should parse the url even when it doesn't have the type='text/html' attribute" do
+      Feedzirra::Parser::Atom.parse(load_sample("atom_with_link_tag_for_url_unmarked.xml")).url.should == "http://www.innoq.com/planet/"
+    end
+    
+    it "should parse the feed_url even when it doesn't have the type='application/atom+xml' attribute" do
+      Feedzirra::Parser::Atom.parse(load_sample("atom_with_link_tag_for_url_unmarked.xml")).feed_url.should == "http://www.innoq.com/planet/atom.xml"
+    end
+    
+    it "should parse the feed_url" do
+      @feed.feed_url.should == "http://aws.typepad.com/aws/atom.xml"
+    end
+    
+    it "should parse entries" do
+      @feed.entries.size.should == 10
+    end
+  end
+end

data/spec/feedzirra/parser/google_docs_atom_entry_spec.rb

@@ -0,0 +1,22 @@
+require File.join(File.dirname(__FILE__), %w[.. .. spec_helper])
+
+describe Feedzirra::Parser::GoogleDocsAtomEntry do
+  describe 'parsing' do
+    before do
+      @feed = Feedzirra::Parser::GoogleDocsAtom.parse(sample_google_docs_list_feed)
+      @entry = @feed.entries.first
+    end
+
+    it 'should have the custom checksum element' do
+      @entry.checksum.should eql '2b01142f7481c7b056c4b410d28f33cf'
+    end
+
+    it 'should have the custom filename element' do
+      @entry.original_filename.should eql "MyFile.pdf"
+    end
+
+    it 'should have the custom suggested filename element' do
+      @entry.suggested_filename.should eql "TaxDocument.pdf"
+    end
+  end
+end

data/spec/feedzirra/parser/google_docs_atom_spec.rb

@@ -0,0 +1,31 @@
+require File.join(File.dirname(__FILE__), %w[.. .. spec_helper])
+
+describe Feedzirra::Parser::GoogleDocsAtom do
+  describe '.able_to_parser?' do
+    it 'should return true for Google Docs feed' do
+      Feedzirra::Parser::GoogleDocsAtom.should be_able_to_parse(sample_google_docs_list_feed)
+    end
+
+    it 'should not be able to parse another Atom feed' do
+      Feedzirra::Parser::GoogleDocsAtom.should_not be_able_to_parse(sample_atom_feed)
+    end
+  end
+
+  describe 'parsing' do
+    before do
+      @feed = Feedzirra::Parser::GoogleDocsAtom.parse(sample_google_docs_list_feed)
+    end
+
+    it 'should return a bunch of objects' do
+      @feed.entries.should_not be_empty
+    end
+
+    it 'should populate a title, interhited from the Atom entry' do
+      @feed.title.should_not be_nil
+    end
+
+    it 'should return a bunch of entries of type GoogleDocsAtomEntry' do
+      @feed.entries.first.should be_a Feedzirra::Parser::GoogleDocsAtomEntry
+    end
+  end
+end

data/spec/feedzirra/parser/itunes_rss_item_spec.rb

@@ -0,0 +1,48 @@
+require File.join(File.dirname(__FILE__), %w[.. .. spec_helper])
+
+describe Feedzirra::Parser::ITunesRSSItem do
+  before(:each) do
+    # I don't really like doing it this way because these unit test should only rely on ITunesRssItem,
+    # but this is actually how it should work. You would never just pass entry xml straight to the ITunesRssItem
+    @item = Feedzirra::Parser::ITunesRSS.parse(sample_itunes_feed).entries.first
+  end
+  
+  it "should parse the title" do
+    @item.title.should == "Shake Shake Shake Your Spices"
+  end
+  
+  it "should parse the author" do
+    @item.itunes_author.should == "John Doe"
+  end  
+
+  it "should parse the subtitle" do
+    @item.itunes_subtitle.should == "A short primer on table spices"
+  end  
+
+  it "should parse the summary" do
+    @item.itunes_summary.should == "This week we talk about salt and pepper shakers, comparing and contrasting pour rates, construction materials, and overall aesthetics. Come and join the party!"
+  end  
+
+  it "should parse the enclosure" do
+    @item.enclosure_length.should == "8727310"
+    @item.enclosure_type.should == "audio/x-m4a"
+    @item.enclosure_url.should == "http://example.com/podcasts/everything/AllAboutEverythingEpisode3.m4a"
+  end  
+
+  it "should parse the guid" do
+    @item.guid.should == "http://example.com/podcasts/archive/aae20050615.m4a"
+  end  
+
+  it "should parse the published date" do
+    @item.published.should == Time.parse_safely("Wed Jun 15 19:00:00 UTC 2005")
+  end  
+
+  it "should parse the duration" do
+    @item.itunes_duration.should == "7:04"
+  end  
+
+  it "should parse the keywords" do
+    @item.itunes_keywords.should == "salt, pepper, shaker, exciting"
+  end  
+
+end