tweettail 1.0.0

data/History.txt

@@ -0,0 +1,4 @@
+== 1.0.0 2009-05-06
+
+* 1 major enhancement:
+  * Initial release

data/Manifest.txt

@@ -0,0 +1,32 @@
+History.txt
+Manifest.txt
+PostInstall.txt
+README.rdoc
+Rakefile
+bin/tweet-tail
+bin/tweet_tail
+bin/tweettail
+features/cli.feature
+features/development.feature
+features/fixtures/search-jaoo-since-1682666650.json
+features/fixtures/search-jaoo.json
+features/fixtures/search-jaoo.short.json
+features/step_definitions/common_steps.rb
+features/step_definitions/executable_steps.rb
+features/step_definitions/logger_steps.rb
+features/step_definitions/twitter_data_steps.rb
+features/support/common.rb
+features/support/env.rb
+features/support/logger.rb
+features/support/matchers.rb
+features/support/mocha.rb
+features/support/time_machine_helpers.rb
+lib/tweet-tail.rb
+lib/tweet-tail/cli.rb
+lib/tweet-tail/tweet_poller.rb
+script/console
+script/destroy
+script/generate
+test/test_helper.rb
+test/test_tweet-tail_cli.rb
+test/test_tweet_poller.rb

data/PostInstall.txt

@@ -0,0 +1,7 @@
+
+For more information on tweet-tail, see http://tweet-tail.rubyforge.org
+
+NOTE: Change this information in PostInstall.txt 
+You can also delete it if you don't want it.
+
+

data/README.rdoc

