tweetwine 0.2.5 → 0.2.7

data/CHANGELOG.rdoc

@@ -1,15 +1,28 @@
+=== 0.2.7 released 2009-12-22
+
+* Formatted help texts so that they do not exceed 80 chars in width.
+
+=== 0.2.6 released 2009-12-22
+
+* Command <tt>search</tt> allows searching statuses.
+* Renamed option <tt>--colorize</tt> to <tt>--colors</tt>.
+* Command <tt>home</tt> shows home timeline instead of friends timeline.
+* Command <tt>help</tt> accepts argument for showing help about a command.
+* Acceptance tests in <tt>example</tt> directory cover all commands.
+* Reimplemented how application starts executing a specific command.
+
 === 0.2.5 released 2009-10-14
 
 * Improved username highlighting for colorization. For example, email
   addresses are not highlighted as usernames anymore.
-* Command line option "--no-colorize" to (temporarily) disable colors from the
-  output.
+* Command line option <tt>--no-colorize</tt> to (temporarily) disable colors
+  from the output.
 * Added first set of acceptance tests under "example" directory.
 
 === 0.2.4 released 2009-09-16
 
 * Retry connection upon connection reset, trying maximum of three times.
-* Display proper version info on Ruby 1.8 when using option "-v".
+* Display proper version info on Ruby 1.8 when using option <tt>-v</tt>.
 * Minor code cleanups.
 * Release 0.2.3 is skipped due to my error in tagging the wrong commit.
 
@@ -25,7 +38,7 @@
 
 === 0.2.1 released 2009-08-17
 
-* Command line option "-v" show version information.
+* Command line option <tt>-v</tt> shows version information.
 * Slight implementation code cleaning.
 
 === 0.2.0 released 2009-08-17
@@ -44,8 +57,8 @@
 
 === 0.1.9 released 2009-07-15
 
-* Added commands "friends" and "followers"
-* Removed dependency to the "json" gem. It is included in Ruby 1.9.
+* Added commands <tt>friends</tt> and <tt>followers</tt>.
+* Removed dependency to the json gem. It is included in Ruby 1.9.
 
 === 0.1.8 released 2009-07-01
 
@@ -67,26 +80,26 @@
 
 === 0.1.4 released 2009-05-12
 
-* Command line option "--page N" fetches a specific status page
+* Command line option <tt>--page N</tt> fetches a specific status page.
 
 === 0.1.3 released 2009-05-05
 
-* Empty status update indicates cancellation of the command
-* Other minor improvements
+* Empty status update indicates cancellation of the command.
+* Other minor improvements.
 
 === 0.1.2 released 2009-05-04
 
-* Renamed command "friends" to "home"
-* Added command "mentions"
-* When showing a status, indicate if it is a reply
-* Improved command line argument and configuration file parsing
+* Renamed command <tt>friends</tt> to <tt>home</tt>.
+* Added command <tt>mentions</tt>.
+* When showing a status, indicate if it is a reply.
+* Improved command line argument and configuration file parsing.
 
 === 0.1.1 released 2009-04-23
 
-* Renamed command "msg" to "update"
-* If status update if longer than 140 characters, warn about it
+* Renamed command <tt>msg</tt> to <tt>update</tt>.
+* If status update if longer than 140 characters, warn about it.
 
 === 0.1.0 released 2009-04-22
 
-* Initial release with minimal functionality
-* Usable for quickly checking friends' statuses and sending status updates
+* Initial release with minimal functionality.
+* Usable for quickly checking friends' statuses and sending status updates.

data/README.rdoc

@@ -4,18 +4,19 @@ A simple but tasty Twitter agent for command line use, made for fun.
 
 == Installation
 
