twail 0.0.1

data/MIT-LICENSE.txt

@@ -0,0 +1,21 @@
+Copyright (c) 2010 Daniel Choi, http://danielchoi.com/software/
+
+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.markdown

@@ -0,0 +1,50 @@
+# twail
+
+`twail` is inspired by the venerable Unix `tail` program.  `twail` tails
+your Twitter timelines.  
+
+Before using twail, you must first get a Twitter API key and authorize the twurl
+command to access your Twitter account. Type 
+
+  twurl -T
+
+for instructions.
+
+Assuming you've done that, read on.
+
+Usage: twail [timeline]
+
+[timeline] can be any of these:
+
+    public 
+    home 
+    friends 
+    user 
+    mentions 
+    retweeted_by_me 
+    retweeted_to_me 
+    retweets_of_me
+
+"home" is the default.
+
+You can use these abbreviations: 
+
+    p h f u m by to of
+
+
+`twail` works like `tail -f`.  It will print tweets out as they appear
+in the specified timeline.  You can redirect the output however you
+want.  One pipeline I like to use is
+
+    twail home | tee -a twitter.home.log
+
+Lots of other pipelines are possible.  Knock yourself out.
+
+`twail` was created by Daniel Choi.  It's really just a convenience
+wrapper around the awesome [twurl][twurl] program.
+
+[twurl]:https://github.com/marcel/twurl
+
+You can follow me on Twitter at <http://twitter.com/danchoi>.
+
+

data/Rakefile

@@ -0,0 +1,7 @@
+require 'rake'
+require 'rake/testtask'
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), 'lib')
+

data/bin/twail

@@ -0,0 +1,2 @@
+require 'twail'
+

data/lib/twail.rb

@@ -0,0 +1,119 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+require 'json'
+require 'yaml'
+require 'twurl'
+
+TIMELINES = %w( public home friends user)
+SPECIAL = %w(mentions retweeted_by_me retweeted_to_me retweets_of_me)
+
+if %w(-h --help).include?(ARGV.first)
+  puts <<END
+
+Before using twail, you must first get a Twitter API key and authorize the twurl
+command to access your Twitter account. Type 
+
+    twurl -T
+
+for instructions.
+
+Assuming you've done that, read on.
+
+Usage: twail [timeline]
+
+[timeline] can be any of these:
+
+    public 
+    home 
+    friends 
+    user 
+    mentions 
+    retweeted_by_me 
+    retweeted_to_me 
+    retweets_of_me
+
+"home" is the default.
+
+You can use these abbreviations: 
+
+    p h f u m by to of
+
+END
+  exit
+end
+
+class String
+  def wrap(len=65)
+    gsub(/\n/, " ").gsub(/.{1,#{len}}(?:\s|\Z)/){$&+"\n"}
+  end
+end
+
+timeline = if ARGV.first 
+             (TIMELINES + SPECIAL).detect {|t| 
+               t =~ /^#{ARGV.first}/ || ((t =~ /_/) && (t.split('_')[1]  =~ /^#{ARGV.first}/)) 
+             } 
+           else
+             'home'
+           end
+puts "Logging #{timeline} timeline at #{Time.now}"
+url = case timeline
+      when 'retweets_of_me'
+        # This doesn't seem to do anything different; figure out later
+        "/1/statuses/#{timeline}.json?include_entities=true"
+      when *SPECIAL
+        "/1/statuses/#{timeline}.json"
+      else 
+        "/1/statuses/#{timeline}_timeline.json"
+      end
+
+trap("INT") { 
+  xs = ['Goodbye.', 'Farewell.', 'Have a nice day.', 
+    'Now go enjoy the weather!', 'Live long and prosper.', 
+    'May the force be with you.']
+  $stderr.puts xs[rand(xs.size)]
+  exit
+}
+
+seen = []
+network = true
+
+loop do 
+  raw = begin 
+          Twurl::CLI.output = StringIO.new
+          Twurl::CLI.run([url]) 
+          if network == false
+            network = true
+            $stderr.print(" The network is back up!\n")
+          end
+          Twurl::CLI.output.read
+          Twurl::CLI.output.rewind
+          Twurl::CLI.output.read
+        rescue SocketError 
+          if network
+            $stderr.print("The network seems to be down.") 
+          else
+            $stderr.print('.')
+          end
+          network = false
+          sleep 20
+          next 
+        end
+  res = JSON.parse(raw).reverse
+  res.each do |x|
+    next if seen.include?(x['id'])
+    seen << x['id']
+    text = x['text'].gsub(/\n/, ' ')
+    user_width = 18
+    from = x['user']['screen_name'][0,user_width]
+    total_width = `tput cols`.to_i
+    text_width = (total_width - user_width) - 3
+    textlines = text.wrap(text_width).split(/\n/)
+
+    puts("%s| %s" % [from.rjust(user_width), textlines.shift])
+    textlines.each do |line|
+      puts("%s| %s" % [''.rjust(user_width), line])
+    end
+  end
+  sleep 30
+end
+

data/notes.txt

@@ -0,0 +1,9 @@
+------------------------------------------------------------------------
+Thu Apr 21 10:15:57 EDT 2011
+
+Basic functionality done.
+
+Write up a README and then and deploy rubygem.
+
+
+

data/twail.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+Gem::Specification.new do |s|
+  s.name        = "twail"
+  s.version     = '0.0.1'
+  s.platform    = Gem::Platform::RUBY
+  s.required_ruby_version = '>= 1.9.0'
+
+  s.authors     = ["Daniel Choi"]
+  s.email       = ["dhchoi@gmail.com"]
+  s.homepage    = "http://danielchoi.com/software/twail.html"
+  s.summary     = %q{tail your Twitter timeslines}
+  s.description = %q{tail your Twitter timeslines}
+
+  s.rubyforge_project = "twail"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'twurl', '>= 0.6.3' 
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification 
+name: twail
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Daniel Choi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-21 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: twurl
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.6.3
+  type: :runtime
+  version_requirements: *id001
+description: tail your Twitter timeslines
+email: 
+- dhchoi@gmail.com
+executables: 
+- twail
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- MIT-LICENSE.txt
+- README.markdown
+- Rakefile
+- bin/twail
+- lib/twail.rb
+- notes.txt
+- twail.gemspec
+has_rdoc: true
+homepage: http://danielchoi.com/software/twail.html
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.9.0
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: twail
+rubygems_version: 1.6.1
+signing_key: 
+specification_version: 3
+summary: tail your Twitter timeslines
+test_files: []
+