billymeltdown-twitter 0.3.8.1 → 0.4.2

data/{History.txt → History}

@@ -1,3 +1,23 @@
+0.4.2 - February 10, 2009
+* 1 minor enhancement
+  * Adding the Social Graph API methods (Josh Owens)
+  
+0.4.1 - January 1, 2009
+* 4 minor enhancements and 2 bug fixes:
+  * Added better exception handling (Billy Gray)
+  * Added page to search (Michael Ivey)
+  * Adding an option to display tweets on CLI in reverse order (oldest first). (Cameron Booth)
+  * Added in_reply_to_status_id option for replying to statuses (anthonycrumley)
+  * Fixed a bug where the @config was improperly set (K. Adam Christensen)
+  * Fix verify_credentials to include a format (breaks in laconica). (dustin)
+  
+0.4.0 - December 23, 2008
+* 3 major changes
+  * Removed active support as dependency
+  * Removed CLI dependencies from install dependency list
+      (they are now only installed by you manually)
+  * Switched to echoe for gem managment
+      
 0.3.7 - August 26, 2008
 			* Fixed source param not getting through
 

data/{Manifest.txt → Manifest}

@@ -1,11 +1,4 @@
-History.txt
-License.txt
-Manifest.txt
-README.txt
-Rakefile
 bin/twitter
-config/hoe.rb
-config/requirements.rb
 examples/blocks.rb
 examples/direct_messages.rb
 examples/favorites.rb
@@ -20,9 +13,8 @@ examples/sent_messages.rb
 examples/timeline.rb
 examples/twitter.rb
 examples/verify_credentials.rb
-lib/twitter.rb
+History
 lib/twitter/base.rb
-lib/twitter/cli.rb
 lib/twitter/cli/config.rb
 lib/twitter/cli/helpers.rb
 lib/twitter/cli/migrations/20080722194500_create_accounts.rb
@@ -32,27 +24,36 @@ lib/twitter/cli/migrations/20080722214606_create_configurations.rb
 lib/twitter/cli/models/account.rb
 lib/twitter/cli/models/configuration.rb
 lib/twitter/cli/models/tweet.rb
+lib/twitter/cli.rb
 lib/twitter/direct_message.rb
 lib/twitter/easy_class_maker.rb
 lib/twitter/rate_limit_status.rb
 lib/twitter/search.rb
+lib/twitter/search_result.rb
+lib/twitter/search_result_info.rb
 lib/twitter/status.rb
 lib/twitter/user.rb
 lib/twitter/version.rb
-script/destroy
-script/generate
-script/txt2html
-setup.rb
+lib/twitter.rb
+License
+Manifest
+Rakefile
+README
 spec/base_spec.rb
 spec/cli/helper_spec.rb
 spec/direct_message_spec.rb
+spec/fixtures/follower_ids.xml
 spec/fixtures/followers.xml
+spec/fixtures/friend_ids.xml
 spec/fixtures/friends.xml
 spec/fixtures/friends_for.xml
 spec/fixtures/friends_lite.xml
 spec/fixtures/friends_timeline.xml
+spec/fixtures/friendship_already_exists.xml
+spec/fixtures/friendship_created.xml
 spec/fixtures/public_timeline.xml
 spec/fixtures/rate_limit_status.xml
+spec/fixtures/search_result_info.yml
 spec/fixtures/search_results.json
 spec/fixtures/status.xml
 spec/fixtures/user.xml
@@ -62,9 +63,6 @@ spec/spec.opts
 spec/spec_helper.rb
 spec/status_spec.rb
 spec/user_spec.rb
-tasks/deployment.rake
-tasks/environment.rake
-tasks/website.rake
 twitter.gemspec
 website/css/common.css
 website/images/terminal_output.png

data/Rakefile

@@ -1,4 +1,42 @@
-require 'config/requirements'
-require 'config/hoe' # setup Hoe + all gem configuration
+ProjectName = 'twitter'
+WebsitePath = "jnunemaker@rubyforge.org:/var/www/gforge-projects/#{ProjectName}"
 
