gilesbowkett-twitter 0.4.3

data/History

@@ -0,0 +1,126 @@
+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
+
+0.3.6 - August 11, 2008
+			* Fixed a few more methods that required post.
+			* Refactored the remaining methods that were not using #request to use it.
+
+0.3.5 - August 4, 2008
+			* Removed sqlite-ruby 1.2.2 as a dependency due to install issues on linux
+			
+0.3.4 - August 3, 2008
+			* Added search support
+			
+0.3.3 - August 3, 2008
+			* Now has option for host when initializing to support identi.ca (Dustin Sallings)
+			* Twitter changed a bunch of methods to POST only so I updated those to now work
+			
+0.3.2 - July 26, 2008
+			* added the CLI gems as dependencies for now until I separate out the CLI from the API wrapper
+			* cleaner CLI errors for no active account or no accounts at all
+			* remove sets a new active account if there are none
+			* added username and password optional arguments to add
+			* added import attempt on install and on anything that uses #current_account helper
+			
+0.3.1 - July 23, 2008
+			* added open to CLI twitter open jnunemaker would open default browser to http://twitter.com/jnunemaker
+			* added -f to timeline and replies which ignores the since_id and shows all results
+			* added clear_config to remove all cached since id's and such
+			* Majorly pimped the output of timelines and replies.
+			
+0.3.0 - July 22, 2008
+			* complete rewrite of CLI. Now supports multiple accounts and changing between them.
+			* added source, truncated, in_reply_to_status_id, in_reply_to_user_id, and favorited to Twitter::Status
+			* added protected to Twitter::User
+			* d CLI method now takes standard input like post
+			* Rewrote several methods that had since parameter to now use a hash instead. This makes it more flexible as API updates.
+			* Rewrote the methods that took lite or since as an argument to instead take a hash.
+			* added Twitter::Base#friendship_exists?
+			* added Twitter::Base#update_location
+			* added Twitter::Base#update_delivery_device
+			* added Twitter::Base#favorites
+			* added Twitter::Base#create_favorite
+			* added Twitter::Base#destroy_favorite
+			* added Twitter::Base#block
+			* added Twitter::Base#unblock
+			
+			BACKWORDS COMPATIBILITY BREAK: 
+			Any method that you have using lite or since as an argument 
+			will no longer work with this version. Simply change to a 
+			hash and you'll be fine. For example:
+			
+			friends(true) would now be friends(:lite => true)
+			
+0.2.7 - June 29, 2008
+			* added #rate_limit_status (Daniel Morrison)
+			* added source parameter option to Base#post 
+			* added twittergem as source when posting from command line
+			* Twitter::RateExceeded raised when you hit your limit (Jim O'Leary)
+			* Twitter::Unavailable raised when twitter returns 503
+			* Twitter::CantConnect is now more descriptive as to what is the problem when it is raised during a request
+			* quoting your message when using twitter post on the command line is now optional (Benoit Caccinolo)
+			* aliased post to p on command line so it's shorter (Benoit Caccinolo)
+			* unescaped html and added some color in command line view (Miles Z. Sterrett)
+			* added gemspec (technoweenie, Miles Z. Sterrett)
+			* Fixed stack trace error on first command line operation (Matt Rose)
+0.2.6 - April 2, 2008
+			* found a more simple way of doing stdin without any extra gem dependencies
+0.2.5 - April 2, 2008
+			* Command line interface can now use stdin for posting (ideas and example code from Jeremy Friesen)
+					$ twitter post 'test without stdin' # => twitters: test without stdin
+					$ echo 'test with stdin' | twitter post 'and an argv[1]' # => twitters: test with stdin and an argv[1]
+					$ echo 'test with stdin without any argv[1]' | twitter post # => twitters: test with stdin without any argv[1]
+0.2.4 - Mar 31, 2008
+			* Added lite option to friends and followers, which doesn't include the user's current status (Daniel Morrison)
+			* Updated since option to use HTTP header, and added the option on timeline() and replies(). (Daniel Morrison)
+0.2.3 - Jan 16, 2008
+			* added d to command line interface twitter d jnunemaker 'hola' (Humbucker)
+			* added progress dots when posting for confirmation when twitter is running slow (Hendy Irawan)
+0.2.2 - added leave and follow which are new twitter api methods for turning notifications on and off
+0.2.0 - Aug 4, 2007
+			* added sent_messages
+			* alias direct_messages to received_messages
+			* added create_friendship
+			* added destroy_friendship
+			* added featured to retrieve the featured twitter users
+			* added replies
+			* added destroy to destroy a status by id
+			* added status to find a status by id
+			* added active support as an extra dependency
+			* implemented d method to send direct messages (jnewland)
+			* fixed since argument in direct_messages method (jnewland)
+0.1.1 - May 20, 2007
+			* hpricot 0.5+ now supported; just a bug fix (Ryan Waldron is the man!)
+0.1.0 - March 31, 2007
+			* added d method for creating direct messages (waiting for it to work as documented)
+			* added featured method for getting featured users statuses (waiting for it to work as documented)
+			* added direct_messages method
+			* added friends_for method
+			* added a few tests
+			* removed relative_created_at as it is deprecated
+			* separated out the call method into call, request and parse methods
+0.0.5 - just a bit of code cleanup
+0.0.4 - added :location, :description, :url, :profile_image_url to user class (Alex Payne)
+0.0.3 - added a bit more informative message when things go wrong
+0.0.2 - added the command line options i forgot to add (friend and follower); improved some docs
+0.0.1 - initial release

data/License

@@ -0,0 +1,19 @@
+Copyright (c) 2007 John Nunemaker
+
+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/Manifest

@@ -0,0 +1,69 @@
+bin/twitter
+examples/blocks.rb
+examples/direct_messages.rb
+examples/favorites.rb
+examples/friends_followers.rb
+examples/friendships.rb
+examples/identica_timeline.rb
+examples/location.rb
+examples/posting.rb
+examples/replies.rb
+examples/search.rb
+examples/sent_messages.rb
+examples/timeline.rb
+examples/twitter.rb
+examples/verify_credentials.rb
+History
+lib/twitter/base.rb
+lib/twitter/cli/config.rb
+lib/twitter/cli/helpers.rb
+lib/twitter/cli/migrations/20080722194500_create_accounts.rb
+lib/twitter/cli/migrations/20080722194508_create_tweets.rb
+lib/twitter/cli/migrations/20080722214605_add_account_id_to_tweets.rb
+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
+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
+spec/fixtures/user_timeline.xml
+spec/search_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/status_spec.rb
+spec/user_spec.rb
+twitter.gemspec
+website/css/common.css
+website/images/terminal_output.png
+website/index.html

data/README

@@ -0,0 +1,84 @@
+= addicted to twitter
+
+... a sweet little diddy that helps you twitter your life away
+
+== Install
+
+sudo gem install twitter will work just fine. For command line use, you'll need a few other gems: sudo gem install main highline activerecord sqlite3-ruby
+
+== Examples
+
+	Twitter::Base.new('your email', 'your password').update('watching veronica mars')
+	
+	# or you can use post
+	Twitter::Base.new('your email', 'your password').post('post works too')
+
+	puts "Public Timeline", "=" * 50
+	Twitter::Base.new('your email', 'your password').timeline(:public).each do |s|
+	  puts s.text, s.user.name
+	  puts
+	end
+
+	puts '', "Friends Timeline", "=" * 50
+	Twitter::Base.new('your email', 'your password').timeline.each do |s|
+	  puts s.text, s.user.name
+	  puts
+	end
+
+	puts '', "Friends", "=" * 50
+	Twitter::Base.new('your email', 'your password').friends.each do |u|
+	  puts u.name, u.status.text
+	  puts
+	end
+
+	puts '', "Followers", "=" * 50
+	Twitter::Base.new('your email', 'your password').followers.each do |u|
+	  puts u.name, u.status.text
+	  puts
+	end
+	
+== Search Examples
+
+	Twitter::Search.new('httparty').each { |r| puts r.inspect }
+	Twitter::Search.new('httparty').from('jnunemaker').each { |r| puts r.inspect }
+	Twitter::Search.new.from('jnunemaker').to('oaknd1').each { |r| puts r.inspect }
+	
+
+== Command Line Use
+
+Note: If you want to use twitter from the command line be sure that sqlite3 and the sqlite3-ruby gem are installed. I removed the sqlite3-ruby gem as a dependency because you shouldn't need that to just use the API wrapper. Eventually I'll move the CLI interface into another gem.
+	
+	$ twitter
+
+Will give you a list of all the commands. You can get the help for each command by running twitter [command] -h. 
+
+The first thing you'll want to do is install the database so your account(s) can be stored. 
+
+	$ twitter install
+	
+You can always uninstall twitter like this:
+
+	$ twitter uninstall
+	
+Once the twitter database is installed and migrated, you can add accounts like this:
+
+	$ twitter add
+	Add New Account:
+	Username: jnunemaker
+	Password (won't be displayed): 
+	Account added.
+
+You can also list all the accounts you've added.
+
+	$ twitter list
+	Account List
+	* jnunemaker
+	  snitch_test
+
+The * means denotes the account that will be used when posting, befriending, defriending, following, leaving or viewing a timeline.
+
+To post using the account marked with the *, simply type the following:
+
+	$ twitter post "releasing my new twitter gem"
+
+That is about it. You can do pretty much anything that you can do with twitter from the command line interface.

data/Rakefile

@@ -0,0 +1,42 @@
+ProjectName = 'twitter'
+WebsitePath = "jnunemaker@rubyforge.org:/var/www/gforge-projects/#{ProjectName}"
+
+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

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+# if we have stdin, let's prepend it to the message for post
+if ARGV[0] && ARGV[0] == 'post' && !STDIN.tty?
+  ARGV[1] = "#{STDIN.read}#{ARGV[1]}"
+end
+
+# if we have stdin, let's prepend it to the message for d
+if ARGV[0] && ARGV[0] == 'd' && !STDIN.tty?
+  ARGV[2] = "#{STDIN.read}#{ARGV[2]}"
+end
+
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'twitter'))
+require 'twitter/cli'

