xh5-twitter-stream 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+.rake_tasks~
+*.swp
+*.orig
+/pkg

data/README.markdown

@@ -0,0 +1,44 @@
+# xh5-twitter-stream
+
+Forked from original TwitterStream gem. This fork doesn't use Twitter::Module.
+
+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.
+
+## Install
+
+    sudo gem install xh5-twitter-stream -s http://gemcutter.org
+
+## Usage
+
+    require 'rubygems'
+    require 'twitter_stream/json_stream'
+    
+    EventMachine::run {
+      stream = TwitterStream::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|
+        # No need to worry here. It might be an issue with Twitter. 
+        # Log message for future reference. JSONStream will try to reconnect after a timeout.
+      end
+      
+      stream.on_max_reconnects do |timeout, retries|
+        # Something is wrong on your side. Send yourself an email.
+      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,28 @@
+require 'rubygems'
+
+gem 'rspec', '= 1.3.0'
+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
+task :default => :spec
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "xh5-twitter-stream"
+    gemspec.summary = "Twitter realtime API client"
+    gemspec.description = "Fork of TwitterStream by Vladimir Koklesnikov. Simple Ruby client library for twitter streaming API. Uses EventMachine for connection handling. Adheres to twitter's reconnection guidline. JSON format only."
+    gemspec.email = "eric@xhfive.com"
+    gemspec.homepage = "http://github.com/erichurst/twitter-stream"
+    gemspec.authors = ["Vladimir Kolesnikov"]
+    gemspec.add_dependency("eventmachine", [">= 0.12.8"])
+    gemspec.add_dependency("roauth", [">= 0.0.2"])
+    gemspec.add_development_dependency("rspec", [">= 1.3.0"])
+  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_stream/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_stream/json_stream.rb

@@ -0,0 +1,290 @@
+require 'eventmachine'
+require 'em/buftok'
+require 'uri'
+require 'roauth'
+
+module TwitterStream
+  class JSONStream < EventMachine::Connection
+    MAX_LINE_LENGTH = 1024*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,
+      :ssl          => false,
+      :user_agent   => 'TwitterStream',
+      :timeout      => 0,
+      :proxy        => ENV['HTTP_PROXY'],
+      :auth         => nil,
+      :oauth        => {},
+      :filters      => []
+    }
+
+    attr_accessor :code
+    attr_accessor :headers
+    attr_accessor :nf_last_reconnect
+    attr_accessor :af_last_reconnect
+    attr_accessor :reconnect_retries
+    attr_accessor :proxy
+    
+    def self.connect options = {}
+      options[:port] = 443 if options[:ssl] && !options.has_key?(:port)
+      options = DEFAULT_OPTIONS.merge(options)
+
+      host = options[:host]
+      port = options[:port]
+
+      if options[:proxy]
+        proxy_uri = URI.parse(options[:proxy])
+        host = proxy_uri.host
+        port = proxy_uri.port
+      end
+      
+      connection = EventMachine.connect host, port, self, options
+      connection.start_tls if options[:ssl]
+      connection
+    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
+      @immediate_reconnect = false
+      @proxy = URI.parse(options[:proxy]) if options[:proxy]
+    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 immediate_reconnect
+      @immediate_reconnect = true
+      @gracefully_closed = false
+      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.class}: " + [e.message, e.backtrace].flatten.join("\n\t"))
+        close_connection
+        return
+      end
+    end
+    
+    def connection_completed
+      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
+
+      if timeout == 0
+        reconnect @options[:host], @options[:port]
+      else
+        EventMachine.add_timer(timeout) do
+          reconnect @options[:host], @options[:port]
+        end
+      end
+    end
+    
+    def reconnect_timeout
+      if @immediate_reconnect
+        @immediate_reconnect = false
+        return 0
+      end
+      
+      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
+      set_comm_inactivity_timeout @options[:timeout] if @options[:timeout] > 0
+      @code    = 0
+      @headers = []
+      @state   = :init
+      @buffer  = BufferedTokenizer.new("\r", MAX_LINE_LENGTH)
+    end
+
+    def send_request
+      data = []
+      request_uri = @options[:path]
+      
+      if @proxy
+        # proxies need the request to be for the full url
+        request_uri = "http#{'s' if @options[:ssl]}://#{@options[:host]}:#{@options[:port]}#{request_uri}"
+      end
+      
+      content = @options[:content]
+      
+      if !@options[:filters].empty?
+        if @options[:method].to_s.upcase == 'GET'
+          request_uri << "?#{filter_list}"
+        else
+          content = filter_list
+        end
+      end
+      
+      data << "#{@options[:method]} #{request_uri} HTTP/1.1"
+      data << "Host: #{@options[:host]}"
+      data << "User-Agent: #{@options[:user_agent]}" if @options[:user_agent]
+      
+      if @options[:auth]
+        data << "Authorization: Basic #{[@options[:auth]].pack('m').delete("\r\n")}"
+      elsif @options[:oauth]
+        data << "Authorization: #{oauth_header}"
+      end
+      
+      if @proxy && @proxy.user
+        data << "Proxy-Authorization: Basic " + ["#{@proxy.user}:#{@proxy.password}"].pack('m').delete("\r\n")
+      end
+      if @options[:method] == 'POST'
+        data << "Content-type: #{@options[:content_type]}"
+        data << "Content-length: #{content.length}"
+      end
+      data << "\r\n"
+      
+      send_data data.join("\r\n") << 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 if @code == 200
+        @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
+        receive_error("invalid status code: #{@code}. #{ln}") unless @code == 200
+      else
+        receive_error('invalid response')
+        close_connection
+      end
+    end
+    
+    def reset_timeouts
+      @nf_last_reconnect = @af_last_reconnect = nil
+      @reconnect_retries = 0
+    end
+    
+    # :filters => %w(miama lebron jesus)
+    # :oauth => {
+    #   :consumer_key    => [key],
+    #   :consumer_secret => [token],
+    #   :access_key      => [access key],
+    #   :access_secret   => [access secret]
+    # }
+    def oauth_header
+      uri = "http://#{@options[:host]}#{@options[:path]}"
+      
+      params = {
+        'track' => @options[:filters].join(',')
+      }
+      
+      ::ROAuth.header(@options[:oauth], uri, params, @options[:method])
+    end
+    
+    def filter_list
+      "track=#{@options[:filters].join(',')}"
+    end
+
+  end  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,27 @@
+require 'rubygems'
+$:.unshift File.expand_path("../../lib", __FILE__)
+
+gem 'rspec', '= 1.3.0'
+require 'spec'
+require 'spec/mocks'
+
+require 'twitter_stream/json_stream'
+
+def fixture_path(path)
+  File.join(File.dirname(__FILE__), '..', 'fixtures', path)
+end
+
+def read_fixture(path)
+  File.read(fixture_path(path))
+end
+
+def connect_stream(opts={}, &blk)
+  EM.run {
+    opts.merge!(:host => Host, :port => Port)
+    stop_in = opts.delete(:stop_in) || 0.5
+    EM.start_server Host, Port, JSONServer
+    @stream = JSONStream.connect(opts)
+    blk.call if blk
+    EM.add_timer(stop_in){ EM.stop }
+  }
+end

