t 0.3.1 → 0.4.0

data/.rspec

@@ -1,2 +1,2 @@
---format=documentation
 --color
+--order random

data/.travis.yml

@@ -1,8 +1,8 @@
-before_install: "gem update --system"
+language: ruby
 rvm:
   - 1.8.7
   - 1.9.2
   - 1.9.3
-  - jruby
-  - rbx
-  - ree
+  - jruby-18mode
+  - rbx-18mode
+  - rbx-19mode

data/README.md

@@ -1,7 +1,8 @@
 # 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 interface for Twitter, powered by the [twitter gem][gem]. The
-CLI attempts to mimic the [Twitter SMS commands][sms] wherever possible,
-however it offers more commands than are available via SMS.
+### A command-line power tool for Twitter.
+
+The CLI attempts to mimic the [Twitter SMS commands][sms] wherever possible,
+however it offers many more commands than are available via SMS.
 
 [travis]: http://travis-ci.org/sferik/t
 [gemnasium]: https://gemnasium.com/sferik/t
@@ -156,15 +157,27 @@ type `t help TASK` to get help for a specific command.
 
 ### <a name="search-all"></a>Retrieve the 20 most recent Tweets that match a specified query
 
-    t search all twitter
+    t search all "query"
+
+### <a name="search-retweets"></a>Returns Tweets you've favorited that mach a specified query
+
+    t search favorites "query"
+
+### <a name="search-mentions"></a>Returns Tweets mentioning you that mach a specified query
+
+    t search mentions "query"
+
+### <a name="search-retweets"></a>Returns Tweets you've retweeted that mach a specified query
+
+    t search retweets "query"
 
 ### <a name="search-timeline"></a>Retrieve Tweets in your timeline that match a specified query
 
-    t search timeline twitter
+    t search timeline "query"
 
 ### <a name="search-user"></a>Retrieve Tweets in a user's timeline that match a specified query
 
