anthonycrumley-twitter 0.3.8

data/History.txt

@@ -0,0 +1,106 @@
+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.txt

@@ -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.txt

@@ -0,0 +1,71 @@
+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
+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
+lib/twitter.rb
+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
+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/direct_message.rb
+lib/twitter/easy_class_maker.rb
+lib/twitter/rate_limit_status.rb
+lib/twitter/search.rb
+lib/twitter/status.rb
+lib/twitter/user.rb
+lib/twitter/version.rb
+script/destroy
+script/generate
+script/txt2html
+setup.rb
+spec/base_spec.rb
+spec/cli/helper_spec.rb
+spec/direct_message_spec.rb
+spec/fixtures/followers.xml
+spec/fixtures/friends.xml
+spec/fixtures/friends_for.xml
+spec/fixtures/friends_lite.xml
+spec/fixtures/friends_timeline.xml
+spec/fixtures/public_timeline.xml
+spec/fixtures/rate_limit_status.xml
+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
+tasks/deployment.rake
+tasks/environment.rake
+tasks/website.rake
+twitter.gemspec
+website/css/common.css
+website/images/terminal_output.png
+website/index.html

data/README.txt

@@ -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,4 @@
+require 'config/requirements'
+require 'config/hoe' # setup Hoe + all gem configuration
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }

data/bin/twitter

@@ -0,0 +1,15 @@
+#!/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
+
+$:.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+require 'twitter'
+require 'twitter/cli'

data/config/hoe.rb

@@ -0,0 +1,74 @@
+require 'twitter/version'
+
+AUTHOR = "John Nunemaker"  # can also be an array of Authors
+EMAIL = "nunemaker@gmail.com"
+DESCRIPTION = "a command line interface for twitter, also a library which wraps the twitter api"
+GEM_NAME = "twitter" # what ppl will type to install your gem
+RUBYFORGE_PROJECT = "twitter" # The unix name for your project
+HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+RELEASE_TYPES = %w( gem ) # can use: gem, tar, zip
+DOWNLOAD_PATH = "http://rubyforge.org/projects/#{RUBYFORGE_PROJECT}"
+
+@config_file = "~/.rubyforge/user-config.yml"
+@config = nil
+RUBYFORGE_USERNAME = "unknown"
+def rubyforge_username
+  unless @config
+    begin
+      @config = YAML.load(File.read(File.expand_path(@config_file)))
+    rescue
+      puts <<-EOS
+ERROR: No rubyforge config file found: #{@config_file}
+Run 'rubyforge setup' to prepare your env for access to Rubyforge
+ - See http://newgem.rubyforge.org/rubyforge.html for more details
+      EOS
+      exit
+    end
+  end
+  RUBYFORGE_USERNAME.replace @config["username"]
+end
+
+
+REV = nil 
+# UNCOMMENT IF REQUIRED: 
+# REV = `svn info`.each {|line| if line =~ /^Revision:/ then k,v = line.split(': '); break v.chomp; else next; end} rescue nil
+VERS = Twitter::VERSION::STRING + (REV ? ".#{REV}" : "")
+RDOC_OPTS = ['--quiet', '--title', 'twitter documentation',
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README",
+    "--inline-source"]
+
+class Hoe
+  def extra_deps 
+    @extra_deps.reject! { |x| Array(x).first == 'hoe' } 
+    @extra_deps
+  end 
+end
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+hoe = Hoe.new(GEM_NAME, VERS) do |p|
+  p.author         = AUTHOR 
+  p.description    = DESCRIPTION
+  p.email          = EMAIL
+  p.summary        = DESCRIPTION
+  p.url            = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.test_globs     = ["test/**/test_*.rb"]
+  p.clean_globs   |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']  #An array of file patterns to delete on clean.
+  
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  #p.extra_deps = []     # An array of rubygem dependencies [name, version], e.g. [ ['active_support', '>= 1.3.1'] ]
+  p.extra_deps = [['hpricot', '>= 0.6'], ['activesupport', '>= 2.1'], 
+                  ['main', '>= 2.8.2'], ['highline', '>= 1.4.0'], 
+                  ['activerecord', '>= 2.1'], ['httparty', '>= 0.1.0']]
+  #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
+  
+end
+
+CHANGES = hoe.paragraphs_of('History.txt', 0..1).join("\\n\\n")
+PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "#{RUBYFORGE_PROJECT}/#{GEM_NAME}"
+hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')
+hoe.rsync_args = '-av --delete --ignore-errors'

data/config/requirements.rb

@@ -0,0 +1,17 @@
+require 'fileutils'
+include FileUtils
+
+require 'rubygems'
+%w[rake hoe newgem rubigen].each do |req_gem|
+  begin
+    require req_gem
+  rescue LoadError
+    puts "This Rakefile requires the '#{req_gem}' RubyGem."
+    puts "Installation: gem install #{req_gem} -y"
+    exit
+  end
+end
+
+$:.unshift(File.join(File.dirname(__FILE__), %w[.. lib]))
+
+require 'twitter'

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,28 @@
+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 '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 'FAVORITES'
+twitter.favorites.each { |f| puts f.text }
+puts
+puts
+
+puts 'CREATE'
+puts twitter.create_favorite(865416114).text
+puts
+puts
+
+puts 'DESTROY'
+puts twitter.destroy_favorite(865416114).text
+puts
+puts