urss 0.0.2

data/.gemrc

@@ -0,0 +1 @@
+:ssl_verify_mode: 0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.gpairrc

@@ -0,0 +1 @@
+alone for github

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/.rvmrc

@@ -0,0 +1 @@
+rvm --create use 1.9.3@urss > /dev/null

data/.travis.yml

@@ -0,0 +1,7 @@
+rvm:
+  - ruby-head
+  - jruby
+  - 1.9.3
+  - 1.8.7
+  - 1.9.2
+  - ree

data/Gemfile

@@ -0,0 +1,9 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in urss.gemspec
+gemspec
+
+gem "rake"
+gem "rspec"
+gem "webmock"
+gem "simplecov"

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 zedtux
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,47 @@
+# Urss [![Build Status](https://secure.travis-ci.org/zedtux/urss.png)](http://travis-ci.org/zedtux/urss) [![Dependency Status](https://gemnasium.com/zedtux/urss.png)](http://gemnasium.com/zedtux/urss)
+
+URSS or Ultra RSS is another ruby library to parse Feed RSS that has been created because there was no existing one that support multiple media:content or media:thumbnail.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'urss'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install urss
+
+## Usage
+
+````ruby
+rss = Urss.at("http://www.ruby-lang.org/en/feeds/news.rss")
+rss.title
+#=> "Ruby News"
+rss.url
+#=> "http://www.ruby-lang.org/en/feeds/news.rss/"
+rss.description
+#=> "The latest news from Ruby-Lang.org."
+rss.updated_at
+#=> ""
+rss.entries.size
+#=> 10
+rss.entries.first.title
+#=> "Ruby 1.9.3-p194 is released"
+rss.entries.first.created_at
+#=> "Fri, 20 Apr 2012 03:19:04 GMT"
+rss.entries.first.url
+#=> "http://www.ruby-lang.org/en/news/2012/04/20/ruby-1-9-3-p194-is-released/"
+````
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,8 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new("spec")
+
+task :default => :spec

data/lib/urss.rb

@@ -0,0 +1,23 @@
+require "urss/version"
+require "open-uri"
+require "nokogiri"
+
+require "urss/rss"
+require "urss/feed"
+require "urss/feed/entry"
+require "urss/feed/atom"
+require "urss/feed/atom_entry"
+require "urss/feed/rss"
+require "urss/feed/rss_entry"
+require "urss/media"
+
+module Urss
+  class NotANokogiriInstance < StandardError; end
+
+  def self.at(url)
+    raise ArgumentError if url.nil? || !url.is_a?(String) || url.empty?
+
+    Rss.build(Nokogiri::XML(open(url)))
+  end
+
+end

data/lib/urss/feed.rb

@@ -0,0 +1,17 @@
+class Urss::Feed
+
+  # ~~~~ Attributes ~~~~
+  attr_accessor :title, :url, :description, :updated_at, :entries
+
+  # ~~~~ Class methods ~~~~
+
+  # ~~~~ Instance methods ~~~~
+  def initialize
+    self.title = nil
+    self.url = nil
+    self.description = nil
+    self.updated_at = nil
+    self.entries = []
+  end
+
+end

data/lib/urss/feed/atom.rb

@@ -0,0 +1,20 @@
+class Urss::Feed::Atom < Urss::Feed
+
+  # ~~~~ Attributes ~~~~
+
+  # ~~~~ Class methods ~~~~
+  def self.build(nokogiri_instance, namespace, root_node)
+    raise Urss::NotANokogiriInstance unless nokogiri_instance.is_a?(Nokogiri::XML::NodeSet)
+    feed_rss = self.new
+    feed_rss.title = nokogiri_instance.xpath("//#{namespace}#{root_node}/title").text
+    feed_rss.url = nokogiri_instance.xpath("//#{namespace}#{root_node}/#{namespace}link[@rel='self']").attr("href").value
+    feed_rss.description = nokogiri_instance.xpath("//#{namespace}#{root_node}/#{namespace}subtitle").text.strip
+    feed_rss.updated_at = nokogiri_instance.xpath("//#{namespace}#{root_node}/#{namespace}updated").text
+    nokogiri_instance.xpath("//#{namespace}entry").each {|item| feed_rss.entries << Urss::Feed::Atom::Entry.build(item, namespace)}
+
+    feed_rss
+  end
+
+  # ~~~~ Instance methods ~~~~
+
+end

data/lib/urss/feed/atom_entry.rb

