pjdavis-twitter 0.3.8

data/tasks/deployment.rake

@@ -0,0 +1,50 @@
+desc 'Preps the gem for a new release'
+task :prep_for_release do
+  require 'rio'
+  Rake::Task['manifest:refresh'].invoke
+  gemspec = %x[rake debug_gem]
+  lines = gemspec.split("\n")
+  rio('twitter.gemspec') < lines[1, lines.length-1].join("\n")
+end
+
+desc 'Release the website and new gem version'
+task :deploy => [:check_version, :website, :release] do
+  puts "Remember to create SVN tag:"
+  puts "svn copy svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/trunk " +
+    "svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/tags/REL-#{VERS} "
+  puts "Suggested comment:"
+  puts "Tagging release #{CHANGES}"
+end
+
+desc 'Runs tasks website_generate and install_gem as a local deployment of the gem'
+task :local_deploy => [:website_generate, :install_gem]
+
+task :check_version do
+  unless ENV['VERSION']
+    puts 'Must pass a VERSION=x.y.z release version'
+    exit
+  end
+  unless ENV['VERSION'] == VERS
+    puts "Please update your version.rb to match the release version, currently #{VERS}"
+    exit
+  end
+end
+
+desc 'Install the package as a gem, without generating documentation(ri/rdoc)'
+task :install_gem_no_doc => [:clean, :package] do
+  sh "#{'sudo ' unless Hoe::WINDOZE }gem install pkg/*.gem --no-rdoc --no-ri"
+end
+
+namespace :manifest do
+  desc 'Recreate Manifest.txt to include ALL files'
+  task :refresh do
+    `rake check_manifest | patch -p0 > Manifest.txt`
+  end
+end
+
+namespace :files do
+  task :copy do
+    files = File.read(File.join(File.dirname(__FILE__), '..', 'Manifest.txt')).split("\n")
+    %x[echo '#{files.inspect}' | pbcopy]
+  end
+end

data/tasks/environment.rake

@@ -0,0 +1,7 @@
+task :ruby_env do
+  RUBY_APP = if RUBY_PLATFORM =~ /java/
+    "jruby"
+  else
+    "ruby"
+  end unless defined? RUBY_APP
+end

data/tasks/website.rake

