simple-rss 2.0.0 → 2.2.0

data/test/base/media_and_enclosure_helpers_test.rb

@@ -0,0 +1,84 @@
+require "test_helper"
+
+class MediaAndEnclosureHelpersTest < Test::Unit::TestCase
+  def setup
+    @feed = SimpleRSS.parse <<~XML
+      <?xml version="1.0" encoding="UTF-8"?>
+      <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd">
+        <channel>
+          <title>Podcast Feed</title>
+          <item>
+            <title>Episode 1</title>
+            <enclosure url="https://example.com/audio-1.mp3" type="audio/mpeg" length="12345" />
+            <media:content url="https://example.com/image-1.jpg" type="image/jpeg" />
+            <media:description>Episode image</media:description>
+            <media:thumbnail url="https://example.com/thumb-1.jpg" />
+            <itunes:duration>00:42:00</itunes:duration>
+            <itunes:image href="https://example.com/itunes-1.jpg" />
+          </item>
+          <item>
+            <title>Episode 2</title>
+            <media:thumbnail url="https://example.com/thumb-2.jpg" />
+          </item>
+          <item>
+            <title>Episode 3</title>
+            <enclosure url="https://example.com/audio-3.mp3" type="audio/mpeg" length="999" />
+          </item>
+          <item>
+            <title>Episode 4</title>
+            <enclosure url="" type="audio/mpeg" length="111" />
+            <media:thumbnail url="" />
+            <itunes:image href="" />
+          </item>
+        </channel>
+      </rss>
+    XML
+  end
+
+  def test_enclosures_extracts_podcast_enclosures
+    enclosures = @feed.enclosures
+
+    assert_equal 2, enclosures.size
+    assert_equal "https://example.com/audio-1.mp3", enclosures.first[:url]
+    assert_equal "audio/mpeg", enclosures.first[:type]
+    assert_equal "12345", enclosures.first[:length]
+    assert_equal "Episode 1", enclosures.first[:item][:title]
+  end
+
+  def test_images_collects_unique_media_urls
+    images = @feed.images
+
+    assert_equal [
+      "https://example.com/thumb-1.jpg",
+      "https://example.com/image-1.jpg",
+      "https://example.com/itunes-1.jpg",
+      "https://example.com/thumb-2.jpg"
+    ], images
+  end
+
+  def test_item_media_helpers
+    first_item = @feed.items.first
+    second_item = @feed.items[1]
+    third_item = @feed.items[2]
+    fourth_item = @feed.items.last
+
+    assert_equal true, first_item.has_media?
+    assert_equal "https://example.com/image-1.jpg", first_item.media_url
+
+    assert_equal true, second_item.has_media?
+    assert_equal "https://example.com/thumb-2.jpg", second_item.media_url
+
+    assert_equal true, third_item.has_media?
+    assert_equal "https://example.com/audio-3.mp3", third_item.media_url
+
+    assert_equal false, fourth_item.has_media?
+    assert_nil fourth_item.media_url
+  end
+
+  def test_media_description_and_itunes_duration_are_parsed
+    first_item = @feed.items.first
+
+    assert_equal "Episode image", first_item[:media_description]
+    assert_equal "00:42:00", first_item[:itunes_duration]
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simple-rss
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.2.0
 platform: ruby
 authors:
 - Lucas Carlson
@@ -60,7 +60,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE
-- README.markdown
+- README.md
 - Rakefile
 - lib/simple-rss.rb
 - simple-rss.gemspec
@@ -68,8 +68,16 @@ files:
 - test/base/base_test.rb
 - test/base/empty_tag_test.rb
 - test/base/encoding_test.rb
+- test/base/enumerable_test.rb
 - test/base/feed_attributes_test.rb
+- test/base/feed_merging_and_diffing_test.rb
+- test/base/fetch_integration_test.rb
+- test/base/fetch_test.rb
+- test/base/filtering_and_validation_test.rb
+- test/base/hash_xml_serialization_test.rb
 - test/base/item_attributes_test.rb
+- test/base/json_serialization_test.rb
+- test/base/media_and_enclosure_helpers_test.rb
 - test/data/atom.xml
 - test/data/atom_with_entry_attrs.xml
 - test/data/atom_with_feed_attrs.xml
@@ -81,7 +89,7 @@ files:
 - test/data/rss20_with_channel_attrs.xml
 - test/data/rss20_with_item_attrs.xml
 - test/test_helper.rb
-homepage: http://github.com/cardmagic/simple-rss
+homepage: https://github.com/cardmagic/simple-rss
 licenses: []
 metadata: {}
 rdoc_options: []
@@ -91,14 +99,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: A simple, flexible, extensible, and liberal RSS and Atom reader for Ruby.
   It is designed to be backwards compatible with the standard RSS parser, but will

data/README.markdown

@@ -1,47 +0,0 @@
-## Welcome to Simple RSS
-
-Simple RSS is a simple, flexible, extensible, and liberal RSS and Atom reader
-for Ruby. It is designed to be backwards compatible with the standard RSS
-parser, but will never do RSS generation.
-
-## Download
-
-* gem install simple-rss
-* https://github.com/cardmagic/simple-rss
-* git clone git@github.com:cardmagic/simple-rss.git
-
-### Usage
-The API is similar to Ruby's standard RSS parser:
-
-    require 'rubygems'
-    require 'simple-rss'
-    require 'open-uri'
-
-    rss = SimpleRSS.parse open('http://rss.slashdot.org/Slashdot/slashdot/to')
-
-    rss.channel.title # => "Slashdot"
-    rss.channel.link # => "http://slashdot.org/"
-    rss.items.first.link # => "http://books.slashdot.org/article.pl?sid=05/08/29/1319236&from=rss"
-
-But since the parser can read Atom feeds as easily as RSS feeds, there are optional aliases that allow more atom like reading:
-
-    rss.feed.title # => "Slashdot"
-    rss.feed.link # => "http://slashdot.org/"
-    rss.entries.first.link # => "http://books.slashdot.org/article.pl?sid=05/08/29/1319236&from=rss"
-
-The parser does not care about the correctness of the XML as it does not use an XML library to read the information. Thus it is flexible and allows for easy extending via:
-
-    SimpleRSS.feed_tags << :some_new_tag
-    SimpleRSS.item_tags << :"item+myrel" # this will extend SimpleRSS to be able to parse RSS items or ATOM entries that have a rel specified, common in many blogger feeds
-    SimpleRSS.item_tags << :"feedburner:origLink" # this will extend SimpleRSS to be able to parse RSS items or ATOM entries that have a specific pre-tag specified, common in many feedburner feeds
-    SimpleRSS.item_tags << :"media:content#url" # this will grab the url attribute of the media:content tag 
-
-## Authors
-
-* Lucas Carlson  (mailto:lucas@rufy.com)
-* Herval Freire (mailto:hervalfreire@gmail.com)
-
-Inspired by [Blagg](http://www.raelity.org/lang/perl/blagg) from Rael Dornfest.
-
-This library is released under the terms of the GNU LGPL.
-