@@ -0,0 +1,44 @@
+class Urss::Feed::Atom::Entry < Urss::Feed::Entry
+
+  # ~~~~ Attributes ~~~~
+
+  # ~~~~ Class methods ~~~~
+  def self.build(nokogiri_instance, namespace=nil)
+    raise Urss::NotANokogiriInstance unless nokogiri_instance.is_a?(Nokogiri::XML::Element)
+
+    entry = self.new
+    entry.title = nokogiri_instance.xpath("./#{namespace}title").text
+    entry.url = nokogiri_instance.xpath("./#{namespace}link[@rel='alternate']").attr("href").value
+    entry.created_at = nokogiri_instance.xpath("./#{namespace}published").text
+    entry.author = nokogiri_instance.xpath("./#{namespace}author/#{namespace}name").text
+    entry.content = nokogiri_instance.xpath("./description").text
+
+    begin
+      # When having only one media:content then all media:* nodes are used to create one Urss::Media
+      # Otherwise each media:* are different Urss::Media
+      single_media = nokogiri_instance.xpath("./media:content").size == 1
+      media = nil
+      nokogiri_instance.xpath("./media:*").each do |media_attributes|
+        if single_media
+          media = Urss::Media.new if media.nil?
+          media.update(media_attributes)
+        else
+          media = Urss::Media.new
+          media.update(media_attributes)
+          media_attributes.children.select{|child| child.class == Nokogiri::XML::Element}.each do |element|
+            media.update(element)
+          end
+          entry.medias << media
+        end
+      end
+      entry.medias << media if single_media
+    rescue Nokogiri::XML::XPath::SyntaxError
+      # No media element
+    end
+
+    entry
+  end
+
+  # ~~~~ Instance methods ~~~~
+
+end

data/lib/urss/feed/entry.rb

@@ -0,0 +1,20 @@
+class Urss::Feed::Entry
+
+  # ~~~~ Attributes ~~~~
+  attr_accessor :title, :url, :comments_url, :created_at, :author, :categories, :content, :medias
+
+  # ~~~~ Class methods ~~~~
+
+  # ~~~~ Instance methods ~~~~
+  def initialize
+    self.title = nil
+    self.url = nil
+    self.comments_url = nil
+    self.created_at = nil
+    self.author = nil
+    self.categories = []
+    self.content = nil
+    self.medias = []
+  end
+  
+end

data/lib/urss/feed/rss.rb

@@ -0,0 +1,27 @@
+class Urss::Feed::Rss < Urss::Feed
+
+  # ~~~~ Attributes ~~~~
+
+  # ~~~~ Class methods ~~~~
+  def self.build(nokogiri_instance, namespace, root_node)
+    raise Urss::NotANokogiriInstance unless nokogiri_instance.is_a?(Nokogiri::XML::NodeSet)
+    feed_rss = self.new
+    feed_rss.title = nokogiri_instance.xpath("//#{namespace}#{root_node}/#{namespace}title").text
+    feed_rss.url = nokogiri_instance.xpath("//#{namespace}#{root_node}/#{namespace}link").text
+    feed_rss.description = nokogiri_instance.xpath("//#{namespace}#{root_node}/#{namespace}description").text
+    feed_rss.updated_at = nokogiri_instance.xpath("//#{namespace}#{root_node}/#{namespace}pubDate").text
+    if feed_rss.updated_at.nil? || feed_rss.updated_at.empty?
+      begin
+        feed_rss.updated_at = nokogiri_instance.xpath("//#{namespace}#{root_node}/dc:date").text
+      rescue Nokogiri::XML::XPath::SyntaxError
+        # No pubDate or date field
+      end
+    end
+    nokogiri_instance.xpath("//#{namespace}item").each {|item| feed_rss.entries << Urss::Feed::Rss::Entry.build(item, namespace)}
+
+    feed_rss
+  end
+
+  # ~~~~ Instance methods ~~~~
+
+end

data/lib/urss/feed/rss_entry.rb

@@ -0,0 +1,49 @@
+class Urss::Feed::Rss::Entry < Urss::Feed::Entry
+
+  # ~~~~ Attributes ~~~~
+
+  # ~~~~ Class methods ~~~~
+  def self.build(nokogiri_instance, namespace=nil)
+    raise Urss::NotANokogiriInstance unless nokogiri_instance.is_a?(Nokogiri::XML::Element)
+
+    entry = self.new
+    entry.title = nokogiri_instance.xpath("./#{namespace}title").text
+    entry.url = nokogiri_instance.xpath("./#{namespace}link").text
+    entry.comments_url = nokogiri_instance.xpath("./comments").text
+    entry.created_at = nokogiri_instance.xpath("./pubDate").text
+    if entry.created_at.nil? || entry.created_at.empty?
+      entry.created_at = nokogiri_instance.xpath("./dc:date").text
+    end
+    entry.author = nokogiri_instance.xpath("./dc:creator", nokogiri_instance.namespaces).text
+    entry.categories = nokogiri_instance.search("category").collect(&:text).join(", ")
+    entry.content = nokogiri_instance.xpath("./description").text
+
+    begin
+      # When having only one media:content then all media:* nodes are used to create one Urss::Media
+      # Otherwise each media:* are different Urss::Media
+      single_media = nokogiri_instance.xpath("./media:content").size == 1
+      media = nil
+      nokogiri_instance.xpath("./media:*").each do |media_attributes|
+        if single_media
+          media = Urss::Media.new if media.nil?
+          media.update(media_attributes)
+        else
+          media = Urss::Media.new
+          media.update(media_attributes)
+          media_attributes.children.select{|child| child.class == Nokogiri::XML::Element}.each do |element|
+            media.update(element)
+          end
+          entry.medias << media
+        end
+      end
+      entry.medias << media if single_media
+    rescue Nokogiri::XML::XPath::SyntaxError
+      # No media element
+    end
+
+    entry
+  end
+
+  # ~~~~ Instance methods ~~~~
+
+end

