twistream 0.2.0

data/README.rdoc

@@ -0,0 +1,5 @@
+= twistream
+
+== what?
+
+twistream is an simple client for hooking up with the twitter streaming api

data/Rakefile

@@ -0,0 +1,58 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "twistream"
+    gem.summary = %Q{a simple streaming api client for twitter}
+    gem.description = %Q{a simple streaming api client for twitter}
+    gem.email = "swessel@gr4yweb.de"
+    gem.homepage = "http://github.com/gr4y/twistream"
+    gem.authors = ["Sascha Wessel"]
+    gem.require_path = 'lib'
+    gem.files = %w( Rakefile ) + Dir.glob("{lib}/**/*") + %w( VERSION )
+    gem.add_runtime_dependency "yajl-ruby", ">= 0.7.8"
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+desc "generate rdoc"
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "twistream #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+desc "run all specs"
+begin
+  gem 'rspec', '1.3.0'
+  require 'spec/rake/spectask'
+  Spec::Rake::SpecTask.new do |t|
+    t.spec_files = FileList['spec/**/*_spec.rb']
+  end
+rescue LoadError
+  warn "[twistream] rspec is not installed. install it with: gem install rspec --version 1.3.0"
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "twistream #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'reek/rake/task'
+Reek::Rake::Task.new do |t|
+  t.fail_on_error = false
+  t.verbose = true
+end
+
+task :test => [:check_dependencies, :spec]
+task :default => [:test, :build]

data/VERSION

@@ -0,0 +1 @@
+0.2.0

data/lib/twistream/client.rb

@@ -0,0 +1,60 @@
+module TwiStream
+  class Client
+    extend TwiStream::EventHandler
+    attr_accessor :realm
+    events :on_error
+
+    def initialize(auth)
+      self.realm = "#{auth[:user]}:#{auth[:pass]}".chomp
+    end
+
+    def sample(params = {}, & block)
+      start(:sample, params, & block)
+    end
+
+    def retweet(params = {}, & block)
+      start(:retweet, params, & block)
+    end
+
+    def firehose(params = {}, & block)
+      start(:firehose, params, & block)
+    end
+
+    def filter_by_keywords(params = {}, & block)
+      start(:filter, :track => params.join(','), & block)
+    end
+
+    def filter_by_users(params = {}, & block)
+      start(:filter, :follow => params.join(','), & block)
+    end
+
+    def filter_by_locations(params = {}, & block)
+      start(:filter, :locations => params.join(','), & block)
+    end
+
+    def stop
+      if @thread.alive?
+        @thread.kill
+      end
+    end
+
+    private
+    def start(api_method, params = {}, & block)
+      url = build_uri(api_method)
+      @thread = Thread.new do
+        begin
+          ::Yajl::HttpStream.post(url, params) do |status|
+            puts status
+            block.call(status)
+          end
+        rescue
+          on_error.trigger($!, $@)
+        end
+      end
+    end
+
+    def build_uri(api_method)
+      URI.parse("http://#{self.realm}@stream.twitter.com/1/statuses/#{api_method.to_s}.json")
+    end
+  end
+end

data/lib/twistream/event.rb

@@ -0,0 +1,18 @@
+module TwiStream
+  class Event
+    attr_reader :name
+
+    def initialize(name)
+      @name = name
+    end
+
+    def handle(method=nil, & block)
+      @handler = method if method
+      @handler = block if block
+    end
+
+    def trigger(* args)
+      @handler.call(* args) if !@handler.nil?
+    end
+  end
+end

data/lib/twistream/event_handler.rb

@@ -0,0 +1,29 @@
+module TwiStream
+  module EventHandler
+
+    def event(name)
+      register_event(name)
+    end
+
+    def events(* names)
+      names.each do |name|
+        event(name)
+      end
+    end
+
+    private
+    def register_event(name)
+      class_eval do
+        variable =:"@#{name}"
+        define_method(name) do
+          event = instance_variable_get(variable)
+          if event == nil
+            event = TwiStream::Event.new(name)
+            instance_variable_set(variable, event)
+          end
+          event
+        end
+      end
+    end
+  end
+end

data/lib/twistream.rb

@@ -0,0 +1,17 @@
+# external require
+require 'uri'
+require 'logger'
+require 'yajl/http_stream'
+
+# gem files
+require 'twistream/event'
+require 'twistream/event_handler'
+require 'twistream/client'
+
+module TwiStream
+  class AuthenticationError < ::StandardError; end
+  LOG = ::Logger.new(STDOUT)
+  LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
+  PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+  VERSION = ::File.exist?(PATH + 'VERSION') ? ::File.read(PATH+'VERSION') : '0'
+end

data/spec/client_spec.rb

@@ -0,0 +1,47 @@
+require "spec_helper"
+
+describe TwiStream::Client do
+
+  before :all do
+    @client = TwiStream::Client.new({:user => 'gr4y', :pass => 'bUx1kkkd'})
+    @client.on_error.handle do |msg,tr|
+      puts msg 
+    end
+  end
+
+  context "start the filter stream, wait 10 seconds and stop" do
+    it "should start the filter stream" do
+      keywords = "nowplaying", "nowwatching"
+      @client.filter_by_keywords(keywords) do |status|
+        puts status
+        status.should_not == be_nil
+      end
+    end
+
+    it "should wait 10 seconds" do
+      sleep 10
+    end
+
+    it "should stop" do
+      @client.stop
+    end
+  end
+
+  context "start the sample stream, wait 10 seconds and stop" do
+    it "should start the sample stream" do
+      @client.sample do |status|
+        puts status
+        status.should_not == be_nil
+      end
+    end
+
+    it "should wait 10 seconds" do
+      sleep 10
+    end
+
+    it "should stop" do
+      @client.stop
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'twistream'	

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification 
+name: twistream
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
+platform: ruby
+authors: 
+- Sascha Wessel
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-11 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 7
+        - 8
+        version: 0.7.8
+  type: :runtime
+  version_requirements: *id001
+description: a simple streaming api client for twitter
+email: swessel@gr4yweb.de
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- Rakefile
+- VERSION
+- lib/twistream.rb
+- lib/twistream/client.rb
+- lib/twistream/event.rb
+- lib/twistream/event_handler.rb
+- README.rdoc
+- spec/client_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/gr4y/twistream
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: a simple streaming api client for twitter
+test_files: 
+- spec/client_spec.rb
+- spec/spec_helper.rb