twitter-lists-cli 0.1.0 → 0.2.0

data/README.md

@@ -4,11 +4,57 @@ A command-line client for manipulating large Twitter lists in the shell, shell s
 
 Currently supports
 ------------------
-- OAuth authentication
+- OAuth authentication (twitter-auth)
 - Showing a users's followers/following
 - Following and unfollowing users
 - Showing, adding, and removing a members from a list
 
+Commands included:
+------------------
+### twitter-auth
+    usage: twitter-auth
+    Get OAuth credentials.
+
+    Global Options:
+            --auth FILE                  Read authentication data from the specified FILE
+
+### twitter-follow
+    usage: twitter-follow [-l LISTNAME] [--only | -d] [USER...]
+    Follow or unfollow users.
+
+        -l, --list LISTNAME              act on the specified LISTNAME instead of the logged-in user
+        -d, --unfollow                   unfollow the specified users
+
+    If no USERs are specified on the command line, they will be read from stdin.
+
+    Global Options:
+            --auth FILE                  Read authentication data from the specified FILE
+
+### twitter-following
+    usage: twitter-following [-r] [-u USER] [-l LISTNAME]
+    Show who is being followed by a user or a list.
+
+        -u, --user USER                  specify a username (default is the logged-in user)
+        -l, --list LISTNAME              show members of the user's LISTNAME instead of the user's followers
+        -r, --reverse                    show followers instead of who is following
+
+    Global options:
+            --auth FILE                  Read authentication data from the specified FILE
+
+### twitter-lists
+    usage: twitter-lists [-s] [-u USER] [-c LISTNAME... | -C LISTNAME... | -d LISTNAME...]
+    Show, create, or delete lists.
+        -u, --user USER                  specify a username (default is the logged-in user)
+        -c, --create                     create the specified list(s)
+        -C, --create-private             create private list(s)
+        -d, --delete                     delete the specified list(s)
+        -s, --slugs                      Use slugs instead of (possibly non-unique) names
+
+    If no LISTNAMEs are specified on the command line, they will be read from stdin.
+
+    Global options:
+            --auth FILE                  Read authentication data from the specified FILE
+
 License
 -------
 Copyright (c) 2010 Dwayne Litzenberger

data/VERSION.yml

@@ -1,5 +1,5 @@
 --- 
 :patch: 0
 :major: 0
-:minor: 1
+:minor: 2
 :build: 

data/bin/twitter-auth

@@ -5,8 +5,8 @@ require 'twitter'
 # Parse arguments
 options = {:only => false, :unfollow=>false}
 OptionParser.new do |opts|
-  opts.banner = "#{opts.program_name}"
-  opts.separator "Get OAuth credentials"
+  opts.banner = "usage: #{opts.program_name}"
+  opts.separator "Get OAuth credentials."
   opts.separator ""
   opts.separator "Global Options:"
   opts.on("--auth FILE", "Read authentication data from the specified FILE") do |optarg|

data/bin/twitter-follow

@@ -5,8 +5,8 @@ require 'twitter'
 # Parse arguments
 options = {:only => false, :unfollow=>false}
 OptionParser.new do |opts|
-  opts.banner = "#{opts.program_name} [-l LISTNAME] [--only | -d] [USER...]"
-  opts.separator "Follow or unfollow users"
+  opts.banner = "usage: #{opts.program_name} [-l LISTNAME] [--only | -d] [USER...]"
+  opts.separator "Follow or unfollow users."
   opts.separator ""
   opts.on("-l", "--list LISTNAME", "act on the specified LISTNAME instead of the logged-in user") do |optarg|
     options[:list] = optarg
@@ -54,30 +54,34 @@ if options[:list]
 end
 
 options[:users].each do |user|
-  if options[:list]
-    if options[:unfollow]
-      begin
-        base.list_remove_member(options[:user], options[:list], user)
-      rescue Twitter::TwitterError => e
-        # Don't raise exception if the user is already removed
-        raise unless e.data['error'] == "The user you are trying to remove from the list is not a member"
-      end
-    else
-      base.list_add_member(options[:user], options[:list], user)
-    end
-  else
-    if options[:unfollow]
-      begin
-        base.friendship_destroy(user)
-      rescue Twitter::TwitterError => e
-        raise unless e.data["error"] == "You are not friends with the specified user."
+  begin
+    if options[:list]
+      if options[:unfollow]
+        begin
+          base.list_remove_member(options[:user], options[:list], user)
+        rescue Twitter::TwitterError => e
+          # Don't raise exception if the user is already removed
+          raise unless e.data['error'] == "The user you are trying to remove from the list is not a member"
+        end
+      else
+        base.list_add_member(options[:user], options[:list], user)
       end
     else