-    t search user sferik twitter
+    t search user sferik "query"
 
 ## <a name="history"></a>History
 ![History](http://twitter.rubyforge.org/images/terminal_output.png "History")
@@ -229,11 +242,9 @@ implementations:
 * Ruby 1.9.3
 * [JRuby][]
 * [Rubinius][]
-* [Ruby Enterprise Edition][ree]
 
 [jruby]: http://www.jruby.org/
 [rubinius]: http://rubini.us/
-[ree]: http://www.rubyenterpriseedition.com/
 
 If something doesn't work on one of these interpreters, it should be considered
 a bug.

data/lib/t/cli.rb

@@ -86,10 +86,10 @@ module T
       user = client.block(screen_name, :include_entities => false)
       say "@#{@rcfile.default_profile[0]} blocked @#{user.screen_name}"
       say
-      say "Run `#{$0} delete block #{user.screen_name}` to unblock."
+      say "Run `#{File.basename($0)} delete block #{user.screen_name}` to unblock."
     end
 
-    desc "direct_messages", "Returns the 20 most recent Direct Messages sent to you."
+    desc "direct_messages", "Returns the #{DEFAULT_NUM_RESULTS} most recent Direct Messages sent to you."
     method_option :number, :aliases => "-n", :type => :numeric, :default => DEFAULT_NUM_RESULTS
     def direct_messages
       defaults = {:include_entities => false}
@@ -117,7 +117,7 @@ module T
         client.favorite(user.status.id, :include_entities => false)
         say "@#{@rcfile.default_profile[0]} favorited @#{user.screen_name}'s latest status: \"#{user.status.text}\""
         say
-        say "Run `#{$0} delete favorite` to unfavorite."
+        say "Run `#{File.basename($0)} delete favorite` to unfavorite."
       else
         raise Thor::Error, "Tweet not found"
       end
@@ -178,7 +178,7 @@ module T
       status = client.update("@#{user.screen_name} #{message}", defaults)
       say "Reply created by @#{@rcfile.default_profile[0]} to @#{user.screen_name} (#{time_ago_in_words(status.created_at)} ago)"
       say
-      say "Run `#{$0} delete status` to delete."
+      say "Run `#{File.basename($0)} delete status` to delete."
     end
 
     desc "retweet SCREEN_NAME", "Sends that user's latest Tweet to your followers."
@@ -189,7 +189,7 @@ module T
         client.retweet(user.status.id, :include_entities => false, :trim_user => true)
         say "@#{@rcfile.default_profile[0]} retweeted @#{user.screen_name}'s latest status: \"#{user.status.text}\""
         say
-        say "Run `#{$0} delete status` to undo."
+        say "Run `#{File.basename($0)} delete status` to undo."
       else
         raise Thor::Error, "Tweet not found"
       end
@@ -202,7 +202,23 @@ module T
     end
     map %w(rt) => :retweet
 
-    desc "sent_messages", "Returns the 20 most recent Direct Messages sent to you."
+    desc "retweets [SCREEN_NAME]", "Returns the #{DEFAULT_NUM_RESULTS} most recent Retweets by a user."
+    method_option :number, :aliases => "-n", :type => :numeric, :default => DEFAULT_NUM_RESULTS
+    method_option :reverse, :aliases => "-r", :type => :boolean, :default => false
+    def retweets(screen_name=nil)
+      screen_name = screen_name.strip_at if screen_name
+      defaults = {:include_entities => false}
+      defaults.merge!(:count => options['number']) if options['number']
+      timeline = client.retweeted_by(screen_name, defaults)
+      timeline.reverse! if options['reverse']
+      page unless T.env.test?
+      timeline.each do |status|
+        say "#{status.user.screen_name.rjust(MAX_SCREEN_NAME_SIZE)}: #{status.text} (#{time_ago_in_words(status.created_at)} ago)"
+      end
+    end
+    map %w(rts) => :retweets
+
+    desc "sent_messages", "Returns the #{DEFAULT_NUM_RESULTS} most recent Direct Messages sent to you."
     method_option :number, :aliases => "-n", :type => :numeric, :default => DEFAULT_NUM_RESULTS
     def sent_messages
       defaults = {:include_entities => false}
@@ -224,7 +240,7 @@ module T
       say "Favorites: #{number_with_delimiter(user.favorites_count)}"
       say "Listed: #{number_with_delimiter(user.listed_count)}"
       say
-      say "Run `#{$0} whois #{user.screen_name}` to view profile."
+      say "Run `#{File.basename($0)} whois #{user.screen_name}` to view profile."
     end
 
     desc "status MESSAGE", "Post a Tweet."
@@ -235,7 +251,7 @@ module T
       status = client.update(message, defaults)
       say "Tweet created by @#{@rcfile.default_profile[0]} (#{time_ago_in_words(status.created_at)} ago)"
       say
-      say "Run `#{$0} delete status` to delete."
+      say "Run `#{File.basename($0)} delete status` to delete."
     end
     map %w(post tweet update) => :status
 
@@ -245,9 +261,9 @@ module T
       if recommendation
         say "Try following @#{recommendation.screen_name}."
         say
-        say "Run `#{$0} follow #{recommendation.screen_name}` to follow."
-        say "Run `#{$0} whois #{recommendation.screen_name}` for profile."
-        say "Run `#{$0} suggest` for another recommendation."
+        say "Run `#{File.basename($0)} follow #{recommendation.screen_name}` to follow."
+        say "Run `#{File.basename($0)} whois #{recommendation.screen_name}` for profile."
+        say "Run `#{File.basename($0)} suggest` for another recommendation."
       end
     end
 
@@ -288,29 +304,29 @@ module T
       say "web: #{user.url}"
     end
 
+    require 't/cli/delete'
     desc "delete SUBCOMMAND ...ARGS", "Delete Tweets, Direct Messages, etc."
     method_option :force, :aliases => "-f", :type => :boolean
-    require 't/cli/delete'
     subcommand 'delete', CLI::Delete
 
-    desc "follow SUBCOMMAND ...ARGS", "Follow users."
     require 't/cli/follow'
+    desc "follow SUBCOMMAND ...ARGS", "Follow users."
     subcommand 'follow', CLI::Follow
 
-    desc "list SUBCOMMAND ...ARGS", "Do various things with lists."
     require 't/cli/list'
+    desc "list SUBCOMMAND ...ARGS", "Do various things with lists."
     subcommand 'list', CLI::List
 
-    desc "search SUBCOMMAND ...ARGS", "Search through Tweets."
     require 't/cli/search'
+    desc "search SUBCOMMAND ...ARGS", "Search through Tweets."
     subcommand 'search', CLI::Search
 
-    desc "set SUBCOMMAND ...ARGS", "Change various account settings."
     require 't/cli/set'
+    desc "set SUBCOMMAND ...ARGS", "Change various account settings."
     subcommand 'set', CLI::Set
 
-    desc "unfollow SUBCOMMAND ...ARGS", "Unfollow users."
     require 't/cli/unfollow'
+    desc "unfollow SUBCOMMAND ...ARGS", "Unfollow users."
     subcommand 'unfollow', CLI::Unfollow
 
   private

data/lib/t/cli/delete.rb

@@ -1,13 +1,12 @@
 require 't/core_ext/string'
 require 't/rcfile'
+require 't/requestable'
 require 'thor'
-require 'twitter'
 
 module T
   class CLI
     class Delete < Thor
-      DEFAULT_HOST = 'api.twitter.com'
-      DEFAULT_PROTOCOL = 'https'
+      include T::Requestable
 
       check_unknown_options!
 
@@ -22,7 +21,7 @@ module T
         user = client.unblock(screen_name, :include_entities => false)
         say "@#{@rcfile.default_profile[0]} unblocked @#{user.screen_name}."
         say
-        say "Run `#{$0} block #{user.screen_name}` to block."
+        say "Run `#{File.basename($0)} block #{user.screen_name}` to block."
       end
 
       desc "dm", "Delete the last Direct Message sent."
@@ -50,7 +49,7 @@ module T
           client.unfavorite(status.id, :include_entities => false)
           say "@#{@rcfile.default_profile[0]} unfavorited @#{status.user.screen_name}'s latest status: \"#{status.text}\""
           say
-          say "Run `#{$0} favorite #{status.user.screen_name}` to favorite."
+          say "Run `#{File.basename($0)} favorite #{status.user.screen_name}` to favorite."
         else
           raise Thor::Error, "Tweet not found"
         end
@@ -81,32 +80,6 @@ module T
       end
       map %w(post tweet update) => :status
 
-    private
-
-      def base_url
-        "#{protocol}://#{host}"
-      end
-
-      def client
-        return @client if @client
-        @rcfile.path = parent_options['profile'] if parent_options['profile']
-        @client = Twitter::Client.new(
-          :endpoint => base_url,
-          :consumer_key => @rcfile.default_consumer_key,
-          :consumer_secret => @rcfile.default_consumer_secret,
-          :oauth_token => @rcfile.default_token,
-          :oauth_token_secret  => @rcfile.default_secret
-        )
-      end
-
-      def host
-        parent_options['host'] || DEFAULT_HOST
-      end
-
-      def protocol
-        parent_options['no_ssl'] ? 'http' : DEFAULT_PROTOCOL
-      end
-
     end
   end
 end

data/lib/t/cli/follow.rb

@@ -3,16 +3,14 @@ require 't/core_ext/enumerable'
 require 't/core_ext/string'
 require 't/collectable'
 require 't/rcfile'
+require 't/requestable'
 require 'thor'
-require 'twitter'
 
 module T
   class CLI
     class Follow < Thor
       include T::Collectable
-
-      DEFAULT_HOST = 'api.twitter.com'
-      DEFAULT_PROTOCOL = 'https'
+      include T::Requestable
 
       check_unknown_options!
 
@@ -40,7 +38,7 @@ module T
         end
         say "@#{@rcfile.default_profile[0]} is now following #{number} more #{number == 1 ? 'user' : 'users'}."
         say
-        say "Run `#{$0} unfollow all followers` to stop."
+        say "Run `#{File.basename($0)} unfollow all followers` to stop."
       end
 
       desc "listed LIST_NAME", "Follow all members of a list."
@@ -58,7 +56,7 @@ module T
         end
         say "@#{@rcfile.default_profile[0]} is now following #{number} more #{number == 1 ? 'user' : 'users'}."
         say
-        say "Run `#{$0} unfollow all listed #{list_name}` to stop."
+        say "Run `#{File.basename($0)} unfollow all listed #{list_name}` to stop."
       end
 
       desc "users SCREEN_NAME [SCREEN_NAME...]", "Allows you to start following users."
@@ -72,33 +70,7 @@ module T
         number = screen_names.length
         say "@#{@rcfile.default_profile[0]} is now following #{number} more #{number == 1 ? 'user' : 'users'}."
         say
-        say "Run `#{$0} unfollow users #{screen_names.join(' ')}` to stop."
-      end
-
-    private
-
-      def base_url
-        "#{protocol}://#{host}"
-      end
-
-      def client
-        return @client if @client
-        @rcfile.path = parent_options['profile'] if parent_options['profile']
-        @client = Twitter::Client.new(
-          :endpoint => base_url,
-          :consumer_key => @rcfile.default_consumer_key,
-          :consumer_secret => @rcfile.default_consumer_secret,
-          :oauth_token => @rcfile.default_token,
-          :oauth_token_secret  => @rcfile.default_secret
-        )
-      end
-
-      def host
-        parent_options['host'] || DEFAULT_HOST
-      end
-
-      def protocol
-        parent_options['no_ssl'] ? 'http' : DEFAULT_PROTOCOL
+        say "Run `#{File.basename($0)} unfollow users #{screen_names.join(' ')}` to stop."
       end
 
     end

data/lib/t/cli/list.rb

@@ -1,17 +1,16 @@
 require 'action_view'
 require 'pager'
 require 't/rcfile'
+require 't/requestable'
 require 'thor'
-require 'twitter'
 
 module T
   class CLI
     class List < Thor
       include ActionView::Helpers::DateHelper
       include Pager
+      include T::Requestable
 
-      DEFAULT_HOST = 'api.twitter.com'
-      DEFAULT_PROTOCOL = 'https'
       DEFAULT_NUM_RESULTS = 20
       MAX_SCREEN_NAME_SIZE = 20
 
@@ -54,32 +53,6 @@ module T
       require 't/cli/list/remove'
       subcommand 'remove', CLI::List::Remove
 
-    private
-
-      def base_url
-        "#{protocol}://#{host}"
-      end
-
-      def client
-        return @client if @client
-        @rcfile.path = parent_options['profile'] if parent_options['profile']
-        @client = Twitter::Client.new(
-          :endpoint => base_url,
-          :consumer_key => @rcfile.default_consumer_key,
-          :consumer_secret => @rcfile.default_consumer_secret,
-          :oauth_token => @rcfile.default_token,
-          :oauth_token_secret  => @rcfile.default_secret
-        )
-      end
-
-      def host
-        parent_options['host'] || DEFAULT_HOST
-      end
-
-      def protocol
-        parent_options['no_ssl'] ? 'http' : DEFAULT_PROTOCOL
-      end
-
     end
   end
 end

data/lib/t/cli/list/add.rb

@@ -1,19 +1,21 @@
 require 'active_support/core_ext/array/grouping'
+require 'retryable'
+require 't/core_ext/enumerable'
 require 't/core_ext/string'
 require 't/collectable'
 require 't/rcfile'
+require 't/requestable'
 require 'thor'
-require 'twitter'
 
 module T
   class CLI
     class List
       class Add < Thor
         include T::Collectable
+        include T::Requestable
 
-        DEFAULT_HOST = 'api.twitter.com'
-        DEFAULT_PROTOCOL = 'https'
         MAX_USERS_PER_LIST = 500
+        MAX_USERS_PER_REQUEST = 100
 
         check_unknown_options!
 
@@ -44,13 +46,15 @@ module T
             return unless yes? "Are you sure you want to add #{number} #{number == 1 ? 'friend' : 'friends'} to the list \"#{list_name}\"?"
           end
           max_members_to_add = MAX_USERS_PER_LIST - existing_list_members
-          list_member_ids_to_add[0...max_members_to_add].in_groups_of(100, false) do |user_id_group|
-            client.list_add_members(list_name, user_id_group)
+          list_member_ids_to_add[0...max_members_to_add].in_groups_of(MAX_USERS_PER_REQUEST, false).threaded_each do |user_id_group|
+            retryable(:tries => 3, :on => Twitter::Error::ServerError, :sleep => 0) do
+              client.list_add_members(list_name, user_id_group)
+            end
           end
           number_added = [number, max_members_to_add].min
           say "@#{@rcfile.default_profile[0]} added #{number_added} #{number_added == 1 ? 'friend' : 'friends'} to the list \"#{list_name}\"."
           say
-          say "Run `#{$0} list remove all friends #{list_name}` to undo."
+          say "Run `#{File.basename($0)} list remove all friends #{list_name}` to undo."
         end
 
         desc "followers LIST_NAME", "Add all followers to a list."
@@ -75,13 +79,15 @@ module T
             return unless yes? "Are you sure you want to add #{number} #{number == 1 ? 'follower' : 'followers'} to the list \"#{list_name}\"?"
           end
           max_members_to_add = MAX_USERS_PER_LIST - existing_list_members
-          list_member_ids_to_add[0...max_members_to_add].in_groups_of(100, false) do |user_id_group|
-            client.list_add_members(list_name, user_id_group)
+          list_member_ids_to_add[0...max_members_to_add].in_groups_of(MAX_USERS_PER_REQUEST, false).threaded_each do |user_id_group|
+            retryable(:tries => 3, :on => Twitter::Error::ServerError, :sleep => 0) do
+              client.list_add_members(list_name, user_id_group)
+            end
           end
           number_added = [number, max_members_to_add].min
           say "@#{@rcfile.default_profile[0]} added #{number_added} #{number_added == 1 ? 'follower' : 'followers'} to the list \"#{list_name}\"."
           say
-          say "Run `#{$0} list remove all followers #{list_name}` to undo."
+          say "Run `#{File.basename($0)} list remove all followers #{list_name}` to undo."
         end
 
         desc "listed FROM_LIST_NAME TO_LIST_NAME", "Add all list memebers to a list."
@@ -106,50 +112,30 @@ module T
             return unless yes? "Are you sure you want to add #{number} #{number == 1 ? 'member' : 'members'} to the list \"#{to_list_name}\"?"
           end
           max_members_to_add = MAX_USERS_PER_LIST - existing_list_members
-          list_member_ids_to_add[0...max_members_to_add].in_groups_of(100, false) do |user_id_group|
-            client.list_add_members(to_list_name, user_id_group)
+          list_member_ids_to_add[0...max_members_to_add].in_groups_of(MAX_USERS_PER_REQUEST, false).threaded_each do |user_id_group|
+            retryable(:tries => 3, :on => Twitter::Error::ServerError, :sleep => 0) do
+              client.list_add_members(to_list_name, user_id_group)
+            end
           end
           number_added = [number, max_members_to_add].min
           say "@#{@rcfile.default_profile[0]} added #{number_added} #{number_added == 1 ? 'member' : 'members'} to the list \"#{to_list_name}\"."
           say
-          say "Run `#{$0} list remove all listed #{from_list_name} #{to_list_name}` to undo."
+          say "Run `#{File.basename($0)} list remove all listed #{from_list_name} #{to_list_name}` to undo."
         end
 
         desc "users LIST_NAME SCREEN_NAME [SCREEN_NAME...]", "Add users to a list."
         def users(list_name, screen_name, *screen_names)
           screen_names.unshift(screen_name)
-          screen_names.map!{|screen_name| screen_name.strip_at}
-          client.list_add_members(list_name, screen_names)
+          screen_names.map!(&:strip_at)
+          screen_names.in_groups_of(MAX_USERS_PER_REQUEST, false).threaded_each do |user_id_group|
+            retryable(:tries => 3, :on => Twitter::Error::ServerError, :sleep => 0) do
+              client.list_add_members(list_name, user_id_group)
+            end
+          end
           number = screen_names.length
           say "@#{@rcfile.default_profile[0]} added #{number} #{number == 1 ? 'user' : 'users'} to the list \"#{list_name}\"."
           say
-          say "Run `#{$0} list remove users #{list_name} #{screen_names.join(' ')}` to undo."
-        end
-
-      private
-
-        def base_url
-          "#{protocol}://#{host}"
-        end
-
-        def client
-          return @client if @client
-          @rcfile.path = parent_options['profile'] if parent_options['profile']
-          @client = Twitter::Client.new(
-            :endpoint => base_url,
-            :consumer_key => @rcfile.default_consumer_key,
-            :consumer_secret => @rcfile.default_consumer_secret,
-            :oauth_token => @rcfile.default_token,
-            :oauth_token_secret  => @rcfile.default_secret
-          )
-        end
-
-        def host
-          parent_options['host'] || DEFAULT_HOST
-        end
-
-        def protocol
-          parent_options['no_ssl'] ? 'http' : DEFAULT_PROTOCOL
+          say "Run `#{File.basename($0)} list remove users #{list_name} #{screen_names.join(' ')}` to undo."
         end
 
       end