jls-tweetstream 2.5.0

data/spec/fixtures/info.json

@@ -0,0 +1,18 @@
+{
+    "info":
+    {
+        "users":
+        [
+            {
+                "id":119476949,
+                "name":"oauth_dancer",
+                "dm":false
+            }
+        ],
+        "delimited":"none",
+        "include_followings_activity":false,
+        "include_user_changes":false,
+        "replies":"none",
+        "with":"user"
+    }
+}

data/spec/fixtures/limit.json

@@ -0,0 +1,5 @@
+{
+  "limit": {
+    "track": 1234
+  }
+}

data/spec/fixtures/scrub_geo.json

@@ -0,0 +1,8 @@
+{
+  "scrub_geo": {
+    "user_id": 1234,
+    "user_id_str": "1234",
+    "up_to_status_id":9876,
+    "up_to_status_id_string": "9876"
+  }
+}

data/spec/fixtures/stall_warning.json

@@ -0,0 +1,7 @@
+{
+  "warning":{
+    "code":"FALLING_BEHIND",
+    "message":"Your connection is falling behind and messages are being queued for delivery to you. Your queue is now over 60% full. You will be disconnected when the queue is full.",
+    "percent_full": 60
+  }
+}

data/spec/fixtures/status_withheld.json

@@ -0,0 +1,7 @@
+{
+  "status_withheld":{
+      "id":1234567890,
+      "user_id":123456,
+      "withheld_in_countries":["de", "ar"]
+  }
+}

data/spec/fixtures/statuses.json