data/lib/urss/media.rb

@@ -0,0 +1,31 @@
+class Urss::Media
+
+  # ~~~~ Attributes ~~~~
+  attr_accessor :content_url, :title, :thumbnail_url
+
+  # ~~~~ Class methods ~~~~
+
+  # ~~~~ Instance methods ~~~~
+  def initialize
+    self.content_url = nil
+    self.title = nil
+    self.thumbnail_url = nil
+  end
+
+  def update(nokogiri_instance)
+    raise Urss::NotANokogiriInstance unless nokogiri_instance.is_a?(Nokogiri::XML::Element)
+
+    if nokogiri_instance.attributes["url"]
+      if nokogiri_instance.name == "thumbnail"
+        self.thumbnail_url = nokogiri_instance.attributes["url"].value
+      else
+        self.content_url = nokogiri_instance.attributes["url"].value
+      end
+    else
+      if nokogiri_instance.name == "title"
+        self.title = nokogiri_instance.text
+      end
+    end
+  end
+
+end

data/lib/urss/rss.rb

@@ -0,0 +1,28 @@
+class Urss::Rss
+
+  # ~~~~ Attributes ~~~~
+
+  # ~~~~ Class methods ~~~~
+  def self.build(nokogiri_instance)
+    raise Urss::NotANokogiriInstance unless nokogiri_instance.is_a?(Nokogiri::XML::Document)
+
+    namespace = nokogiri_instance.namespaces["xmlns"] ? "xmlns:" : nil
+
+    # Factory
+    ["channel", "feed"].each do |root|
+      unless (root_instance = nokogiri_instance.xpath("//#{namespace}#{root}")).empty?
+        rss_object = case root
+        when "channel"
+          Urss::Feed::Rss
+        when "feed"
+          Urss::Feed::Atom
+        end.build(root_instance, namespace, root)
+        return rss_object
+        break
+      end
+    end
+  end
+
+  # ~~~~ Instance methods ~~~~
+
+end

data/lib/urss/version.rb

@@ -0,0 +1,3 @@
+module Urss
+  VERSION = "0.0.2"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+require "simplecov"
+SimpleCov.start
+
+require "rubygems"
+require "bundler/setup"
+
+# require "webmock/rspec" is not working. So:
+require "webmock"
+include WebMock::API
+
+require "support/webmocks"
+
+require "urss"
+
+RSpec.configure do |config|
+  
+end

data/spec/support/fixtures/atom.xml

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="utf-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+  <rss:title type="text">dive into mark</title>
+  <subtitle type="html">
+    A &lt;em&gt;lot&lt;/em&gt; of effort
+    went into making this effortless
+  </subtitle>
+  <updated>2005-07-31T12:29:29Z</updated>
+  <id>tag:example.org,2003:3</id>
+  <link rel="alternate" type="text/html" 
+   hreflang="en" href="http://example.org/"/>
+  <link rel="self" type="application/atom+xml" 
+   href="http://example.org/feed.atom"/>
+  <rights>Copyright (c) 2003, Mark Pilgrim</rights>
+  <generator uri="http://www.example.com/" version="1.0">
+    Example Toolkit
+  </generator>
+  <entry>
+    <title>Atom draft-07 snapshot</title>
+    <link rel="alternate" type="text/html" 
+     href="http://example.org/2005/04/02/atom"/>
+    <link rel="enclosure" type="audio/mpeg" length="1337"
+     href="http://example.org/audio/ph34r_my_podcast.mp3"/>
+    <id>tag:example.org,2003:3.2397</id>
+    <updated>2005-07-31T12:29:29Z</updated>
+    <published>2003-12-13T08:29:29-04:00</published>
+    <author>
+      <name>Mark Pilgrim</name>
+      <uri>http://example.org/</uri>
+      <email>f8dy@example.com</email>
+    </author>
+    <contributor>
+      <name>Sam Ruby</name>
+    </contributor>
+    <contributor>
+      <name>Joe Gregorio</name>
+    </contributor>
+    <content type="xhtml" xml:lang="en" 
+     xml:base="http://diveintomark.org/">
+      <div xmlns="http://www.w3.org/1999/xhtml">
+        <p><i>[Update: The Atom draft is finished.]</i></p>
+      </div>
+    </content>
+  </entry>
+</feed>