pupil 0.0.3

data/.document

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

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,11 @@
+source "http://rubygems.org"
+
+gem "oauth"
+
+group :development do
+  gem "rspec", "~> 2.3.0"
+  gem "yard", "~> 0.6.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.4"
+  gem "rcov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,32 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    oauth (0.4.5)
+    rake (0.9.2)
+    rcov (0.9.10)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    yard (0.6.8)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  jeweler (~> 1.6.4)
+  oauth
+  rcov
+  rspec (~> 2.3.0)
+  yard (~> 0.6.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Oame
+
+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,19 @@
+= pupil
+
+Description goes here.
+
+== Contributing to pupil
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Oame. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,42 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "pupil"
+  gem.homepage = "http://github.com/oame/pupil"
+  gem.license = "MIT"
+  gem.summary = %Q{The Twitter API Wrapper for Ruby}
+  gem.description = %Q{The "Lazy" Twitter API wrapper for Ruby. It was made for Kbot library.}
+  gem.email = "oame@oameya.com"
+  gem.authors = ["Oame"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.0.3

data/lib/pupil.rb

@@ -0,0 +1,652 @@
+# -*- coding: utf-8 -*-
+
+require 'net/http'
+require 'rexml/document'
+require 'uri'
+require 'rubygems' if RUBY_VERSION < '1.9.0'
+require 'oauth'
+#require 'pp'
+
+class Pupil
+  attr_reader :screen_name
+  
+  class UnsupportedParameter < StandardError; end
+  
+  # @param [Hash] pupil_key
+  def initialize(pupil_key)
+    @screen_name = pupil_key[:screen_name]
+    @client = nil
+    @config = nil
+    consumer = OAuth::Consumer.new(
+      pupil_key[:consumer_key],
+      pupil_key[:consumer_secret],
+      :site => 'http://api.twitter.com'
+    )
+    @access_token = OAuth::AccessToken.new(
+      consumer,
+      pupil_key[:access_token],
+      pupil_key[:access_token_secret]
+    )
+  end
+  
+  # @param [Hash] parameter
+  # @return [String] serialized parameters
+  def param_serializer parameter
+    ant = Hash.new
+    parameter.each do |key, value|
+      case key.to_sym
+      when :include
+        if value.class == String || Symbol
+          ant[:"include_#{value}"] = :true
+          break
+        end
+        
+        value.each do |element|
+          raise UnsupportedParameter, 'include_entities is not supported.' if element.to_sym == :entities
+          ant[:"include_#{element}"] = :true
+        end
+      when :exclude
+        if value.class == String || Symbol
+          ant[:"exclude_#{value}"] = :true
+          break
+        end
+        
+        value.each do |element|
+          ant[:"exclude_#{element}"] = :true
+        end
+      else
+        ant[key.to_sym] = value
+      end
+    end
+    param = ant.inject(""){|k,v|k+"&#{v[0]}=#{v[1]}"}.sub!(/^&/,"?")
+    return param ? param : ""
+  end
+  
+  class REXML::Document
+    def is_error?
+      if self.root.get_text("error") then
+        return true
+      else
+        return false
+      end
+    end
+
+    def get_error_message
+      return self.root.get_text("error")
+    end
+  end
+
+  public
+  
+  # @return [Hash] user profile
+  def verify_credentials
+    response = @access_token.get('/account/verify_credentials.xml')
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    user = User.new(doc.elements['/user'])
+    return user
+  end
+  
+  # @param [Hash] param
+  # @return [Hash] alias to Pupil#home_timeline
+  # @deprecated Use {#home_timeline} instead of this method because
+  #   is was obsoleted.
+  def friends_timeline(param = {})
+    param_s = param_serializer(param)
+    begin
+      response = @access_token.get("http://api.twitter.com/1/statuses/friends_timeline.xml"+param_s)
+    rescue
+      return false
+    end
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    statuses = Array.new
+
+    doc.get_elements('/statuses/status').each do |element|
+      status = Status.new(element)
+      statuses << status
+    end
+
+    return statuses
+  end
+  
+  # @param [Hash] param
+  # @return [Array] timeline
+  def home_timeline(param = {})
+    param_s = param_serializer(param)
+    begin
+      response = @access_token.get("http://api.twitter.com/1/statuses/home_timeline.xml"+param_s)
+    rescue
+      return false
+    end
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    statuses = Array.new
+    doc.get_elements('/statuses/status').each{|element|
+      status = Status.new(element)
+      statuses << status
+    }
+    return statuses
+  end
+  
+  # @param [Hash] param
+  # @return [Hash] timeline
+  # @option param [Fixnum] :user_id The ID of user
+  # @option param [String] :screen_name The Screen name of user
+  # @option param [Fixnum] :since_id
+  # @option param [Fixnum] :max_id
+  # @option param [Fixnum] :count
+  # @option param [Fixnum] :page Specifies
+  # @option param [Symbol] :trim_user
+  # @option param [Symbol] :include => :rts
+  # @option param [Symbol] :exclude => :replies
+  # @option param [Symbol] :contributor_details
+  # @example
+  #   twitter = Pupil.new PUPIL_KEY
+  #   twitter.user_timeline(:screen_name => 'o_ame', :exclude_replies => :true).each do |status|
+  #     puts "#{status.user.screen_name}: #{status.text}"
+  #   end
+  def user_timeline(param = {})
+    param_s = param_serializer(param)
+    begin
+      response = @access_token.get("http://api.twitter.com/1/statuses/user_timeline.xml"+param_s)
+    rescue
+      return false
+    end
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    statuses = Array.new
+    doc.get_elements('/statuses/status').each{|element|
+      status = Status.new(element)
+      statuses << status
+    }
+    return statuses
+  end
+  
+  # @param [Hash] param
+  # @return [Hash] mention
+  def mentions(param = {})
+    param_s = param_serializer(param)
+    begin
+      response = @access_token.get("http://api.twitter.com/1/statuses/mentions.xml"+param_s)
+    rescue
+      return false
+    end
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    statuses = Array.new
+
+    doc.get_elements('/statuses/status').each{|element|
+      status = Status.new(element)
+      statuses << status
+    }
+
+    return statuses
+  end
+  
+  # @param [Hash] param
+  # @return [Hash] directmessages
+  def dm(param = {})
+    param_s = param_serializer(param)
+    begin
+      response = @access_token.get("http://api.twitter.com/1/direct_messages.xml"+param_s)
+    rescue
+      return false
+    end
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    directmessages = Array.new
+
+    doc.get_elements('/direct-messages/direct_message').each{|element|
+      dm = DirectMessage.new(element)
+      directmessages << dm
+    }
+
+    return directmessages
+  end
+  
+  # @param [Hash] param
+  # @return [Hash] directmessage you sent
+  def dm_sent(param = {})
+    param_s = param_serializer(param)
+    begin
+      response = @access_token.get("http://api.twitter.com/1/direct_messages/sent.xml"+param_s)
+    rescue
+      return false
+    end
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    directmessages = Array.new
+
+    doc.get_elements('/direct-messages/direct_message').each{|element|
+      dm = DirectMessage.new(element)
+      directmessages << dm
+    }
+
+    return directmessages
+  end
+  
+  # @param [Fixnum] dm_id message id that you want to delete
+  # @return [Hash] response
+  def dm_destroy(dm_id)
+    begin
+      response = @access_token.post("http://api.twitter.com/1/direct_messages/destroy/#{dm_id}.xml")
+    rescue
+      return false
+    end
+    return response
+  end
+  
+  # @param [String] src source user
+  # @param [String] dst destination user
+  # @return [Boolean] return true if paired users have friendship, or ruturn false
+  def friendship_exists?(src, dst)
+    begin
+      response = @access_token.get("http://api.twitter.com/1/friendships/exists.xml?user_a=#{src}&user_b=#{dst}")
+    rescue
+      return false
+    end
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    if doc.elements["friends"].text() == "true" then
+      return true
+    else
+      return false
+    end
+  end
+  
+  # @param [String] name screen_name
+  # @return [Hash] response
+  def follow name
+    begin
+      response = @access_token.post("http://api.twitter.com/1/friendships/create/#{name}.xml")
+    rescue
+      return false
+    end
+    return response
+  end
+  
+  # @param [String] name screen_name
+  # @return [Hash] response
+  def unfollow name
+    begin
+      response = @access_token.post("http://api.twitter.com/1/friendships/destroy/#{name}.xml")
+    rescue
+      return false
+    end
+    return response
+  end
+  
+  # @param [Fixnum] id id
+  # @return [Hash] response
+  def block(id)
+    begin
+      response = @access_token.post("http://api.twitter.com/1/blocks/create.xml?id=#{id}")
+    rescue
+      return false
+    end
+    return response
+  end
+  
+  # @param [Fixnum] id id
+  # @return [Hash] response
+  def unblock(id)
+    begin
+      response = @access_token.post("http://api.twitter.com/1/blocks/destroy.xml?id=#{id}")
+    rescue
+      return false
+    end
+    return response
+  end
+  
+  # @return [Hash] list of blocking users
+  def blocking
+    response = @access_token.get("http://api.twitter.com/1/blocks/blocking.xml")
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    users = Array.new
+    doc.get_elements('/users/user').each{|element|
+      user = User.new(element)
+      users << user
+    }
+    return users
+  end
+  
+  # @param [Fixnum] id list id
+  # @param [String] ids id comma separated
+  # @return [Hash] response
+  def addlist(listid,ids)
+    response = @access_token.post("http://api.twitter.com/1/#{@username}/#{listid}/create_all.xml?user_id=#{ids}")
+    return response
+  end
+  
+  # @return [Hash] lists
+  def lists
+    response = @access_token.get("http://api.twitter.com/1/#{@username}/lists.xml")
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    lists = Array.new
+    doc.get_elements('/lists_list/lists/list').each{|element|
+      list = List.new(element)
+      lists << list
+    }
+    return lists
+  end
+  
+  
+  def lists_member_create(listid,id)
+    begin
+      response = @access_token.post("http://api.twitter.com/1/#{@username}/#{listid}/members.xml?id=#{id}")
+    rescue
+      return false
+    else
+      return response
+    end
+
+  end
+
+  def lookup(param = [])
+    param_s = param.join(",")
+    begin
+      response = @access_token.get("http://api.twitter.com/1/users/lookup.xml?user_id="+param_s)
+    rescue
+      return false
+    end
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    users = Array.new
+    doc.get_elements('/users/user').each{|element|
+      user = User.new(element)
+      users << user
+    }
+
+    return users
+  end
+
+  def friends_ids(name)
+    begin
+      response = @access_token.get("http://api.twitter.com/1/friends/ids/#{name}.xml")
+    rescue
+      return false
+    end
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    ids = Array.new
+
+    doc.get_elements('/ids/id').each{|element|
+      ids << element.text()
+    }
+
+    return ids
+  end
+
+  def followers_ids(name)
+    begin
+      response = @access_token.get("http://api.twitter.com/1/followers/ids/#{name}.xml")
+    rescue
+      return false
+    end
+    doc = REXML::Document.new(response.body)
+    if doc.is_error? then
+      return doc.get_error_message
+    end
+    ids = Array.new
+
+    doc.get_elements('/ids/id').each{|element|
+      ids << element.text()
+    }
+
+    return ids
+  end
+
+  def rate_limit
+    begin
+      response = @access_token.get("http://api.twitter.com/1/account/rate_limit_status.xml")
+    rescue
+      return false
+    end
+    doc = REXML::Document.new(response.body)
+    return false if doc.is_error?
+    limit = doc.get_elements('/hash/hourly-limit').shift.text()
+
+    return limit
+  end
+
+  def update(status,irt='')
+    begin
+      response = @access_token.post(
+      'http://api.twitter.com/1/statuses/update.json',
+      'status'=> status,
+      'in_reply_to_status_id' => irt
+      )
+    rescue
+      return false
+    end
+    return response
+  end
+
+  def destroy(status_id)
+    begin
+      response = @access_token.post("http://api.twitter.com/1/statuses/destroy/#{status_id}.xml")
+    rescue
+      return false
+    end
+    return response
+  end
+
+  def update_location(location='')
+    location = URI.escape(location)
+    begin
+      response = @access_token.post("http://api.twitter.com/1/account/update_location.xml?location=#{location}")
+    rescue
+      return false
+    end
+    return response
+  end
+  
+  class List
+    attr_reader :id
+    attr_reader :name
+    attr_reader :full_name
+    attr_reader :slug
+    attr_reader :description
+    attr_reader :subscriber_count
+    attr_reader :member_count
+    attr_reader :uri
+    attr_reader :following
+    attr_reader :mode
+    attr_reader :user
+
+    def initialize(element)
+      @id = element.elements['id'].text()
+      @name = element.elements['name'].text()
+      @full_name = element.elements['full_name'].text()
+      @slug = element.elements['slug'].text()
+      @description = element.elements['description'].text()
+      @subscriber_count = element.elements['subscriber_count'].text()
+      @member_count = element.elements['member_count'].text()
+      @uri = element.elements['uri'].text()
+      @following = element.elements['following'].text()
+      @mode = element.elements['mode'].text()
+      @user = User.new(element.elements['user'])
+    end
+  end
+  class DirectMessage
+    attr_reader :id
+    attr_reader :sender_id
+    attr_reader :text
+    attr_reader :recipient_id
+    attr_reader :created_at
+    attr_reader :sender_screen_name
+    attr_reader :recipient_screen_name
+    attr_reader :sender
+    attr_reader :recipient
+    
+    def initialize(element)
+      @id = element.elements['id'].text()
+      @sender_id = element.elements['sender_id'].text()
+      @text = element.elements['text'].text()
+      @recipient_id = element.elements['recipient_id'].text()
+      @created_at = element.elements['created_at'].text()
+      @sender_screen_name = element.elements['sender_screen_name'].text()
+      @recipient_screen_name= element.elements['recipient_screen_name'].text()
+      @sender = User.new(element.elements['sender'])
+      @recipient = User.new(element.elements['recipient'])
+    end
+  end
+  class User
+    attr_reader :id
+    attr_reader :name
+    attr_reader :screen_name
+    attr_reader :description
+    attr_reader :url
+    attr_reader :followers_count
+    attr_reader :friends_count
+    attr_reader :statuses_count
+    attr_reader :location
+    attr_reader :profile_image_url
+    attr_reader :profile_background_color
+    attr_reader :profile_background_image_url
+    attr_reader :profile_background_tile
+    attr_reader :profile_text_color
+    attr_reader :profile_link_color
+    attr_reader :profile_sidebar_fill_color
+    attr_reader :profile_sidebar_border_color
+    attr_reader :protected
+    attr_reader :created_at
+    attr_reader :favourites_count
+    attr_reader :utc_offset
+    attr_reader :time_zone
+    attr_reader :notifications
+    attr_reader :geo_enabled
+    attr_reader :verified
+    attr_reader :lang
+    attr_reader :contributors_enabled
+    attr_reader :following
+    attr_reader :follow_request_sent
+
+    def initialize(element)
+      @id = element.elements['id'].text()
+      @name = element.elements['name'].text()
+      @screen_name = element.elements['screen_name'].text()
+      @location = element.elements['location'].text()
+      @description = element.elements['description'].text()
+      @profile_image_url = element.elements['profile_image_url'].text()
+      @url = element.elements['url'].text()
+      @protected = element.elements['protected'].text()
+      @followers_count = element.elements['followers_count'].text()
+      @friends_count = element.elements['friends_count'].text()
+      @profile_background_color = element.elements['profile_background_color'].text()
+      @profile_background_image_url = element.elements['profile_background_image_url'].text()
+      @profile_background_tile = element.elements['profile_background_tile'].text()
+      @profile_text_color = element.elements['profile_text_color'].text()
+      @profile_link_color = element.elements['profile_link_color'].text()
+      @profile_sidebar_fill_color = element.elements['profile_sidebar_fill_color'].text()
+      @profile_sidebar_border_color = element.elements['profile_sidebar_border_color'].text()
+      @statuses_count = element.elements['statuses_count'].text()
+      @created_at = element.elements['created_at'].text()
+      @favourites_count = element.elements['favourites_count'].text()
+      @utc_offset = element.elements['utc_offset'].text()
+      @time_zone = element.elements['time_zone'].text()
+      @notifications = element.elements['notifications'].text()
+      @geo_enabled = element.elements['geo_enabled'].text()
+      @verified = element.elements['verified'].text()
+      @lang = element.elements['lang'].text()
+      @contributors_enabled = element.elements['contributors_enabled'].text()
+      @following = element.elements['following'].text()
+      @follow_request_sent = element.elements['follow_request_sent'].text()
+    end
+  end
+
+  class Status
+    attr_reader :created_at
+    attr_reader :id
+    attr_reader :text
+    attr_reader :source
+    attr_reader :truncated
+    attr_reader :in_reply_to_status_id
+    attr_reader :in_reply_to_user_id
+    attr_reader :in_reply_to_screen_name
+    attr_reader :favorited
+    attr_reader :user
+    attr_reader :geo
+    attr_reader :place
+    attr_reader :coordinates
+    attr_reader :contributors
+    attr_reader :annotations
+    attr_reader :entities
+
+    def initialize(element)
+      @created_at = element.elements['created_at'].text()
+      @id = element.elements['id'].text()
+      @text = element.elements['text'].text()
+      @source = element.elements['source'].text()
+      @truncated = element.elements['truncated'].text()
+      @in_reply_to_status_id = element.elements['in_reply_to_status_id'].text()
+      @in_reply_to_user_id = element.elements['in_reply_to_user_id'].text()
+      @in_reply_to_screen_name = element.elements['in_reply_to_screen_name'].text()
+      @favorited = element.elements['favorited'].text()
+      @user = User.new(element.elements['user'])
+      @geo = element.elements['geo'].text()
+      @place = element.elements['place'].text()
+      @coordinates = (element.elements['coordinates'].nil?) ? nil : element.elements['coordinates'].text()
+      @contributors = (element.elements['contributors'].nil?) ? nil : element.elements['contributors'].text()
+      @annotations = (element.elements['annotations'].nil?) ? nil : element.elements['annotations'].text()
+      @entities = (element.elements['entities'].nil?) ? nil : Entities.new(element.elements['entities'])
+    end
+  end
+
+  class Entities
+    attr_reader :user_mentions
+    attr_reader :urls
+    attr_reader :hashtags
+    
+    def initialize(element)
+      @user_mentions = UserMention.new(element.elements['user_mention'])
+      @urls = URL.new(element.elements['urls'])
+      @hashtags = Hashtag.new(element.elements['hashtags'])
+    end
+  end
+  
+  class UserMention
+    attr_reader :id
+    attr_reader :screen_name
+    attr_reader :name
+    attr_reader :start
+    attr_reader :end
+    
+    def initialize(element)
+      @id = element.elements['id'].text()
+      @screen_name = element.elements['screen_name'].text()
+      @name = element.elements['name'].text()
+      @start = element.attributes['start']
+      @end = element.attributes['end']
+    end
+  end
+  
+  class URL
+    attr_reader :url
+    attr_reader :expanded_url
+    attr_reader :start
+    attr_reader :end
+    
+    def initialize(element)
+      @url = element.elements['url'].text()
+      @expanded_url = element.elements['expanded_url'].text()
+      @start = element.attributes['start']
+      @end = element.attributes['end']
+    end
+  end
+  
+  class Hashtag
+    attr_reader :text
+    attr_reader :start
+    attr_reader :end
+    
+    def initialize(element)
+      @text = element.elements['text'].text()
+      @start = element.attributes['start']
+      @end = element.attributes['end']
+    end
+  end
+end

data/lib/pupil/keygen.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+require 'rubygems' if RUBY_VERSION < '1.9.0'
+require 'oauth'
+
+class Pupil
+  def self.keygen
+    print "Enter OAuth Consumer_Key: "
+    oauth_consumer_key = gets.chomp.strip
+    print "Enter OAuth Consumer_Secret: "
+    oauth_consumer_secret = gets.chomp.strip
+
+    CONSUMER_KEY = oauth_consumer_key
+    CONSUMER_SECRET = oauth_consumer_secret
+
+    consumer = OAuth::Consumer.new(CONSUMER_KEY, CONSUMER_SECRET, :site => 'http://twitter.com')
+
+    request_token = consumer.get_request_token
+
+    puts "Access to this URL and approve: #{request_token.authorize_url}"
+
+    print "Enter OAuth Verifier: "
+    oauth_verifier = gets.chomp.strip
+
+    access_token = request_token.get_access_token(:oauth_verifier => oauth_verifier)
+
+    puts "Process complete!"
+    puts "Access token: #{access_token.token}"
+    puts "Access token secret: #{access_token.secret}"
+  end
+end

data/pupil.gemspec

@@ -0,0 +1,67 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{pupil}
+  s.version = "0.0.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = [%q{Oame}]
+  s.date = %q{2011-09-11}
+  s.description = %q{The "Lazy" Twitter API wrapper for Ruby. It was made for Kbot library.}
+  s.email = %q{oame@oameya.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/pupil.rb",
+    "lib/pupil/keygen.rb",
+    "pupil.gemspec",
+    "spec/pupil_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/oame/pupil}
+  s.licenses = [%q{MIT}]
+  s.require_paths = [%q{lib}]
+  s.rubygems_version = %q{1.8.5}
+  s.summary = %q{The Twitter API Wrapper for Ruby}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<oauth>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<oauth>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<yard>, ["~> 0.6.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<oauth>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<yard>, ["~> 0.6.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

data/spec/pupil_spec.rb

@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+
+### WARNING ###
+# pupil_spec require PUPIL_TESTKEY in spec_testkey.rb
+# You should create file spec_testkey.rb into /spec to define PUPIL_TESTKEY with Pupil key.
+
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Pupil, "が #home_timeline を呼ぶ時は" do
+  before do
+    pupil = Pupil.new PUPIL_TESTKEY
+    @home_timeline = pupil.home_timeline
+  end
+  
+  it "Array型を返すこと" do
+    @home_timeline.class.should == Array
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'pupil'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  require "#{File.dirname(__FILE__)}/pupil_testkey.rb"
+end

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification
+name: pupil
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+  prerelease: 
+platform: ruby
+authors:
+- Oame
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-11 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: &2154807720 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2154807720
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2154807120 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: *2154807120
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &2154806520 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *2154806520
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &2154805920 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *2154805920
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &2154805280 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.4
+  type: :development
+  prerelease: false
+  version_requirements: *2154805280
+- !ruby/object:Gem::Dependency
+  name: rcov
+  requirement: &2154804680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *2154804680
+description: The "Lazy" Twitter API wrapper for Ruby. It was made for Kbot library.
+email: oame@oameya.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/pupil.rb
+- lib/pupil/keygen.rb
+- pupil.gemspec
+- spec/pupil_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/oame/pupil
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -2172588966398234870
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.5
+signing_key: 
+specification_version: 3
+summary: The Twitter API Wrapper for Ruby
+test_files: []