superfeedr-blather 0.1.0

data/Gemfile

@@ -0,0 +1,18 @@
+source "http://rubygems.org"
+
+gem 'blather', "~> 0.4.14"
+
+# group :development do
+#   gem 'blather', :require => 'blather/client'
+# end
+
+group :development do
+  gem "jeweler", "~> 1.5.2"
+  gem "yard", "~> 0.6.0"
+end
+
+group :test do
+  gem 'rspec'
+  gem 'autotest'
+  gem 'autotest-notification', :require => 'autotest_notification'
+end

data/Gemfile.lock

@@ -0,0 +1,40 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    ZenTest (4.4.2)
+    autotest (4.4.6)
+      ZenTest (>= 4.4.1)
+    autotest-notification (2.3.1)
+      autotest (~> 4.3)
+    blather (0.4.14)
+      eventmachine (>= 0.12.6)
+      nokogiri (>= 1.4.0)
+    diff-lcs (1.1.2)
+    eventmachine (0.12.10)
+    git (1.2.5)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    nokogiri (1.4.4)
+    rake (0.8.7)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    yard (0.6.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  autotest
+  autotest-notification
+  blather (~> 0.4.14)
+  jeweler (~> 1.5.2)
+  rspec
+  yard (~> 0.6.0)

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2010 David Nolan
+
+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

@@ -0,0 +1,67 @@
+= superfeedr-blather
+
+superfeedr-blather implements a Superfeedr[http://superfeedr.com] PubSub XMPP client in Ruby using the Blather gem.
+
+Starting up a connection and echoing new notifications is as easy as this:
+
+ setup YOUR_SUPERFEEDR_USERNAME, YOUR_SUPERFEEDR_PASSWORD
+ 
+ pubsub_event do |e|
+   e.items.each do |i|
+     puts "New post from #{i.entry.title}:"
+     puts i.entry.content
+   end
+ end
+
+== About
+
+You get some patches for Blather and some classes that wrap the stuff
+you want from Superfeedr (entries, authors etc.).
+
+Under-the-hood, Blather uses EventMachine and Nokogiri so it's fast
+and convenient. If you want to daemonize your client, daemon-kit[https://github.com/kennethkalmer/daemon-kit/] comes
+ready with a {blather template}[https://github.com/kennethkalmer/daemon-kit/blob/master/lib/daemon_kit/xmpp.rb].
+
+You might want to compare Superfeedr's own
+superfeedr-ruby[https://github.com/superfeedr/superfeedr-ruby] which
+is based on a different XMPP lib, Skates.
+
+== Tips
+
+Take a look in <tt>/examples</tt> for examples of handling notifications,
+(un)subscribing, and fetching the list of subscriptions.
+
+When you're playing around, subscribe to Superfeedr's <tt>dummy.xml</tt> feed and use the button on
+http://www.superfeedr.com/users/kapoq/feeds/xmpp_console to generate a
+new notification on demand ("show console" displays the button).
+
+== Install
+
+ git clone git://github.com/kapoq/superfeedr-blather.git
+
+== Source and latest version
+
+superfeedr-blather lives at
+https://github.com/kapoq/superfeedr-blather.
+
+Stop by and say hi some time (contribs welcome).
+
+== Author
+
+Dave Nolan / Kapoq Ltd / kapoq.com[http://kapoq.com]
+
+== TODO
+
+* apply patches upstream to blather
+  * loading filename conflicts using bundler
+  * multiple namespaces
+
+* improve type-casting
+
+* implement superfeedr-specific handlers
+
+* swap out default client so there's no attempt to load roster on connect
+
+* implement Superfeedr notifications extensions:
+  * stripped
+  * chunks (No mention in the Superfeedr schema docs but is used elsewhere)

data/README.rdoc

@@ -0,0 +1,64 @@
+= superfeedr-blather
+
+superfeedr-blather implements a Superfeedr[http://superfeedr.com] PubSub XMPP client in Ruby using the Blather gem.
+
+Starting up a connection and echoing new notifications is as easy as this:
+
+ setup YOUR_SUPERFEEDR_USERNAME, YOUR_SUPERFEEDR_PASSWORD
+ 
+ pubsub_event do |e|
+   e.items.each do |i|
+     puts "New post from #{i.entry.title}:"
+     puts i.entry.content
+   end
+ end
+
+== About
+
+You get some patches for Blather and some classes that wrap the stuff
+you want from Superfeedr (entries, authors etc.).
+
+Under-the-hood, Blather uses EventMachine and Nokogiri so it's fast
+and convenient. If you want to daemonize your client, daemon-kit[https://github.com/kennethkalmer/daemon-kit/] comes
+ready with a {blather template}[https://github.com/kennethkalmer/daemon-kit/blob/master/lib/daemon_kit/xmpp.rb].
+
+You might want to compare Superfeedr's own
+superfeedr-ruby[https://github.com/superfeedr/superfeedr-ruby] which
+is based on a different XMPP lib, Skates.
+
+== Tips
+
+Take a look in <tt>/examples</tt> for examples of handling notifications,
+(un)subscribing, and fetching the list of subscriptions.
+
+When you're playing around, subscribe to Superfeedr's <tt>dummy.xml</tt> feed and use the button on
+http://www.superfeedr.com/users/kapoq/feeds/xmpp_console to generate a
+new notification on demand ("show console" displays the button).
+
+== Install
+
+ git clone git://github.com/kapoq/superfeedr-blather.git
+
+== Source and latest version
+
+superfeedr-blather lives at
+https://github.com/kapoq/superfeedr-blather.
+
+Stop by and say hi some time (contribs welcome).
+
+== Author
+
+Dave Nolan / Kapoq Ltd / kapoq.com[http://kapoq.com]
+
+== TODO
+
+* apply patches upstream to blather
+  * loading filename conflicts using bundler
+  * multiple namespaces
+
+* improve type-casting
+
+* implement Superfeedr notifications extensions:
+  * stripped
+  * chunks (No mention in the Superfeedr schema docs but is used elsewhere)
+

data/Rakefile

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "superfeedr-blather"
+  gem.homepage = "http://github.com/kapoq/superfeedr-blather"
+  gem.license = "MIT"
+  gem.summary = %Q{superfeedr-blather implements a Superfeedr PubSub XMPP client in Ruby using the Blather gem.}
+  gem.description = %Q{You get some patches for Blather and some classes that wrap the stuff you want from Superfeedr (entries, authors etc.). Under-the-hood, Blather uses EventMachine and Nokogiri so it’s fast and convenient. If you want to daemonize your client, daemon-kit comes ready with a blather template.}
+  gem.email = "dave@kapoq.com"
+  gem.authors = ["dave@kapoq.com"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  gem.add_runtime_dependency 'blather', '~> 0.4.14'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/autotest/discover.rb

@@ -0,0 +1 @@
+Autotest.add_discovery { "rspec2" }

data/examples/echo.rb

@@ -0,0 +1,24 @@
+require File.expand_path(File.dirname(__FILE__)) + '/../lib/superfeedr-blather'
+require 'blather/client'
+
+setup YOUR_SUPERFEEDR_USERNAME, YOUR_SUPERFEEDR_PASSWORD
+
+when_ready do
+  Blather.logger.info "Connected..."
+end
+
+pubsub_event do |e|
+  puts "\n<!--Incoming!-->\n\n"
+
+  e.items.each do |i|
+    entry = i.entry
+    puts "Entry:"
+    puts "  #{entry.id}"
+    puts "  #{entry.link.href}"
+    puts "  #{entry.title}"
+    puts "  #{entry.content}"
+  end
+  
+  puts "\n<--eof message-->"
+end
+

data/examples/sub_unsub.rb

@@ -0,0 +1,41 @@
+require File.expand_path(File.dirname(__FILE__)) + '/../lib/superfeedr-blather'
+require 'blather/client'
+
+setup YOUR_SUPERFEEDR_USERNAME, YOUR_SUPERFEEDR_PASSWORD
+
+when_ready do
+  Blather.logger.info "Connected..."
+
+  # TODO: use callbacks instead of timed sequence
+  
+  EM.add_timer(1) {
+    write_to_stream Blather::Stanza::PubSub::Subscriptions.new(:get, :id => "subman1", :from => jid, :to => "firehoser.superfeedr.com")
+  }
+  
+  EM.add_timer(4) {
+    Blather.logger.info "unsubscribing from dummy"
+    write_to_stream Blather::Stanza::PubSub::Unsubscribe.new :set, "firehoser.superfeedr.com", "http://superfeedr.com/dummy.xml", jid
+  }
+
+  EM.add_timer(7) {
+    write_to_stream Blather::Stanza::PubSub::Subscriptions.new(:get, :id => "subman1", :from => jid, :to => "firehoser.superfeedr.com")
+  }
+
+  EM.add_timer(10) {
+    Blather.logger.info "re-subscribing to dummy"
+    write_to_stream Blather::Stanza::PubSub::Subscribe.new :set, "firehoser.superfeedr.com", "http://superfeedr.com/dummy.xml", jid
+  }
+  
+  EM.add_timer(13) {
+    write_to_stream Blather::Stanza::PubSub::Subscriptions.new(:get, :id => "subman1", :from => jid, :to => "firehoser.superfeedr.com")
+  }
+end
+
+pubsub_subscriptions do |subs|
+  if subs.list.detect { |sub| sub.node_url =~ /dummy\.xml/ }
+    Blather.logger.info "subscribed to dummy.xml"
+  else
+    Blather.logger.info "not subscribed to dummy.xml"
+  end  
+end
+

data/examples/timer.rb

@@ -0,0 +1,19 @@
+require File.expand_path(File.dirname(__FILE__)) + '/../lib/superfeedr-blather'
+require 'blather/client'
+
+setup YOUR_SUPERFEEDR_USERNAME, YOUR_SUPERFEEDR_PASSWORD
+
+when_ready do
+  Blather.logger.info"Connected..."
+
+  EM.add_periodic_timer(3) {
+    Blather.logger.info "fetching subs"
+    write_to_stream Blather::Stanza::PubSub::Subscriptions.new(:get, :id => "subman1", :from => jid, :to => "firehoser.superfeedr.com")
+  }
+end
+
+pubsub_subscriptions do |subs|
+  puts "\n<!--Incoming!-->\n\n"
+  subs.list.each { |sub| puts "#{sub.node_url} is #{sub.subscription_state}" }
+  puts "\n<--eof message-->"
+end

data/lib/blather/event.rb

@@ -0,0 +1,20 @@
+# Monkey-patch to add status and fix items lookup
+
+module Blather
+  class Stanza
+    class PubSub
+      class Event < Message
+        def items
+          items_node.find('.//ps:item', :ps => PS).map do |i|
+            PubSubItem.new(nil,nil,self.document).inherit i
+          end
+        end
+        
+        def status
+          n = find("ps_event:event/sf:status", :ps_event => PS_EVENT, :sf => SF)
+          Superfeedr::Status.new(n) if n
+        end
+      end
+    end
+  end
+end

data/lib/blather/namespaces.rb

@@ -0,0 +1,5 @@
+ATOM     = "http://www.w3.org/2005/Atom"
+GEO      = "http://www.georss.org/georss"
+PS       = "http://jabber.org/protocol/pubsub"
+PS_EVENT = "http://jabber.org/protocol/pubsub#event"
+SF       = "http://superfeedr.com/xmpp-pubsub-ext"

data/lib/blather/pubsub.rb

@@ -0,0 +1,12 @@
+# Adds superfeedr entry to PubSubItem
+
+module Blather
+  class Stanza
+    class PubSubItem < XMPPNode
+      def entry
+        n = find("atom:entry", :atom => ATOM)
+        Superfeedr::Entry.new(n) unless n.nil?
+      end
+    end
+  end
+end

data/lib/blather/subscriptions.rb

@@ -0,0 +1,36 @@
+# Monkey-patch to add superfeedr namespace and jid/page attributes
+
+module Blather
+  class Stanza
+    class PubSub      
+      class Subscriptions
+        def self.new(type, opts = {})
+          new_node      = super type, nil
+          new_node.to   = opts.delete(:to) || opts.delete(:host)
+          new_node.from = opts.delete(:from)
+          new_node.id   = opts.delete(:id)
+          new_node.pubsub.add_namespace_definition("sf", SF)
+          new_node.subscriptions(opts.delete(:page) || 1)
+          new_node
+        end  
+
+        def subscriptions(page = 1)
+          aff = pubsub.find_first('subscriptions', self.class.registered_ns)
+          unless aff
+            aff = XMPPNode.new('subscriptions', self.document)
+            aff["sf:page"] = page.to_s
+            aff["jid"] = self.from
+            self.pubsub << aff
+          end
+          aff
+        end
+
+        def list
+          subscriptions.find('//ns:subscription', :ns => self.class.registered_ns).map do |child|
+            Superfeedr::Subscription.new(child)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/superfeedr/superfeedr.rb

@@ -0,0 +1,210 @@
+module Superfeedr
+  class Node
+    def initialize(node)
+      @node = node
+    end
+    
+    private
+    
+    def content_from(name, ns = nil)
+      child = xpath(name, ns).first
+      child.content if child
+    end
+
+    def datetime_from(name, ns = nil)
+      datetime = content_from(name, ns)
+      DateTime.parse(datetime) if datetime
+    end
+
+    def integer_from(name, ns = nil)
+      int = content_from(name, ns)
+      int.to_i if int
+    end
+
+    def xpath(name, ns = nil)
+      ns ||= {:atom => ATOM, :geo => GEO, :sf => SF}      
+      @node.xpath(name, ns)
+    end
+  end
+
+
+  class Entry < Node
+    # entry[@id] : the Unique ID of the entry. If the original entry doesn't have an ID.
+    def id
+      content_from("atom:id")
+    end
+
+    # entry[@title] : The title of the entry.
+    def title
+      content_from("atom:title")
+    end
+
+    # entry[@published] : The publication date (iso8601) of the entry.
+    def published_at
+      datetime_from("atom:published")
+    end    
+
+    # entry[@updated] : The last updated date (iso8601) of the entry.
+    def updated_at
+      datetime_from("atom:updated")
+    end
+    
+    # entry[@content] : The content of the entry. Check the type attribute to determine the mime-type.
+    def content
+      content_from("atom:content")
+    end
+
+    def mime_type
+      content_from("atom:content/@type")
+    end    
+
+    # entry[@summary] (optional, unique) : The summary of the entry. Check the type attribute to determine the mime-type  
+    def summary
+      content_from("atom:summary")
+    end
+
+    # entry[@xml:lang] : The language of the entry. It's either extracted or computed from the content (the longer t# he content, the more relevant).
+    def lang
+      content_from("@lang")
+    end
+
+    def link
+      child = xpath("atom:link")
+      Link.new(child) if child
+    end
+    
+    def categories
+      xpath(".//atom:category/@term").map { |c| c.text }
+    end
+
+    def authors
+      xpath(".//atom:author").map { |child| Author.new(child) }
+    end
+
+    def points
+      xpath(".//geo:point").map { |child| Point.new(child) }
+    end
+  end
+
+  class Status < Node
+    # title (provided only upon notification) : the feed title.
+    def title
+      content_from("sf:title")
+    end    
+    
+    # http[@code] : last HTTP status code, please see Status Code Definitions.
+    def http_code
+      content_from("sf:http/@code")
+    end
+    
+    # http : the content of that tag is a more explicit log message for your information.
+    def http
+      content_from("sf:http")
+    end
+
+    # status[@feed] : contains the URL of the feed
+    def feed
+      content_from("@feed")
+    end
+
+    # status[@digest] : if sets to true; it indicates that the
+    # notification is a digest.
+    def digest?
+      !!content_from("@digest")
+    end    
+
+    # period : the polling frequency in seconds for this feed.
+    def period
+      integer_from("sf:period")
+    end
+
+    # next_fetch : the feed will be fetched at most before this time.
+    def next_fetch
+      datetime_from("sf:next_fetch")
+    end
+    
+    # last_fetch : the last time at which we fetched the feed.
+    def last_fetch
+      datetime_from("sf:last_fetch")
+    end
+    
+    # last_parse : the last time at which we parsed the feed. It happens that we fetch a feed and do not parse it as its content hasn't been modified.
+    def last_parse
+      datetime_from("sf:last_parse")
+    end
+
+    # last_maintenance_at : Each feed inside Node has a
+    # maintenance cycle that we use to detect stale feeds, or related
+    # feeds. We normally run maintenance at most every 24hour for each
+    # feed.
+    
+    def last_maintenance_at
+      datetime_from("sf:last_maintenance_at")
+    end
+
+    # entries_count_since_last_maintenance (provided only upon notification) : The number of new entries in the feed since we last ran the maintenance script. This is a very good indicator of the verboseness of a feed. You may want to remove feeds that are too verbose.
+    def entries_count_since_last_maintenance
+      integer_from("sf:entries_count_since_last_maintenance")
+    end
+  end
+
+  class Author < Node
+    def name
+      content_from("atom:name")
+    end
+
+    def uri
+      content_from("atom:uri")
+    end
+
+    def email
+      content_from("atom:email")
+    end
+  end
+
+  class Link < Node    
+    def type
+      content_from("@type")
+    end
+
+    def title
+      content_from("@title")
+    end
+
+    def rel
+      content_from("@rel")
+    end
+
+    def href
+      content_from("@href")
+    end    
+  end
+
+  class Point < Node 
+    def raw
+      content_from(".")
+    end
+
+    def longtitude
+      point.first
+    end
+
+    def latitude
+      point.last
+    end
+
+    def point
+      @point ||= (raw || []) && raw.split(",")
+    end    
+  end
+
+  class Subscription < Node
+    def subscription_state
+      content_from("@subscription")
+    end
+
+    def node_url
+      content_from("@node")
+    end    
+  end  
+end

data/lib/superfeedr-blather.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+require 'bundler/setup'
+
+Bundler.require(:default)
+
+%w(namespaces pubsub event subscriptions).each { |f| require File.join(File.expand_path(File.dirname(__FILE__)), "blather", f) }
+%w(superfeedr).each { |f| require File.join(File.expand_path(File.dirname(__FILE__)), "superfeedr", f) }

data/spec/fixtures/notification.xml

@@ -0,0 +1,51 @@
+<message type="chat" from="firehoser.superfeedr.com" to="test@superfeedr.com"><active xmlns="http://jabber.org/protocol/chatstates"/>
+  <event xmlns="http://jabber.org/protocol/pubsub#event">
+    <status xmlns="http://superfeedr.com/xmpp-pubsub-ext" feed="http://superfeedr.com/dummy.xml">
+      <http code="200">7462B in 2.441718s, 2/10 new entries</http>
+      <next_fetch>2010-12-10T16:06:41Z</next_fetch>
+      <title>The Dummy Time Feed</title>
+      <entries_count_since_last_maintenance>19</entries_count_since_last_maintenance>
+      <period>450</period>
+      <last_fetch>2010-12-10T15:59:11Z</last_fetch>
+      <last_parse>2010-12-10T15:59:11Z</last_parse>
+      <last_maintenance_at>2010-12-10T06:25:29+00:00</last_maintenance_at>
+    </status>
+    <items node="http://superfeedr.com/dummy.xml">
+      <item xmlns="http://jabber.org/protocol/pubsub">
+        <entry xmlns="http://www.w3.org/2005/Atom" xmlns:geo="http://www.georss.org/georss" xmlns:as="http://activitystrea.ms/spec/1.0/" xmlns:sf="http://superfeedr.com/xmpp-pubsub-ext" lang="en-US">
+          <id>tag:superfeedr.com,2005:String/1291996755</id>
+          <published>2010-12-10T15:59:15+00:00</published>
+          <updated>2010-12-10T15:59:15+00:00</updated>
+          <title>15:59:15</title>
+          <content type="text">Friday December 10 15:59:15 UTC 2010 Somebody wanted to know what time it was.</content>
+          <summary>A short message from our sponsors</summary>
+          <geo:point>37.773721,-122.414957</geo:point>
+          <link type="text/html" title="15:59:15" rel="alternate" href="http://superfeedr.com/?1291996755"/>
+          <category term="tests"/>
+          <author>
+            <name>Superfeedr</name>
+            <uri>http://superfeedr.com/</uri>
+            <email>julien@superfeedr.com</email>
+          </author>
+        </entry>
+      </item>
+      <item xmlns="http://jabber.org/protocol/pubsub">
+        <entry xmlns="http://www.w3.org/2005/Atom" xmlns:geo="http://www.georss.org/georss" xmlns:as="http://activitystrea.ms/spec/1.0/" xmlns:sf="http://superfeedr.com/xmpp-pubsub-ext" lang="en-US">
+          <id>tag:superfeedr.com,2005:String/1291996758</id>
+          <published>2010-12-10T15:59:18+00:00</published>
+          <updated>2010-12-10T15:59:18+00:00</updated>
+          <title>15:59:18</title>
+          <content type="text">Friday December 10 15:59:18 UTC 2010 Somebody wanted to know what time it was.</content>
+          <geo:point>37.773721,-122.414957</geo:point>
+          <link type="text/html" title="15:59:18" rel="alternate" href="http://superfeedr.com/?1291996758"/>
+          <category term="tests"/>
+          <author>
+            <name>Superfeedr</name>
+            <uri>http://superfeedr.com/</uri>
+            <email>julien@superfeedr.com</email>
+          </author>
+        </entry>
+      </item>
+    </items>
+  </event>
+</message>

data/spec/fixtures/resource_list.xml

@@ -0,0 +1,26 @@
+<iq from="firehoser.superfeedr.com" to="test@superfeedr.com/client" type="result" id="subman1">
+  <pubsub xmlns:superfeedr="http://superfeedr.com/xmpp-pubsub-ext" xmlns="http://jabber.org/protocol/pubsub">
+    <subscriptions page="1">
+      <subscription node="http://superfeedr.com/dummy.xml" format="atom" jid="test@superfeedr.com" subscription="subscribed" digest="false">
+        <superfeedr:status>
+          <superfeedr:http code="304">Content not modified</superfeedr:http>
+          <superfeedr:next_fetch>2010-12-29T19:59:27+00:00</superfeedr:next_fetch>
+          <superfeedr:period>14400</superfeedr:period>
+          <superfeedr:last_fetch>2010-12-29T15:59:27+00:00</superfeedr:last_fetch>
+          <superfeedr:last_parse>2010-12-29T11:19:47+00:00</superfeedr:last_parse>
+          <superfeedr:last_maintenance_at>2010-12-29T07:21:29+00:00</superfeedr:last_maintenance_at>
+        </superfeedr:status>
+      </subscription>
+      <subscription node="http://superfeedr.com/fake.xml" format="atom" jid="test@superfeedr.com" subscription="subscribed" digest="false">
+        <superfeedr:status>
+          <superfeedr:http code="2">Content not modified</superfeedr:http>
+          <superfeedr:next_fetch>2010-12-29T19:59:27+00:00</superfeedr:next_fetch>
+          <superfeedr:period>14400</superfeedr:period>
+          <superfeedr:last_fetch>2010-12-29T15:59:27+00:00</superfeedr:last_fetch>
+          <superfeedr:last_parse>2010-12-29T11:19:47+00:00</superfeedr:last_parse>
+          <superfeedr:last_maintenance_at>2010-12-29T07:21:29+00:00</superfeedr:last_maintenance_at>
+        </superfeedr:status>
+      </subscription>
+    </subscriptions>
+  </pubsub>
+</iq>

data/spec/fixtures/resources_list_request.xml

@@ -0,0 +1,5 @@
+<iq type="get" id="subman1" to="firehoser.superfeedr.com" from="test@superfeedr.com/client">
+  <pubsub xmlns="http://jabber.org/protocol/pubsub" xmlns:superfeedr="http://superfeedr.com/xmpp-pubsub-ext">
+    <subscriptions superfeedr:page="1" jid="test@superfeedr.com/client"/>
+  </pubsub>
+</iq>

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__)) + "/../lib/superfeedr-blather"
+
+Bundler.require(:test)
+
+RSpec.configure do |config|
+  # config.include SpecHelper
+end

data/spec/stanza/notification_spec.rb

@@ -0,0 +1,152 @@
+require 'spec_helper'
+
+describe "notifications" do
+  let(:message) { @message ||= open(File.expand_path(File.dirname(__FILE__) + '/../fixtures/notification.xml')) }
+  let(:node)    { @node    ||= Blather::XMPPNode.import(Nokogiri::XML.parse(message).root) }
+  
+  describe Blather::Stanza::PubSub::Event do
+    it "finds items" do
+      node.should have(2).items
+    end
+
+    it "finds status" do
+      node.status.should be_present
+    end  
+  end
+
+  describe Blather::Stanza::PubSubItem do
+    it "finds entries" do
+      node.items.map(&:entry).compact.should have(2).entries
+    end
+  end
+
+  describe Superfeedr::Entry do
+    let(:entry) { node.items.first.entry }
+
+    it "finds the id" do
+      entry.id.should == "tag:superfeedr.com,2005:String/1291996755"
+    end
+
+    it "finds the title" do
+      entry.title.should == "15:59:15"
+    end  
+
+    it "finds the date published" do
+      entry.published_at.should == DateTime.parse("2010-12-10T15:59:15+00:00")
+    end
+    
+    it "finds the date updated" do
+      entry.updated_at.should == DateTime.parse("2010-12-10T15:59:15+00:00")
+    end
+
+    it "finds the mime-type of the content" do
+      entry.mime_type.should == "text"
+    end  
+    
+    it "finds the content" do
+      entry.content.should == "Friday December 10 15:59:15 UTC 2010 Somebody wanted to know what time it was."
+    end
+
+    it "finds the summary" do
+      entry.summary.should == "A short message from our sponsors"
+    end
+
+    it "finds the lanugage" do
+      entry.lang.should == "en-US"
+    end
+
+    it "finds the link" do
+      entry.link.should be_instance_of(Superfeedr::Link)
+    end
+    
+    it "finds points" do
+      entry.points.should have(1).item
+    end
+    
+    it "finds the categories" do
+      entry.categories.should =~ %w(tests)
+    end
+    
+    it "finds the authors" do
+      entry.authors.should have(1).item
+    end
+  end
+
+  describe Superfeedr::Status do
+    let(:status) { node.status }
+    
+    it "finds the title" do
+      status.title.should == "The Dummy Time Feed"
+    end
+
+    it "finds the http status" do
+      status.http_code.should == "200"
+    end
+
+    it "finds the http response stats" do
+      status.http.should == "7462B in 2.441718s, 2/10 new entries"
+    end
+
+    it "finds the entries_count_since_last_maintenance" do
+      status.entries_count_since_last_maintenance.should == 19
+    end
+
+    it "finds the period" do
+      status.period.should == 450
+    end
+
+    it "finds the next fetch datetime" do
+      status.next_fetch.should == DateTime.parse("2010-12-10T16:06:41Z")
+    end  
+  end
+
+  describe Superfeedr::Link do
+    let(:link) { node.items.first.entry.link }
+
+    it "finds type" do
+      link.type.should == "text/html"
+    end
+    
+    it "finds title" do
+      link.title.should == "15:59:15"
+    end
+
+    it "finds rel" do
+      link.rel.should == "alternate"
+    end
+
+    it "finds href" do
+      link.href.should == "http://superfeedr.com/?1291996755"
+    end  
+  end
+
+  describe Superfeedr::Author do
+    let(:author) { node.items.first.entry.authors.first }
+
+    it "finds name" do
+      author.name.should == "Superfeedr"
+    end
+
+    it "finds uri" do
+      author.uri.should == "http://superfeedr.com/"
+    end
+
+    it "finds email" do
+      author.email.should == "julien@superfeedr.com"
+    end
+  end
+
+  describe Superfeedr::Point do
+    let(:point) { node.items.first.entry.points.first }
+
+    it "finds long/lat" do
+      point.longtitude.should == "37.773721"
+      point.latitude.should   == "-122.414957"
+    end
+
+    it "finds raw data" do
+      point.raw.should == "37.773721,-122.414957"
+    end  
+  end
+
+end

data/spec/stanza/subscriptions_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+describe "list of resources/subscriptions" do
+  let(:stanza) { @stanza ||= open(File.expand_path(File.dirname(__FILE__) + '/../fixtures/resource_list.xml')) }
+  let(:node)   { @node   ||= Blather::XMPPNode.import(Nokogiri::XML.parse(stanza).root) }
+
+  describe Blather::Stanza::PubSub::Subscriptions do
+    it "finds subscriptions" do
+      node.list.should have(2).items
+    end
+  end
+
+  describe Superfeedr::Subscription do
+    let(:sub) { node.list.first }
+
+    it "finds subscription state" do
+      sub.subscription_state.should == "subscribed"
+    end    
+  end
+end
+
+describe "requesting list of resources/subscriptions" do
+  describe Blather::Stanza::PubSub::Subscriptions do
+    let(:node) { @node ||= Blather::Stanza::PubSub::Subscriptions.new(:get, :id => "subman1", :from => "test@superfeedr.com", :to => "firehoser.superfeedr.com") }
+    
+    it "includes correct to, from, and id attributes in the <iq> node" do
+      node["from"].should == "test@superfeedr.com"
+      node["to"].should   == "firehoser.superfeedr.com"
+      node["id"].should   == "subman1"
+    end
+    
+    it "includes superfeedr namespace in the <pubsub> node" do
+      pubsub_node = node.find_first(".//ns:subscriptions", :ns => Blather::Stanza::PubSub.registered_ns)
+      pubsub_node.namespaces["xmlns:sf"].should == "http://superfeedr.com/xmpp-pubsub-ext"
+    end
+    
+    it "includes page and jid in the <subscriptions> node" do
+      subscriptions_node = node.find_first(".//ns:subscriptions", :ns => Blather::Stanza::PubSub.registered_ns)
+      subscriptions_node["jid"].should == "test@superfeedr.com"
+      subscriptions_node["sf:page"].should == "1"
+    end    
+  end  
+end
+

data/superfeedr-blather.gemspec

@@ -0,0 +1,82 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{superfeedr-blather}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["dave@kapoq.com"]
+  s.date = %q{2011-01-03}
+  s.description = %q{You get some patches for Blather and some classes that wrap the stuff you want from Superfeedr (entries, authors etc.). Under-the-hood, Blather uses EventMachine and Nokogiri so it’s fast and convenient. If you want to daemonize your client, daemon-kit comes ready with a blather template.}
+  s.email = %q{dave@kapoq.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README",
+    "README.rdoc"
+  ]
+  s.files = [
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE",
+    "README",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "autotest/discover.rb",
+    "examples/echo.rb",
+    "examples/sub_unsub.rb",
+    "examples/timer.rb",
+    "lib/blather/event.rb",
+    "lib/blather/namespaces.rb",
+    "lib/blather/pubsub.rb",
+    "lib/blather/subscriptions.rb",
+    "lib/superfeedr-blather.rb",
+    "lib/superfeedr/superfeedr.rb",
+    "spec/fixtures/notification.xml",
+    "spec/fixtures/resource_list.xml",
+    "spec/fixtures/resources_list_request.xml",
+    "spec/spec_helper.rb",
+    "spec/stanza/notification_spec.rb",
+    "spec/stanza/subscriptions_spec.rb",
+    "superfeedr-blather.gemspec"
+  ]
+  s.homepage = %q{http://github.com/kapoq/superfeedr-blather}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{superfeedr-blather implements a Superfeedr PubSub XMPP client in Ruby using the Blather gem.}
+  s.test_files = [
+    "examples/echo.rb",
+    "examples/sub_unsub.rb",
+    "examples/timer.rb",
+    "spec/spec_helper.rb",
+    "spec/stanza/notification_spec.rb",
+    "spec/stanza/subscriptions_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<blather>, ["~> 0.4.14"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_development_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_runtime_dependency(%q<blather>, ["~> 0.4.14"])
+    else
+      s.add_dependency(%q<blather>, ["~> 0.4.14"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_dependency(%q<blather>, ["~> 0.4.14"])
+    end
+  else
+    s.add_dependency(%q<blather>, ["~> 0.4.14"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+    s.add_dependency(%q<yard>, ["~> 0.6.0"])
+    s.add_dependency(%q<blather>, ["~> 0.4.14"])
+  end
+end
+

metadata

@@ -0,0 +1,154 @@
+--- !ruby/object:Gem::Specification 
+name: superfeedr-blather
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- dave@kapoq.com
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-03 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: blather
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 4
+        - 14
+        version: 0.4.14
+  type: :runtime
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 5
+        - 2
+        version: 1.5.2
+  type: :development
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: yard
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 0
+        version: 0.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: blather
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 4
+        - 14
+        version: 0.4.14
+  type: :runtime
+  prerelease: false
+  version_requirements: *id004
+description: "You get some patches for Blather and some classes that wrap the stuff you want from Superfeedr (entries, authors etc.). Under-the-hood, Blather uses EventMachine and Nokogiri so it\xE2\x80\x99s fast and convenient. If you want to daemonize your client, daemon-kit comes ready with a blather template."
+email: dave@kapoq.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README
+- README.rdoc
+files: 
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README
+- README.rdoc
+- Rakefile
+- VERSION
+- autotest/discover.rb
+- examples/echo.rb
+- examples/sub_unsub.rb
+- examples/timer.rb
+- lib/blather/event.rb
+- lib/blather/namespaces.rb
+- lib/blather/pubsub.rb
+- lib/blather/subscriptions.rb
+- lib/superfeedr-blather.rb
+- lib/superfeedr/superfeedr.rb
+- spec/fixtures/notification.xml
+- spec/fixtures/resource_list.xml
+- spec/fixtures/resources_list_request.xml
+- spec/spec_helper.rb
+- spec/stanza/notification_spec.rb
+- spec/stanza/subscriptions_spec.rb
+- superfeedr-blather.gemspec
+has_rdoc: true
+homepage: http://github.com/kapoq/superfeedr-blather
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3239166693757579629
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: superfeedr-blather implements a Superfeedr PubSub XMPP client in Ruby using the Blather gem.
+test_files: 
+- examples/echo.rb
+- examples/sub_unsub.rb
+- examples/timer.rb
+- spec/spec_helper.rb
+- spec/stanza/notification_spec.rb
+- spec/stanza/subscriptions_spec.rb