pubsubhubbub 0.1.0

data/README.rdoc

@@ -0,0 +1,27 @@
+= Ruby / Asynchronous PubSubHubbub Client
+
+EventMachine based / asynchronous PubSubHubbub client. Supports posting single or multiple URLs.
+
+Full Spec: http://code.google.com/p/pubsubhubbub
+
+HTTP PubSub: Webhooks & PubSubHubbub: http://www.igvita.com/2009/06/29/http-pubsub-webhooks-pubsubhubbub
+
+== Simple client example
+
+  EventMachine.run {
+    pub = EventMachine::PubSubHubbub.new('http://pubsubhubbub.appspot.com/publish').publish "http://www.test.com/"
+
+    pub.callback { puts "Successfully notified hub." }
+    pub.errback  { puts "Uh oh, something broke: #{pub.response}" }
+  }
+
+== Posting multiple URL's
+
+  EventMachine.run {
+    feeds = ["http://www.test.com", "http://www.test.com/2"]
+    pub = EventMachine::PubSubHubbub.new('http://pubsubhubbub.appspot.com/publish').publish feeds
+
+    pub.callback { puts "Successfully notified hub." }
+    pub.errback  { puts "Uh oh, something broke: #{pub.response}" }
+  }
+

data/VERSION

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

data/lib/pubsubhubbub.rb

@@ -0,0 +1,10 @@
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+
+require "rubygems"
+require "eventmachine"
+require "em-http"
+require "cgi"
+
+%w[ client ].each do |file|
+  require "pubsubhubbub/#{file}"
+end

data/lib/pubsubhubbub/client.rb

@@ -0,0 +1,60 @@
+# #--
+# Copyright (C)2009 Ilya Grigorik
+#
+# You can redistribute this under the terms of the Ruby
+# #--
+
+module EventMachine
+  class PubSubHubbub
+    include EventMachine::Deferrable
+
+    HEADERS = {"User-Agent" => "PubSubHubbub Ruby", "Content-Type" => "application/x-www-form-urlencoded"}
+
+    def initialize(hub)
+      @hub = hub.kind_of?(URI) ? hub : URI::parse(hub)
+    end
+
+    def publish(*feeds)
+      data = feeds.flatten.collect do |feed|
+        {'hub.url' => feed, 'hub.mode' => 'publish'}.to_params
+      end.join("&")
+
+      r = EventMachine::HttpRequest.new(@hub).post :body => data, :head => HEADERS
+      r.callback { 
+        if r.response_header.status == 204
+          succeed r
+        else
+          fail r
+        end
+      }
+
+      r.errback { fail }
+      r
+    end
+
+     # These command will work only if the callback URL supports confirmation.
+    def subscribe(feed, callback, options = {});   command('subscribe', feed, callback, options);   end
+    def unsubscribe(feed, callback, options = {}); command('unsubscribe', feed, callback, options); end
+
+    private
+    
+    def command(cmd, feed, callback, options)
+      options['hub.verify'] ||= "sync"
+
+      params = {'hub.topic' => feed, 'hub.mode' => cmd, 'hub.callback' => callback}.merge(options).to_params
+      r = EventMachine::HttpRequest.new(@hub).post :body => params, :head => HEADERS
+
+      r.callback {
+        if r.response_header.status == 204
+          succeed r
+        else
+          fail r
+        end
+      }
+
+      r.errback { fail }
+      r
+    end
+
+  end
+end

data/test/test_client.rb

@@ -0,0 +1,62 @@
+require 'rubygems'
+require 'spec'
+require 'eventmachine'
+require 'lib/pubsubhubbub'
+
+describe EventMachine::PubSubHubbub do
+
+  def failed
+    EventMachine.stop
+    fail
+  end
+
+  it "should publish single feed to hub" do
+    EventMachine.run {
+      pub = EventMachine::PubSubHubbub.new('http://pubsubhubbub.appspot.com/publish').publish "http://www.test.com/"
+
+      pub.errback { failed }
+      pub.callback {
+        pub.response_header.status.should == 204
+        EventMachine.stop
+      }
+    }
+  end
+
+  it "should publish multiple feeds to hub" do
+    EventMachine.run {
+      feeds = ['http://www.test.com', 'http://www.test.com/2']
+      pub = EventMachine::PubSubHubbub.new('http://pubsubhubbub.appspot.com/publish').publish feeds
+
+      pub.errback { failed }
+      pub.callback {
+        pub.response_header.status.should == 204
+        EventMachine.stop
+      }
+    }
+  end
+  
+  it "should subscribe a single feed to hub" do
+    EventMachine.run {
+      sub = EventMachine::PubSubHubbub.new('http://pubsubhubbub.appspot.com/').subscribe "http://blog.superfeedr.com/atom.xml", "http://superfeedr.com/hubbub", {}
+      
+      sub.errback { failed }
+      sub.callback {
+        sub.response_header.status.should == 204
+        EventMachine.stop
+      }
+    }    
+  end
+  
+  it "should unsubscribe a single feed to hub" do
+    EventMachine.run {
+      sub = EventMachine::PubSubHubbub.new('http://pubsubhubbub.appspot.com/').unsubscribe "http://blog.superfeedr.com/atom.xml", "http://superfeedr.com/hubbub", {}
+      
+      sub.errback { failed }
+      sub.callback {
+        sub.response_header.status.should == 204
+        EventMachine.stop
+      }
+    }    
+  end
+
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: pubsubhubbub
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Ilya Grigorik
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-26 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: eventmachine
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.12.9
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: em-http-request
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.1.5
+    version: 
+description: Asynchronous PubSubHubbub client for Ruby
+email: ilya@igvita.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- VERSION
+- lib/pubsubhubbub.rb
+- lib/pubsubhubbub/client.rb
+- test/test_client.rb
+has_rdoc: true
+homepage: http://github.com/igrigorik/pubsubhubbub
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: pubsubhubbub
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Asynchronous PubSubHubbub client for Ruby
+test_files: 
+- test/test_client.rb