twail 0.0.3 → 0.0.4

data/.gitignore

@@ -0,0 +1,2 @@
+pkg/
+*.log

data/README.markdown

@@ -1,13 +1,15 @@
 # twail
 
 `twail` is inspired by the venerable Unix `tail` program.  `twail` lets
-you tail your Twitter timelines.  
+you tail your Twitter timelines, or run a twitter search.  
 
-# Installation
+![screenshot](https://github.com/danchoi/twail/raw/master/screenshot.png)
+
+## Installation
 
     gem install twail
 
-# Setup
+## Setup
 
 Before using twail, you must first get a Twitter API key and authorize
 the `twurl` command (note that this is a different command from `twail`)
@@ -17,12 +19,17 @@ to access your Twitter account. Type
 
 for instructions.
 
-
-# Usage
+## Usage
 
     twail [timeline]
 
-The output looks like this:
+    or 
+
+    twail s [search args]
+
+## Tailing your timelines 
+
+The timeline output looks like this:
 
     $ twail home
     Logging home timeline at 2011-04-21 11:21:36 -0400
@@ -77,9 +84,8 @@ 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
+In timeline mode, `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
@@ -87,6 +93,53 @@ want.  One pipeline I like to use is
 Lots of other pipelines are possible.  Knock yourself out.  To stop
 `twail`, press `CTRL-C`.
 
+
+## Search for tweets
+
+You can run a Twitter search with `twail s [search args]`.
+
+Search arguments are simply the words you want to submit as your Twitter search
+query.
+
+`twail` will print each of search results as it fetches them and keep going
+backward in time until the results are exhausted.
+
+The output of `twail` in search mode looks like this:
+
+    $ twail s vitunes itunes
+    2011-08-02 20:38:03 |      garry_stewart | Via @otaku_jstewart: http://bit.ly/rgfaKw <-- ViTunes: Controlling iTunes from vi/vim
+    2011-08-02 20:16:29 |              xshay | RT @notahat: If you feel that you don't have enough nerd cred, try driving iTunes from Vim: http://t.co/hFkolMZ
+    2011-08-02 20:00:08 |           rubygems | vitunes (0.4.6): http://is.gd/1JmVwn Control iTunes with Vim
+    2011-08-02 19:54:08 |          priyaaank | iTune from vi! Every vi lover's dream. :) http://danielchoi.com/software/vitunes.html
+    2011-08-02 19:50:02 |               k_ui | Vim で動く iTunes クローンらしい > ViTunes http://bit.ly/o9FGap
+    2011-08-02 19:47:50 |         hongymagic | RT @jadzor: ViTunes. Yeah, that's right. http://t.co/ZZkIk2T
+    2011-08-02 19:34:33 |       lindsayevans | RT @jadzor: ViTunes. Yeah, that's right. http://t.co/ZZkIk2T
+    2011-08-02 19:31:22 |             jadzor | ViTunes. Yeah, that's right. http://t.co/ZZkIk2T
+    2011-08-02 19:25:13 |          david2777 | Hahaha ViTunes http://t.co/xaGEOli
+    2011-08-02 19:11:51 |            notahat | If you feel that you don't have enough nerd cred, try driving iTunes from Vim: http://t.co/hFkolMZ
+    2011-08-02 18:58:38 |            rnewman | RT @boingr: controlling iTunes in vim with http://danielchoi.com/software/vitunes.html
+    2011-08-02 18:56:30 |           benbelly | For you @edgauthier RT @newsycombinator ViTunes http://j.mp/lSDlBt
+    2011-08-02 18:50:18 |         pelayo1974 | Applesfera - ViTunes, controla iTunes desde el Terminal http://www.applesfera.com/curiosidades/vitunes-controla-itunes-desde-el-terminal
+    2011-08-02 18:43:28 |              frigo | RT @msutherl: omg awesome, ViTunes: control iTunes from Vim: http://t.co/iheGoIA
+    2011-08-02 18:39:10 |         SinnerBOFH | #BOFHers #vim RT @tatai: Igual empiezo a usar iTunes entonces ;) RT @elorz007: @tatai Interfaz de iTunes para vi http://bit.ly/ope5Q7
+    2011-08-02 18:19:00 |            bgarber | RT @otaviocc: VIM + iTunes = ViTunes http://j.mp/lSDlBt
+    2011-08-02 18:17:51 |             geyson | RT @otaviocc: VIM + iTunes = ViTunes http://j.mp/lSDlBt
+    2011-08-02 18:04:30 |             apoena | "@otaviocc: VIM + iTunes = ViTunes http://t.co/CBkWJ6t" isso é oldschool.vou testar hoje.hehe
+    2011-08-02 17:47:13 |           otaviocc | VIM + iTunes = ViTunes http://j.mp/lSDlBt
+    2011-08-02 17:44:35 |           spdalton | @danchoi vitunes is amazing. Thank you!
+    2011-08-02 17:41:21 |         felipebrnd | +1 membro! @taverneiro Wow! RT @newsycombinator ViTunes http://t.co/zeqqMx0
+    2011-08-02 17:39:59 |               3kwa | @knotty can you control iTunes from XCode? http://bit.ly/kdRLNG :D
+    2011-08-02 17:38:54 |           spdalton | This is why I use Vim. (via http://t.co/sbqWJ8c) http://t.co/WgH6DGT
+    2011-08-02 17:29:43 |            ggarron | vitunes http://t.co/dqC1sdq #mac
+    etc.
+
+
+## About
+
+If you like `twail` and you're a Vim user, try [twim][twim].
+
+[twim]:https://github.com/danchoi/twim
+
 `twail` was created by Daniel Choi.  It's really just a convenience
 wrapper around the awesome [twurl][twurl] program.
 

data/lib/twail.rb

@@ -3,6 +3,7 @@
 require 'json'
 require 'yaml'
 require 'twurl'
+require 'time'
 
 TIMELINES = %w( public home friends user)
 SPECIAL = %w(mentions retweeted_by_me retweeted_to_me retweets_of_me)
@@ -52,6 +53,26 @@ class String
   end
 end
 
+
+# search is different
+if ARGV.first =~ /^s/ # search
+
+  query = "?q=#{ARGV[1..-1].join(' ')}"
+
+  while query 
+    url = "http://search.twitter.com/search.json#{query}"
+    json = `curl -s '#{url}'`
+    res = JSON.parse(json)
+    res['results'].each do |x|
+      time = Time.parse(x['created_at']).localtime
+      puts "%s | %s | %s" % [time.to_s.gsub(/\s\S+$/,''), x['from_user'].rjust(18), x['text'].gsub(/\n/, ' ')]
+    end
+    query = res['next_page']
+  end
+  exit 
+end
+
+# timeline tail
 timeline = if ARGV.first 
              (TIMELINES + SPECIAL).detect {|t| 
                t =~ /^#{ARGV.first}/ || ((t =~ /_/) && (t.split('_')[1]  =~ /^#{ARGV.first}/)) 
@@ -70,6 +91,7 @@ url = case timeline
         "/1/statuses/#{timeline}_timeline.json"
       end
 
+
 trap("INT") { 
   xs = ['Goodbye.', 'Farewell.', 'Have a nice day.', 
     'Now go enjoy the weather!', 'Live long and prosper.', 

data/lib/twail_debug.rb

@@ -0,0 +1,67 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+require 'json'
+require 'yaml'
+require 'twurl'
+require 'pp'
+
+TIMELINES = %w( public home friends user)
+SPECIAL = %w(mentions retweeted_by_me retweeted_to_me retweets_of_me)
+
+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
+
+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
+      end
+res = JSON.parse(raw).reverse
+pp res
+
+

data/twail.gemspec

@@ -2,7 +2,7 @@
 $:.push File.expand_path("../lib", __FILE__)
 Gem::Specification.new do |s|
   s.name        = "twail"
-  s.version     = '0.0.3'
+  s.version     = '0.0.4'
   s.platform    = Gem::Platform::RUBY
   s.required_ruby_version = '>= 1.9.0'
 

metadata

@@ -2,7 +2,7 @@
 name: twail
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors: 
 - Daniel Choi
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-04-21 00:00:00 -04:00
+date: 2011-08-02 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -34,12 +34,15 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
+- .gitignore
 - MIT-LICENSE.txt
 - README.markdown
 - Rakefile
 - bin/twail
 - lib/twail.rb
+- lib/twail_debug.rb
 - notes.txt
+- screenshot.png
 - twail.gemspec
 has_rdoc: true
 homepage: https://github.com/danchoi/twail