@@ -0,0 +1,55 @@
+= tweet-tail
+
+* http://github.com/drnic/tweet-tail
+
+== DESCRIPTION:
+
+Get the latest search results streaming to your console:
+
+    $ tweet-tail railsconf
+    rubysolo: protip: it helps to actually READ the error message.  #railsconf
+    voxxit: So, everyone, how is #railsconf coming? When is the big 3.0 announcement?
+    JesseGoldberg: @GavinStark I don't have as much to chat about as you do while you are at RailsConf.
+    wndxlori: Anyone else not eaten yet #railsconf
+    zenmatt: Great dinner and coversation with @heroku at n9ne in the palms. #railsconf
+    Adkron: Damn you #railsconf why can I not visit you this year.  I'm missing all the gitjour goodness.
+    pengwynn: Meeting a lot of great folks at the open gov hackathon at #railsconf #gov20
+    davidjrice: Enjoying ordering taxis to our hotel... "for the wynn!" #railsconf quick noms at stripburger then whiskeys at the stage door with ey ftw!
+    cricketgeek: as pointed out by @jnewland at sushi this evening... http://pic.im/2LY  #railsconf
+    paulog: had fun at gilt groupe coctail party.  props. #railsconf
+    Amuse_Bouche: I hope my two favorite people in the world form an alliance! (Swoon) RT: @dhh Loved talking to @tferris at #railsconf. So much resonates.
+    abie: At open gov BOF #railsconf
+    matthewcarriere: running a saas bof was great... I hope it gets some more time this week. #railsconf
+    jdar: @tullytully RT @dgou:for the benefit of people at #railsconf keynote, here is penelope trunk on tim ferris: http://bit.ly/b81E
+    yorzi: Reading: "Rails 3 and the Real Secret to High Productivity: RailsConf 2009 - May 04 - 07, 2009, Las Vegas,NV" ( http://tinyurl.com/czmkxn )
+
+Or let it sit there all day with the `-f` option (as like `tail -f`)
+
+== INSTALL:
+
+* sudo gem install tweet-tail
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 Dr Nic Williams
+
+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/Rakefile

@@ -0,0 +1,25 @@
+require 'rubygems' unless ENV['NO_RUBYGEMS']
+%w[rake rake/clean fileutils newgem rubigen].each { |f| require f }
+require File.dirname(__FILE__) + '/lib/tweet-tail'
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new('tweettail', TweetTail::VERSION) do |p|
+  p.developer('Dr Nic', 'drnicwilliams@gmail.com')
+  p.changes        = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.rubyforge_name = 'drnicutilities'
+  p.extra_dev_deps = [
+    ['newgem', ">= #{::Newgem::VERSION}"]
+  ]
+  
+  p.clean_globs |= %w[**/.DS_Store tmp *.log]
+  path = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
+  p.remote_rdoc_dir = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')
+  p.rsync_args = '-av --delete --ignore-errors'
+end
+
+require 'newgem/tasks' # load /tasks/*.rake
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+# task :default => [:spec, :features]

data/bin/tweet-tail

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+#
+#  Created on 2009-5-1 by Dr Nic Williams
+#  Copyright (c) 2009. All rights reserved.
+
+require 'rubygems'
+require File.expand_path(File.dirname(__FILE__) + "/../lib/tweet-tail")
+require "tweet-tail/cli"
+
+TweetTail::CLI.execute(STDOUT, ARGV)

data/bin/tweet_tail

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+#
+#  Created on 2009-5-1 by Dr Nic Williams
+#  Copyright (c) 2009. All rights reserved.
+
+require 'rubygems'
+require File.expand_path(File.dirname(__FILE__) + "/../lib/tweet-tail")
+require "tweet-tail/cli"
+
+TweetTail::CLI.execute(STDOUT, ARGV)

data/bin/tweettail

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+#
+#  Created on 2009-5-1 by Dr Nic Williams
+#  Copyright (c) 2009. All rights reserved.
+
+require 'rubygems'
+require File.expand_path(File.dirname(__FILE__) + "/../lib/tweet-tail")
+require "tweet-tail/cli"
+
+TweetTail::CLI.execute(STDOUT, ARGV)

data/features/cli.feature

@@ -0,0 +1,39 @@
+Feature: Live twitter search results on command line
+  In order to reduce cost of getting live search results
+  As a twitter user
+  I want twitter search results appearing in the console
+
+  Scenario: Display some search results
+    Given twitter has some search results for "jaoo"
+    When I run local executable "tweet-tail" with arguments "jaoo"
+    Then I should see some twitter messages
+  
+  Scenario: Display explicit search results
+    Given twitter has some search results for "jaoo"
+    When I run executable internally with arguments "jaoo"
+    Then I should see
+      """
+      mattnhodges: Come speak with me at JAOO next week - http://jaoo.dk/
+      Steve_Hayes: @VenessaP I think they went out for noodles. #jaoo
+      theRMK: Come speak with Matt at JAOO next week
+      drnic: reading my own abstract for JAOO presentation
+      """
+  
+  Scenario: Poll for results until app cancelled
+    Given twitter has some search results for "jaoo"
+    When I run executable internally with arguments "jaoo -f" and wait 1 sleep cycle and quit
+    Then I should see
+      """
+      mattnhodges: Come speak with me at JAOO next week - http://jaoo.dk/
+      Steve_Hayes: @VenessaP I think they went out for noodles. #jaoo
+      theRMK: Come speak with Matt at JAOO next week
+      drnic: reading my own abstract for JAOO presentation
+      CaioProiete: Wish I could be at #JAOO Australia...
+      """
+  
+  Scenario: Show help if no search query passed
+    When I run local executable "tweet-tail" with arguments ""
+    Then I should see help option "-f"
+  
+  
+  

data/features/development.feature

@@ -0,0 +1,13 @@
+Feature: Development processes of newgem itself (rake tasks)
+
+  As a Newgem maintainer or contributor
+  I want rake tasks to maintain and release the gem
+  So that I can spend time on the tests and code, and not excessive time on maintenance processes
+    
+  Scenario: Generate RubyGem
+    Given this project is active project folder
+    And "pkg" folder is deleted
+    When I invoke task "rake gem"
+    Then folder "pkg" is created
+    And file with name matching "pkg/*.gem" is created else you should run "rake manifest" to fix this
+    And gem spec key "rdoc_options" contains /--mainREADME.rdoc/

data/features/fixtures/search-jaoo-since-1682666650.json

@@ -0,0 +1,22 @@
+{
+    "results": [{
+        "text": "Wish I could be at #JAOO Australia...",
+        "to_user_id": null,
+        "from_user": "CaioProiete",
+        "id": 1711269079,
+        "from_user_id": 4936114,
+        "iso_language_code": "en",
+        "source": "<a href="http:\/\/www.twhirl.org\/">twhirl<\/a>",
+        "profile_image_url": "http:\/\/s3.amazonaws.com\/twitter_production\/profile_images\/48685982\/image_normal.jpg",
+        "created_at": "Tue, 05 May 2009 23:33:52 +0000"
+    }],
+    "since_id": 1682666650,
+    "max_id": 1711269079,
+    "refresh_url": "?since_id=1711269079&q=jaoo",
+    "results_per_page": 15,
+    "next_page": "?page=2&max_id=1711269079&q=jaoo",
+    "warning": "since_id removed for pagination.",
+    "completed_in": 0.017173,
+    "page": 1,
+    "query": "jaoo"
+}

data/features/fixtures/search-jaoo.json

@@ -0,0 +1,56 @@
+{
+    "results": [
+    {
+        "text": "reading my own abstract for JAOO presentation",
+        "to_user_id": null,
+        "from_user": "drnic",
+        "id": 1666627310,
+        "from_user_id": 5075,
+        "iso_language_code": "en",
+        "source": "<a href="http:\/\/iconfactory.com\/software\/twitterrific">twitterrific<\/a>",
+        "profile_image_url": "http:\/\/s3.amazonaws.com\/twitter_production\/profile_images\/55631479\/Photo_24_normal.jpg",
+        "created_at": "Fri, 01 May 2009 04:45:42 +0000"
+    },
+    {
+        "text": "Come speak with Matt at JAOO next week",
+        "to_user_id": null,
+        "from_user": "theRMK",
+        "id": 1666334207,
+        "from_user_id": 8783115,
+        "iso_language_code": "en",
+        "source": "<a href="http:\/\/83degrees.com\/to\/powertwitter">Power Twitter<\/a>",
+        "profile_image_url": "http:\/\/s3.amazonaws.com\/twitter_production\/profile_images\/110356397\/rmk_manga2_normal.jpg",
+        "created_at": "Fri, 01 May 2009 04:01:38 +0000"
+    },
+    {
+        "text": "@VenessaP I think they went out for noodles. #jaoo",
+        "to_user_id": 102294,
+        "to_user": "VenessaP",
+        "from_user": "Steve_Hayes",
+        "id": 1666166639,
+        "from_user_id": 3169244,
+        "iso_language_code": "en",
+        "source": "<a href="http:\/\/www.atebits.com\/">Tweetie<\/a>",
+        "profile_image_url": "http:\/\/s3.amazonaws.com\/twitter_production\/profile_images\/68791310\/Steve_Hayes_Thumbnail_normal.jpg",
+        "created_at": "Fri, 01 May 2009 03:38:48 +0000"
+    },
+    {
+        "text": "Come speak with me at JAOO next week - http:\/\/jaoo.dk\/",
+        "to_user_id": null,
+        "from_user": "mattnhodges",
+        "id": 1664823944,
+        "from_user_id": 503163,
+        "iso_language_code": "en",
+        "source": "<a href="http:\/\/desktop.seesmic.com\/">Seesmic Desktop<\/a>",
+        "profile_image_url": "http:\/\/s3.amazonaws.com\/twitter_production\/profile_images\/86466627\/Picture_2_normal.png",
+        "created_at": "Fri, 01 May 2009 01:06:48 +0000"
+    }],
+    "since_id": 0,
+    "max_id": 1682666650,
+    "refresh_url": "?since_id=1682666650&q=jaoo",
+    "results_per_page": 15,
+    "next_page": "?page=2&max_id=1682666650&q=jaoo",
+    "completed_in": 0.03198,
+    "page": 1,
+    "query": "jaoo"
+}

data/features/fixtures/search-jaoo.short.json

@@ -0,0 +1,26 @@
+{
+    "results": [
+    {
+        "text": "reading my own abstract for JAOO presentation",
+        "from_user": "drnic",
+        "id": 1666627310
+    },
+    {
+        "text": "Come speak with Matt at JAOO next week",
+        "from_user": "theRMK",
+        "id": 1666334207
+    },
+    {
+        "text": "@VenessaP I think they went out for noodles. #jaoo",
+        "from_user": "Steve_Hayes",
+        "id": 1666166639
+    },
+    {
+        "text": "Come speak with me at JAOO next week - http:\/\/jaoo.dk\/",
+        "from_user": "mattnhodges",
+        "id": 1664823944,
+    }],
+    "refresh_url": "?since_id=1682666650&q=jaoo",
+    "results_per_page": 15,
+    "next_page": "?page=2&max_id=1682666650&q=jaoo"
+}

data/features/step_definitions/common_steps.rb

@@ -0,0 +1,162 @@
+Given /^this project is active project folder/ do
+  @active_project_folder = File.expand_path(File.dirname(__FILE__) + "/../..")
+end
+
+Given /^env variable \$([\w_]+) set to "(.*)"/ do |env_var, value|
+  ENV[env_var] = value
+end
+
+Given /"(.*)" folder is deleted/ do |folder|
+  in_project_folder { FileUtils.rm_rf folder }
+end
+
+When /^I invoke "(.*)" generator with arguments "(.*)"$/ do |generator, arguments|
+  @stdout = StringIO.new
+  in_project_folder do
+    if Object.const_defined?("APP_ROOT")
+      APP_ROOT.replace(FileUtils.pwd)
+    else 
+      APP_ROOT = FileUtils.pwd
+    end
+    run_generator(generator, arguments.split(' '), SOURCES, :stdout => @stdout)
+  end
+  File.open(File.join(@tmp_root, "generator.out"), "w") do |f|
+    @stdout.rewind
+    f << @stdout.read
+  end
+end
+
+When /^I run executable "(.*)" with arguments "(.*)"/ do |executable, arguments|
+  @stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
+  in_project_folder do
+    system "#{executable} #{arguments} > #{@stdout} 2> #{@stdout}"
+  end
+end
+
+When /^I run project executable "(.*)" with arguments "(.*)"/ do |executable, arguments|
+  @stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
+  in_project_folder do
+    system "ruby #{executable} #{arguments} > #{@stdout} 2> #{@stdout}"
+  end
+end
+
+When /^I run local executable "(.*)" with arguments "(.*)"/ do |executable, arguments|
+  @stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
+  executable = File.expand_path(File.join(File.dirname(__FILE__), "/../../bin", executable))
+  in_project_folder do
+    system "ruby #{executable} #{arguments} > #{@stdout} 2> #{@stdout}"
+  end
+end
+
+When /^I invoke task "rake (.*)"/ do |task|
+  @stdout = File.expand_path(File.join(@tmp_root, "tests.out"))
+  in_project_folder do
+    system "rake #{task} --trace > #{@stdout} 2> #{@stdout}"
+  end
+end
+
+Then /^folder "(.*)" (is|is not) created/ do |folder, is|
+  in_project_folder do
+    File.exists?(folder).should(is == 'is' ? be_true : be_false)
+  end
+end
+
+Then /^file "(.*)" (is|is not) created/ do |file, is|
+  in_project_folder do
+    File.exists?(file).should(is == 'is' ? be_true : be_false)
+  end
+end
+
+Then /^file with name matching "(.*)" is created/ do |pattern|
+  in_project_folder do
+    Dir[pattern].should_not be_empty
+  end
+end
+
+Then /^file "(.*)" contents (does|does not) match \/(.*)\// do |file, does, regex|
+  in_project_folder do
+    actual_output = File.read(file)
+    (does == 'does') ?
+      actual_output.should(match(/#{regex}/)) :
+      actual_output.should_not(match(/#{regex}/))
+  end
+end
+
+Then /gem file "(.*)" and generated file "(.*)" should be the same/ do |gem_file, project_file|
+  File.exists?(gem_file).should be_true
+  File.exists?(project_file).should be_true
+  gem_file_contents = File.read(File.dirname(__FILE__) + "/../../#{gem_file}")
+  project_file_contents = File.read(File.join(@active_project_folder, project_file))
+  project_file_contents.should == gem_file_contents
+end
+
+Then /^(does|does not) invoke generator "(.*)"$/ do |does_invoke, generator|
+  actual_output = File.read(@stdout)
+  does_invoke == "does" ?
+    actual_output.should(match(/dependency\s+#{generator}/)) :
+    actual_output.should_not(match(/dependency\s+#{generator}/))
+end
+
+Then /I should see help option "(.*)"/ do |opt|
+  actual_output = File.read(@stdout)
+  actual_output.should match(/#{opt}/)
+end
+
+Then /^I should see$/ do |text|
+  actual_output = File.read(@stdout)
+  actual_output.should contain(text)
+end
+
+Then /^I should not see$/ do |text|
+  actual_output = File.read(@stdout)
+  actual_output.should_not contain(text)
+end
+
+Then /^I should see exactly$/ do |text|
+  actual_output = File.read(@stdout)
+  actual_output.should == text
+end
+
+Then /^I should see all (\d+) tests pass/ do |expected_test_count|
+  expected = %r{^#{expected_test_count} tests, \d+ assertions, 0 failures, 0 errors}
+  actual_output = File.read(@stdout)
+  actual_output.should match(expected)
+end
+
+Then /^I should see all (\d+) examples pass/ do |expected_test_count|
+  expected = %r{^#{expected_test_count} examples?, 0 failures}
+  actual_output = File.read(@stdout)
+  actual_output.should match(expected)
+end
+
+Then /^yaml file "(.*)" contains (\{.*\})/ do |file, yaml|
+  in_project_folder do
+    yaml = eval yaml
+    YAML.load(File.read(file)).should == yaml
+  end
+end
+
+Then /^Rakefile can display tasks successfully/ do
+  @stdout = File.expand_path(File.join(@tmp_root, "rakefile.out"))
+  in_project_folder do
+    system "rake -T > #{@stdout} 2> #{@stdout}"
+  end
+  actual_output = File.read(@stdout)
+  actual_output.should match(/^rake\s+\w+\s+#\s.*/)
+end
+
+Then /^task "rake (.*)" is executed successfully/ do |task|
+  @stdout.should_not be_nil
+  actual_output = File.read(@stdout)
+  actual_output.should_not match(/^Don't know how to build task '#{task}'/)
+  actual_output.should_not match(/Error/i)
+end
+
+Then /^gem spec key "(.*)" contains \/(.*)\// do |key, regex|
+  in_project_folder do
+    gem_file = Dir["pkg/*.gem"].first
+    gem_spec = Gem::Specification.from_yaml(`gem spec #{gem_file}`)
+    spec_value = gem_spec.send(key.to_sym)
+    spec_value.to_s.should match(/#{regex}/)
+  end
+end

data/features/step_definitions/executable_steps.rb

@@ -0,0 +1,27 @@
+# a version of the bin/tweet-tail file
+When /^I run executable internally with arguments "([^\"]*)"$/ do |args|
+  require 'rubygems'
+  require File.dirname(__FILE__) + "/../../lib/tweet-tail"
+  require "tweet-tail/cli"
+  @stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
+  in_project_folder do
+    TweetTail::CLI.execute(@stdout_io = StringIO.new, args.split(" "))
+    @stdout_io.rewind
+    File.open(@stdout, "w") { |f| f << @stdout_io.read }
+  end
+end
+
+When /^I run executable internally with arguments "([^\"]*)" and wait (\d+) sleep cycles? and quit$/ do |args, cycles|
+  hijack_sleep(cycles.to_i)
+  When %Q{I run executable internally with arguments "#{args}"}
+end
+
+Then /^I should see some twitter messages$/ do
+  actual_output = File.read(@stdout)
+  # puts actual_output # UNCOMMENT this to see what the current live data looks like
+  lines = actual_output.split("\n")
+  lines.length.should_not == 0
+  lines.each do |line|
+    line.should =~ /^[\w_]+:\s.+$/
+  end
+end

data/features/step_definitions/logger_steps.rb

@@ -0,0 +1,3 @@
+When /^I dump stdout$/ do
+  dump(File.exists?(@stdout) ? File.read(@stdout) : @stdout)
+end

data/features/step_definitions/twitter_data_steps.rb

@@ -0,0 +1,12 @@
+Given /^twitter has some search results for "([^\"]*)"$/ do |query|
+  FakeWeb.register_uri(
+    :get,
+    "http://search.twitter.com/search.json?q=#{query}",
+    :file => File.expand_path(File.dirname(__FILE__) + "/../fixtures/search-#{query}.json"))
+  
+  since = "1682666650"
+  FakeWeb.register_uri(
+    :get,
+    "http://search.twitter.com/search.json?since_id=#{since}&q=#{query}",
+    :file => File.expand_path(File.dirname(__FILE__) + "/../fixtures/search-#{query}-since-#{since}.json"))
+end

data/features/support/common.rb

@@ -0,0 +1,29 @@
+module CommonHelpers
+  def in_tmp_folder(&block)
+    FileUtils.chdir(@tmp_root, &block)
+  end
+
+  def in_project_folder(&block)
+    project_folder = @active_project_folder || @tmp_root
+    FileUtils.chdir(project_folder, &block)
+  end
+
+  def in_home_folder(&block)
+    FileUtils.chdir(@home_path, &block)
+  end
+
+  def force_local_lib_override(project_name = @project_name)
+    rakefile = File.read(File.join(project_name, 'Rakefile'))
+    File.open(File.join(project_name, 'Rakefile'), "w+") do |f|
+      f << "$:.unshift('#{@lib_path}')\n"
+      f << rakefile
+    end
+  end
+
+  def setup_active_project_folder project_name
+    @active_project_folder = File.join(@tmp_root, project_name)
+    @project_name = project_name
+  end
+end
+
+World(CommonHelpers)

data/features/support/env.rb

@@ -0,0 +1,21 @@
+# require File.dirname(__FILE__) + "/../../lib/tweet-tail"
+
+gem 'cucumber'
+require 'cucumber'
+gem 'rspec'
+require 'spec'
+
+Before do
+  @tmp_root = File.dirname(__FILE__) + "/../../tmp"
+  @home_path = File.expand_path(File.join(@tmp_root, "home"))
+  FileUtils.rm_rf   @tmp_root
+  FileUtils.mkdir_p @home_path
+  ENV['HOME'] = @home_path
+end
+
+gem "fakeweb"
+require "fakeweb"
+
+Before do
+  FakeWeb.allow_net_connect = false
+end

data/features/support/logger.rb

@@ -0,0 +1,17 @@
+module LoggerHelper
+  def dump(contents)
+    in_tmp_folder do
+      File.open("dump_file.txt", "w") do |file|
+        file << contents
+      end
+      unless ENV['CUCUMBER_EDITOR']
+        puts contents
+      else
+        `#{ENV['CUCUMBER_EDITOR']} '#{File.expand_path filename}'`
+      end
+    end
+  end
+  
+end
+
+World(LoggerHelper)

data/features/support/matchers.rb

@@ -0,0 +1,11 @@
+module Matchers
+  def contain(expected)
+    simple_matcher("contain #{expected.inspect}") do |given, matcher|
+      matcher.failure_message = "expected #{given.inspect} to contain #{expected.inspect}"
+      matcher.negative_failure_message = "expected #{given.inspect} not to contain #{expected.inspect}"
+      given.index expected
+    end
+  end
+end
+
+World(Matchers)

data/features/support/mocha.rb

@@ -0,0 +1,15 @@
+require "mocha"
+ 
+World(Mocha::Standalone)
+ 
+Before do
+  mocha_setup
+end
+ 
+After do
+  begin
+    mocha_verify
+  ensure
+    mocha_teardown
+  end
+end

data/features/support/time_machine_helpers.rb

@@ -0,0 +1,9 @@
+module TimeMachineHelper
+  # expects sleep() to be called +cycles+ times, and then raises an Interrupt
+  def hijack_sleep(cycles)
+    results = [*1..cycles] # irrelevant truthy values for each sleep call expected
+    Kernel::stubs(:sleep).returns(*results).then.raises(Interrupt)
+  end
+end
+
+World(TimeMachineHelper)

data/lib/tweet-tail.rb

@@ -0,0 +1,13 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+module TweetTail
+  VERSION = '1.0.0'
+end
+
+gem 'json'
+require "json"
+
+require "open-uri"
+
+require "tweet-tail/tweet_poller"

data/lib/tweet-tail/cli.rb

@@ -0,0 +1,42 @@
+require 'optparse'
+
+module TweetTail::CLI
+  def self.execute(stdout, arguments=[])
+    options = { :polling => false }
+    
+    parser = OptionParser.new do |opts|
+      opts.banner = <<-BANNER.gsub(/^          /,'')
+        Display latest twitter search results. Even poll for them for hours of fun.
+        
+        Usage: #{File.basename($0)} [options]
+        
+        Options are:
+      BANNER
+      opts.separator ""
+      opts.on("-f", "Poll for new search results each 15 seconds."
+              ) { |arg| options[:polling] = true }
+      opts.on("-h", "--help",
+              "Show this help message.") { stdout.puts opts; exit }
+      opts.parse!(arguments)
+    end
+    
+    unless query = arguments.shift
+      stdout.puts parser
+      exit
+    end
+
+    begin
+      app = TweetTail::TweetPoller.new(query)
+      app.refresh
+      stdout.puts app.render_latest_results
+      while(options[:polling])
+        Kernel::sleep(15)
+        app.refresh
+        if app.render_latest_results.size > 0
+          stdout.puts app.render_latest_results
+        end
+      end
+    rescue Interrupt
+    end
+  end
+end

data/lib/tweet-tail/tweet_poller.rb

@@ -0,0 +1,34 @@
+class TweetTail::TweetPoller
+  attr_accessor :query, :latest_results, :refresh_url
+  
+  def initialize(query)
+    @query   = query
+  end
+  
+  def refresh
+    unless @refresh_url
+      @latest_feed = JSON.parse(initial_json_data)
+    else
+      @latest_feed = JSON.parse(refresh_json_data)
+    end
+    @latest_results = @latest_feed["results"].reverse
+    @refresh_url    = @latest_feed["refresh_url"]
+  end
+  
+  def render_latest_results
+    @latest_results.inject("") do |output, tweet|
+      screen_name = tweet['from_user']
+      message     = tweet['text']
+      output += "#{screen_name}: #{message}\n"
+    end
+  end
+
+  protected
+  def initial_json_data
+    Net::HTTP.get(URI.parse("http://search.twitter.com/search.json?q=#{query}"))
+  end
+
+  def refresh_json_data
+    Net::HTTP.get(URI.parse("http://search.twitter.com/search.json#{refresh_url}"))
+  end
+end 

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/tweet-tail.rb'}"
+puts "Loading tweet-tail gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/test/test_helper.rb

@@ -0,0 +1,7 @@
+require 'stringio'
+require 'test/unit'
+require "rubygems"
+require File.dirname(__FILE__) + '/../lib/tweet-tail'
+
+gem "mocha"
+require "mocha"

data/test/test_tweet-tail_cli.rb

@@ -0,0 +1,15 @@
+require File.join(File.dirname(__FILE__), "test_helper.rb")
+require 'tweet-tail/cli'
+
+class TestTweetTailCli < Test::Unit::TestCase
+  def setup
+    TweetTail::CLI.execute(@stdout_io = StringIO.new, ['jaoo'])
+    @stdout_io.rewind
+    @stdout = @stdout_io.read
+  end
+  
+  def test_print_default_output
+    puts @stdout
+    assert_match(/To update this executable/, @stdout)
+  end
+end

data/test/test_tweet_poller.rb

@@ -0,0 +1,68 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestTweetPoller < Test::Unit::TestCase
+
+  def setup
+    @app = TweetTail::TweetPoller.new('jaoo')
+    @app.expects(:initial_json_data).returns(<<-JSON)
+    {
+        "results": [{
+            "text": "reading my own abstract for JAOO presentation",
+            "from_user": "drnic",
+            "id": 1666627310
+        },{
+            "text": "Come speak with Matt at JAOO next week",
+            "from_user": "theRMK",
+            "id": 1666334207
+        },{
+            "text": "@VenessaP I think they went out for noodles. #jaoo",
+            "from_user": "Steve_Hayes",
+            "id": 1666166639
+        },{
+            "text": "Come speak with me at JAOO next week - http:\/\/jaoo.dk\/",
+            "from_user": "mattnhodges",
+            "id": 1664823944
+        }],
+        "refresh_url": "?since_id=1682666650&q=jaoo"
+    }
+    JSON
+    @app.refresh
+  end
+  
+  def test_found_results
+    assert_equal(4, @app.latest_results.length)
+  end
+  
+  def test_message_render
+    expected = <<-RESULTS.gsub(/^    /, '')
+    mattnhodges: Come speak with me at JAOO next week - http://jaoo.dk/
+    Steve_Hayes: @VenessaP I think they went out for noodles. #jaoo
+    theRMK: Come speak with Matt at JAOO next week
+    drnic: reading my own abstract for JAOO presentation
+    RESULTS
+    assert_equal(expected, @app.render_latest_results)
+  end
+  
+  def test_ready_for_refresh
+    assert_equal('?since_id=1682666650&q=jaoo', @app.refresh_url)
+  end
+  
+  def test_refresh_data
+    @app.expects(:refresh_json_data).returns(<<-JSON)
+    {
+      "results": [{
+        "text": "Wish I could be at #JAOO Australia...",
+        "from_user": "CaioProiete",
+        "id": 1711269079
+      }],
+      "refresh_url": "?since_id=1711269079&q=jaoo"
+    }
+    JSON
+    @app.refresh
+    expected = <<-RESULTS.gsub(/^    /, '')
+    CaioProiete: Wish I could be at #JAOO Australia...
+    RESULTS
+    assert_equal(expected, @app.render_latest_results)
+    assert_equal('?since_id=1711269079&q=jaoo', @app.refresh_url)
+  end
+end

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification 
+name: tweettail
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Dr Nic
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-06 00:00:00 +10:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: newgem
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.4.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.0
+    version: 
+description: |-
+  Get the latest search results streaming to your console:
+  
+      $ tweet-tail railsconf
+      rubysolo: protip: it helps to actually READ the error message.  #railsconf
+      voxxit: So, everyone, how is #railsconf coming? When is the big 3.0 announcement?
+      JesseGoldberg: @GavinStark I don't have as much to chat about as you do while you are at RailsConf.
+      wndxlori: Anyone else not eaten yet #railsconf
+      zenmatt: Great dinner and coversation with @heroku at n9ne in the palms. #railsconf
+      Adkron: Damn you #railsconf why can I not visit you this year.  I'm missing all the gitjour goodness.
+      pengwynn: Meeting a lot of great folks at the open gov hackathon at #railsconf #gov20
+      davidjrice: Enjoying ordering taxis to our hotel... "for the wynn!" #railsconf quick noms at stripburger then whiskeys at the stage door with ey ftw!
+      cricketgeek: as pointed out by @jnewland at sushi this evening... http://pic.im/2LY  #railsconf
+      paulog: had fun at gilt groupe coctail party.  props. #railsconf
+      Amuse_Bouche: I hope my two favorite people in the world form an alliance! (Swoon) RT: @dhh Loved talking to @tferris at #railsconf. So much resonates.
+      abie: At open gov BOF #railsconf
+      matthewcarriere: running a saas bof was great... I hope it gets some more time this week. #railsconf
+      jdar: @tullytully RT @dgou:for the benefit of people at #railsconf keynote, here is penelope trunk on tim ferris: http://bit.ly/b81E
+      yorzi: Reading: "Rails 3 and the Real Secret to High Productivity: RailsConf 2009 - May 04 - 07, 2009, Las Vegas,NV" ( http://tinyurl.com/czmkxn )
+  
+  Or let it sit there all day with the `-f` option (as like `tail -f`)
+email: 
+- drnicwilliams@gmail.com
+executables: 
+- tweet-tail
+- tweet_tail
+- tweettail
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- README.rdoc
+files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- README.rdoc
+- Rakefile
+- bin/tweet-tail
+- bin/tweet_tail
+- bin/tweettail
+- features/cli.feature
+- features/development.feature
+- features/fixtures/search-jaoo-since-1682666650.json
+- features/fixtures/search-jaoo.json
+- features/fixtures/search-jaoo.short.json
+- features/step_definitions/common_steps.rb
+- features/step_definitions/executable_steps.rb
+- features/step_definitions/logger_steps.rb
+- features/step_definitions/twitter_data_steps.rb
+- features/support/common.rb
+- features/support/env.rb
+- features/support/logger.rb
+- features/support/matchers.rb
+- features/support/mocha.rb
+- features/support/time_machine_helpers.rb
+- lib/tweet-tail.rb
+- lib/tweet-tail/cli.rb
+- lib/tweet-tail/tweet_poller.rb
+- script/console
+- script/destroy
+- script/generate
+- test/test_helper.rb
+- test/test_tweet-tail_cli.rb
+- test/test_tweet_poller.rb
+has_rdoc: true
+homepage: http://github.com/drnic/tweet-tail
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+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: drnicutilities
+rubygems_version: 1.3.3
+signing_key: 
+specification_version: 3
+summary: "Get the latest search results streaming to your console:  $ tweet-tail railsconf rubysolo: protip: it helps to actually READ the error message"
+test_files: 
+- test/test_helper.rb
+- test/test_tweet-tail_cli.rb
+- test/test_tweet_poller.rb