@@ -0,0 +1 @@
+{"favorited":false,"text":"listening to Where U Headed by Universal Playaz. http://iLike.com/s/9zpOZ #musicmonday something for the ladies","in_reply_to_user_id":null,"in_reply_to_screen_name":null,"source":"<a href=\"http://www.iLike.com\" rel=\"nofollow\">iLike</a>","truncated":false,"created_at":"Tue Sep 22 01:29:13 +0000 2009","user":{"statuses_count":378,"favourites_count":1,"profile_text_color":"666666","location":"Atlanta, Ga","profile_background_image_url":"http://a3.twimg.com/profile_background_images/36516125/Universal_Playaz.jpg","profile_link_color":"2FC2EF","description":"Paper Chaser","following":null,"verified":false,"notifications":null,"profile_sidebar_fill_color":"252429","profile_image_url":"http://a1.twimg.com/profile_images/413331530/DIESELSTATScopy_normal.jpg","url":"http://www.myspace.com/DieselDtheg","profile_sidebar_border_color":"181A1E","screen_name":"DieselD2143","profile_background_tile":true,"followers_count":75,"protected":false,"time_zone":"Eastern Time (US & Canada)","created_at":"Thu Jun 18 15:56:32 +0000 2009","name":"Diesel D","friends_count":119,"profile_background_color":"1A1B1F","id":48392351,"utc_offset":-18000},"in_reply_to_status_id":null,"id":4161231023} {"favorited":false,"text":"David Bowie and Nine Inch Nails perform \"Hurt\" http://bit.ly/AOaWG #musicmonday #nineinchnails #nin","in_reply_to_user_id":null,"in_reply_to_screen_name":null,"source":"web","truncated":false,"created_at":"Tue Sep 22 01:29:16 +0000 2009","user":{"statuses_count":668,"favourites_count":25,"profile_text_color":"445d85","location":"S\u00e3o Paulo, Brazil","profile_background_image_url":"http://a3.twimg.com/profile_background_images/38174991/GeorgeRomero-oil-400.jpg","profile_link_color":"555757","description":"You think I ain't worth a dollar, but I feel like a millionaire","following":null,"verified":false,"notifications":null,"profile_sidebar_fill_color":"a3a7ad","profile_image_url":"http://a1.twimg.com/profile_images/96034368/n1076431955_30001395_7912_normal.jpg","url":null,"profile_sidebar_border_color":"c7d1ed","screen_name":"RenatonMiranda","profile_background_tile":true,"followers_count":111,"protected":false,"time_zone":"Santiago","created_at":"Sat Mar 14 15:03:59 +0000 2009","name":"Renato Miranda","friends_count":143,"profile_background_color":"287356","id":24379310,"utc_offset":-14400},"in_reply_to_status_id":null,"id":4161232008} {"favorited":false,"text":"#musicmonday ,time to download some songs today!! :)","in_reply_to_user_id":null,"in_reply_to_screen_name":null,"source":"web","truncated":false,"created_at":"Tue Sep 22 01:29:19 +0000 2009","user":{"statuses_count":188,"favourites_count":0,"profile_text_color":"3D1957","location":"under the water","profile_background_image_url":"http://s.twimg.com/a/1253562286/images/themes/theme10/bg.gif","profile_link_color":"FF0000","description":"ask me ","following":null,"verified":false,"notifications":null,"profile_sidebar_fill_color":"7AC3EE","profile_image_url":"http://a1.twimg.com/profile_images/421281292/twit_pic_normal.jpg","url":"http://www.exploretalent.com/contest_video.php?talentnum=2053105&cm_id=3398","profile_sidebar_border_color":"65B0DA","screen_name":"julieanne11343","profile_background_tile":true,"followers_count":9,"protected":false,"time_zone":"Pacific Time (US & Canada)","created_at":"Mon Jul 20 21:08:22 +0000 2009","name":"Julieanne","friends_count":17,"profile_background_color":"642D8B","id":58591151,"utc_offset":-28800},"in_reply_to_status_id":null,"id":4161233120} {"text":"#Musicmonday \"Dont be tardy f0r the party\"","truncated":false,"source":"<a href=\"http://twitterhelp.blogspot.com/2008/05/twitter-via-mobile-web-mtwittercom.html\" rel=\"nofollow\">mobile web</a>","in_reply_to_status_id":null,"favorited":false,"created_at":"Tue Sep 22 01:29:19 +0000 2009","user":{"verified":false,"notifications":null,"profile_sidebar_fill_color":"e0ff92","location":"Dope Girl Island","profile_sidebar_border_color":"87bc44","description":"","following":null,"profile_background_tile":false,"followers_count":29,"profile_image_url":"http://a3.twimg.com/profile_images/217487577/badbad_normal.jpg","time_zone":"Eastern Time (US & Canada)","url":null,"friends_count":65,"profile_background_color":"9ae4e8","screen_name":"SwagGirlOnDeck","protected":false,"statuses_count":847,"favourites_count":0,"created_at":"Fri May 01 16:59:15 +0000 2009","profile_text_color":"000000","name":"Mariah Reta","id":36987168,"profile_background_image_url":"http://s.twimg.com/a/1253301564/images/themes/theme1/bg.png","utc_offset":-18000,"profile_link_color":"0000ff"},"in_reply_to_user_id":null,"id":4161233317,"in_reply_to_screen_name":null} 

data/spec/fixtures/user_withheld.json

@@ -0,0 +1,6 @@
+{
+  "user_withheld":{
+    "id":123456,
+    "withheld_in_countries":["de","ar"]
+  }
+}

data/spec/helper.rb

@@ -0,0 +1,58 @@
+require 'simplecov'
+require 'coveralls'
+
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start
+
+require 'tweetstream'
+require 'tweetstream/site_stream_client'
+require 'json'
+require 'rspec'
+require 'webmock/rspec'
+require 'yajl'
+
+WebMock.disable_net_connect!(:allow => 'coveralls.io')
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+
+  config.after(:each) do
+    TweetStream.reset
+  end
+end
+
+def samples(fixture)
+  samples = []
+  Yajl::Parser.parse(fixture(fixture), :symbolize_keys => true) do |hash|
+    samples << hash
+  end
+  samples
+end
+
+def sample_tweets
+  return @tweets if @tweets
+  @tweets = samples('statuses.json')
+end
+
+def sample_direct_messages
+  return @direct_messages if @direct_messages
+  @direct_messages = samples('direct_messages.json')
+end
+
+def fixture_path
+  File.expand_path("../fixtures", __FILE__)
+end
+
+def fixture(file)
+  File.new(fixture_path + '/' + file)
+end
+
+FakeHttp = Class.new do
+  def callback; end
+  def errback; end
+end