data/examples/blocks.rb

@@ -0,0 +1,15 @@
+require 'rubygems'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+twitter = Twitter::Base.new(config['email'], config['password'])
+
+puts 'BLOCK CREATE'
+puts twitter.block('project_rockne').name
+puts
+puts
+
+puts 'BLOCK DESTROY'
+puts twitter.block('project_rockne').name
+puts
+puts

data/examples/direct_messages.rb

@@ -0,0 +1,29 @@
+require 'rubygems'
+require 'activesupport'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+twitter = Twitter::Base.new(config['email'], config['password'])
+
+puts 'SINCE'
+twitter.direct_messages(:since => Time.now - 5.day).each do |s|
+  puts "- #{s.id} #{s.text}"
+end
+puts
+puts
+
+# puts 'SINCE_ID'
+# twitter.direct_messages(:since_id => 33505386).each do |s|
+#   puts "- #{s.text}"
+# end
+# puts
+# puts
+# 
+# puts 'PAGE'
+# twitter.direct_messages(:page => 1).each do |s|
+#   puts "- #{s.text}"
+# end
+# puts
+# puts
+
+# puts twitter.destroy_direct_message(34489057).inspect

data/examples/favorites.rb

@@ -0,0 +1,20 @@
+require 'rubygems'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+twitter = Twitter::Base.new(config['email'], config['password'])
+
+puts 'CREATE'
+puts twitter.create_favorite(865416114).text
+puts
+puts
+
+puts 'FAVORITES'
+twitter.favorites.each { |f| puts f.text }
+puts
+puts
+
+puts 'DESTROY'
+puts twitter.destroy_favorite(865416114).text
+puts
+puts

