t 0.8.1 → 0.8.2

data/README.md

@@ -1,159 +1,171 @@
 # Twitter CLI [![Build Status](https://secure.travis-ci.org/sferik/t.png?branch=master)][travis] [![Dependency Status](https://gemnasium.com/sferik/t.png?travis)][gemnasium]
 ### A command-line power tool for Twitter.
 
-The CLI attempts to mimic the [Twitter SMS commands][sms] wherever possible,
-however it offers vastly more commands and capabilities than are available via
-SMS.
+The CLI takes syntactic cues from the [Twitter SMS commands][sms], however it
+offers vastly more commands and capabilities than are available via SMS.
 
 [travis]: http://travis-ci.org/sferik/t
 [gemnasium]: https://gemnasium.com/sferik/t
 [gem]: https://rubygems.org/gems/twitter
 [sms]: https://support.twitter.com/articles/14020-twitter-sms-command
 
-## <a name="installation"></a>Installation
+## Installation
+    # Requires Ruby :)
     gem install t
 
-## <a name="configuration"></a>Configuration
+## Configuration
 
-Because Twitter requires OAuth for most of its functionality, you'll need to
+Twitter requires OAuth for most of its functionality, so you'll need to
 register a new application at <http://dev.twitter.com/apps/new>. Once you
-create your application make sure to set the "Application Type" to "Read, Write
-and Access direct messages", otherwise you won't be able to post status updates
-or send direct messages via the CLI.
+create your application, make sure to set your application's Access Level to
+"Read, Write and Access direct messages", otherwise you may receive an error
+that looks something like this:
 
-Once you have registered your application, you'll be given a consumer key and
-secret, which you can use to authorize your Twitter account.
+    Read-only application cannot POST
+
+Once you've successfully registered your application, you'll be given a
+consumer key and secret, which you can use to authorize your Twitter account.
 
     t authorize -c YOUR_CONSUMER_KEY -s YOUR_CONSUMER_SECRET
 
-This will direct you to a URL where you can authenticate to Twitter and then
-enter the returned PIN back into the terminal.  Assuming that works, you'll be
-authorized to use `t` as that user. To authorize multiple accounts, simply
-repeat the last step while signed in to Twitter as a different user.
+This command directs you to a URL where you can sign-in to Twitter and then
+enter the returned PIN back into the terminal. If you type the PIN correctly,
+you should now be authorized authorized to use `t` as that user. To authorize
+multiple accounts, simply repeat the last step, signing into Twitter as a
+different user.
 
-You can see a list of all the accounts you've authorized.
+You can see a list of all the accounts you've authorized by typing the command:
 
     t accounts
 
+The output of which will be structured like this:
+
     sferik
       UDfNTpOz5ZDG4a6w7dIWj
       uuP7Xbl2mEfGMiDu1uIyFN
     gem
       thG9EfWoADtIr6NjbL9ON (active)
 
-Notice that one account is marked as the active. To change the active account
-use the `set` subcommand, passing either just the username, if it's
-unambiguous, or the username and consumer key pair, like so:
+**Note**: One account (specifically, the last one you authorized) is marked as
+active. To change the active account use the `set` subcommand, passing either
+just the username, if it's unambiguous, or the username and consumer key pair.
+Something like this:
 
     t set active sferik UDfNTpOz5ZDG4a6w7dIWj
 
-Account information is stored in the YAML-formatted file `~/.trc`. **Note**:
-Anyone with access to this file can masquerade as you on Twitter, so it's
-important to keep it secure, just as you would treat your SSH private key. For
-this reason, the file is hidden and has the permission bits set to 0600.
+Account information is stored in a YAML-formatted file located at `~/.trc`.
+**Note**: Anyone with access to this file can masquerade as you on Twitter, so
+it's important to keep it secure, just as you would treat your SSH private key.
+For this reason, the file is hidden and has the permission bits set to 0600.
 
-## <a name="examples"></a>Usage Examples
-Typing `t help` will give you a list of all the available commands. You can
-type `t help TASK` to get help for a specific command.
+## Usage Examples
+Typing `t help` will list all the available commands. You can type `t help
+TASK` to get help for a specific command.
 
     t help
 
-### <a name="update"></a>Update your status
+### Update your status
     t update "I'm tweeting from the command line. Isn't that special?"
 
 **Note**: If your tweet includes special characters (e.g. `!`), make sure to
 wrap it in single quotes instead of double quotes, so those characters are not