data/spec/tweetstream/client_authentication_spec.rb

@@ -0,0 +1,83 @@
+require 'helper'
+
+describe TweetStream::Client do
+  before do
+    @stream = stub("EM::Twitter::Client",
+      :connect => true,
+      :unbind => true,
+      :each => true,
+      :on_error => true,
+      :on_max_reconnects => true,
+      :on_reconnect => true,
+      :connection_completed => true,
+      :on_no_data_received => true,
+      :on_unauthorized => true,
+      :on_enhance_your_calm => true
+    )
+    EM.stub!(:run).and_yield
+    EM::Twitter::Client.stub!(:connect).and_return(@stream)
+  end
+
+  describe "basic auth" do
+    before do
+      TweetStream.configure do |config|
+        config.username = 'tweetstream'
+        config.password = 'rubygem'
+        config.auth_method = :basic
+      end
+
+      @client = TweetStream::Client.new
+    end
+
+    it "tries to connect via a JSON stream with basic auth" do
+      EM::Twitter::Client.should_receive(:connect).with(
+        :path => '/1.1/statuses/filter.json',
+        :method => 'POST',
+        :user_agent => TweetStream::Configuration::DEFAULT_USER_AGENT,
+        :on_inited => nil,
+        :params => {:track => 'monday'},
+        :basic => {
+          :username => 'tweetstream',
+          :password => 'rubygem'
+        },
+        :proxy => nil
+      ).and_return(@stream)
+
+      @client.track('monday')
+    end
+  end
+
+  describe "oauth" do
+    before do
+      TweetStream.configure do |config|
+        config.consumer_key = '123456789'
+        config.consumer_secret = 'abcdefghijklmnopqrstuvwxyz'
+        config.oauth_token = '123456789'
+        config.oauth_token_secret = 'abcdefghijklmnopqrstuvwxyz'
+        config.auth_method = :oauth
+      end
+
+      @client = TweetStream::Client.new
+    end
+
+    it "tries to connect via a JSON stream with oauth" do
+      EM::Twitter::Client.should_receive(:connect).with(
+        :path => '/1.1/statuses/filter.json',
+        :method => 'POST',
+        :user_agent => TweetStream::Configuration::DEFAULT_USER_AGENT,
+        :on_inited => nil,
+        :params => {:track => 'monday'},
+        :oauth => {
+          :consumer_key => '123456789',
+          :consumer_secret => 'abcdefghijklmnopqrstuvwxyz',
+          :token => '123456789',
+          :token_secret => 'abcdefghijklmnopqrstuvwxyz'
+        },
+        :proxy => nil
+      ).and_return(@stream)
+
+      @client.track('monday')
+    end
+  end
+
+end

data/spec/tweetstream/client_site_stream_spec.rb