-Dir['tasks/**/*.rake'].each { |rake| load rake }
+require 'rubygems'
+require 'rake'
+require 'echoe'
+require 'spec/rake/spectask'
+require "lib/#{ProjectName}/version"
+
+Echoe.new(ProjectName, Twitter::Version) do |p|
+  p.description     = "a command line interface for twitter, also a library which wraps the twitter api"
+  p.url             = "http://#{ProjectName}.rubyforge.org"
+  p.author          = "John Nunemaker"
+  p.email           = "nunemaker@gmail.com"
+  p.extra_deps      = [['hpricot', '>= 0.6'], ['activesupport', '>= 2.1'], ['httparty', '>= 0.2.4']]
+  p.need_tar_gz     = false
+  p.docs_host       = WebsitePath
+end
+
+desc 'Upload website files to rubyforge'
+task :website do
+  sh %{rsync -av website/ #{WebsitePath}}
+  Rake::Task['website_docs'].invoke
+end
+
+task :website_docs do
+  Rake::Task['redocs'].invoke
+  sh %{rsync -av doc/ #{WebsitePath}/docs}
+end
+
+desc 'Preps the gem for a new release'
+task :prepare do
+  %w[manifest build_gemspec].each do |task|
+    Rake::Task[task].invoke
+  end
+end
+
+Rake::Task[:default].prerequisites.clear
+task :default => :spec
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList["spec/**/*_spec.rb"]
+end

data/bin/twitter

@@ -10,6 +10,5 @@ if ARGV[0] && ARGV[0] == 'd' && !STDIN.tty?
   ARGV[2] = "#{STDIN.read}#{ARGV[2]}"
 end
 
-$:.unshift File.join(File.dirname(__FILE__), '..', 'lib')
-require 'twitter'
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'twitter'))
 require 'twitter/cli'

data/examples/direct_messages.rb

@@ -1,4 +1,5 @@
 require 'rubygems'
+require 'activesupport'
 require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
 config = YAML::load(open(ENV['HOME'] + '/.twitter'))
 

data/examples/favorites.rb

@@ -4,13 +4,13 @@ config = YAML::load(open(ENV['HOME'] + '/.twitter'))
 
 twitter = Twitter::Base.new(config['email'], config['password'])
 
-puts 'FAVORITES'
-twitter.favorites.each { |f| puts f.text }
+puts 'CREATE'
+puts twitter.create_favorite(865416114).text
 puts
 puts
 
-puts 'CREATE'
-puts twitter.create_favorite(865416114).text
+puts 'FAVORITES'
+twitter.favorites.each { |f| puts f.text }
 puts
 puts
 

data/examples/replies.rb

@@ -1,4 +1,5 @@
 require 'rubygems'
+require 'activesupport'
 require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
 config = YAML::load(open(ENV['HOME'] + '/.twitter'))
 

data/examples/search.rb

@@ -2,6 +2,7 @@ require 'rubygems'
 require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
 
 Twitter::Search.new('httparty').each { |r| puts r.inspect,'' }
+Twitter::Search.new('httparty').page(2).each { |r| puts r.inspect, '' }
 
 # search = Twitter::Search.new
 # search.from('jnunemaker').to('oaknd1').each { |r| puts r.inspect, '' }

data/examples/sent_messages.rb

@@ -1,4 +1,5 @@
 require 'rubygems'
+require 'activesupport'
 require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
 config = YAML::load(open(ENV['HOME'] + '/.twitter'))
 

data/examples/timeline.rb

@@ -1,4 +1,5 @@
 require 'rubygems'
+require 'activesupport'
 require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
 config = YAML::load(open(ENV['HOME'] + '/.twitter'))
 

data/lib/twitter.rb

@@ -1,6 +1,12 @@
-%w(uri cgi net/http yaml rubygems hpricot active_support).each { |f| require f }
+require 'uri'
+require 'cgi'
+require 'net/http'
+require 'yaml'
+require 'time'
+require 'rubygems'
+require 'hpricot'
 
-$:.unshift(File.join(File.dirname(__FILE__)))
+$:.unshift(File.dirname(__FILE__))
 require 'twitter/version'
 require 'twitter/easy_class_maker'
 require 'twitter/base'
@@ -9,6 +15,8 @@ require 'twitter/search'
 require 'twitter/status'
 require 'twitter/direct_message'
 require 'twitter/rate_limit_status'
+require 'twitter/search_result_info'
+require 'twitter/search_result'
 
 module Twitter
   class Unavailable < StandardError; end
@@ -16,10 +24,10 @@ module Twitter
   class BadResponse < StandardError; end
   class UnknownTimeline < ArgumentError; end
   class RateExceeded < StandardError; end
-  class CantFindUsers < ArgumentError; end
-  class AlreadyFollowing < StandardError; end
   class RequestRefused < ArgumentError; end
-  class YouAreNotFriends < StandardError; end
+  class CantFindUsers < RequestRefused; end
+  class AlreadyFollowing < RequestRefused; end
+  class YouAreNotFriends < RequestRefused; end
 
   SourceName = 'twittergem'
 end

data/lib/twitter/base.rb