-interpreted by your shell. However, if you use single quotes, your Tweet can't
-contain any apostrophes.
+interpreted by your shell. (However, if you use single quotes, your Tweet
+obviously can't contain any apostrophes.)
+
+### Retrieve detailed information about a Twitter user
+    t whois @sferik
 
-### <a name="stats"></a>Retrieve stats about users
+### Retrieve stats for multiple users
     t users -l @sferik @gem
 
-### <a name="follow"></a>Follow users
+### Follow users
     t follow @sferik @gem
 
-### <a name="does-follow"></a>Find out if one user follows another
+### Check whether one user follows another
     t does_follow @ev @sferik
 
-**Note**: If the first user doesn't follow the second, `t` will exit with a
-non-zero exit code. This allows you to execute conditional commands, for
-example:
+**Note**: If the first user does not follow the second, `t` will exit with a
+non-zero exit code. This allows you to execute commands conditionally, for
+example, only attempt to send a user a direct message if he are already
+follows you:
 
-    t does_follow @ev @sferik && t dm @ev "What's up, bro?"
+    t does_follow @ev && t dm @ev "What's up, bro?"
 
-### <a name="friends"></a>List all your friends (ordered by number of followers)
+### Create a list for everyone you're following
+    t list create following-`date "+%Y-%m-%d"`
+
+### Add everyone you're following to that list (up to 500 users)
+    t followings | xargs t list add following-`date "+%Y-%m-%d"`
+
+### List all the members of a list, in long format
+    t list members -l following-`date "+%Y-%m-%d"`
+
+### List all your lists, in long format
+    t lists -l
+
+### List all your friends, ordered by number of followers
     t friends -lf
 
-### <a name="leaders"></a>List all your leaders (people you follow who don't follow you back)
+### List all your leaders (people you follow who don't follow you back)
     t leaders -lf
 
-### <a name="unfollow"></a>Unfollow everyone you follow who doesn't follow you back
+### Unfollow everyone you follow who doesn't follow you back
     t leaders | xargs t unfollow
 
-### <a name="follow"></a>Follow everyone who follows you (who you don't already follow)
-    t disciples | xargs t follow
-
-### <a name="follow-roulette"></a>Follow roulette: randomly follow someone who follows you
+### Follow roulette: randomly follow someone who follows you (who you don't already follow)
     t disciples | shuf | head -1 | xargs t follow
 
-### <a name="timeline"></a>Output the last 200 tweets in your timeline to a CSV file
-    t timeline -n 200 --csv > timeline.csv
-
-### <a name="favorite"></a>Favorite the last 10 tweets that mention you
+### Favorite the last 10 tweets that mention you
     t mentions -n 10 -l | awk '{print $1}' | xargs t favorite
 
-### <a name="list-create"></a>Create a list
-    t list create presidents
-
-### <a name="list-add"></a>Add users to a list
-    t list add presidents @BarackObama @Jasonfinn
-
-### Create a list that contains today's date in the name
-    t list create following-`date "+%Y-%m-%d"`
-
-### <a name="followings"></a>Add everyone you're following to a list
-    t followings | xargs t list add following-`date "+%Y-%m-%d"`
-
-### <a name="list-members"></a>Display members of a list
-    t list members following-`date "+%Y-%m-%d"`
+### Output the last 200 tweets in your timeline to a CSV file
+    t timeline -n 200 --csv > timeline.csv
 
-### <a name="list-members-count"></a>Count the number of Twitter employees
+### Count the number of employees who work for Twitter
     t list members twitter team | wc -l
 
-### <a name="search-all"></a>Search Twitter for the 20 most recent Tweets that match a specified query
+### Search Twitter for the 20 most recent Tweets that match a specified query
     t search all "query"
 
-### <a name="search-retweets"></a>Search Tweets you've favorited that match a specified query
+### Download the latest Linux kernel via BitTorrent (possibly NSFW, depending where you work)
+    t search all "lang:en filter:links linux torrent" -n 1 | grep -o "http://t.co/[0-9A-Za-z]*" | xargs open
+
+### Search Tweets you've favorited that match a specified query
     t search favorites "query"
 
-### <a name="search-mentions"></a>Search Tweets mentioning you that match a specified query
+### Search Tweets mentioning you that match a specified query
     t search mentions "query"
 
-### <a name="search-retweets"></a>Search Tweets you've retweeted that match a specified query
+### Search Tweets you've retweeted that match a specified query
     t search retweets "query"
 
-### <a name="search-timeline"></a>Search Tweets in your timeline that match a specified query
+### Search Tweets in your timeline that match a specified query
     t search timeline "query"
 
-### <a name="search-user"></a>Search Tweets in a user's timeline that match a specified query
+### Search Tweets in another user's timeline that match a specified query
     t search user @sferik "query"
 
-## <a name="features"></a>Features
+## Features
+* Deep search: Instead of using the Twitter Search API, [which only only goes
+  back 6-9 days][index], `t search` fetches up to 3,200 tweets via the REST API
+  and then checks each one against a regular expression.
 * Multithreaded: Whenever possible, Twitter API requests are made in parallel,
   resulting in faster performance for bulk operations.
-* Designed for Unix: All output is designed to be piped to other Unix
-  utilities, like grep, cut, awk, bc, wc, and xargs for advanced processing.
-* 99% C0 Code Coverage: Extremely well tested, with a 3:1 test-to-code ratio.
-* Generate spreadsheets: Output any command in CSV format simply by adding the
-  `--csv` flag.
+* Designed for Unix: Output is designed to be piped to other Unix utilities,
+  like grep, cut, awk, bc, wc, and xargs for advanced text processing.
+* Generate spreadsheets: Convert the output of any command to CSV format simply
+  by adding the `--csv` flag.
+* 98% C0 Code Coverage: Well tested, with a 3:1 test-to-code ratio.
+
+[search]: https://dev.twitter.com/docs/using-search
 
-## <a name="terminology"></a>Relationship Terminology
+## Relationship Terminology
 
 There is some ambiguity in the terminology used to describe relationships on
-Twitter. For example, some people use the term "friends" to mean the set of
-everyone you follow, while we use it to mean just the subset of people who
-follow you back (i.e., friendship is bidirectional). Here is the full table of
-terminology used throughout `t`:
+Twitter. For example, some people use the term "friends" to mean everyone you
+follow. In `t`, "friends" refers to just the subset of people who follow you
+back (i.e., friendship is bidirectional). Here is the full table of terminology
+used by `t`:
 
                                ___________________________________________________
                               |                         |                         |
@@ -169,17 +181,20 @@ terminology used throughout `t`:
                               |       followings        |
                               |_________________________|
 
-## <a name="history"></a>History
-![History](http://twitter.rubyforge.org/images/terminal_output.png "History")
+## Screenshots
+![Timeline](https://github.com/sferik/t/raw/master/screenshots/timeline.png)
+![List](https://github.com/sferik/t/raw/master/screenshots/list.png)
 
+## History
 The [twitter gem][gem] previously contained a command-line interface, up until
 version 0.5.0, when it was [removed][]. This project is offered as a sucessor
 to that effort, however it is a clean room implementation that contains none of
-John Nunemaker's original code.
+the original code.
 
 [removed]: https://github.com/jnunemaker/twitter/commit/dd2445e3e2c97f38b28a3f32ea902536b3897adf
+![History](https://github.com/sferik/t/raw/master/screenshots/history.png)
 
-## <a name="contributing"></a>Contributing
+## Contributing
 In the spirit of [free software][fsf], **everyone** is encouraged to help
 improve this project.
 
@@ -200,7 +215,7 @@ Here are some ways *you* can contribute:
 
 [issues]: https://github.com/sferik/t/issues
 
-## <a name="issues"></a>Submitting an Issue
+## Submitting an Issue
 We use the [GitHub issue tracker][issues] to track bugs and features. Before
 submitting a bug report or feature request, check to make sure it hasn't
 already been submitted. You can indicate support for an existing issue by
@@ -211,19 +226,23 @@ bug report should include a pull request with failing specs.
 
 [gist]: https://gist.github.com/
 
-## <a name="pulls"></a>Submitting a Pull Request
-1. Fork the project.
-2. Create a topic branch.
-3. Implement your feature or bug fix.
-4. Add specs for your feature or bug fix.
-5. Run `bundle exec rake spec`. If your changes are not 100% covered, go back
-   to step 4.
-6. Commit and push your changes.
-7. Submit a pull request. Please do not include changes to the gemspec,
-   version, or history file. (If you want to create your own version for some
-   reason, please do so in a separate commit.)
-
-## <a name="versions"></a>Supported Ruby Versions
+## Submitting a Pull Request
+1. [Fork the repository.][fork]
+2. [Create a topic branch.][branch]
+3. Add specs for your unimplemented feature or bug fix.
+4. Run `bundle exec rake spec`. If your specs pass, return to step 3.
+5. Implement your feature or bug fix.
+6. Run `bundle exec rake spec`. If your specs fail, return to step 5.
+7. Run `open coverage/index.html`. If your changes are not completely covered
+   by your tests, return to step 3.
+6. Add, commit, and push your changes.
+7. [Submit a pull request.][pr]
+
+[fork]: http://help.github.com/fork-a-repo/
+[branch]: http://learn.github.com/p/branching.html
+[pr]: http://help.github.com/send-pull-requests/
+
+## Supported Ruby Versions
 This library aims to support and is [tested against][travis] the following Ruby
 implementations:
 
@@ -234,8 +253,7 @@ implementations:
 
 [rubinius]: http://rubini.us/
 
-If something doesn't work on one of these interpreters, it should be considered
-a bug.
+If something doesn't work on one of these Ruby versions, it's a bug.
 
 This library may inadvertently work (or seem to work) on other Ruby
 implementations, however support will only be provided for the versions listed
@@ -244,11 +262,11 @@ above.
 If you would like this library to support another Ruby version, you may
 volunteer to be a maintainer. Being a maintainer entails making sure all tests
 run and pass on that implementation. When something breaks on your
-implementation, you will be personally responsible for providing patches in a
-timely fashion. If critical issues for a particular implementation exist at the
-time of a major release, support for that Ruby version may be dropped.
+implementation, you will be responsible for providing patches in a timely
+fashion. If critical issues for a particular implementation exist at the time
+of a major release, support for that Ruby version may be dropped.
 
-## <a name="copyright"></a>Copyright
+## Copyright
 Copyright (c) 2011 Erik Michaels-Ober. See [LICENSE][] for details.
 
 [license]: https://github.com/sferik/t/blob/master/LICENSE.md

data/lib/t/cli.rb

@@ -142,13 +142,15 @@ module T
       elsif options['long']
         array = direct_messages.map do |direct_message|
           created_at = direct_message.created_at > 6.months.ago ? direct_message.created_at.strftime("%b %e %H:%M") : direct_message.created_at.strftime("%b %e  %Y")
-          [direct_message.id.to_s, created_at, "@#{direct_message.sender.screen_name}", direct_message.text.gsub(/\n+/, ' ')]
+          [direct_message.id, created_at, "@#{direct_message.sender.screen_name}", direct_message.text.gsub(/\n+/, ' ')]
         end
         if STDOUT.tty?
           headings = ["ID", "Posted at", "Screen name", "Text"]
           array.unshift(headings) unless direct_messages.empty?
+          print_table(array, :truncate => true)
+        else
+          print_table(array)
         end
-        print_table(array)
       else
         direct_messages.each do |direct_message|
           say "#{direct_message.sender.screen_name.rjust(MAX_SCREEN_NAME_SIZE)}: #{direct_message.text.gsub(/\n+/, ' ')} (#{time_ago_in_words(direct_message.created_at)} ago)"
@@ -174,13 +176,15 @@ module T
       elsif options['long']
         array = direct_messages.map do |direct_message|
           created_at = direct_message.created_at > 6.months.ago ? direct_message.created_at.strftime("%b %e %H:%M") : direct_message.created_at.strftime("%b %e  %Y")
-          [direct_message.id.to_s, created_at, "@#{direct_message.recipient.screen_name}", direct_message.text.gsub(/\n+/, ' ')]
+          [direct_message.id, created_at, "@#{direct_message.recipient.screen_name}", direct_message.text.gsub(/\n+/, ' ')]
         end
         if STDOUT.tty?
           headings = ["ID", "Posted at", "Screen name", "Text"]
           array.unshift(headings) unless direct_messages.empty?
+          print_table(array, :truncate => true)
+        else
+          print_table(array)
         end
-        print_table(array)
       else
         direct_messages.each do |direct_message|
           say "#{direct_message.recipient.screen_name.rjust(MAX_SCREEN_NAME_SIZE)}: #{direct_message.text.gsub(/\n+/, ' ')} (#{time_ago_in_words(direct_message.created_at)} ago)"
@@ -727,13 +731,15 @@ module T
         end
       elsif options['long']
         array = places.map do |place|
-          [place.woeid.to_s, place.parent_id.to_s, place.place_type, place.name, place.country]
+          [place.woeid, place.parent_id, place.place_type, place.name, place.country]
         end
         if STDOUT.tty?
           headings = ["WOEID", "Parent ID", "Type", "Name", "Country"]
           array.unshift(headings) unless places.empty?
+          print_table(array, :truncate => true)
+        else
+          print_table(array)
         end
-        print_table(array)
       else
         if STDOUT.tty?
           print_in_columns(places.map(&:name))

data/lib/t/core_ext/enumerable.rb

@@ -2,21 +2,18 @@ module Enumerable
 
   def threaded_each
     threads = []
-    result = each do |object|
+    each do |object|
       threads << Thread.new{yield object}
     end
-    threads.each(&:join)
-    result
+    threads.each(&:value)
   end
 
   def threaded_map
-    results = map{nil}
     threads = []
-    each_with_index do |object, index|
-      threads << Thread.new{results[index] = yield object}
+    each do |object|
+      threads << Thread.new{yield object}
     end
-    threads.each(&:join)
-    results
+    threads.map(&:value)
   end
 
 end

data/lib/t/printable.rb

@@ -44,13 +44,15 @@ module T
         elsif options['long']
           array = lists.map do |list|
             created_at = list.created_at > 6.months.ago ? list.created_at.strftime("%b %e %H:%M") : list.created_at.strftime("%b %e  %Y")
-            [list.id.to_s, created_at, list.full_name, number_with_delimiter(list.member_count), number_with_delimiter(list.subscriber_count), list.mode, list.description]
+            [list.id, created_at, list.full_name, number_with_delimiter(list.member_count), number_with_delimiter(list.subscriber_count), list.mode, list.description]
           end
           if STDOUT.tty?
             headings = ["ID", "Created at", "Slug", "Members", "Subscribers", "Mode", "Description"]
             array.unshift(headings) unless lists.empty?
+            print_table(array, :truncate => true)
+          else
+            print_table(array)
           end
-          print_table(array)
         else
           if STDOUT.tty?
             print_in_columns(lists.map(&:full_name))
@@ -72,26 +74,29 @@ module T
         elsif options['long']
           array = statuses.map do |status|
             created_at = status.created_at > 6.months.ago ? status.created_at.strftime("%b %e %H:%M") : status.created_at.strftime("%b %e  %Y")
-            [status.id.to_s, created_at, "@#{status.user.screen_name}", status.text.gsub(/\n+/, ' ')]
+            [status.id, created_at, "@#{status.user.screen_name}", status.text.gsub(/\n+/, ' ')]
           end
           if STDOUT.tty?
             headings = ["ID", "Posted at", "Screen name", "Text"]
             array.unshift(headings) unless statuses.empty?
+            print_table(array, :truncate => true)
+          else
+            print_table(array)
           end
-          print_table(array)
         else
-          ENV['THOR_COLUMNS'] = "80"
           if STDOUT.tty? && !options['no-color']
+            say unless statuses.empty?
             statuses.each do |status|
               say("   #{Thor::Shell::Color::BOLD}@#{status.user.screen_name}", :yellow)
-              Thor::Shell::Basic.new.print_wrapped(status.text, :indent => 3)
+              print_wrapped(status.text, :indent => 3)
               say("   #{Thor::Shell::Color::BOLD}#{time_ago_in_words(status.created_at)} ago", :black)
               say
             end
           else
+            say unless statuses.empty?
             statuses.each do |status|
               say("   @#{status.user.screen_name}")
-              Thor::Shell::Basic.new.print_wrapped(status.text, :indent => 3)
+              print_wrapped(status.text, :indent => 3)
               say("   #{time_ago_in_words(status.created_at)} ago")
               say
             end
@@ -123,13 +128,15 @@ module T
         elsif options['long']
           array = users.map do |user|
             created_at = user.created_at > 6.months.ago ? user.created_at.strftime("%b %e %H:%M") : user.created_at.strftime("%b %e  %Y")
-            [user.id.to_s, created_at, number_with_delimiter(user.statuses_count), number_with_delimiter(user.favourites_count), number_with_delimiter(user.listed_count), number_with_delimiter(user.friends_count), number_with_delimiter(user.followers_count), "@#{user.screen_name}", user.name]
+            [user.id, created_at, number_with_delimiter(user.statuses_count), number_with_delimiter(user.favourites_count), number_with_delimiter(user.listed_count), number_with_delimiter(user.friends_count), number_with_delimiter(user.followers_count), "@#{user.screen_name}", user.name]
           end
           if STDOUT.tty?
             headings = ["ID", "Since", "Tweets", "Favorites", "Listed", "Following", "Followers", "Screen name", "Name"]
             array.unshift(headings) unless users.empty?
+            print_table(array, :truncate => true)
+          else
+            print_table(array)
           end
-          print_table(array)
         else
           if STDOUT.tty?
             print_in_columns(users.map{|user| "@#{user.screen_name}"})