data/spec/twitter_stream/json_stream.rb

@@ -0,0 +1,162 @@
+$:.unshift "."
+require File.dirname(__FILE__) + '/../spec_helper.rb'
+require 'twitter_stream/json_stream'
+
+include TwitterStream
+
+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
+    
+    it "should connect to the proxy if provided" do
+      EM.should_receive(:connect).with do |host, port, handler, opts|
+        host.should == 'my-proxy'
+        port.should == 8080
+        opts[:host].should == 'stream.twitter.com'
+        opts[:port].should == 80
+        opts[:proxy].should == 'http://my-proxy:8080'
+      end
+      stream = JSONStream.connect(:proxy => "http://my-proxy:8080") {}
+    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
+    attr_reader :stream
+    before :each do
+      $data_to_send = read_fixture('twitter_stream/basic_http.txt')
+      $recieved_data = ''
+      $close_connection = false
+    end
+    
+    it "should parse headers" do
+      connect_stream
+      stream.code.should == 200
+      stream.headers[0].downcase.should include 'content-type'
+    end
+    
+    it "should parse headers even after connection close" do
+      connect_stream
+      stream.code.should == 200
+      stream.headers[0].downcase.should include 'content-type'
+    end
+    
+    it "should extract records" do
+      connect_stream :user_agent => 'TEST_USER_AGENT'
+      $recieved_data.upcase.should include('USER-AGENT: TEST_USER_AGENT')
+    end
+    
+    it "should send correct user agent" do
+      connect_stream
+    end
+  end
+  
+  context "on network failure" do
+    attr_reader :stream
+    before :each do
+      $data_to_send = ''
+      $close_connection = true
+    end
+    
+    it "should timeout on inactivity" do
+      connect_stream :stop_in => 1.5 do
+        stream.should_receive(:reconnect)        
+      end
+    end    
+    
+    it "should reconnect on network failure" do
+      connect_stream do
+        stream.should_receive(:reconnect)
+      end
+    end
+    
+    it "should reconnect with 0.25 at base" do
+      connect_stream do
+        stream.should_receive(:reconnect_after).with(0.25)
+      end
+    end
+    
+    it "should reconnect with linear timeout" do
+      connect_stream do
+        stream.nf_last_reconnect = 1
+        stream.should_receive(:reconnect_after).with(1.25)
+      end
+    end
+    
+    it "should stop reconnecting after 100 times" do
+      connect_stream do
+        stream.reconnect_retries = 100
+        stream.should_not_receive(:reconnect_after)
+      end
+    end
+    
+    it "should notify after reconnect limit is reached" do
+      timeout, retries = nil, nil
+      connect_stream do
+        stream.on_max_reconnects do |t, r|
+          timeout, retries = t, r
+        end
+        stream.reconnect_retries = 100
+      end
+      timeout.should == 0.25
+      retries.should == 101
+    end
+  end
+  
+  context "on application failure" do
+    attr_reader :stream
+    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
+      connect_stream do
+        stream.should_receive(:reconnect_after).with(10)
+      end
+    end
+    
+    it "should reconnect with exponential timeout" do
+      connect_stream do
+        stream.af_last_reconnect = 160
+        stream.should_receive(:reconnect_after).with(320)
+      end
+    end
+    
+    it "should not try to reconnect after limit is reached" do
+      connect_stream do
+        stream.af_last_reconnect = 320
+        stream.should_not_receive(:reconnect_after)
+      end
+    end
+  end  
+end