@@ -0,0 +1,145 @@
+require 'helper'
+
+describe TweetStream::Client do
+  before(:each) do
+    TweetStream.configure do |config|
+      config.consumer_key = 'abc'
+      config.consumer_secret = 'def'
+      config.oauth_token = '123'
+      config.oauth_token_secret = '456'
+    end
+    @client = TweetStream::Client.new
+
+    @stream = stub("EM::Twitter::Client",
+      :connect => true,
+      :unbind => true,
+      :each => true,
+      :on_error => true,
+      :on_max_reconnects => true,
+      :on_reconnect => true,
+      :connection_completed => true,
+      :on_no_data_received => true,
+      :on_unauthorized => true,
+      :on_enhance_your_calm => true
+    )
+    EM.stub!(:run).and_yield
+    EM::Twitter::Client.stub!(:connect).and_return(@stream)
+  end
+
+  describe "Site Stream support" do
+    context "when calling #sitestream" do
+      it "sends the sitestream host" do
+        EM::Twitter::Client.should_receive(:connect).with(hash_including(:host => "sitestream.twitter.com")).and_return(@stream)
+        @client.sitestream
+      end
+
+      it "uses the sitestream uri" do
+        @client.should_receive(:start).once.with('/1.1/site.json', an_instance_of(Hash)).and_return(@stream)
+        @client.sitestream
+      end
+
+      it "supports :followings => true" do
+        @client.should_receive(:start).once.with('/1.1/site.json', hash_including(:with => 'followings')).and_return(@stream)
+        @client.sitestream(['115192457'], :followings => true)
+      end
+
+      it "supports :with => 'followings'" do
+        @client.should_receive(:start).once.with('/1.1/site.json', hash_including(:with => 'followings')).and_return(@stream)
+        @client.sitestream(['115192457'], :with => 'followings')
+      end
+
+      it "supports :with => 'user'" do
+        @client.should_receive(:start).once.with('/1.1/site.json', hash_including(:with => 'user')).and_return(@stream)
+        @client.sitestream(['115192457'], :with => 'user')
+      end
+
+      it "supports :replies => 'all'" do
+        @client.should_receive(:start).once.with('/1.1/site.json', hash_including(:replies => 'all')).and_return(@stream)
+        @client.sitestream(['115192457'], :replies => 'all')
+      end
+
+      describe "control management" do
+        before do
+          @control_response = {"control" =>
+            {
+              "control_uri" =>"/1.1/site/c/01_225167_334389048B872A533002B34D73F8C29FD09EFC50"
+            }
+          }
+        end
+        it "assigns the control_uri" do
+          @stream.should_receive(:each).and_yield(@control_response.to_json)
+          @client.sitestream
+
+          expect(@client.control_uri).to eq("/1.1/site/c/01_225167_334389048B872A533002B34D73F8C29FD09EFC50")
+        end
+
+        it "instantiates a SiteStreamClient" do
+          @stream.should_receive(:each).and_yield(@control_response.to_json)
+          @client.sitestream
+
+          expect(@client.control).to be_kind_of(TweetStream::SiteStreamClient)
+        end
+
+        it "passes the client's on_error to the SiteStreamClient" do
+          called = false
+          @client.on_error { |err| called = true }
+          @stream.should_receive(:each).and_yield(@control_response.to_json)
+          @client.sitestream
+
+          @client.control.on_error.call
+
+          expect(called).to be_true
+        end
+      end
+
+      describe "data handling" do
+        context "messages" do
+          before do
+            @ss_message = {'for_user' => '12345', 'message' => {'id' => 123, 'user' => {'screen_name' => 'monkey'}, 'text' => 'Oo oo aa aa'}}
+          end
+
+          it "yields a site stream message" do
+            @stream.should_receive(:each).and_yield(@ss_message.to_json)
+            yielded_status = nil
+            @client.sitestream do |message|
+              yielded_status = message
+            end
+            expect(yielded_status).not_to be_nil
+            expect(yielded_status[:for_user]).to eq('12345')
+            expect(yielded_status[:message][:user][:screen_name]).to eq('monkey')
+            expect(yielded_status[:message][:text]).to eq('Oo oo aa aa')
+          end
+          it "yields itself if block has an arity of 2" do
+            @stream.should_receive(:each).and_yield(@ss_message.to_json)
+            yielded_client = nil
+            @client.sitestream do |_, client|
+              yielded_client = client
+            end
+            expect(yielded_client).not_to be_nil
+            expect(yielded_client).to eq(@client)
+          end
+        end
+
+        context "friends list" do
+          before do
+            @friends_list = { 'friends' => [123, 456] }
+         end
+
+          it "yields a friends list array" do
+            @stream.should_receive(:each).and_yield(@friends_list.to_json)
+            yielded_list = nil
+            @client.on_friends do |friends|
+              yielded_list = friends
+            end
+            @client.sitestream
+
+            expect(yielded_list).not_to be_nil
+            expect(yielded_list).to be_an(Array)
+            expect(yielded_list.first).to eq(123)
+          end
+        end
+      end
+    end
+  end
+
+end