-Install Tweetwine as a RubyGem from GitHub:
+Install Tweetwine as a RubyGem from Gemcutter[http://gemcutter.org/]:
 
-  $ sudo gem install tuomas-tweetwine --source http://gems.github.com
+  $ sudo gem install tweetwine --source http://gemcutter.org
 
-The program is compatible with Ruby 1.9.1, and it requires <b>rest_client</b>
-gem to be installed. In addition, <b>json</b> gem is needed for Ruby 1.8.6.
+The program is compatible with both Ruby 1.8 and 1.9.
+
+The program requires <b>rest_client</b> gem to be installed. In addition, the program needs <b>json</b> gem on Ruby 1.8.
 
 == Usage
 
 In the command line, run the program by entering
 
-  $ tweetwine [options...] [command]
+  $ tweetwine [global_options...] [command] [command_options...]
 
 The program needs the user's username and password for authentication. This
 information can be supplied either via a configuration file or as an option
@@ -27,22 +28,20 @@ program recognizes the following basic settings:
 
   username: <your_username>
   password: <your_password>
-  colorize: true|false 
+  colors: true|false
 
-When invoking the program, the supported commands are
+The program supports showing the home timeline of the authenticated user, the
+latest statuses of friends and followers, and the latest statuses that mention
+the user. If that's not enough, statuses can be searched with arbitrary terms.
+In addition, new statuses can be sent.
 
-<tt>home</tt>:: Fetch friends' latest statuses (the contents of the authenticated user's home).
-<tt>mentions</tt>:: Fetch latest mentions for the authenticated user.
-<tt>user [name]</tt>:: Fetch a specific user's latest statuses, identified by the argument; if given no argument, fetch the statuses of the authenticated user.
-<tt>update [status]</tt>:: Send a status update, but confirm the action first before actually sending. The status update can either be given as an argument or via STDIN if no argument is given.
-<tt>friends</tt>:: Fetch friends and their latest statuses.
-<tt>followers</tt>:: Fetch followers and their latest statuses.
+For all the global options and commands, see:
 
-If no <tt>[command]</tt> is given, the default action is <tt>home</tt>.
+  $ tweetwine help
 
-For all the options, see:
+For information about a specific command and its options, use:
 
-  $ tweetwine -h
+  $ tweetwine help command
 
 === URL shortening for status update
 
@@ -53,7 +52,7 @@ example:
 
   username: spoonman
   password: withyourhands
-  colorize: true
+  colors: true
   shorten_urls:
     enable: true
     service_url: http://is.gd/create.php

data/Rakefile

@@ -45,10 +45,12 @@ task :gemspec do
   end
 end
 