data/xh5-twitter-stream.gemspec

@@ -0,0 +1,61 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{xh5-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{2010-10-12}
+  s.description = %q{Fork of TwitterStream by Vladimir Koklesnikov. 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{eric@xhfive.com}
+  s.extra_rdoc_files = [
+    "README.markdown"
+  ]
+  s.files = [
+    ".gitignore",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "examples/reader.rb",
+     "fixtures/twitter_stream/basic_http.txt",
+     "lib/twitter_stream/.json_stream.rb.swp",
+     "lib/twitter_stream/json_stream.rb",
+     "spec/spec_helper.rb",
+     "spec/twitter_stream/json_stream.rb",
+     "xh5-twitter-stream.gemspec"
+  ]
+  s.homepage = %q{http://github.com/erichurst/twitter-stream}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Twitter realtime API client}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/twitter_stream/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
+      s.add_runtime_dependency(%q<eventmachine>, [">= 0.12.8"])
+      s.add_runtime_dependency(%q<roauth>, [">= 0.0.2"])
+      s.add_development_dependency(%q<rspec>, [">= 1.3.0"])
+    else
+      s.add_dependency(%q<eventmachine>, [">= 0.12.8"])
+      s.add_dependency(%q<roauth>, [">= 0.0.2"])
+      s.add_dependency(%q<rspec>, [">= 1.3.0"])
+    end
+  else
+    s.add_dependency(%q<eventmachine>, [">= 0.12.8"])
+    s.add_dependency(%q<roauth>, [">= 0.0.2"])
+    s.add_dependency(%q<rspec>, [">= 1.3.0"])
+  end
+end
+

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification 
+name: xh5-twitter-stream
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Vladimir Kolesnikov
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-12 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: eventmachine
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 12
+        - 8
+        version: 0.12.8
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: roauth
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 0
+        - 2
+        version: 0.0.2
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id003
+description: Fork of TwitterStream by Vladimir Koklesnikov. Simple Ruby client library for twitter streaming API. Uses EventMachine for connection handling. Adheres to twitter's reconnection guidline. JSON format only.
+email: eric@xhfive.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- .gitignore
+- README.markdown
+- Rakefile
+- VERSION
+- examples/reader.rb
+- fixtures/twitter_stream/basic_http.txt
+- lib/twitter_stream/.json_stream.rb.swp
+- lib/twitter_stream/json_stream.rb
+- spec/spec_helper.rb
+- spec/twitter_stream/json_stream.rb
+- xh5-twitter-stream.gemspec
+has_rdoc: true
+homepage: http://github.com/erichurst/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 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Twitter realtime API client
+test_files: 
+- spec/spec_helper.rb
+- spec/twitter_stream/json_stream.rb
+- examples/reader.rb