data/spec/tweetstream/client_spec.rb

@@ -0,0 +1,391 @@
+require 'helper'
+
+describe TweetStream::Client do
+  before(:each) do
+    TweetStream.configure do |config|
+      config.consumer_key = 'abc'
+      config.consumer_secret = 'def'
+      config.oauth_token = '123'
+      config.oauth_token_secret = '456'
+    end
+    @client = TweetStream::Client.new
+  end
+
+  describe "#start" do
+    before do
+      @stream = stub("EM::Twitter::Client",
+        :connect => true,
+        :unbind => true,
+        :each => true,
+        :on_error => true,
+        :on_max_reconnects => true,
+        :on_reconnect => true,
+        :connection_completed => true,
+        :on_no_data_received => true,
+        :on_unauthorized => true,
+        :on_enhance_your_calm => true
+      )
+      EM.stub!(:run).and_yield
+      EM::Twitter::Client.stub!(:connect).and_return(@stream)
+    end
+
+    it "connects if the reactor is already running" do
+      EM.stub!(:reactor_running?).and_return(true)
+      @client.should_receive(:connect)
+      @client.track('abc')
+    end
+
+    it "starts the reactor if not already running" do
+      EM.should_receive(:run).once
+      @client.track('abc')
+    end
+
+    it "warns when callbacks are passed as options" do
+      @stream.stub(:each).and_yield(nil)
+      Kernel.should_receive(:warn).with(/Passing callbacks via the options hash is deprecated and will be removed in TweetStream 3.0/)
+      @client.track('abc', :inited => Proc.new { })
+    end
+
+    describe 'proxy usage' do
+      it 'connects with a proxy' do
+        @client = TweetStream::Client.new(:proxy => { :uri => 'http://someproxy:8081'})
+        EM::Twitter::Client.should_receive(:connect).
+          with(hash_including(:proxy => { :uri => 'http://someproxy:8081'})).and_return(@stream)
+        @stream.should_receive(:each).and_return
+        @client.track('abc')
+      end
+    end
+
+    describe "#each" do
+      it "calls the appropriate parser" do
+        @client = TweetStream::Client.new
+        Yajl::Parser.should_receive(:parse).twice.and_return({})
+        @stream.should_receive(:each).and_yield(sample_tweets[0].to_json)
+        @client.track('abc','def')
+      end
+
+      it "yields a Twitter::Tweet" do
+        @stream.should_receive(:each).and_yield(sample_tweets[0].to_json)
+        @client.track('abc'){|s| expect(s).to be_kind_of(Twitter::Tweet)}
+      end
+
+      it "yields the client if a block with arity 2 is given" do
+        @stream.should_receive(:each).and_yield(sample_tweets[0].to_json)
+        @client.track('abc'){|s,c| expect(c).to eq(@client)}
+      end
+
+      it "includes the proper values" do
+        tweet = sample_tweets[0]
+        tweet[:id] = 123
+        tweet[:user][:screen_name] = 'monkey'
+        tweet[:text] = "Oo oo aa aa"
+        @stream.should_receive(:each).and_yield(tweet.to_json)
+        @client.track('abc') do |s|
+          expect(s[:id]).to eq(123)
+          expect(s.user.screen_name).to eq('monkey')
+          expect(s.text).to eq('Oo oo aa aa')
+        end
+      end
+
+      it "calls the on_stall_warning callback if specified" do
+        @stream.should_receive(:each).and_yield(fixture('stall_warning.json'))
+        @client.on_stall_warning do |warning|
+          expect(warning[:code]).to eq('FALLING_BEHIND')
+        end.track('abc')
+      end
+
+      it "calls the on_scrub_geo callback if specified" do
+        @stream.should_receive(:each).and_yield(fixture('scrub_geo.json'))
+        @client.on_scrub_geo do |up_to_status_id, user_id|
+          expect(up_to_status_id).to eq(9876)
+          expect(user_id).to eq(1234)
+        end.track('abc')
+      end
+
+      it "calls the on_delete callback" do
+        @stream.should_receive(:each).and_yield(fixture('delete.json'))
+        @client.on_delete do |id, user_id|
+          expect(id).to eq(1234)
+          expect(user_id).to eq(3)
+        end.track('abc')
+      end
+
+      it "calls the on_limit callback" do
+        limit = nil
+        @stream.should_receive(:each).and_yield(fixture('limit.json'))
+        @client.on_limit do |l|
+          limit = l
+        end.track('abc')
+
+        expect(limit).to eq(1234)
+      end
+
+      it "calls the on_status_withheld callback" do
+        status = nil
+        @stream.should_receive(:each).and_yield(fixture('status_withheld.json'))
+        @client.on_status_withheld do |s|
+          status = s
+        end.track('abc')
+
+        expect(status[:user_id]).to eq(123456)
+      end
+
+      it "calls the on_user_withheld callback" do
+        status = nil
+        @stream.should_receive(:each).and_yield(fixture('user_withheld.json'))
+        @client.on_user_withheld do |s|
+          status = s
+        end.track('abc')
+
+        expect(status[:id]).to eq(123456)
+      end
+
+      context "using on_anything" do
+        it "yields the raw hash" do
+          hash = {:id => 1234}
+          @stream.should_receive(:each).and_yield(hash.to_json)
+          yielded_hash = nil
+          @client.on_anything do |h|
+            yielded_hash = h
+          end.track('abc')
+
+          expect(yielded_hash).not_to be_nil
+          expect(yielded_hash[:id]).to eq(1234)
+        end
+        it "yields itself if block has an arity of 2" do
+          hash = {:id => 1234}
+          @stream.should_receive(:each).and_yield(hash.to_json)
+          yielded_client = nil
+          @client.on_anything do |_, client|
+            yielded_client = client
+          end.track('abc')
+          expect(yielded_client).not_to be_nil
+          expect(yielded_client).to eq(@client)
+        end
+      end
+
+      context "using on_timeline_status" do
+        it "yields a Status" do
+          tweet = sample_tweets[0]
+          tweet[:id] = 123
+          tweet[:user][:screen_name] = 'monkey'
+          tweet[:text] = "Oo oo aa aa"
+          @stream.should_receive(:each).and_yield(tweet.to_json)
+          yielded_status = nil
+          @client.on_timeline_status do |status|
+            yielded_status = status
+          end.track('abc')
+          expect(yielded_status).not_to be_nil
+          expect(yielded_status[:id]).to eq(123)
+          expect(yielded_status.user.screen_name).to eq('monkey')
+          expect(yielded_status.text).to eq('Oo oo aa aa')
+        end
+        it "yields itself if block has an arity of 2" do
+          @stream.should_receive(:each).and_yield(sample_tweets[0].to_json)
+          yielded_client = nil
+          @client.on_timeline_status do |_, client|
+            yielded_client = client
+          end.track('abc')
+          expect(yielded_client).not_to be_nil
+          expect(yielded_client).to eq(@client)
+        end
+      end
+
+      context "using on_direct_message" do
+        it "yields a DirectMessage" do
+          direct_message = sample_direct_messages[0]
+          direct_message[:direct_message][:id] = 1234
+          direct_message[:direct_message][:sender][:screen_name] = "coder"
+          @stream.should_receive(:each).and_yield(direct_message.to_json)
+          yielded_dm = nil
+          @client.on_direct_message do |dm|
+            yielded_dm = dm
+          end.userstream
+          expect(yielded_dm).not_to be_nil
+          expect(yielded_dm.id).to eq(1234)
+          expect(yielded_dm.sender.screen_name).to eq("coder")
+        end
+
+        it "yields itself if block has an arity of 2" do
+          @stream.should_receive(:each).and_yield(sample_direct_messages[0].to_json)
+          yielded_client = nil
+          @client.on_direct_message do |_, client|
+            yielded_client = client
+          end.userstream
+          expect(yielded_client).to eq(@client)
+        end
+      end
+
+      it "calls on_error if a non-hash response is received" do
+        @stream.should_receive(:each).and_yield('["favorited"]')
+        @client.on_error do |message|
+          expect(message).to eq('Unexpected JSON object in stream: ["favorited"]')
+        end.track('abc')
+      end
+
+      it "calls on_error if a json parse error occurs" do
+        @stream.should_receive(:each).and_yield("{'a_key':}")
+        @client.on_error do |message|
+          expect(message).to eq("Yajl::ParseError occured in stream: {'a_key':}")
+        end.track('abc')
+      end
+    end
+
+    describe "#on_error" do
+      it "passes the message on to the error block" do
+        @stream.should_receive(:on_error).and_yield('Uh oh')
+        @client.on_error do |m|
+          expect(m).to eq('Uh oh')
+        end.track('abc')
+      end
+
+      it "returns the block when defined" do
+        @client.on_error { |m| true; }
+        expect(@client.on_error).to be_kind_of(Proc)
+      end
+
+      it "returns nil when undefined" do
+        expect(@client.on_error).to be_nil
+      end
+    end
+
+    describe "#on_max_reconnects" do
+      it "raises a ReconnectError" do
+        @stream.should_receive(:on_max_reconnects).and_yield(30, 20)
+        expect(lambda{ @client.track('abc') }).to raise_error(TweetStream::ReconnectError, "Failed to reconnect after 20 tries.")
+      end
+    end
+  end
+
+  describe "API methods" do
+    %w(firehose retweet sample links).each do |method|
+      it "##{method} should make a call to start with \"statuses/#{method}\"" do
+        @client.should_receive(:start).once.with('/1.1/statuses/' + method + '.json', {})
+        @client.send(method)
+      end
+    end
+
+    describe "#filter" do
+      it "makes a call to 'statuses/filter' with the query params provided" do
+        @client.should_receive(:start).once.with('/1.1/statuses/filter.json', :follow => 123, :method => :post)
+        @client.filter(:follow => 123)
+      end
+      it "makes a call to 'statuses/filter' with the query params provided longitude/latitude pairs, separated by commas " do
+        @client.should_receive(:start).once.with('/1.1/statuses/filter.json', :locations => '-122.75,36.8,-121.75,37.8,-74,40,-73,41', :method => :post)
+        @client.filter(:locations => '-122.75,36.8,-121.75,37.8,-74,40,-73,41')
+      end
+    end
+
+    describe "#follow" do
+      it "makes a call to start with 'statuses/filter' and a follow query parameter" do
+        @client.should_receive(:start).once.with('/1.1/statuses/filter.json', :follow => [123], :method => :post)
+        @client.follow(123)
+      end
+
+      it "comma-joins multiple arguments" do
+        @client.should_receive(:start).once.with('/1.1/statuses/filter.json', :follow => [123,456], :method => :post)
+        @client.follow(123, 456)
+      end
+    end
+
+    describe "#locations" do
+      it "calls #start with 'statuses/filter' with the query params provided longitude/latitude pairs" do
+        @client.should_receive(:start).once.with('/1.1/statuses/filter.json', :locations => ['-122.75,36.8,-121.75,37.8,-74,40,-73,41'], :method => :post)
+        @client.locations('-122.75,36.8,-121.75,37.8,-74,40,-73,41')
+      end
+
+      it "calls #start with 'statuses/filter' with the query params provided longitude/latitude pairs and additional filter" do
+        @client.should_receive(:start).once.with('/1.1/statuses/filter.json', :locations => ['-122.75,36.8,-121.75,37.8,-74,40,-73,41'], :track => 'rock', :method => :post)
+        @client.locations('-122.75,36.8,-121.75,37.8,-74,40,-73,41', :track => 'rock')
+      end
+    end
+
+    describe "#track" do
+      it "makes a call to start with 'statuses/filter' and a track query parameter" do
+        @client.should_receive(:start).once.with('/1.1/statuses/filter.json', :track => ['test'], :method => :post)
+        @client.track('test')
+      end
+
+      it "comma-joins multiple arguments" do
+        @client.should_receive(:start).once.with('/1.1/statuses/filter.json', :track => ['foo', 'bar', 'baz'], :method => :post)
+        @client.track('foo', 'bar', 'baz')
+      end
+
+      it "comma-joins an array of arguments" do
+        @client.should_receive(:start).once.with('/1.1/statuses/filter.json', :track => [['foo','bar','baz']], :method => :post)
+        @client.track(['foo','bar','baz'])
+      end
+
+      it "calls #start with 'statuses/filter' and the provided queries" do
+        @client.should_receive(:start).once.with('/1.1/statuses/filter.json', :track => ['rock'], :method => :post)
+        @client.track('rock')
+      end
+    end
+  end
+
+  %w(on_delete on_limit on_inited on_reconnect on_no_data_received on_unauthorized on_enhance_your_calm).each do |proc_setter|
+    describe "##{proc_setter}" do
+      it "sets when a block is given" do
+        proc = Proc.new{|a,b| puts a }
+        @client.send(proc_setter, &proc)
+        expect(@client.send(proc_setter)).to eq(proc)
+      end
+
+      it "returns nil when undefined" do
+        expect(@client.send(proc_setter)).to be_nil
+      end
+    end
+  end
+
+  describe "#stop" do
+    it "calls EventMachine::stop_event_loop" do
+      EventMachine.should_receive :stop_event_loop
+      expect(TweetStream::Client.new.stop).to be_nil
+    end
+
+    it "returns the last status yielded" do
+      EventMachine.should_receive :stop_event_loop
+      client = TweetStream::Client.new
+      client.send(:instance_variable_set, :@last_status, {})
+      expect(client.stop).to eq({})
+    end
+  end
+
+  describe "#close_connection" do
+    it "does not call EventMachine::stop_event_loop" do
+      EventMachine.should_not_receive :stop_event_loop
+      expect(TweetStream::Client.new.close_connection).to be_nil
+    end
+  end
+
+  describe "#stop_stream" do
+    before(:each) do
+      @stream = stub("EM::Twitter::Client",
+        :connect => true,
+        :unbind => true,
+        :each => true,
+        :on_error => true,
+        :on_max_reconnects => true,
+        :on_reconnect => true,
+        :connection_completed => true,
+        :on_no_data_received => true,
+        :on_unauthorized => true,
+        :on_enhance_your_calm => true,
+        :stop => true
+      )
+      EM::Twitter::Client.stub!(:connect).and_return(@stream)
+      @client = TweetStream::Client.new
+      @client.connect('/')
+    end
+
+    it "calls stream.stop to cleanly stop the current stream" do
+      @stream.should_receive(:stop)
+      @client.stop_stream
+    end
+
+    it "does not stop eventmachine" do
+      EventMachine.should_not_receive :stop_event_loop
+      @client.stop_stream
+    end
+  end
+end