data/examples/friends_followers.rb

@@ -0,0 +1,25 @@
+require 'rubygems'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+twitter = Twitter::Base.new(config['email'], config['password'])
+
+puts "FRIENDS"
+twitter.friends.each { |f| puts f.name }
+puts
+puts
+
+puts "FRIENDS FOR"
+twitter.friends_for('orderedlist', :lite => true).each { |f| puts f.name }
+puts
+puts
+
+puts "FOLLOWERS"
+twitter.followers(:lite => true).each { |f| puts f.name }
+puts
+puts
+
+puts "FOLLOWERS FOR"
+twitter.followers_for('orderedlist', :lite => true).each { |f| puts f.name }
+puts
+puts

data/examples/friendships.rb

@@ -0,0 +1,13 @@
+require 'rubygems'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+twitter = Twitter::Base.new(config['email'], config['password'])
+
+puts twitter.create_friendship('orderedlist').name
+puts twitter.follow('orderedlist').name
+puts twitter.leave('orderedlist').name
+puts twitter.destroy_friendship('orderedlist').name
+
+puts twitter.friendship_exists?('jnunemaker', 'orderedlist').inspect
+puts twitter.friendship_exists?('jnunemaker', 'ze').inspect

data/examples/identica_timeline.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+identica = Twitter::Base.new(config['email'], config['password'], :api_host => 'identi.ca/api')
+
+identica.timeline(:public).each { |s| puts s.text, s.user.name, '' }

data/examples/location.rb