@@ -12,8 +12,10 @@ module Twitter
     # Identi.ca example:
     #   Twitter.new('email/username', 'password', :api_host => 'identi.ca/api')
     def initialize(email, password, options={})
-      @config, @config[:email], @config[:password] = {}, email, password
       @api_host = options.delete(:api_host) || 'twitter.com'
+      @config, @config[:email], @config[:password] = options, email, password
+      @proxy_host = options[:proxy_host]
+      @proxy_port = options[:proxy_port]
     end
     
     # Returns an array of statuses for a timeline; Defaults to your friends timeline.
@@ -33,6 +35,13 @@ module Twitter
       friends(options.merge({:id => id}))
     end
     
+    # Returns an array of user ids who are friends for the account or the option id/username passed in
+    def friend_ids(id_or_screenname = nil)
+      path = id_or_screenname ? "friends/ids/#{id_or_screenname}.xml" : "friends/ids.xml"
+      doc = request(path, :auth => true)
+      (doc/:id).inject([]) {|ids, id| ids << id.innerHTML; ids}
+    end
+    
     # Returns an array of users who are following you
     def followers(options={})
       users(call(:followers, {:args => parse_options(options)}))
@@ -42,6 +51,13 @@ module Twitter
       followers(options.merge({:id => id}))
     end
     
+    # Returns an array of user ids who are followers for the account or the option id/username passed in
+    def follower_ids(id_or_screenname = nil)
+      path = id_or_screenname ? "followers/ids/#{id_or_screenname}.xml" : "followers/ids.xml"
+      doc = request(path, :auth => true)
+      (doc/:id).inject([]) {|ids, id| ids << id.innerHTML; ids}
+    end
+    
     # Returns a single status for a given id
     def status(id)
       statuses(call("show/#{id}")).first
@@ -159,6 +175,7 @@ module Twitter
     def post(status, options={})
       form_data = {'status' => status}
       form_data.merge!({'source' => options[:source]}) if options[:source]
+      form_data.merge!({'in_reply_to_status_id' => options[:in_reply_to_status_id]}) if options[:in_reply_to_status_id]
       Status.new_from_xml(request('statuses/update.xml', :auth => true, :method => :post, :form_data => form_data))
     end
     alias :update :post
@@ -166,7 +183,7 @@ module Twitter
     # Verifies the credentials for the auth user.
     #   raises Twitter::CantConnect on failure.
     def verify_credentials
-      request('account/verify_credentials', :auth => true)
+      request('account/verify_credentials.xml', :auth => true)
     end
     
     private      
@@ -184,28 +201,18 @@ module Twitter
       # 
       # ie: call(:public_timeline, :auth => false)
       def call(method, options={})
-        options.reverse_merge!({ :auth => true, :args => {} })
+        options = { :auth => true, :args => {} }.merge(options)
         # Following line needed as lite=false doesn't work in the API: http://tinyurl.com/yo3h5d
         options[:args].delete(:lite) unless options[:args][:lite]
         args = options.delete(:args)
         request(build_path("statuses/#{method.to_s}.xml", args), options)
       end
       
-      # Makes a request to twitter.
-      def request(path, options={})
-        options.reverse_merge!({
-          :headers => { "User-Agent" => @config[:email] },
-          :method => :get
-        })
-        unless options[:since].blank?
-          since = options[:since].kind_of?(Date) ? options[:since].strftime('%a, %d-%b-%y %T GMT') : options[:since].to_s  
-          options[:headers]["If-Modified-Since"] = since
-        end
-        
+      def response(path, options={})
         uri = URI.parse("http://#{@api_host}")
         
         begin
-          response = Net::HTTP::Proxy(options[:proxy_host], options[:proxy_port]).start(uri.host, uri.port) do |http|
+          response = Net::HTTP::Proxy(@proxy_host, @proxy_port).start(uri.host, uri.port) do |http|
             klass = Net::HTTP.const_get options[:method].to_s.downcase.capitalize
             req = klass.new("#{uri.path}/#{path}", options[:headers])
             req.basic_auth(@config[:email], @config[:password]) if options[:auth]
@@ -217,7 +224,24 @@ module Twitter
         rescue => error
           raise CantConnect, error.message
         end
+      end
+      
+      # Makes a request to twitter.
+      def request(path, options={})
+        options = {
+          :headers => { "User-Agent" => @config[:email] },
+          :method => :get,
+        }.merge(options)
+        
+        unless options[:since].nil?
+          since = options[:since].kind_of?(Date) ? options[:since].strftime('%a, %d-%b-%y %T GMT') : options[:since].to_s  
+          options[:headers]["If-Modified-Since"] = since
+        end
         
