tuiter 0.0.1

data/AUTHORS

@@ -0,0 +1,14 @@
+Tuiter was design and developed by Manoel Lemos (manoel@lemos.net), to provide
+basic access to the Twitter API. It was developed for the experimental project
+called Tuitersfera Brasil (http://tuitersfera.com.br), an application to
+monitor the Twitter usage in Brazil.
+
+Both projects were latter adopted by WebCo Internet (http://webcointernet.com).
+
+The authors and contributors of Tuiter are:
+
+* Manoel Lemos  (manoel@lemos.net)
+* Luiz Rocha    (lsdr@lsdr.net)
+* Luis Cipriani (lfcipriani@talleye.com)
+* Lucas Húngaro (lucashungaro@gmail.com)
+

data/CHANGELOG

@@ -0,0 +1,3 @@
+== Tuiter 0.0.1
+  * extracting tuiter from tuitersfera
+

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009, Manoel Lemos 
+
+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,27 @@
+= Tuiter
+
+Tuiter was design and developed by {Manoel Lemos}[http://manoellemos.com] to provide access to the Twitter API. It was developed for the experimental project called {Tuitersfera Brasil}[http://tuitersfera.com.br], an application to monitor the Twitter usage in Brazil.
+
+Both Tuiter and Tuitersfera were adopted, further developed and maintained by {Webco Internet}[http://webcointernet.com].
+
+== Instalation
+
+A tuiter gem is avaliable in Github. To install simply run on a console:
+
+    gem install webco-utils --source=http://gems.github.com
+
+If you already have Github gem repository on you gem source, you can leave the source part out.
+
+== Basic Usage
+
+    require 'tuiter'
+    client = Tuiter::Client.new(:username => '<twitter_login>', :password => '<twitter_pwd>')
+    
+    client.update('Hey Ho, Twitters!')
+
+There are (or at least we pretend to add :-) another examples in the examples/ folder.
+
+== Roadmap and TO-DO list
+
+Check out the library roadmap and to-do list {in the wiki}[http://wiki.github.com/webco/tuiter]
+

data/Rakefile

@@ -0,0 +1,128 @@
+#!/usr/bin/env ruby
+
+require "rake"
+require "rake/testtask"
+require "rake/rdoctask"
+
+require "lib/tuiter/version"
+
+desc "Run test suite"
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
+  t.verbose = false
+end
+
+desc "Report code statistics (KLOCs, etc) from the library"
+task "stats" do
+  require "code_statistics"
+  ::CodeStatistics::TEST_TYPES << "Tests"
+  ::CodeStatistics.new(["Libraries", "lib"], ["Tests", "test"]).to_s
+end
+
+desc "List the names of the test methods"
+task "list" do
+  $LOAD_PATH.unshift("test")
+  $LOAD_PATH.unshift("lib")
+  require "test/unit"
+  Test::Unit.run = true
+  test_files = Dir.glob(File.join('test', '**/*_test.rb'))
+  test_files.each do |file|
+    load file
+    klass = File.basename(file, '.rb').classify.constantize
+    puts klass.name.gsub('Test', '')
+    test_methods = klass.instance_methods.grep(/^test/).map {|s| s.gsub(/^test: /, '')}.sort
+    test_methods.each {|m| puts "  " + m }
+  end
+end
+
+def spec_files
+  %w( Rakefile AUTHORS CHANGELOG LICENSE README.rdoc ) + Dir["{lib,examples,test}/**/*"]
+end
+
+def spec
+  spec = Gem::Specification.new do |s|
+    s.name = "tuiter"
+    s.version = Tuiter::VERSION::STRING 
+    s.summary = "Yet another Twitter API wrapper library in Ruby"
+    s.authors = ["Manoel Lemos", "WebCo Internet"]
+    s.email = "opensource@webcointernet.com"
+    s.homepage = "http://github.com/webco/tuiter"
+    s.description = "Yet another Twitter API wrapper library in Ruby"
+    s.has_rdoc = false
+    # s.extra_rdoc_files = ["LICENSE", "README.rdoc", "CHANGELOG"]
+    # s.rdoc_options = ["--inline-source", "--charset=utf-8"]
+    s.files = spec_files
+    s.rubyforge_project = "tuiter"
+
+    # Dependencies
+    s.add_dependency "json", ">= 1.1"
+  end
+end
+
+desc "Creates the gemspec"
+task "gemify" do
+  skip_fields = %w(new_platform original_platform specification_version loaded required_ruby_version rubygems_version platform bindir )
+
+  result = "# WARNING: RAKE AUTO-GENERATED FILE. DO NOT MANUALLY EDIT!\n"
+  result << "# RUN: 'rake gemify'\n\n"
+  result << "Gem::Specification.new do |s|\n"
+
+  spec.instance_variables.each do |ivar|
+    value = spec.instance_variable_get(ivar)
+    name = ivar.split("@").last
+    value = Date.today.to_s if name == "date"
+
+    next if skip_fields.include?(name) || value.nil? || value == "" || (value.respond_to?(:empty?) && value.empty?)
+    if name == "dependencies"
+      value.each do |d|
+        dep, *ver = d.to_s.split(" ")
+        result << " s.add_dependency #{dep.inspect}, #{ver.join(" ").inspect.gsub(/[()]/, "").gsub(", runtime", "")}\n"
+      end
+    elsif name == "required_rubygems_version"
+      result << " s.required_rubygems_version = Gem::Requirement.new(\">= 0\") if s.respond_to? :required_rubygems_version=\n"
+    else
+      case value
+      when Array
+        value = name != "files" ? value.inspect : value.inspect.split(",").join(",\n")
+      when FalseClass
+      when TrueClass
+      when Fixnum
+      when String
+        value = value.inspect
+      else
+        value = value.to_s.inspect
+      end
+      result << " s.#{name} = #{value}\n"
+    end
+  end
+  
+  result << "end"
+  File.open(File.join(File.dirname(__FILE__), "#{spec.name}.gemspec"), "w"){|f| f << result}
+end
+
+desc "Build the gem"
+task "build" => "gemify" do
+  sh "gem build #{spec.name}.gemspec"
+end
+
+desc "Install the gem locally"
+task "install" => "build" do
+  sh "gem install #{spec.name}-#{spec.version}.gem && rm -r *.gem *.gemspec"
+end
+
+desc "Publish the gem to Rubyforge"
+task "rubyforge" => "build" do
+  require 'rubyforge'
+  rubyforge_config_path = File.expand_path(File.join('~', '.rubyforge'))
+  user_config = YAML::load(File.open(rubyforge_config_path + '/user-config.yml'))
+  auto_config = YAML::load(File.open(rubyforge_config_path + '/auto-config.yml'))
+
+  @rubyforge = RubyForge.new(user_config, auto_config)
+  
+  @rubyforge.login
+  @rubyforge.add_release('tuiter', 'tuiter', "#{spec.version}", "#{spec.name}-#{spec.version}.gem")
+end
+
+task :default => ["test"]
+

data/examples/basic_example.rb

@@ -0,0 +1,8 @@
+require 'tuiter'
+
+client = Tuiter::Client.new(:username => 'screen_name', :password => 'password')
+
+15.times do
+  client.update('All work and no play makes Jack a dull boy')
+end
+

data/lib/tuiter.rb

@@ -0,0 +1,11 @@
+require 'open-uri'
+require 'uri'
+require 'net/http'
+require 'logger'
+
+require 'json'
+
+require 'tuiter/client'
+require 'tuiter/data/user'
+require 'tuiter/data/status'
+require 'tuiter/data/rate_limit'

data/lib/tuiter/client.rb

@@ -0,0 +1,189 @@
+module Tuiter
+
+  class Client
+    attr_accessor :username, :password
+    
+    def initialize(options = {})
+      @pid = Process.pid
+      @logger = options[:logger] || Logger.new('tuiter.log')
+      @username = options[:username]
+      @password = options[:password]
+      log("initialize()")
+    end
+    
+    def update(status, in_reply_to_status_id = nil)
+      log("update() sending: #{status}")
+      url = URI.parse('http://twitter.com/statuses/update.json')
+      req = Net::HTTP::Post.new(url.path)
+      req.basic_auth @username, @password
+      req.set_form_data({'status'=>status, 'in_reply_to_status_id'=>in_reply_to_status_id })
+      res = Net::HTTP.new(url.host, url.port).start {|http| http.request(req) }
+      case res
+      when Net::HTTPSuccess, Net::HTTPRedirection
+        log("update() success: OK")
+        return res # OK
+      else
+        log("update() error: #{res.error!}")
+        res.error!
+      end
+    end
+    
+    def direct_new(user, text)
+      log("direct_new() sending: #{text} to #{user}")
+      url = URI.parse('http://twitter.com/direct_messages/new.json')
+      req = Net::HTTP::Post.new(url.path)
+      req.basic_auth @username, @password
+      req.set_form_data({'user'=>user, 'text'=>text })
+      res = Net::HTTP.new(url.host, url.port).start {|http| http.request(req) }
+      case res
+      when Net::HTTPSuccess, Net::HTTPRedirection
+        log("direct_new() success: OK")
+        return res # OK
+      else
+        log("direct_new() error: #{res.error!}")
+        res.error!
+      end
+    end
+    
+    def friendship_new(user, follow = nil)
+      log("friendship_new() following: #{user}")
+      url = URI.parse("http://twitter.com/friendships/create/#{user}.json")
+      req = Net::HTTP::Post.new(url.path)
+      req.basic_auth @username, @password
+      req.set_form_data({'follow'=>"true"}) if follow
+      res = Net::HTTP.new(url.host, url.port).start {|http| http.request(req) }
+      case res
+      when Net::HTTPSuccess, Net::HTTPRedirection
+        log("friendship_new() success: OK")
+        return res # OK
+      else
+        log("friendship_new() error: #{res.error!}")
+        res.error!
+      end
+    end
+    
+    def verify_credentials?
+      if res = request("http://twitter.com/account/verify_credentials.json")
+        return UserExtended.new(JSON.parse(res))
+      else
+        return nil
+      end
+    end
+    
+    def get_followers(options = {})
+      if options[:id]
+        query = "http://twitter.com/statuses/followers/#{options[:id]}.json"
+      else
+        query = "http://twitter.com/statuses/followers.json"
+      end
+      if options[:page]
+        params = "?page=#{options[:page]}"
+      else
+        params = ""
+      end
+      if res = request(query+params)
+        data = JSON.parse(res)
+        return data.map { |d| User.new(d) }
+      else
+        return nil
+      end
+    end
+    
+    def get_replies(options = {})
+      query = "http://twitter.com/statuses/replies.json"
+      if options[:since]
+        params = "?since=#{options[:since]}"
+      elsif options[:since_id]
+        params = "?since_id=#{options[:since_id]}"
+      else
+        params = ""
+      end
+      if options[:page]
+        if params == ""
+            params = "?page=#{options[:page]}"
+        else
+            params = params + "&" + "page=#{options[:page]}"
+        end
+      end
+      if res = request(query+params)
+        data = JSON.parse(res)
+        return data.map { |d| Status.new(d) }
+      else
+        return nil
+      end
+    end
+    
+    def get_client
+      if res = request("http://twitter.com/users/show/#{@username}.json")
+        return UserExtended.new(JSON.parse(res))
+      else
+        return nil
+      end
+    end
+    
+    def get_user(id)
+      if res = request("http://twitter.com/users/show/#{id}.json")
+        return UserExtended.new(JSON.parse(res))
+      else
+        return nil
+      end
+    end
+    
+    def get_status(id)
+      if res = request("http://twitter.com/statuses/show/#{id}.json")
+        return Status.new(JSON.parse(res))
+      else
+        return nil
+      end
+    end
+    
+    def rate_limit
+      if res = request("http://twitter.com/account/rate_limit_status.json")
+        return RateLimit.new(JSON.parse(res))
+      else
+        return nil
+      end
+    end
+    
+    def follows_me?(id)
+      if res = request("http://twitter.com/friendships/exists.json?user_a=#{id}&user_b=#{@username}")
+        return true if res == "true"
+        return false
+      else
+        return nil
+      end
+    end
+  
+    private
+
+    def request(url)
+      http = nil
+      status = Timeout::timeout(10) do
+        log("request() query: #{url}")
+        http = open(url, :http_basic_authentication=>[@username, @password])
+        log("request() debug: http status is #{http.status.join(' ')}")
+        if http.status == ["200", "OK"]
+          res = http.read
+          return res
+        end
+        return nil        
+      end
+    rescue Timeout::Error
+      log("request() error: timeout error")
+      return nil
+    rescue OpenURI::HTTPError => e
+      log("request() http error: #{e.message} in #{e.backtrace.first.to_s}")
+      return nil
+    rescue Exception => e
+      log("request() error: #{e.message} in #{e.backtrace.first.to_s}")
+      return nil
+    end  
+
+    def log(message)
+      @logger.info "[Tuiter:#{@pid}] #{Time.now.to_s} : #{message}"
+    end
+    
+  end
+  
+end
+

data/lib/tuiter/data/rate_limit.rb

@@ -0,0 +1,22 @@
+module Tuiter
+  
+  class RateLimit
+    attr_accessor :reset_time
+    attr_accessor :reset_time_in_seconds
+    attr_accessor :reset_window
+    attr_accessor :remaining_hits
+    attr_accessor :hourly_limit
+
+    def initialize(data = nil)
+      unless data.nil?
+        @reset_time_in_seconds = Time.at(data["reset_time_in_seconds"].to_i)
+        @reset_time = Time.parse(data["reset_time"])
+        @reset_window = @reset_time - Time.now
+        @remaining_hits = data["remaining_hits"].to_i
+        @hourly_limit = data["hourly_limit"].to_i
+      end
+    end
+
+  end
+end
+

data/lib/tuiter/data/status.rb

@@ -0,0 +1,44 @@
+module Tuiter
+
+  class StatusBasic
+    attr_accessor :created_at
+    attr_accessor :id
+    attr_accessor :text
+    attr_accessor :source
+    attr_accessor :truncated
+    attr_accessor :in_reply_to_status_id
+    attr_accessor :in_reply_to_user_id
+    attr_accessor :favorited
+    attr_accessor :in_reply_to_screen_name
+
+    def initialize(data = nil)
+      unless data.nil?
+        @created_at = Time.parse(data["created_at"])
+        @id = data["id"]
+        @text = data["text"]
+        @source = data["source"]
+        @truncated = data["truncated"]
+        @in_reply_to_status_id = data["in_reply_to_status_id"]
+        @in_reply_to_user_id = data["in_reply_to_user_id"]
+        @favorited = data["favorited"]
+        @in_reply_to_screen_name = data["in_reply_to_screen_name"]
+      end
+    end  
+
+  end
+
+
+  class Status < StatusBasic
+    attr_accessor :user
+
+    def initialize(data=nil)
+      unless data.nil?
+        super(data)
+        @user = UserBasic.new(data["user"])
+      end
+    end
+
+  end
+
+end
+

data/lib/tuiter/data/user.rb

@@ -0,0 +1,83 @@
+module Tuiter
+
+  class UserBasic
+    attr_accessor :id
+    attr_accessor :name
+    attr_accessor :screen_name
+    attr_accessor :location
+    attr_accessor :description
+    attr_accessor :profile_image_url
+    attr_accessor :url
+    attr_accessor :protected
+    attr_accessor :followers_count
+
+    def initialize(data = nil)
+      unless data.nil?
+        @id = data["id"]
+        @name = data["name"]
+        @screen_name = data["screen_name"]
+        @location = data["location"]
+        @description = data["description"]
+        @profile_image_url = data["profile_image_url"]
+        @url = data["url"]
+        @protected = data["protected"]
+        @followers_count = data["followers_count"]
+      end
+    end
+
+  end
+
+  class UserExtended < UserBasic
+    attr_accessor :profile_background_color
+    attr_accessor :profile_text_color
+    attr_accessor :profile_link_color
+    attr_accessor :profile_sidebar_fill_color
+    attr_accessor :profile_sidebar_border_color
+    attr_accessor :friends_count
+    attr_accessor :created_at
+    attr_accessor :favourites_count
+    attr_accessor :utc_offset
+    attr_accessor :time_zone
+    attr_accessor :profile_background_image_url
+    attr_accessor :profile_background_tile
+    attr_accessor :following
+    attr_accessor :notifications
+    attr_accessor :statuses_count
+
+    def initialize(data = nil)
+      unless data.nil?
+        super(data)
+        @profile_background_color = data["profile_background_color"]
+        @profile_text_color = data["profile_text_color"]
+        @profile_link_color = data["profile_link_color"]
+        @profile_sidebar_fill_color = data["profile_sidebar_fill_color"]
+        @profile_sidebar_border_color = data["profile_sidebar_border_color"]
+        @friends_count = data["friends_count"].to_i
+        @created_at = Time.parse(data["created_at"])
+        @favourites_count = data["favourites_count"].to_i
+        @utc_offset = data["utc_offset"]
+        @time_zone = data["time_zone"]
+        @profile_background_image_url = data["profile_background_image_url"]
+        @profile_background_tile = data["profile_background_tile"]
+        @following = data["following"]
+        @notifications = data["notifications"]
+        @statuses_count = data["statuses_count"].to_i
+      end
+    end
+
+  end
+
+   class User < UserBasic
+    attr_accessor :status
+
+    def initialize(data=nil)
+      unless data.nil?
+        super(data)
+        @status = StatusBasic.new(data["status"])
+      end
+    end
+
+  end
+
+end
+

data/lib/tuiter/version.rb

@@ -0,0 +1,16 @@
+#
+# Tuiter, Copyright (c) 2009 Manoel Lemos & WebCo Internet
+#
+
+unless defined? Tuiter::VERSION
+  module Tuiter
+    module VERSION
+      MAJOR = 0
+      MINOR = 0
+      TINY = 1
+
+      STRING = [MAJOR, MINOR, TINY].join('.')
+    end
+  end
+end
+

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: tuiter
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Manoel Lemos
+- WebCo Internet
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-03-20 00:00:00 -03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.1"
+    version: 
+description: Yet another Twitter API wrapper library in Ruby
+email: opensource@webcointernet.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Rakefile
+- AUTHORS
+- CHANGELOG
+- LICENSE
+- README.rdoc
+- lib/tuiter
+- lib/tuiter/client.rb
+- lib/tuiter/data
+- lib/tuiter/data/rate_limit.rb
+- lib/tuiter/data/status.rb
+- lib/tuiter/data/user.rb
+- lib/tuiter/version.rb
+- lib/tuiter.rb
+- examples/basic_example.rb
+has_rdoc: false
+homepage: http://github.com/webco/tuiter
+post_install_message: 
+rdoc_options: []
+
+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: tuiter
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Yet another Twitter API wrapper library in Ruby
+test_files: []
+