@@ -0,0 +1,8 @@
+require 'rubygems'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+twitter = Twitter::Base.new(config['email'], config['password'])
+
+puts twitter.update_location('Hollywood, CA').location
+puts twitter.update_delivery_device('none')

data/examples/posting.rb

@@ -0,0 +1,9 @@
+require 'rubygems'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+twitter = Twitter::Base.new(config['email'], config['password'])
+puts twitter.post("This is a test from the example file").inspect
+
+# sending a direct message
+# puts twitter.d('jnunemaker', 'this is a test').inspect

data/examples/replies.rb

@@ -0,0 +1,27 @@
+require 'rubygems'
+require 'activesupport'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+twitter = Twitter::Base.new(config['email'], config['password'])
+
+puts 'SINCE'
+twitter.replies(:since => Time.now - 5.day).each do |s|
+  puts "- #{s.text}"
+end
+puts
+puts
+
+puts 'SINCE_ID'
+twitter.replies(:since_id => 863081345).each do |s|
+  puts "- #{s.text}"
+end
+puts
+puts
+
+puts 'PAGE'
+twitter.replies(:page => 1).each do |s|
+  puts "- #{s.text}"
+end
+puts
+puts

data/examples/search.rb

@@ -0,0 +1,18 @@
+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, '' }
+# pp search.result
+# search.clear
+
+# search.from('jnunemaker').to('oaknd1').since(814529437).containing('milk').each { |r| puts r.inspect, '' }
+# search.clear
+# 
+# search.geocode('40.757929', '-73.985506', '50mi').containing('holland').each { |r| puts r.inspect, '' }
+# search.clear
+
+# pp search.from('jnunemaker').fetch()

data/examples/sent_messages.rb

@@ -0,0 +1,27 @@
+require 'rubygems'
+require 'activesupport'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+twitter = Twitter::Base.new(config['email'], config['password'])
+
+puts 'SINCE'
+twitter.sent_messages(:since => Time.now - 5.day).each do |s|
+  puts "- #{s.text}"
+end
+puts
+puts
+
+puts 'SINCE_ID'
+twitter.sent_messages(:since_id => 33505386).each do |s|
+  puts "- #{s.text}"
+end
+puts
+puts
+
+puts 'PAGE'
+twitter.sent_messages(:page => 1).each do |s|
+  puts "- #{s.text}"
+end
+puts
+puts

data/examples/timeline.rb

@@ -0,0 +1,34 @@
+require 'rubygems'
+require 'activesupport'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+twitter = Twitter::Base.new(config['email'], config['password'])
+
+puts 'SINCE'
+twitter.timeline(:user, :since => Time.now - 1.day).each do |s|
+  puts "- #{s.text}"
+end
+puts
+puts
+
+puts 'SINCE_ID'
+twitter.timeline(:user, :since_id => 865547074).each do |s|
+  puts "- #{s.text}"
+end
+puts
+puts
+
+puts 'COUNT'
+twitter.timeline(:user, :count => 1).each do |s|
+  puts "- #{s.text}"
+end
+puts
+puts
+
+puts 'PAGE'
+twitter.timeline(:user, :page => 1).each do |s|
+  puts "- #{s.text}"
+end
+puts
+puts

data/examples/twitter.rb

@@ -0,0 +1,27 @@
+require 'rubygems'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+puts "Public Timeline", "=" * 50
+Twitter::Base.new(config['email'], config['password']).timeline(:public).each do |s|
+  puts s.text, s.user.name
+  puts
+end
+
+puts '', "Friends Timeline", "=" * 50
+Twitter::Base.new(config['email'], config['password']).timeline.each do |s|
+  puts s.text, s.user.name
+  puts
+end
+
+puts '', "Friends", "=" * 50
+Twitter::Base.new(config['email'], config['password']).friends.each do |u|
+  puts u.name, u.status.text
+  puts
+end
+
+puts '', "Followers", "=" * 50
+Twitter::Base.new(config['email'], config['password']).followers.each do |u|
+  puts u.name, u.status.text
+  puts
+end

data/examples/verify_credentials.rb

@@ -0,0 +1,13 @@
+require 'rubygems'
+require File.join(File.dirname(__FILE__), '..', 'lib', 'twitter')
+config = YAML::load(open(ENV['HOME'] + '/.twitter'))
+
+twitter = Twitter::Base.new(config['email'], config['password'])
+
+puts twitter.verify_credentials
+
+begin
+  Twitter::Base.new('asdf', 'foobar').verify_credentials
+rescue => error
+  puts error.message
+end