+desc "Install the software as a gem"
 task :install => [:package] do
   sh %{sudo gem install pkg/#{name}-#{version}.gem}
 end
 
+desc "Uninstall the gem"
 task :uninstall => [:clean] do
   sh %{sudo gem uninstall #{name}}
 end

data/bin/tweetwine

@@ -1,80 +1,15 @@
 #!/usr/bin/env ruby
 
-EXIT_HELP = 1
-EXIT_VERSION = 2
 EXIT_SIGINT = 6
-EXIT_ERROR = 64
 
 trap("INT") do
   puts "\nAbort"
   exit(EXIT_SIGINT)
 end
 
-require "optparse"
 require "tweetwine"
 
-include Tweetwine
+exec_name = File.basename($0)
+config_file = ENV["HOME"] + "/.#{exec_name}"
 
-cmd_parser = lambda do |args|
-  options = {}
-  begin
-    OptionParser.new do |opt|
-      executable_name = File.basename($0)
-
-      opt.banner =<<-END
-Usage: #{executable_name} [options...] [command]
-
-  Commands: #{Client::COMMANDS.join(", ")}
-
-  Options:
-
-      END
-      opt.on("-a", "--auth USERNAME:PASSWORD", "Authentication") do |arg|
-        options[:username], options[:password] = arg.split(":", 2)
-      end
-      opt.on("-c", "--colorize", "Colorize output with ANSI escape codes") do
-        options[:colorize] = true
-      end
-      opt.on("-n", "--num N", Integer, "The number of statuses to fetch, defaults to #{Client::DEFAULT_NUM_STATUSES}") do |arg|
-        options[:num_statuses] = arg
-      end
-      opt.on("--no-colorize", "Do not colorize output with ANSI escape codes") do
-        options[:colorize] = false
-      end
-      opt.on("--no-url-shorten", "Do not shorten URLs for status update") do
-        options[:shorten_urls] = { :enable => false }
-      end
-      opt.on("-p", "--page N", Integer, "The page number of the statuses to fetch, defaults to #{Client::DEFAULT_PAGE_NUM}") do |arg|
-        options[:page_num] = arg
-      end
-      opt.on("-v", "--version", "Show version information and exit") do
-        puts "#{executable_name} #{Tweetwine::VERSION}"
-        exit(EXIT_VERSION)
-      end
-      opt.on_tail("-h", "--help", "Show this help message and exit") do
-        puts opt
-        exit(EXIT_HELP)
-      end
-    end.parse!(args)
-  rescue OptionParser::ParseError => e
-    raise ArgumentError, e.message
-  end
-  options
-end
-
-def create_dependencies(options)
-  io = Tweetwine::IO.new(options)
-  rest_client = RestClientWrapper.new(io)
-  url_shortener = lambda { |opts| UrlShortener.new(rest_client, opts) }
-  Client::Dependencies.new io, rest_client, url_shortener
-end
-
-begin
-  config = StartupConfig.new(Client::COMMANDS)
-  config.parse(ARGV, ENV["HOME"] + "/.tweetwine", &cmd_parser)
-  client = Client.new(create_dependencies(config.options), config.options)
-  client.send(config.command, *config.args)
-rescue ArgumentError, ClientError => e
-  puts "Error: #{e.message}"
-  exit(EXIT_ERROR)
-end
+Tweetwine::CLI.launch(ARGV, exec_name, config_file)

data/example/example_helper.rb

@@ -1,59 +1,49 @@
-require "coulda"
-require "matchy"
-require "open4"
-require "tweetwine"
+%w{
+  coulda
+  matchy
+  fakeweb
+  open4
+  stringio
+  time
+  timecop
+}.each { |lib| require lib }
 
-module Tweetwine
-  module ExampleHelpers
-    DEFAULT_INJECTION =<<-END
-require "fakeweb"
 FakeWeb.allow_net_connect = false
-
-require "date"
-require "time"
-require "timecop"
 Timecop.freeze(Time.parse("2009-10-14 01:56:15 +0300"))
 
-def fixture(filename)
-  contents = nil
-  filepath = File.dirname(__FILE__) << "/example/fixtures/" << filename
-  File.open(filepath) do |f|
-    contents = f.readlines.join("\n")
-  end
-  contents
-end
-    END
+require "tweetwine"
 
-    def launch_app(args, injection_code = "", &blk)
+module Tweetwine
+  module ExampleHelpers
+    TEST_USER = "fooman"
+    TEST_PASSWD = "barpwd"
+    TEST_AUTH = "#{TEST_USER}:#{TEST_PASSWD}"
+
+    def launch_app(args, &blk)
       lib = File.dirname(__FILE__) << "/../lib"
       executable = File.dirname(__FILE__) << "/../bin/tweetwine"
-      code =<<-END
-#{escape_injection_for_shell(DEFAULT_INJECTION)}
-#{escape_injection_for_shell(injection_code)}
-`cat #{executable}`
-      END
-      launch_cmd = "ruby -rubygems -I#{lib} -e \"#{code}\" -- #{args}"
+      launch_cmd = "ruby -rubygems -I#{lib} -- #{executable} #{args}"
       Open4::popen4(launch_cmd, &blk)
     end
 
-    private
-
-    def escape_injection_for_shell(code)
-      code_dup = code.dup
-      code_dup.gsub!('\'', '\\\'')
-      code_dup.gsub!('"', '\\"')
-      code_dup
+    def launch_cli(args, *input)
+      input, output = StringIO.new(input.join("\n")), StringIO.new
+      extra_opts = { :input => input, :output => output }
+      CLI.launch(args, "test", nil, extra_opts)
+      output.string.split("\n")
     end
-  end
-end
 
-module Test
-  module Unit
-    class TestCase
-      include Tweetwine::ExampleHelpers
+    def fixture(filename)
+      contents = nil
+      filepath = File.dirname(__FILE__) << "/fixtures/" << filename
+      File.open(filepath) do |f|
+        contents = f.readlines.join("\n")
+      end
+      contents
     end
   end
 end
 
 include Coulda
 include Tweetwine
+include Tweetwine::ExampleHelpers

data/example/fixtures/mentions.json

@@ -0,0 +1 @@
+[{"in_reply_to_screen_name":"fooman","geo":null,"in_reply_to_user_id":29706667,"in_reply_to_status_id":5917716667,"source":"<a href=\"http://apiwiki.twitter.com/\" rel=\"nofollow\">API</a>","user":{"profile_sidebar_fill_color":"ccf5cd","followers_count":32768,"description":null,"following":false,"time_zone":"GMT","friends_count":2,"profile_sidebar_border_color":"e0ffee","notifications":false,"favourites_count":0,"profile_text_color":"000000","url":null,"statuses_count":42,"profile_background_image_url":null,"profile_link_color":"1f6603","protected":false,"geo_enabled":false,"profile_background_tile":false,"created_at":"Fri Jul 24 15:18:06 +0000 2009","profile_image_url":null,"location":"Spain","name":"Jill Valentine","profile_background_color":"ffffff","id":59804598,"verified":false,"utc_offset":0,"screen_name":"jillv"},"truncated":false,"created_at":"Sat Oct 10 22:36:25 +0000 2009","id":5930046667,"favorited":false,"text":"@fooman, did you see their eyes glow yellow after sunset?"},{"in_reply_to_screen_name":"fooman","geo":null,"in_reply_to_user_id":29706667,"in_reply_to_status_id":5917726667,"source":"<a href=\"http://apiwiki.twitter.com/\" rel=\"nofollow\">API</a>","user":{"profile_sidebar_fill_color":"ccf5cd","followers_count":327,"description":null,"following":false,"time_zone":"GMT","friends_count":22,"profile_sidebar_border_color":"e0ffee","notifications":false,"favourites_count":0,"profile_text_color":"000000","url":null,"statuses_count":42,"profile_background_image_url":null,"profile_link_color":"1f6603","protected":false,"geo_enabled":false,"profile_background_tile":false,"created_at":"Fri Jul 25 15:18:06 +0000 2009","profile_image_url":null,"location":"Spain","name":"Chris Redfield","profile_background_color":"ffffff","id":59804333,"verified":false,"utc_offset":0,"screen_name":"redfield"},"truncated":false,"created_at":"Thu Oct 8 22:36:25 +0000 2009","id":5930056667,"favorited":false,"text":"sometimes it is just best to run, just like @fooman"}]

data/example/fixtures/search.json

@@ -0,0 +1 @@
+{"results":[{"profile_image_url":"","created_at":"Tue, 13 Oct 2009 18:18:44 +0000","from_user":"thatswhatshesaid","to_user_id":52166667,"text":"@hatguy braid, perhaps the best indie game of 2009","id":6900986667,"from_user_id":1216667,"to_user":"hatguy","geo":null,"iso_language_code":"en","source":""},{"profile_image_url":"","created_at":"Tue, 13 Oct 2009 11:44:27 +0000","from_user":"jillv","to_user_id":null,"text":"braid is even better than of the games i'm in, expect re4","id":6891036667,"from_user_id":3486667,"geo":null,"iso_language_code":"en","source":""}],"max_id":6902086667,"since_id":0,"refresh_url":"?since_id=6902084185&q=braid+game","next_page":"?page=2&max_id=6902084185&rpp=2&q=braid+game","results_per_page":2,"page":1,"completed_in":0.020717,"query":"braid+game"}

data/example/fixtures/update.json

@@ -0,0 +1 @@
+{"favorited":false,"geo":null,"in_reply_to_screen_name":null,"source":"<a href=\"http://apiwiki.twitter.com/\" rel=\"nofollow\">API</a>","in_reply_to_user_id":null,"in_reply_to_status_id":null,"user":{"profile_background_tile":false,"description":"just testing","verified":false,"profile_background_color":"1a1b1f","following":false,"profile_sidebar_fill_color":"24252b","profile_image_url":"","followers_count":0,"statuses_count":1,"time_zone":"Helsinki","profile_sidebar_border_color":"1a1b1f","url":"http://www.twitter.com/fooman","screen_name":"fooman","friends_count":0,"protected":false,"notifications":false,"favourites_count":0,"created_at":"Wed Oct 10 12:00:00 +0000 2009","profile_text_color":"6b6b6b","location":"Finland","name":"Fooman","profile_background_image_url":"http://s.twimg.com/a/1258674567/images/themes/theme5/bg.gif","id":29700570,"geo_enabled":false,"utc_offset":7200,"profile_link_color":"0070cc"},"created_at":"Sat Oct 13 14:23:41 +0000 2009","truncated":false,"id":5919326888,"text":"bored. going to sleep."}

data/example/fixtures/user.json

@@ -0,0 +1 @@
+[{"geo":null,"source":"web","truncated":false,"favorited":false,"user":{"profile_background_image_url":null,"description":"","profile_link_color":"0070cc","profile_background_tile":false,"statuses_count":2,"profile_background_color":"1a1b1f","following":false,"followers_count":2,"profile_sidebar_fill_color":"24252b","friends_count":2,"time_zone":null,"profile_sidebar_border_color":"1a1b1f","protected":false,"url":null,"notifications":false,"favourites_count":0,"profile_image_url":null,"location":null,"name":"Jill Valentine","id":29706667,"verified":false,"geo_enabled":false,"utc_offset":0,"created_at":"Wed Apr 08 12:12:22 +0000 2009","profile_text_color":"6b6b6b","screen_name":"jillv"},"in_reply_to_user_id":15506667,"in_reply_to_status_id":null,"in_reply_to_screen_name":"chris","id":679006667,"text":"@chris wait me until the garden","created_at":"Wed Oct 14 07:57:00 +0000 2009"},{"geo":null,"source":"web","truncated":false,"favorited":false,"user":{"profile_background_image_url":null,"description":"","profile_link_color":"0070cc","profile_background_tile":false,"statuses_count":2,"profile_background_color":"1a1b1f","following":false,"followers_count":2,"profile_sidebar_fill_color":"24252b","friends_count":2,"time_zone":null,"profile_sidebar_border_color":"1a1b1f","protected":false,"url":null,"notifications":false,"favourites_count":0,"profile_image_url":null,"location":null,"name":"Jill Valentine","id":29706667,"verified":false,"geo_enabled":false,"utc_offset":0,"created_at":"Wed Apr 08 12:12:22 +0000 2009","profile_text_color":"6b6b6b","screen_name":"jillv"},"in_reply_to_user_id":null,"in_reply_to_status_id":null,"in_reply_to_screen_name":null,"id":6766566667,"text":"so boring to wait","created_at":"Sat Oct 10 15:39:16 +0000 2009"}]

data/example/fixtures/users.json

@@ -0,0 +1 @@
+[{"profile_background_image_url":null,"description":"","profile_link_color":"1F98C7","status":{"source":"web","truncated":false,"favorited":false,"in_reply_to_user_id":null,"in_reply_to_status_id":null,"in_reply_to_screen_name":null,"id":6626773208,"text":"choosing next target","created_at":"Sun Oct 13 11:22:34 +0000 2009"},"profile_background_tile":false,"statuses_count":1,"profile_background_color":"C6E2EE","following":true,"followers_count":1,"profile_sidebar_fill_color":"DAECF4","friends_count":2,"time_zone":null,"profile_sidebar_border_color":"C6E2EE","protected":false,"url":null,"notifications":false,"favourites_count":0,"profile_image_url":null,"location":null,"name":"Jill Valentine","id":85386667,"verified":false,"geo_enabled":false,"utc_offset":0,"created_at":"Thu Oct 1 18:43:52 +0000 2009","profile_text_color":"663B12","screen_name":"jillv"},{"profile_background_image_url":null,"description":"","verified":false,"profile_link_color":"990000","status":{"source":"web","truncated":false,"favorited":false,"in_reply_to_user_id":null,"in_reply_to_status_id":null,"in_reply_to_screen_name":null,"id":689686667,"text":null,"created_at":null},"profile_background_tile":false,"profile_background_color":"EBEBEB","following":true,"statuses_count":0,"profile_sidebar_fill_color":"F3F3F3","followers_count":1,"time_zone":null,"profile_sidebar_border_color":"DFDFDF","protected":false,"url":null,"friends_count":1,"profile_image_url":null,"location":null,"name":"ham","id":15506667,"geo_enabled":false,"notifications":false,"utc_offset":7200,"favourites_count":0,"created_at":"Fri Oct 2 20:41:17 +0000 2008","profile_text_color":"333333","screen_name":"ham"}]

data/example/search_statuses_example.rb

@@ -0,0 +1,36 @@
+require "example_helper"
+
+FakeWeb.register_uri(:get, "http://search.twitter.com/search.json?q=braid%20game&rpp=2&page=1", :body => fixture("search.json"))
+
+Feature "search statuses" do
+  in_order_to "search statuses"
+  as_a "any user"
+  i_want_to "see latest statuses that match the search"
+
+  Scenario "see statuses that match the search" do
+    When "application is launched 'search' command and search words as extra arguments" do
+      @output = launch_cli(%W{-a anyuser:anypwd --no-colors -n 2 search braid game})
+    end
+
+    Then "the latest statuses that match the search are shown" do
+      @output[0].should == "thatswhatshesaid, in reply to hatguy, 5 hours ago:"
+      @output[1].should == "@hatguy braid, perhaps the best indie game of 2009"
+      @output[2].should == ""
+      @output[3].should == "jillv, 11 hours ago:"
+      @output[4].should == "braid is even better than of the games i'm in, expect re4"
+    end
+  end
+
+  Scenario "attempt searching without specifying search word" do
+    When "application is launched 'search' command without extra arguments" do
+      @status = launch_app("-a anyuser:anypwd --no-colors -n 2 search") do |pid, stdin, stdout|
+        @output = stdout.readlines
+      end
+    end
+
+    Then "the latest statuses that match the search are shown" do
+      @output[0].should == "Error: No search word\n"
+      @status.exitstatus.should == CLI::EXIT_ERROR
+    end
+  end
+end

data/example/show_followers_example.rb

@@ -0,0 +1,23 @@
+require "example_helper"
+
+FakeWeb.register_uri(:get, "https://#{TEST_AUTH}@twitter.com/statuses/followers/#{TEST_USER}.json", :body => fixture("users.json"))
+
+Feature "show followers and their latest statuses" do
+  in_order_to "to see who follows me"
+  as_a "authenticated user"
+  i_want_to "see my followers and their latest statuses, if any"
+
+  Scenario "see followers and their latest statuses" do
+    When "application is launched 'followers' command" do
+      @output = launch_cli(%W{-a #{TEST_AUTH} --no-colors followers})
+    end
+
+    Then "my followers and their latest statuses are shown" do
+      @output[0].should == "jillv, 12 hours ago:"
+      @output[1].should == "choosing next target"
+      @output[2].should == ""
+      @output[3].should == "ham"
+      @output[4].should == nil
+    end
+  end
+end

data/example/show_friends_example.rb

@@ -0,0 +1,23 @@
+require "example_helper"
+
+FakeWeb.register_uri(:get, "https://#{TEST_AUTH}@twitter.com/statuses/friends/#{TEST_USER}.json", :body => fixture("users.json"))
+
+Feature "show friends and their latest statuses" do
+  in_order_to "to see who I follow"
+  as_a "authenticated user"
+  i_want_to "see my friends and their latest statuses, if any"
+
+  Scenario "see friends and their latest statuses" do
+    When "application is launched 'friends' command" do
+      @output = launch_cli(%W{-a #{TEST_AUTH} --no-colors friends})
+    end
+
+    Then "my friends and their latest statuses are shown" do
+      @output[0].should == "jillv, 12 hours ago:"
+      @output[1].should == "choosing next target"
+      @output[2].should == ""
+      @output[3].should == "ham"
+      @output[4].should == nil
+    end
+  end
+end

data/example/show_home_example.rb

@@ -0,0 +1,51 @@
+require "example_helper"
+
+FakeWeb.register_uri(:get, "https://#{TEST_AUTH}@twitter.com/statuses/home_timeline.json?count=20&page=1", :body => fixture("home.json"))
+
+Feature "show the latest statuses in the home timeline for the user" do
+  in_order_to "stay up-to-date"
+  as_a "authenticated user"
+  i_want_to "see the latest statuses in the home view"
+
+  Scenario "see home with colorization disabled" do
+    When "application is launched with no command" do
+      @output = launch_cli(%W{-a #{TEST_AUTH} --no-colors})
+    end
+
+    Then "the latest statuses in the home view are shown" do
+      @output[0].should == "pelit, 11 days ago:"
+      @output[1].should == "F1-kausi alkaa marraskuussa http://bit.ly/1qQwjQ"
+      @output[2].should == ""
+      @output[58].should == "radar, 15 days ago:"
+      @output[59].should == "Four short links: 29 September 2009 http://bit.ly/dYxay"
+    end
+  end
+
+  Scenario "see home with colorization enabled" do
+    When "application is launched with no command" do
+      @output = launch_cli(%W{-a #{TEST_AUTH} --colors})
+    end
+
+    Then "the latest statuses in the home view are shown" do
+      @output[0].should == "\e[32mpelit\e[0m, 11 days ago:"
+      @output[1].should == "F1-kausi alkaa marraskuussa \e[36mhttp://bit.ly/1qQwjQ\e[0m"
+      @output[2].should == ""
+      @output[58].should == "\e[32mradar\e[0m, 15 days ago:"
+      @output[59].should == "Four short links: 29 September 2009 \e[36mhttp://bit.ly/dYxay\e[0m"
+    end
+  end
+
+  Scenario "the command for showing the home view is the default command" do
+    When "application is launched with 'home' command" do
+      @output = launch_cli(%W{-a #{TEST_AUTH} --no-colors home})
+    end
+
+    Then "the latest statuses in the home view are shown" do
+      @output[0].should == "pelit, 11 days ago:"
+      @output[1].should == "F1-kausi alkaa marraskuussa http://bit.ly/1qQwjQ"
+      @output[2].should == ""
+      @output[58].should == "radar, 15 days ago:"
+      @output[59].should == "Four short links: 29 September 2009 http://bit.ly/dYxay"
+    end
+  end
+end

data/example/show_mentions_example.rb

@@ -0,0 +1,23 @@
+require "example_helper"
+
+FakeWeb.register_uri(:get, "https://#{TEST_AUTH}@twitter.com/statuses/mentions.json?count=20&page=1", :body => fixture("mentions.json"))
+
+Feature "show the latest statuses mentioning the user" do
+  in_order_to "know if someone has mention me"
+  as_a "authenticated user"
+  i_want_to "see the latest statuses that mention me"
+
+  Scenario "see the latest statuses that mention me" do
+    When "application is launched with 'mentions' command" do
+      @output = launch_cli(%W{-a #{TEST_AUTH} --no-colors mentions})
+    end
+
+    Then "the latest statuses that mention me are shown" do
+      @output[0].should == "jillv, in reply to fooman, 3 days ago:"
+      @output[1].should == "@fooman, did you see their eyes glow yellow after sunset?"
+      @output[2].should == ""
+      @output[3].should == "redfield, in reply to fooman, 5 days ago:"
+      @output[4].should == "sometimes it is just best to run, just like @fooman"
+    end
+  end
+end

data/example/show_metadata_example.rb

@@ -5,7 +5,7 @@ Feature "show metadata" do
   as_a "user"
   i_want_to "see application metadata"
 
-  Scenario "see version" do
+  Scenario "see version with designated exit status" do
     When "application is launched with -v" do
       @status = launch_app("-v") do |pid, stdin, stdout|
         @output = stdout.gets
@@ -14,11 +14,11 @@ Feature "show metadata" do
 
     Then "version is shown" do
       @output.should =~ /\d\.\d\.\d$/
-      @status.exitstatus.should == 2
+      @status.exitstatus.should == CLI::EXIT_VERSION
     end
   end
 
-  Scenario "see help" do
+  Scenario "see help with designated exit status" do
     When "application is launched with -h" do
       @status = launch_app("-h") do |pid, stdin, stdout|
         @output = stdout.readlines
@@ -26,10 +26,57 @@ Feature "show metadata" do
     end
 
     Then "help is shown" do
-      @output[0].should =~ /^Usage:.* \[options\.\.\.\] \[command\]/
-      @output[2].should =~ /Commands: #{Client::COMMANDS.join(", ")}/
-      @output[4].should =~ /Options:$/
-      @status.exitstatus.should == 1
+      @output.join.should == <<-END
+A simple but tasty Twitter agent for command line use, made for fun.
+
+Usage: tweetwine [global_options...] [command] [command_options...]
+
+  [command] is one of
+    * followers,
+    * friends,
+    * home,
+    * mentions,
+    * search,
+    * update, or
+    * user.
+
+  The default command is home.
+
+  [global_options]:
+    -a, --auth USERNAME:PASSWORD     Authentication
+    -c, --colors                     Colorize output with ANSI escape codes
+    -n, --num N                      The number of statuses in page, default 20
+        --no-colors                  Do not use ANSI colors
+        --no-url-shorten             Do not shorten URLs for status update
+    -p, --page N                     The page number for statuses, default 1
+    -v, --version                    Show version information and exit
+    -h, --help                       Show this help message and exit
+      END
+      @status.exitstatus.should == CLI::EXIT_HELP
+    end
+  end
+
+  Scenario "upon invalid option, use designated exit status" do
+    When "application is launched with -X" do
+      @status = launch_app("-X") do |pid, stdin, stdout|
+        @output = stdout.readlines
+      end
+    end
+
+    Then "designated exit status is returned" do
+      @status.exitstatus.should == CLI::EXIT_ERROR
+    end
+  end
+
+  Scenario "upon invalid command, use designated exit status" do
+    When "application is launched with 'unknown'" do
+      @status = launch_app("unknown") do |pid, stdin, stdout|
+        @output = stdout.readlines
+      end
+    end
+
+    Then "designated exit status is returned" do
+      @status.exitstatus.should == CLI::EXIT_ERROR
     end
   end
 end