tweetstream 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Intridea, Inc.
+
+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.rdoc

@@ -0,0 +1,77 @@
+= TweetStream
+
+TweetStream provides simple Ruby access to Twitter's Streaming API
+(http://apiwiki.twitter.com/Streaming-API-Documentation).
+
+== Installation
+
+The TweetStream gem is available on GitHub and Gemcutter. To get the
+latest gem from GitHub:
+
+    gem sources -a http://gems.github.com/
+    gem install intridea-tweetstream
+    
+To install from Gemcutter:
+
+    gem sources -a http://gemcutter.org/
+    gem install tweetstream
+
+== Usage
+
+Using TweetStream is quite simple:
+
+    require 'rubygems'
+    require 'tweetstream'
+    
+    # This will pull a sample of all tweets based on
+    # your Twitter account's Streaming API role.
+    TweetStream::Client.new('username','password').sample do |status|
+      # The status object is a special Hash with 
+      # method access to its keys.
+      puts "#{status.text}"
+    end
+    
+You can also use it to track keywords or follow a given set of
+user ids:
+
+  # Use 'track' to track a list of single-word keywords
+  TweetStream::Client.new('username','password').track('term1', 'term2') do |status|
+    puts "#{status.text}"
+  end
+  
+  # Use 'follow' to follow a group of user ids (integers, not screen names)
+  TweetStream::Client.new('username','password').follow(14252, 53235) do |status|
+    puts "#{status.text}"
+  end
+  
+The methods available to TweetStream::Client will be kept in parity
+with the methods available on the Streaming API wiki page.
+
+== Daemonizing
+
+It is also possible to create a daemonized script quite easily
+using the TweetStream library:
+
+  # The third argument is an optional process name
+  TweetStream::Client.new('username','password', 'tracker').track('term1', 'term2') do |status|
+    # do something in the background
+  end
+  
+If you put the above into a script and run the script with <tt>ruby scriptname.rb</tt>, you will see a list of daemonization commands such
+as start, stop, and run.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Contributors
+
+* Michael Bleigh (initial gem)
+
+== Copyright
+
+Copyright (c) 2009 Intridea, Inc. (http://www.intridea.com/). See LICENSE for details.

data/Rakefile

@@ -0,0 +1,50 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "tweetstream"
+    gem.summary = %Q{TweetStream is a simple wrapper for consuming the Twitter Streaming API.}
+    gem.description = %Q{TweetStream allows you to easily consume the Twitter Streaming API utilizing the YAJL Ruby gem.}
+    gem.email = "michael@intridea.com"
+    gem.homepage = "http://github.com/intridea/tweetstream"
+    gem.authors = ["Michael Bleigh"]
+    gem.add_development_dependency "rspec"
+    gem.add_dependency 'yajl-ruby', '>= 0.6.3'
+    gem.add_dependency 'daemons'
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "tweetstream #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

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

data/lib/tracker.rb

@@ -0,0 +1,12 @@
+require 'rubygems'
+require 'tweetstream'
+require 'logger'
+
+File.open('tracker.log', File::WRONLY | File::APPEND | File::CREAT) do |file|
+  log = Logger.new(file)
+
+  TweetStream::Daemon.new('mbleigh','hotmail', 'tracker').track('fail') do |status|
+    log.info "[#{status.user.screen_name}] #{status.text}"
+    puts "[#{status.user.screen_name}] #{status.text}"
+  end
+end

data/lib/tweetstream.rb

@@ -0,0 +1,5 @@
+require 'tweetstream/client'
+require 'tweetstream/hash'
+require 'tweetstream/status'
+require 'tweetstream/user'
+require 'tweetstream/daemon'

data/lib/tweetstream/client.rb

@@ -0,0 +1,109 @@
+require 'uri'
+require 'cgi'
+require 'yajl'
+require 'yajl/http_stream'
+
+module TweetStream
+  # Provides simple access to the Twitter Streaming API (http://apiwiki.twitter.com/Streaming-API-Documentation)
+  # for Ruby scripts that need to create a long connection to
+  # Twitter for tracking and other purposes.
+  #
+  # Basic usage of the library is to call one of the provided
+  # methods and provide a block that will perform actions on
+  # a yielded TweetStream::Status. For example:
+  #
+  #     TweetStream::Client.new('user','pass').track('fail') do |status|
+  #       puts "[#{status.user.screen_name}] #{status.text}"
+  #     end
+  #
+  # For information about a daemonized TweetStream client,
+  # view the TweetStream::Daemon class.
+  class Client
+    attr_accessor :username, :password
+    
+    # Create a new client with the Twitter credentials
+    # of the account you want to be using its API quota. 
+    def initialize(user, pass)
+      self.username = user
+      self.password = pass
+    end
+   
+    # Returns all public statuses. The Firehose is not a generally
+    # available resource. Few applications require this level of access. 
+    # Creative use of a combination of other resources and various access 
+    # levels can satisfy nearly every application use case. 
+    def firehose(query_parameters = {}, &block)
+      start('statuses/firehose', query_parameters, &block)
+    end
+    
+    # Returns all retweets. The retweet stream is not a generally available 
+    # resource. Few applications require this level of access. Creative
+    # use of a combination of other resources and various access levels
+    # can satisfy nearly every application use case. As of 9/11/2009,
+    # the site-wide retweet feature has not yet launched,
+    # so there are currently few, if any, retweets on this stream.
+    def retweet(query_parameters = {}, &block)
+      start('statuses/retweet', query_parameters, &block)
+    end
+    
+    # Returns a random sample of all public statuses. The default access level 
+    # provides a small proportion of the Firehose. The "Gardenhose" access
+    # level provides a proportion more suitable for data mining and
+    # research applications that desire a larger proportion to be statistically
+    # significant sample.
+    def sample(query_parameters = {}, &block)
+      start('statuses/sample', query_parameters, &block)
+    end
+
+    # Specify keywords to track. Queries are subject to Track Limitations, 
+    # described in Track Limiting and subject to access roles, described in 
+    # the statuses/filter method. Track keywords are case-insensitive logical 
+    # ORs. Terms are exact-matched, and also exact-matched ignoring
+    # punctuation. Phrases, keywords with spaces, are not supported. 
+    # Keywords containing punctuation will only exact match tokens.
+    # Query parameters may be passed as the last argument.
+    def track(*keywords, &block)
+      query_params = keywords.pop if keywords.last.is_a?(::Hash)
+      query_params ||= {}
+      start('statuses/filter', query_params.merge(:track => keywords.join(',')), &block)
+    end
+    
+    # Returns public statuses from or in reply to a set of users. Mentions 
+    # ("Hello @user!") and implicit replies ("@user Hello!" created without 
+    # pressing the reply "swoosh") are not matched. Requires integer user
+    # IDs, not screen names. Query parameters may be passed as the last argument.
+    def follow(*user_ids, &block)
+      query_params = user_ids.pop if user_ids.last.is_a?(::Hash)
+      query_params ||= {}
+      start('statuses/filter', query_params.merge(:follow => user_ids.join(',')), &block)
+    end
+
+    #:nodoc:
+    def start(path, query_parameters = {}, &block)
+      uri = build_uri(path, query_parameters)
+      
+      Yajl::HttpStream.get(uri, :symbolize_keys => true) do |hash|
+        yield TweetStream::Status.new(hash)
+      end
+    end
+ 
+    protected
+
+    #:nodoc:
+    def build_uri(path, query_parameters = {})
+      URI.parse("http://#{self.username}:#{self.password}@stream.twitter.com/1/#{path}.json#{build_query_parameters(query_parameters)}")
+    end
+
+    #:nodoc:
+    def build_query_parameters(query)
+      return '' unless query && query.is_a?(::Hash) && query.size > 0
+      pairs = []
+      
+      query.each_pair do |k,v|
+        pairs << "#{k.to_s}=#{CGI.escape(v.to_s)}"
+      end
+
+      "?#{pairs.join('&')}"
+    end
+  end
+end

data/lib/tweetstream/daemon.rb

@@ -0,0 +1,40 @@
+require 'daemons'
+
+# A daemonized TweetStream client that will allow you to
+# create backgroundable scripts for application specific
+# processes. For instance, if you create a script called
+# <tt>tracker.rb</tt> and fill it with this:
+#
+#     require 'rubygems'
+#     require 'tweetstream'
+#
+#     TweetStream::Daemon.new('user','pass', 'tracker').track('intridea') do |status|
+#       # do something here
+#     end
+#
+# And then you call this from the shell:
+#
+#     ruby tracker.rb start
+#
+# A daemon process will spawn that will automatically
+# run the code in the passed block whenever a new tweet
+# matching your search term ('intridea' in this case)
+# is posted.
+#
+class TweetStream::Daemon < TweetStream::Client
+  # Initialize a Daemon with the credentials of the
+  # Twitter account you wish to use. The daemon has
+  # an optional process name for use when querying
+  # running processes.
+  def initialize(user, pass, app_name=nil)
+    @app_name = app_name
+    super(user, pass)
+  end
+  
+  #:nodoc:
+  def start(path, query_parameters = {}, &block)
+    Daemons.run_proc(@app_name || 'tweetstream', :multiple => true) do
+      super(path, query_parameters, &block)
+    end
+  end
+end

data/lib/tweetstream/hash.rb

@@ -0,0 +1,16 @@
+#:nodoc:
+class TweetStream::Hash < ::Hash
+  def initialize(other_hash)
+    other_hash.keys.each do |key|
+      self[key.to_sym] = other_hash[key]
+    end
+  end
+  
+  def method_missing(method_name, *args)
+    if key?(method_name.to_sym)
+      self[method_name.to_sym]
+    else
+      super
+    end
+  end
+end

data/lib/tweetstream/status.rb

@@ -0,0 +1,8 @@
+# A simple Hash wrapper that gives you method-based
+# access to the properties of a Twitter status.
+class TweetStream::Status < TweetStream::Hash
+  def initialize(hash)
+    super
+    self[:user] = TweetStream::User.new(self[:user])
+  end
+end

data/lib/tweetstream/user.rb

@@ -0,0 +1,5 @@
+# A simple Hash wrapper that gives you method-based
+# access to user properties returned by the streamer.
+class TweetStream::User < TweetStream::Hash
+  
+end

data/spec/data/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/spec.opts

@@ -0,0 +1,2 @@
+--colour
+--format progress

data/spec/spec_helper.rb

@@ -0,0 +1,24 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'rubygems'
+require 'tweetstream'
+require 'spec'
+require 'spec/autorun'
+require 'yajl'
+
+def sample_tweets
+  if @tweets
+    @tweets
+  else
+    @tweets = []
+    Yajl::Parser.parse(File.open(File.dirname(__FILE__) + '/data/statuses.json', 'r')) do |hash|
+      @tweets << hash
+    end
+    @tweets
+  end
+end
+
+Spec::Runner.configure do |config|
+  
+end

data/spec/tweetstream/client_spec.rb

@@ -0,0 +1,122 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe TweetStream::Client do
+  it 'should set the username and password from the initializers' do
+    @client = TweetStream::Client.new('abc','def')
+    @client.username.should == 'abc'
+    @client.password.should == 'def'
+  end
+
+  describe '#build_uri' do
+    before do
+      @client = TweetStream::Client.new('abc','def')
+    end
+
+    it 'should return a URI' do
+      @client.send(:build_uri, '').is_a?(URI).should be_true
+    end
+
+    it 'should contain the auth information from the client' do
+      @client.send(:build_uri, '').user.should == 'abc'
+      @client.send(:build_uri, '').password.should == 'def'
+    end
+
+    it 'should have the specified path with the version prefix and a json extension' do
+      @client.send(:build_uri, 'awesome').path.should == '/1/awesome.json'
+    end
+
+    it 'should add on a query string if such parameters are specified' do
+      @client.send(:build_uri, 'awesome', :q => 'abc').query.should == 'q=abc'
+    end
+  end
+
+  describe '#build_query_parameters' do
+    before do
+      @client = TweetStream::Client.new('abc','def')
+    end
+  
+    it 'should return a blank string if passed a nil value' do
+      @client.send(:build_query_parameters, nil).should == ''
+    end
+
+    it 'should return a blank string if passed an empty hash' do
+      @client.send(:build_query_parameters, {}).should == ''
+    end
+
+    it 'should add a query parameter for a key' do
+      @client.send(:build_query_parameters, {:query => 'abc'}).should == '?query=abc'
+    end
+
+    it 'should escape characters in the value' do
+      @client.send(:build_query_parameters, {:query => 'awesome guy'}).should == '?query=awesome+guy'
+    end
+
+    it 'should join multiple pairs together' do
+      ['?a=b&c=d','?c=d&a=b'].include?(@client.send(:build_query_parameters, {:a => 'b', :c => 'd'})).should be_true
+    end
+  end
+
+  describe '#start' do
+    before do
+      @client = TweetStream::Client.new('abc','def')
+    end
+
+    it 'should make a call to Yajl::HttpStream' do
+      Yajl::HttpStream.should_receive(:get).once.with(URI.parse('http://abc:def@stream.twitter.com/1/cool.json'), :symbolize_keys => true).and_return({})
+      @client.start('cool')
+    end
+
+    it 'should yield a TwitterStream::Status for each update' do
+      Yajl::HttpStream.should_receive(:get).once.with(URI.parse('http://abc:def@stream.twitter.com/1/statuses/filter.json?track=musicmonday'), :symbolize_keys => true).and_yield(sample_tweets[0])
+      @client.track('musicmonday') do |status|
+        status.is_a?(TweetStream::Status).should be_true
+        @yielded = true
+      end
+      @yielded.should be_true
+    end
+  end
+  
+  describe ' API methods' do
+    before do
+      @client = TweetStream::Client.new('abc','def')
+    end
+    
+    %w(firehose retweet sample).each do |method|
+      it "##{method} should make a call to start with \"statuses/#{method}\"" do
+        @client.should_receive(:start).once.with('statuses/' + method, {})
+        @client.send(method)
+      end
+    end
+    
+    it '#track should make a call to start with "statuses/filter" and a track query parameter' do
+      @client.should_receive(:start).once.with('statuses/filter', :track => 'test')
+      @client.track('test')
+    end
+    
+    it '#track should comma-join multiple arguments' do
+      @client.should_receive(:start).once.with('statuses/filter', :track => 'foo,bar,baz')
+      @client.track('foo', 'bar', 'baz')
+    end
+    
+    it '#follow should make a call to start with "statuses/filter" and a follow query parameter' do
+      @client.should_receive(:start).once.with('statuses/filter', :follow => '123')
+      @client.follow(123)
+    end
+    
+    it '#follow should comma-join multiple arguments' do
+      @client.should_receive(:start).once.with('statuses/filter', :follow => '123,456')
+      @client.follow(123, 456)
+    end
+  end
+
+  describe '#track' do
+    before do
+      @client = TweetStream::Client.new('abc','def')
+    end
+
+    it 'should call #start with "statuses/filter" and the provided queries' do
+      @client.should_receive(:start).once.with('statuses/filter', :track => 'rock')
+      @client.track('rock')
+    end
+  end
+end

data/spec/tweetstream/hash_spec.rb

@@ -0,0 +1,19 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe TweetStream::Hash do
+  it 'should be initialized by passing in an existing hash' do
+    TweetStream::Hash.new(:abc => 123)[:abc].should == 123
+  end
+  
+  it 'should symbolize incoming keys' do
+    TweetStream::Hash.new('abc' => 123)[:abc].should == 123
+  end
+  
+  it 'should allow access via method calls' do
+    TweetStream::Hash.new(:abc => 123).abc.should == 123
+  end
+  
+  it 'should still throw NoMethod for non-existent keys' do
+    lambda{TweetStream::Hash.new({}).akabi}.should raise_error(NoMethodError)
+  end
+end

data/spec/tweetstream/status_spec.rb

@@ -0,0 +1,9 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe TweetStream::Status do
+  it 'should modify the :user key into a TweetStream::User object' do
+    @status = TweetStream::Status.new(:user => {:screen_name => 'bob'})
+    @status.user.is_a?(TweetStream::User).should be_true
+    @status.user.screen_name.should == 'bob'
+  end
+end

data/spec/tweetstream_spec.rb

@@ -0,0 +1,5 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe TweetStream do
+
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification 
+name: tweetstream
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Michael Bleigh
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-09-22 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.6.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: daemons
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: TweetStream allows you to easily consume the Twitter Streaming API utilizing the YAJL Ruby gem.
+email: michael@intridea.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/tracker.log
+- lib/tracker.rb
+- lib/tweetstream.rb
+- lib/tweetstream/client.rb
+- lib/tweetstream/daemon.rb
+- lib/tweetstream/hash.rb
+- lib/tweetstream/status.rb
+- lib/tweetstream/user.rb
+- spec/data/statuses.json
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/tweetstream/client_spec.rb
+- spec/tweetstream/hash_spec.rb
+- spec/tweetstream/status_spec.rb
+- spec/tweetstream_spec.rb
+has_rdoc: true
+homepage: http://github.com/intridea/tweetstream
+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.5
+signing_key: 
+specification_version: 3
+summary: TweetStream is a simple wrapper for consuming the Twitter Streaming API.
+test_files: 
+- spec/spec_helper.rb
+- spec/tweetstream/client_spec.rb
+- spec/tweetstream/hash_spec.rb
+- spec/tweetstream/status_spec.rb
+- spec/tweetstream_spec.rb