+        handle_response!(response(path, options))
+      end
+      
+      def handle_response!(response)
         if %w[200 304].include?(response.code)
           response = parse(response.body)
           raise RateExceeded if (response/:hash/:error).text =~ /Rate limit exceeded/
@@ -227,20 +251,23 @@ module Twitter
         elsif response.code == '401'
           raise CantConnect, 'Authentication failed. Check your username and password'
         elsif response.code == '403'
-          # get an Hpricot document
-          doc = parse(response.body)
-          raise CantFindUsers, (doc/:hash/:error).text if (doc/:hash/:error).text =~ /Could not find both specified users/
-          raise AlreadyFollowing, (doc/:hash/:error).text if (doc/:hash/:error).text =~ /already on your list/
-          raise YouAreNotFriends, (doc/:hash/:error).text if (doc/:hash/:error).text =~ /You are not friends/
-          raise RequestRefused, "Response code #{response.code}: #{response.message}"
+          error_message = (parse(response.body)/:hash/:error).text
+          raise CantFindUsers, error_message  if error_message =~ /Could not find both specified users/
+          raise AlreadyFollowing, error_message if error_message =~ /already on your list/
+          raise YouAreNotFriends, error_message if error_message =~ /You are not friends/
+          raise RequestRefused, "Response code #{response.code}: #{response.message} #{error_message}"
         else
-          raise CantConnect, "Twitter is returning a #{response.code}: #{response.message}"
+          raise CantConnect, "Twitter is returning a #{response.code}: #{response.message} #{(doc/:hash/:error).text}"
         end
-      end      
+      end
     
       # Given a path and a hash, build a full path with the hash turned into a query string
       def build_path(path, options)
-        path += "?#{options.to_query}" unless options.blank?
+        unless options.nil?
+          query = options.inject('') { |str, h| str += "#{CGI.escape(h[0].to_s)}=#{CGI.escape(h[1].to_s)}&"; str }
+          path += "?#{query}"
+        end
+        
         path
       end
 
@@ -255,4 +282,4 @@ module Twitter
         Hpricot.XML(response || '')
       end
   end
-end
+end

data/lib/twitter/cli.rb

@@ -1,8 +1,10 @@
 require 'rubygems'
+
 gem 'main', '>= 2.8.2'
 gem 'highline', '>= 1.4.0'
-gem 'activerecord', '>= 2.1'
+gem 'activerecord', '= 2.2.2'
 gem 'sqlite3-ruby', '>= 1.2.1'
+
 require 'main'
 require 'highline/import'
 require 'activerecord'
@@ -177,7 +179,7 @@ Main {
         end
         post_thread.join
         progress_thread.join
-        say "Got it! New twitter created at: #{status.created_at}\n"
+        say "Got it! New tweet created at: #{status.created_at}\n"
       end
     end
   end
@@ -215,7 +217,7 @@ Main {
   end
   
   mode 'follow' do
-    description "Allows you to turn on notifications for a user"
+    description "Allows you to add notifications for a user (aka Follow Them)"
     argument('username') {
       required
       description 'username or id of twitterrer to follow'
@@ -275,21 +277,25 @@ Main {
     option('force', 'f') {
       description "Ignore since_id and show first page of results even if there aren't new ones"
     }
+    option('reverse', 'r') {
+      description 'Reverse the output so the oldest tweets are at the top'
+    }
     
     def run
       do_work do
         timeline = params['timeline'].value == 'me' ? 'user' : params['timeline'].value
         options, since_id = {}, Configuration["#{timeline}_since_id"]
-        options[:since_id] = since_id if !since_id.blank? && !params['force'].given?
+        options[:since_id] = since_id if !since_id.nil? && !params['force'].given?
+        reverse = params['reverse'].given? ? true : false
         cache = [:friends, :user].include?(timeline)
         collection = base.timeline(timeline.to_sym, options)
-        output_tweets(collection, {:cache => cache, :since_prefix => timeline})
+        output_tweets(collection, {:cache => cache, :since_prefix => timeline, :reverse => reverse})
       end
     end
   end
   
   mode 'replies' do
-    description 'Allows you to view all @replies at you'
+    description 'Allows you to view all @replies sent to you'
     option('force', 'f') {
       description "Ignore since_id and show first page of replies even if there aren't new ones"
     }
@@ -297,7 +303,7 @@ Main {
     def run
       do_work do
         options, since_id = {}, Configuration["replies_since_id"]
-        options[:since_id] = since_id if !since_id.blank? && !params['force'].given?
+        options[:since_id] = since_id if !since_id.nil? && !params['force'].given?
         collection = base.replies(options)
         output_tweets(collection, {:since_prefix => 'replies'})
       end