-      begin
-        base.friendship_create(user, true)
-      rescue Twitter::TwitterError => e
-        raise unless e.data["error"] =~ /\ACould not follow user: (.* is already on your list\.|You've already requested to follow .*)\Z/
+      if options[:unfollow]
+        begin
+          base.friendship_destroy(user)
+        rescue Twitter::TwitterError => e
+          raise unless e.data["error"] == "You are not friends with the specified user."
+        end
+      else
+        begin
+          base.friendship_create(user, true)
+        rescue Twitter::TwitterError => e
+          raise unless e.data["error"] =~ /\ACould not follow user: (.* is already on your list\.|You've already requested to follow .*)\Z/
+        end
       end
     end
+  rescue Twitter::TwitterError => e
+    $stderr.puts "#{$0}: error: #{user}: #{e}"
   end
 end

data/bin/twitter-following

@@ -5,12 +5,15 @@ require 'twitter'
 # Parse arguments
 options = {}
 OptionParser.new do |opts|
-  opts.banner = "#{opts.program_name} [-r] [-u USER] [LISTNAME]"
-  opts.separator "Show who is being followed by a user or a list"
+  opts.banner = "usage: #{opts.program_name} [-r] [-u USER] [-l LISTNAME]"
+  opts.separator "Show who is being followed by a user or a list."
   opts.separator ""
   opts.on("-u", "--user USER", "specify a username (default is the logged-in user)") do |optarg|
     options[:user] = optarg
   end
+  opts.on("-l", "--list LISTNAME", "show members of the user's LISTNAME instead of the user's followers") do |optarg|
+    options[:list] = optarg
+  end
   opts.on("-r", "--reverse", "show followers instead of who is following") do |optarg|
     options[:reverse] = optarg
   end
@@ -24,8 +27,7 @@ end.parse!
 options[:auth_file] ||= ENV["TWITTER_AUTHFILE"]
 options[:auth_file] ||= File.expand_path("~/.twitter")
 raise "No --auth file specified" unless options[:auth_file] # XXX TODO - output usage information
-raise "Too many arguments specified" if ARGV.length > 1 # XXX TODO - output usage information
-options[:list] = ARGV[0]
+raise "Too many arguments specified" unless ARGV.empty? # XXX TODO - output usage information
 
 auth = YAML.load_file(options[:auth_file])
 oauth = Twitter::OAuth.new(auth["token"], auth["secret"])

data/bin/twitter-lists

@@ -3,16 +3,20 @@ require 'optparse'
 require 'twitter'
 
 # Parse arguments
-options = {:create => false, :delete => false}
+options = {:create => false, :delete => false, :private => false}
 OptionParser.new do |opts|
-  opts.banner = "#{opts.program_name} [-s] [-u USER] [-c LISTNAME... | -d LISTNAME...]"
-  opts.separator "Show, create, or delete lists"
+  opts.banner = "usage: #{opts.program_name} [-s] [-u USER] [-c LISTNAME... | -C LISTNAME... | -d LISTNAME...]"
+  opts.separator "Show, create, or delete lists."
   opts.on("-u", "--user USER", "specify a username (default is the logged-in user)") do |optarg|
     options[:user] = optarg
   end
   opts.on("-c", "--create", "create the specified list(s)") do |optarg|
     options[:create] = true
   end
+  opts.on("-C", "--create-private", "create private list(s)") do |optarg|
+    options[:create] = true
+    options[:private] = true
+  end
   opts.on("-d", "--delete", "delete the specified list(s)") do |optarg|
     options[:delete] = true
   end
@@ -61,7 +65,11 @@ options[:user] ||= base.verify_credentials.screen_name
 
 if options[:create]
   options[:lists].each do |list|
-    base.list_create(options[:user], :name => list)
+    if options[:private]
+      base.list_create(options[:user], :name => list, :mode => "private")
+    else
+      base.list_create(options[:user], :name => list)
+    end
   end
 elsif options[:delete]
   options[:lists].each do |list|

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Dwayne Litzenberger