twitter-stream 0.1.0

data/README.markdown

@@ -0,0 +1,30 @@
+# twitter-stream
+
+Simple Ruby client library for [twitter streaming API](http://apiwiki.twitter.com/Streaming-API-Documentation). 
+Uses [EventMachine](http://rubyeventmachine.com/) for connection handling. Adheres to twitter's [reconnection guidline](http://apiwiki.twitter.com/Streaming-API-Documentation#Connecting).
+
+JSON format only.
+
+## Usage
+
+    EventMachine::run {
+      stream = Twitter::JSONStream.connect(
+        :path    => '/1/statuses/filter.json?track=football',
+        :auth    => 'LOGIN:PASSWORD',
+      )
+
+      stream.each_item do |item|
+        # do someting with unparsed JSON item
+      end
+
+      stream.on_error do |message|
+        # log or something
+      end
+    }
+    
+
+## Examples
+
+Open examples/reader.rb. Replace LOGIN:PASSWORD with your real twitter login and password. And
+    ruby examples/reader.rb
+

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rubygems'
+gem 'rspec'
+require 'spec/rake/spectask'
+
+desc "Run all specs"
+Spec::Rake::SpecTask.new('spec') do |t|
+  t.spec_files = FileList['spec/**/*.rb']
+  t.spec_opts = %w(-fs --color)
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "twitter-stream"
+    gemspec.summary = "Twitter realtime API client"
+    gemspec.description = "Simple Ruby client library for twitter streaming API. Uses EventMachine for connection handling. Adheres to twitter's reconnection guidline. JSON format only."
+    gemspec.email = "voloko@gmail.com"
+    gemspec.homepage = "http://github.com/voloko/twitter-stream"
+    gemspec.authors = ["Vladimir Kolesnikov"]
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/VERSION

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

data/examples/reader.rb

@@ -0,0 +1,40 @@
+require 'rubygems'
+lib_path = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift lib_path unless $LOAD_PATH.include?(lib_path)
+
+require 'twitter/json_stream'
+
+EventMachine::run {
+  stream = Twitter::JSONStream.connect(
+    :path    => '/1/statuses/filter.json',
+    :auth    => 'LOGIN:PASSWORD',
+    :method  => 'POST',
+    :content => 'track=basketball,football,baseball,footy,soccer'
+  )
+    
+  stream.each_item do |item|
+    $stdout.print "item: #{item}\n"
+    $stdout.flush
+  end
+  
+  stream.on_error do |message|
+    $stdout.print "error: #{message}\n"
+    $stdout.flush
+  end
+  
+  stream.on_reconnect do |timeout, retries|
+    $stdout.print "reconnecting in: #{timeout} seconds\n"
+    $stdout.flush
+  end
+  
+  stream.on_max_reconnects do |timeout, retries|
+    $stdout.print "Failed after #{retries} failed reconnects\n"
+    $stdout.flush
+  end
+  
+  trap('TERM') {  
+    stream.stop
+    EventMachine.stop if EventMachine.reactor_running? 
+  }
+}
+puts "The event loop has ended"

data/fixtures/twitter/basic_http.txt

@@ -0,0 +1,14 @@
+HTTP/1.1 200 OK
+Content-Type: application/json
+Transfer-Encoding: chunked
+Server: Jetty(6.1.17)
+
+{"text":"Just wanted the world to know what our theologically deep pastor @bprentice has for a desktop background. http://yfrog.com/1rl4ij","favorited":false,"in_reply_to_user_id":null,"in_reply_to_screen_name":null,"source":"<a href=\"http://www.atebits.com/\" rel=\"nofollow\">Tweetie</a>","truncated":false,"created_at":"Thu Oct 08 19:34:09 +0000 2009","geo":null,"user":{"geo_enabled":false,"profile_text_color":"5b5252","location":"Stillwater, Oklahoma","statuses_count":122,"followers_count":70,"profile_link_color":"220099","description":"Taking an unchanging Savior to a changing world!  Eagle Heights in Stillwater, Oklahoma.","following":null,"friends_count":136,"profile_sidebar_fill_color":"f37a20","url":"http://www.eagleheights.com","profile_image_url":"http://a3.twimg.com/profile_images/249941843/online_logo_normal.jpg","verified":false,"notifications":null,"favourites_count":0,"profile_sidebar_border_color":"c5f109","protected":false,"screen_name":"eagleheights","profile_background_tile":false,"profile_background_image_url":"http://a1.twimg.com/profile_background_images/5935314/EHBC_LOGO.jpg","created_at":"Tue Mar 17 14:52:04 +0000 2009","name":"Eagle Heights","time_zone":"Central Time (US & Canada)","id":24892440,"utc_offset":-21600,"profile_background_color":"3d3d3d"},"id":4714982187,"in_reply_to_status_id":null}
+
+{"text":"I finally took a good pic of our resident BobCat @ the JakeCruise Ranch:  http://yfrog.com/769vij","favorited":false,"in_reply_to_user_id":null,"in_reply_to_screen_name":null,"source":"<a href=\"http://www.atebits.com/\" rel=\"nofollow\">Tweetie</a>","truncated":false,"created_at":"Thu Oct 08 19:34:12 +0000 2009","geo":null,"user":{"geo_enabled":false,"profile_text_color":"141318","location":"West Hollywood, CA","statuses_count":265,"followers_count":80,"profile_link_color":"DA4425","description":"Gay Programmer in SoCal","following":null,"friends_count":37,"profile_sidebar_fill_color":"5DD2F4","url":"http://www.kelvo.com/","profile_image_url":"http://a1.twimg.com/profile_images/197950488/kelvis_green_current_normal.jpeg","verified":false,"notifications":null,"favourites_count":1,"profile_sidebar_border_color":"1F6926","protected":false,"screen_name":"KelvisWeHo","profile_background_tile":false,"profile_background_image_url":"http://a1.twimg.com/profile_background_images/9898116/thaneeya3.jpg","created_at":"Fri Apr 17 18:44:57 +0000 2009","name":"Kelvis Del Rio","time_zone":"Pacific Time (US & Canada)","id":32517583,"utc_offset":-28800,"profile_background_color":"cccccc"},"id":4714983168,"in_reply_to_status_id":null}
+
+{"text":"Thursdays are long. But at least we're allowed a cheat sheet for stats.  http://yfrog.com/9gjc7j","favorited":false,"in_reply_to_user_id":null,"in_reply_to_screen_name":null,"source":"<a href=\"http://twitterrific.com\" rel=\"nofollow\">Twitterrific</a>","truncated":false,"created_at":"Thu Oct 08 19:34:21 +0000 2009","geo":null,"user":{"geo_enabled":false,"profile_text_color":"663B12","location":"Calgary ","statuses_count":68,"followers_count":10,"profile_link_color":"1F98C7","description":"pure. love. art. music. ","following":null,"friends_count":22,"profile_sidebar_fill_color":"DAECF4","url":null,"profile_image_url":"http://a3.twimg.com/profile_images/391882135/Photo_550_normal.jpg","verified":false,"notifications":null,"favourites_count":5,"profile_sidebar_border_color":"C6E2EE","protected":false,"screen_name":"KarinRudmik","profile_background_tile":false,"profile_background_image_url":"http://a3.twimg.com/profile_background_images/33520483/shimmering__by_AnBystrowska.jpg","created_at":"Wed Jul 29 02:37:13 +0000 2009","name":"Karin Rudmik","time_zone":"Mountain Time (US & Canada)","id":61091098,"utc_offset":-25200,"profile_background_color":"C6E2EE"},"id":4714986148,"in_reply_to_status_id":null}
+
+
+
+{"text":"acabando de almorzar, les comparto mi ultima creacion: http://yfrog.com/5mi94j pollo a la maracuya, con verduras sofritas ^^","favorited":false,"in_reply_to_user_id":null,"in_reply_to_screen_name":null,"source":"<a href=\"http://www.seesmic.com/\" rel=\"nofollow\">Seesmic</a>","truncated":false,"created_at":"Thu Oct 08 19:34:28 +0000 2009","geo":null,"user":{"geo_enabled":false,"profile_text_color":"3C3940","location":"Cartagena de Indias","statuses_count":1016,"followers_count":190,"profile_link_color":"0099B9","description":"Cartagenero extremadamente consentido, flojo y amante del anime, el manga, la cocina y los mmorpgs. pdt: y de los postres por supuesto!!!","following":null,"friends_count":253,"profile_sidebar_fill_color":"95E8EC","url":"http://www.flickr.com/photos/lobitokun/","profile_image_url":"http://a1.twimg.com/profile_images/451679242/shippo_normal.jpg","verified":false,"notifications":null,"favourites_count":9,"profile_sidebar_border_color":"5ED4DC","protected":false,"screen_name":"lobitokun","profile_background_tile":false,"profile_background_image_url":"http://a3.twimg.com/profile_background_images/24664583/hideki1.jpg","created_at":"Fri Jul 17 15:32:14 +0000 2009","name":"emiro gomez beltran","time_zone":"Bogota","id":57672295,"utc_offset":-18000,"profile_background_color":"0099B9"},"id":4714988998,"in_reply_to_status_id":null}

data/lib/twitter/json_stream.rb

@@ -0,0 +1,201 @@
+require 'eventmachine'
+require 'em/buftok'
+
+module Twitter
+  class JSONStream < EventMachine::Connection
+    MAX_LINE_LENGTH = 16*1024
+    
+    # network failure reconnections
+    NF_RECONNECT_START = 0.25 
+    NF_RECONNECT_ADD   = 0.25
+    NF_RECONNECT_MAX   = 16
+    
+    # app failure reconnections
+    AF_RECONNECT_START = 10
+    AF_RECONNECT_MUL   = 2
+    
+    RECONNECT_MAX   = 320
+    RETRIES_MAX     = 10
+    
+    DEFAULT_OPTIONS = {
+      :method       => 'GET',
+      :path         => '/',
+      :content_type => "application/x-www-form-urlencoded",
+      :content      => '',
+      :path         => '/1/statuses/filter.json',
+      :host         => 'stream.twitter.com',
+      :port         => 80,
+      :auth         => 'test:test',
+      :user_agent   => 'TwitterStream',
+    }
+
+    attr_accessor :code
+    attr_accessor :headers
+    attr_accessor :nf_last_reconnect
+    attr_accessor :af_last_reconnect
+    attr_accessor :reconnect_retries
+    
+    def self.connect options = {}
+      options = DEFAULT_OPTIONS.merge(options)
+      EventMachine.connect options[:host], options[:port], self, options
+    end
+
+    def initialize options = {}
+      @options = DEFAULT_OPTIONS.merge(options) # merge in case initialize called directly
+      @gracefully_closed = false
+      @nf_last_reconnect = nil
+      @af_last_reconnect = nil
+      @reconnect_retries = 0
+    end
+
+    def each_item &block
+      @each_item_callback = block
+    end
+    
+    def on_error &block
+      @error_callback = block
+    end
+    
+    def on_reconnect &block
+      @reconnect_callback = block
+    end
+    
+    def on_max_reconnects &block
+      @max_reconnects_callback = block
+    end
+
+    def stop
+      @gracefully_closed = true
+      close_connection
+    end
+    
+    def unbind
+      receive_line(@buffer.flush) unless @buffer.empty?
+      schedule_reconnect unless @gracefully_closed
+    end
+
+    def receive_data data
+      begin
+        @buffer.extract(data).each do |line| 
+          receive_line(line)
+        end
+      rescue Exception => e
+        receive_error(e.message)
+        close_connection
+        return
+      end
+    end
+    
+    def post_init
+      reset_state
+      send_request
+    end
+    
+  protected
+    def schedule_reconnect
+      timeout = reconnect_timeout
+      @reconnect_retries += 1
+      if timeout <= RECONNECT_MAX && @reconnect_retries <= RETRIES_MAX
+        reconnect_after(timeout) 
+      else
+        @max_reconnects_callback.call(timeout, @reconnect_retries) if @max_reconnects_callback
+      end
+    end
+    
+    def reconnect_after timeout
+      @reconnect_callback.call(timeout, @reconnect_retries) if @reconnect_callback
+      EventMachine.add_timer(timeout) do
+        reconnect @options[:host], @options[:port]
+      end
+    end
+    
+    def reconnect_timeout
+      if (@code == 0) # network failure
+        if @nf_last_reconnect
+          @nf_last_reconnect += NF_RECONNECT_ADD
+        else
+          @nf_last_reconnect = NF_RECONNECT_START
+        end
+        [@nf_last_reconnect,NF_RECONNECT_MAX].min
+      else
+        if @af_last_reconnect
+          @af_last_reconnect *= AF_RECONNECT_MUL
+        else
+          @af_last_reconnect = AF_RECONNECT_START
+        end
+        @af_last_reconnect
+      end
+    end
+  
+    def reset_state
+      @code    = 0
+      @headers = []
+      @state   = :init
+      @buffer  = BufferedTokenizer.new("\r", MAX_LINE_LENGTH)
+    end
+
+    def send_request
+      data = []
+      data << "#{@options[:method]} #{@options[:path]} HTTP/1.1"
+      data << "Host: #{@options[:host]}"
+      data << "User-agent: #{@options[:user_agent]}" if @options[:user_agent]
+      data << "Authorization: Basic " + [@options[:auth]].pack('m').delete("\r\n")
+      if @options[:method] == 'POST'
+        data << "Content-type: #{@options[:content_type]}"
+        data << "Content-length: #{@options[:content].length}"
+      end
+      data << "\r\n"
+      send_data data.join("\r\n") + @options[:content]
+    end
+
+    def receive_line ln
+      case @state
+      when :init
+        parse_response_line ln
+      when :headers
+        parse_header_line ln
+      when :stream
+        parse_stream_line ln
+      end
+    end
+
+    def receive_error e
+      @error_callback.call(e) if @error_callback
+    end
+
+    def parse_stream_line ln
+      ln.strip!
+      unless ln.empty?
+        if ln[0,1] == '{'
+          @each_item_callback.call(ln) if @each_item_callback
+        end
+      end
+    end
+
+    def parse_header_line ln
+      ln.strip!
+      if ln.empty?
+        reset_timeouts
+        @state = :stream
+      else
+        headers << ln
+      end
+    end
+
+    def parse_response_line ln
+      if ln =~ /\AHTTP\/1\.[01] ([\d]{3})/
+        @code = $1.to_i
+        @state = :headers
+      else
+        receive_error('invalid response')
+        close_connection
+      end
+    end
+    
+    def reset_timeouts
+      @nf_last_reconnect = @af_last_reconnect = nil
+      @reconnect_retries = 0
+    end
+
+  end  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+require 'rubygems'
+lib_path = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift lib_path unless $LOAD_PATH.include?(lib_path)
+
+gem 'rspec'
+require 'spec'
+require 'spec/mocks'
+
+def fixture_path(path)
+  File.join(File.dirname(__FILE__), '..', 'fixtures', path)
+end
+
+def read_fixture(path)
+  File.read(fixture_path(path))
+end

data/spec/twitter/json_stream.rb

@@ -0,0 +1,189 @@
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+require 'twitter/json_stream'
+
+include Twitter
+
+describe JSONStream do
+  
+  context "on create" do
+    
+    it "should return stream" do
+      EM.should_receive(:connect).and_return('TEST INSTANCE')
+      stream = JSONStream.connect {}
+      stream.should == 'TEST INSTANCE'
+    end
+    
+    it "should define default properties" do
+      EM.should_receive(:connect).with do |host, port, handler, opts|
+        host.should == 'stream.twitter.com'
+        port.should == 80
+        opts[:path].should == '/1/statuses/filter.json'
+        opts[:method].should == 'GET'
+      end
+      stream = JSONStream.connect {}
+    end
+    
+  end
+  
+  
+  Host = "127.0.0.1"
+  Port = 9550
+  
+  class JSONServer < EM::Connection
+    attr_accessor :data
+    def receive_data data
+      $recieved_data = data
+      send_data $data_to_send
+      EventMachine.next_tick {
+        close_connection if $close_connection
+      }
+    end
+  end
+  
+  context "on valid stream" do
+    before :each do
+      $data_to_send = read_fixture('twitter/basic_http.txt')
+      $recieved_data = ''
+      $close_connection = false
+    end
+    
+    it "should parse headers" do
+      EM.run {
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port
+        EM.add_timer(0.5){ EM.stop }
+      }
+      @stream.code.should == 200
+      @stream.headers[0].downcase.should include 'content-type'
+    end
+    
+    it "should parse headers even after connection close" do
+      EM.run {
+        $close_connection = true
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port
+        EM.add_timer(0.5){ EM.stop }
+      }
+      @stream.code.should == 200
+      @stream.headers[0].downcase.should include 'content-type'
+    end
+    
+    it "should extract records" do
+      EM.run {
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port, :user_agent => 'TEST_USER_AGENT'
+        EM.add_timer(0.5){ EM.stop }
+      }
+      $recieved_data.upcase.should include('USER-AGENT: TEST_USER_AGENT')
+    end
+    
+    it "should send correct user agent" do
+      EM.run {
+        $close_connection = true
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port
+        EM.add_timer(0.5){ EM.stop }
+      }
+    end
+  end
+  
+  context "on network failure" do
+    before :each do
+      $data_to_send = ''
+      $close_connection = true
+    end
+    
+    it "should reconnect on network failure" do
+      EM.run {
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port
+        @stream.should_receive(:reconnect)
+        EM.add_timer(0.5){ EM.stop }
+      }
+    end
+    
+    it "should reconnect with 0.25 at base" do
+      EM.run {
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port
+        @stream.should_receive(:reconnect_after).with(0.25)
+        EM.add_timer(0.5){ EM.stop }
+      }
+    end
+    
+    it "should reconnect with linear timeout" do
+      EM.run {
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port
+        @stream.nf_last_reconnect = 1
+        @stream.should_receive(:reconnect_after).with(1.25)
+        EM.add_timer(0.5){ EM.stop }
+      }
+    end
+    
+    it "should stop reconnecting after 100 times" do
+      EM.run {
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port
+        @stream.reconnect_retries = 100
+        @stream.should_not_receive(:reconnect_after)
+        EM.add_timer(0.5){ EM.stop }
+      }
+    end
+    
+    it "should notify after reconnect limit is reached" do
+      timeout, retries = nil, nil
+      EM.run {
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port
+        @stream.on_max_reconnects do |t, r|
+          timeout, retries = t, r
+        end
+        @stream.reconnect_retries = 100
+        EM.add_timer(0.5){ EM.stop }
+      }
+      timeout.should == 0.25
+      retries.should == 101
+    end
+  end
+  
+  context "on application failure" do
+    before :each do
+      $data_to_send = 'HTTP/1.1 401 Unauthorized\r\nWWW-Authenticate: Basic realm="Firehose"\r\n\r\n1'
+      $close_connection = true
+    end
+    
+    it "should reconnect on application failure 10 at base" do
+      EM.run {
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port
+        @stream.should_receive(:reconnect_after).with(10)
+        EM.add_timer(0.5){ EM.stop }
+      }
+    end
+    
+    it "should reconnect with exponential timeout" do
+      EM.run {
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port
+        @stream.af_last_reconnect = 160
+        @stream.should_receive(:reconnect_after).with(320)
+        EM.add_timer(0.5){ EM.stop }
+      }
+    end
+    
+    it "should not try to reconnect after limit is reached" do
+      EM.run {
+        EM.start_server Host, Port, JSONServer
+        @stream = JSONStream.connect :host => Host, :port => Port
+        @stream.af_last_reconnect = 320
+        @stream.should_not_receive(:reconnect_after)
+        EM.add_timer(0.5){ EM.stop }
+      }
+    end
+  end
+  
+  
+  
+end
+

data/twitter-stream.gemspec

@@ -0,0 +1,46 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{twitter-stream}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Vladimir Kolesnikov"]
+  s.date = %q{2009-10-11}
+  s.description = %q{Simple Ruby client library for twitter streaming API. Uses EventMachine for connection handling. Adheres to twitter's reconnection guidline. JSON format only.}
+  s.email = %q{voloko@gmail.com}
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "examples/reader.rb",
+     "fixtures/twitter/basic_http.txt",
+     "lib/twitter/json_stream.rb",
+     "spec/spec_helper.rb",
+     "spec/twitter/json_stream.rb",
+     "twitter-stream.gemspec"
+  ]
+  s.homepage = %q{http://github.com/voloko/twitter-stream}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.4}
+  s.summary = %q{Twitter realtime API client}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/twitter/json_stream.rb",
+     "examples/reader.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: twitter-stream
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Vladimir Kolesnikov
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-11 00:00:00 +04:00
+default_executable: 
+dependencies: []
+
+description: Simple Ruby client library for twitter streaming API. Uses EventMachine for connection handling. Adheres to twitter's reconnection guidline. JSON format only.
+email: voloko@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- README.markdown
+- Rakefile
+- VERSION
+- examples/reader.rb
+- fixtures/twitter/basic_http.txt
+- lib/twitter/json_stream.rb
+- spec/spec_helper.rb
+- spec/twitter/json_stream.rb
+- twitter-stream.gemspec
+has_rdoc: true
+homepage: http://github.com/voloko/twitter-stream
+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: 
+rubygems_version: 1.3.4
+signing_key: 
+specification_version: 3
+summary: Twitter realtime API client
+test_files: 
+- spec/spec_helper.rb
+- spec/twitter/json_stream.rb
+- examples/reader.rb