@@ -0,0 +1,17 @@
+desc 'Generate website files'
+task :website_generate => :ruby_env do
+  (Dir['website/**/*.txt'] - Dir['website/version*.txt']).each do |txt|
+    sh %{ #{RUBY_APP} script/txt2html #{txt} > #{txt.gsub(/txt$/,'html')} }
+  end
+end
+
+desc 'Upload website files to rubyforge'
+task :website_upload do
+  host = "#{rubyforge_username}@rubyforge.org"
+  remote_dir = "/var/www/gforge-projects/#{PATH}/"
+  local_dir = 'website'
+  sh %{rsync -aCv #{local_dir}/ #{host}:#{remote_dir}}
+end
+
+desc 'Generate and upload website files'
+task :website => [:website_upload, :publish_docs]

data/twitter.gemspec

@@ -0,0 +1,49 @@
+Gem::Specification.new do |s|
+  s.name = %q{twitter}
+  s.version = "0.3.8"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["John Nunemaker", "PJ Davis"]
+  s.date = %q{2008-08-26}
+  s.default_executable = %q{twitter}
+  s.description = %q{a command line interface for twitter, also a library which wraps the twitter api}
+  s.email = %q{nunemaker@gmail.com}
+  s.executables = ["twitter"]
+  s.extra_rdoc_files = ["History.txt", "License.txt", "Manifest.txt", "README.txt"]
+  s.files = ["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"]
+  s.has_rdoc = true
+  s.homepage = %q{http://twitter.rubyforge.org}
+  s.rdoc_options = ["--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{twitter}
+  s.rubygems_version = %q{1.2.0}
+  s.summary = %q{a command line interface for twitter, also a library which wraps the twitter api}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if current_version >= 3 then
+      s.add_runtime_dependency(%q<hpricot>, [">= 0.6"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 2.1"])
+      s.add_runtime_dependency(%q<main>, [">= 2.8.2"])
+      s.add_runtime_dependency(%q<highline>, [">= 1.4.0"])
+      s.add_runtime_dependency(%q<activerecord>, [">= 2.1"])
+      s.add_runtime_dependency(%q<httparty>, [">= 0.1.0"])
+    else
+      s.add_dependency(%q<hpricot>, [">= 0.6"])
+      s.add_dependency(%q<activesupport>, [">= 2.1"])
+      s.add_dependency(%q<main>, [">= 2.8.2"])
+      s.add_dependency(%q<highline>, [">= 1.4.0"])
+      s.add_dependency(%q<activerecord>, [">= 2.1"])
+      s.add_dependency(%q<httparty>, [">= 0.1.0"])
+    end
+  else
+    s.add_dependency(%q<hpricot>, [">= 0.6"])
+    s.add_dependency(%q<activesupport>, [">= 2.1"])
+    s.add_dependency(%q<main>, [">= 2.8.2"])
+    s.add_dependency(%q<highline>, [">= 1.4.0"])
+    s.add_dependency(%q<activerecord>, [">= 2.1"])
+    s.add_dependency(%q<httparty>, [">= 0.1.0"])
+  end
+end

data/website/css/common.css

@@ -0,0 +1,47 @@
+@media screen, projection {
+	/*
+	Copyright (c) 2007, Yahoo! Inc. All rights reserved.
+	Code licensed under the BSD License:
+	http://developer.yahoo.net/yui/license.txt
+	version: 2.2.0
+	*/
+	body {font:13px arial,helvetica,clean,sans-serif;*font-size:small;*font:x-small;}table {font-size:inherit;font:100%;}select, input, textarea {font:99% arial,helvetica,clean,sans-serif;}pre, code {font:115% monospace;*font-size:100%;}body * {line-height:1.22em;}
+	body,div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,form,fieldset,input,textarea,p,blockquote,th,td{margin:0;padding:0;}table{border-collapse:collapse;border-spacing:0;}fieldset,img{border:0;}address,caption,cite,code,dfn,em,strong,th,var{font-style:normal;font-weight:normal;}/*ol,ul {list-style:none;}*/caption,th {text-align:left;}h1,h2,h3,h4,h5,h6{font-size:100%;font-weight:normal;}q:before,q:after{content:'';}abbr,acronym {border:0;}
+	/* end of yahoo reset and fonts */
+	
+	body 										{color:#333; background:#4b1a1a; line-height:1.3;}
+	p												{margin:0 0 20px;}
+	a												{color:#4b1a1a;}
+	a:hover									{text-decoration:none;}
+	strong									{font-weight:bold;}
+	em											{font-style:italics;}
+	h1,h2,h3,h4,h5,h6				{font-weight:bold;}
+	h1											{font-size:197%; margin:30px 0; color:#4b1a1a;}
+	h2											{font-size:174%; margin:20px 0; color:#b8111a;}
+	h3											{font-size:152%; margin:10px 0;}
+	h4											{font-size:129%; margin:10px 0;}
+	pre 										{background:#eee; margin:0 0 20px; padding:20px; border:1px solid #ccc; font-size:100%; overflow:auto;}
+	code										{font-size:100%; margin:0; padding:0;}
+	ul, ol									{margin:10px 0 10px 25px;}
+	ol li										{margin:0 0 10px;}
+
+
+
+
+
+	div#wrapper 							{background:#fff; width:560px; margin:0 auto; padding:20px; border:10px solid #bc8c46; border-width:0 10px;}
+	div#header								{position:relative; border-bottom:1px dotted; margin:0 0 10px; padding:0 0 10px;}
+	div#header p							{margin:0; padding:0;}
+	div#header h1							{margin:0; padding:0;}
+	ul#nav										{position:absolute; top:0; right:0; list-style:none; margin:0; padding:0;}
+	ul#nav li									{display:inline; padding:0 0 0 5px;}
+	ul#nav li a								{}
+	div#content								{}
+	div#footer								{margin:40px 0 0; border-top:1px dotted; padding:10px 0 0;}
+
+
+
+
+
+
+}

data/website/index.html

@@ -0,0 +1,156 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 
+<head> 
+	<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> 
+	<title>Ruby Twitter Gem by John Nunemaker</title> 
+	<link rel="stylesheet" href="css/common.css" type="text/css" /> 
+</head> 
+<body> 
+ 
+<div id="wrapper"> 
+	<div id="header"> 
+		<h1>Twitter</h1> 
+		<p>command line tweets and an api wrapper</p> 
+		
+		<ul id="nav">
+			<li><a href="rdoc/">Docs</a></li> 
+			<li><a href="http://github.com/jnunemaker/twitter">Github</a></li>
+			<li><a href="http://jnunemaker.lighthouseapp.com/projects/14843-twitter-gem/overview">Lighthouse</a></li>
+			<li><a href="http://rubyforge.org/projects/twitter/">Rubyforge</a></li> 
+		</ul> 
+	</div> 
+	
+	<div id="content"> 
+		<h2>Install</h2> 
+		<pre><code>$ sudo gem install twitter</code></pre> 
+		<p><small>note: the twitter gem now works with hpricot 0.5+</small></p> 
+		
+		<h2>API Wrapping</h2> 
+		<p>I do my best to keep it easy to use. Below are some code samples showing a few of the methods.</p> 
+		
+		<pre><code>twit = twit
+twit.update('watching veronica mars')
+ 
+puts "Public Timeline", "=" * 50
+twit.timeline(:public).each do |s|
+  puts s.text, s.user.name
+  puts
+end
+ 
+puts '', "Friends Timeline", "=" * 50
+twit.timeline(:friends).each do |s|
+  puts s.text, s.user.name
+  puts
+end
+ 
+puts '', "You and Your Friends Timeline", "=" * 50
+twit.timeline(:user).each do |s|
+  puts s.text, s.user.name
+  puts
+end
+ 
+puts '', "Your Friends", "=" * 50
+twit.friends.each do |u|
+  puts u.name, u.status.text
+  puts
+end
+ 
+puts '', "jnunemaker's Friends", "=" * 50
+twit.friends_for('jnunemaker').each do |u|
+  puts u.name
+  puts
+end
+ 
+puts '', "Your Followers", "=" * 50
+twit.followers.each do |u|
+  puts u.name
+  puts
+end
+		</code></pre>
+		
+		<h2>Search API Examples</h2>
+		
+<pre><code>#searches all tweets for httparty
+Twitter::Search.new('httparty').each { |r| puts r.inspect }
+
+# searches all of jnunemaker's tweets for httparty
+Twitter::Search.new('httparty').from('jnunemaker').each { |r| puts r.inspect }
+
+# searches all tweets from jnunemaker to oaknd1
+Twitter::Search.new.from('jnunemaker').to('oaknd1').each { |r| puts r.inspect }
+
+# you can also use fetch to actually just get the parsed response
+Twitter::Search.new.from('jnunemaker').to('oaknd1').fetch()
+</code></pre>
+		
+		<h2>Command Line</h2>
+		
+		<p><img src="images/terminal_output.png" alt="Terminal Output" style="width:560px;" /></p>
+		
+		<p><strong>Note: If you want to use twitter from the command line be sure that sqlite3 and the sqlite3-ruby gem are installed.</strong> 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.</p>
+		
+	<p>The first thing you'll want to do is install the database so your account(s) can be stored.</p> 
+
+		<pre><code>$ twitter install</code></pre>
+
+	<p>You can always uninstall twitter like this:</p>
+
+		<pre><code>$ twitter uninstall</code></pre>
+
+	<p>Once the twitter database is installed and migrated, you can add accounts like this:</p>
+
+		<pre><code>$ twitter add
+Add New Account:
+Username: jnunemaker
+Password (won't be displayed): 
+Account added.</code></pre>
+
+	<p>You can also list all the accounts you've added.</p>
+
+		<pre><code>$ twitter list
+Account List
+* jnunemaker
+  snitch_test</code></pre>
+
+	<p>The * means denotes the account that will be used when posting, befriending, defriending, following, leaving or viewing a timeline.</p>
+
+	<p>To post using the account marked with the *, simply type the following:</p>
+
+		<pre><code>$ twitter post "releasing my new twitter gem"</code></pre>
+
+	<p>That is about it. You can do pretty much anything that you can do with twitter from the command line interface.</p>
+		
+		<pre><code>$ twitter</code></pre>
+
+		<p>Will give you a list of all the commands. You can get the help for each command by running twitter [command] -h. </p>
+		
+		
+		<h2>Support</h2> 
+		<p>Conversations welcome in the <a href="http://groups.google.com/group/ruby-twitter-gem">google group</a> and bugs/features over at <a href="http://jnunemaker.lighthouseapp.com/projects/14843-twitter-gem/overview">lighthouse</a></p>
+		
+		<h2>Uses</h2> 
+		<ul> 
+			<li><a href="http://snitch.rubyforge.org">Snitch</a></li> 
+			<li><a href="http://al3x.net/entries/766">Growl + Twitter</a></li> 
+			<li><a href="http://snippets.dzone.com/posts/show/3714">Twitter Woot Bot</a> (<a href="http://soylentfoo.jnewland.com/articles/2007/03/22/woot-twitter-bot-now-official">more here</a>)</li> 
+			<li><a href="http://soylentfoo.jnewland.com/articles/2007/01/22/tweet-update-twitter-via-quicksilver">Tweet Quicksilver Action</a></li> 
+			<li><a href="http://blog.evanweaver.com/articles/2007/02/09/log-system-security-events-to-twitter">logging security events to twitter</a></li> 
+			<li><a href="http://shareomatic.com/">Shareomatic</a> is using it for their <a href="http://twitter.com/shareomatic">twitter account</a></li> 
+		</ul> 
+		
+		<p>Using the twitter gem for something, <a href="mailto:nunemaker@gmail.com">let me know</a> and I'll add you above.</p> 
+	</div> 
+ 
+	<div id="footer"> 
+		<p>Created by <a href="http://addictedtonew.com/about/">John Nunemaker</a></p> 
+	</div> 
+</div> 
+ 
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> 
+<script type="text/javascript">_uacct = "UA-85301-9"; urchinTracker();</script> 
+ 
+<!-- 103bees.com 'bee' code v1.11 - please do not make any changes! --> 
+<script type="text/javascript" src="http://103bees.com/bees/?bee=3672&amp;fid=5643"></script> 
+<!-- 103bees.com 'bee' code --> 
+</body> 
+</html>

metadata

@@ -0,0 +1,181 @@
+--- !ruby/object:Gem::Specification 
+name: pjdavis-twitter
+version: !ruby/object:Gem::Version 
+  version: 0.3.8
+platform: ruby
+authors: 
+- John Nunemaker
+- PJ Davis
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-08-26 00:00:00 -07:00
+default_executable: twitter
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hpricot
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0.6"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "2.1"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: main
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.8.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: highline
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.4.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "2.1"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.1.0
+    version: 
+description: a command line interface for twitter, also a library which wraps the twitter api
+email: nunemaker@gmail.com
+executables: 
+- twitter
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- License.txt
+- Manifest.txt
+- README.txt
+files: 
+- 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
+has_rdoc: true
+homepage: http://twitter.rubyforge.org
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+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: twitter
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: a command line interface for twitter, also a library which wraps the twitter api
+test_files: []
+