jdb/gritter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Reworking and expanding documentation to use JLP.

Browse Source
This commit is contained in:
Jonathan Bernard 2012-01-23 13:09:59 -06:00
parent 6041c284ec
commit c3dfb014a2
2 changed files with 244 additions and 204 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
src/com/jdbernard/twitter/ConsoleColor.java
View File

@ -1,7 +1,19 @@
/**
* # ConsoleColor
* @author Jonathan Bernard (jdbernard@gmail.com)
* @org jdbernard.com/twitter/ConsoleColor
* @copyright 2010-2012 Jonathan Bernard
*/
package com.jdbernard.twitter; package com.jdbernard.twitter;
/**
* The ConsoleColor class is a wrapper around [ANSI escape codes].
*
* [ANSI escape codes]: http://en.wikipedia.org/wiki/ANSI_escape_code
*/
public class ConsoleColor { public class ConsoleColor {
// Storage for color information.
public final Colors fg; public final Colors fg;
public final Colors bg; public final Colors bg;
public final boolean bright; public final boolean bright;

436
src/com/jdbernard/twitter/TwitterCLI.groovy
View File

@ -1,3 +1,9 @@
/**
* # TwitterCLI
* @author Jonathan Bernard (jdbernard@gmail.com)
* @org jdbernard.com/twitter/TwitterCLI
* @copyright 2010-2012 Jonathan Bernard
*/
package com.jdbernard.twitter package com.jdbernard.twitter
import com.martiansoftware.nailgun.NGContext import com.martiansoftware.nailgun.NGContext
@ -10,6 +16,11 @@ import twitter4j.TwitterFactory
import twitter4j.conf.Configuration import twitter4j.conf.Configuration
import twitter4j.conf.PropertyConfiguration import twitter4j.conf.PropertyConfiguration
/**
* TwitterCLI is a command-line interface (CLI) to the [Twitter API].
*
* [Twitter API]: https://dev.twitter.com/docs
*/
public class TwitterCLI { public class TwitterCLI {
private static String EOL = System.getProperty("line.separator") private static String EOL = System.getProperty("line.separator")
@ -32,19 +43,30 @@ public class TwitterCLI {
private Logger log = LoggerFactory.getLogger(getClass()) private Logger log = LoggerFactory.getLogger(getClass())
/* ============================================= */ /// ## Main Methods ##
/* ======== MAIN METHODS - Entry points ======== */ /// ------------------
/* ============================================= */
/**
* #### main
* This is the main entry-point to the client.
* @org jdbernard.com/twitter/TwitterCLI/main
*/
public static void main(String[] args) { public static void main(String[] args) {
TwitterCLI inst = new TwitterCLI(new File(System.getProperty("user.home"), TwitterCLI inst = new TwitterCLI(new File(System.getProperty("user.home"),
".gritterrc")) ".gritterrc"))
// trim the last argumnet, not all cli's are well-behaved // trim the last argumnet, as not all cli's are well-behaved
args[-1] = args[-1].trim() args[-1] = args[-1].trim()
inst.run((args as List) as LinkedList) inst.run((args as List) as LinkedList) }
}
/**
* #### nailMain
* This is the entry point when the client is called from a [Nailgun]
* instance.
*
* [Nailgun]: http://www.martiansoftware.com/nailgun/
* @org jdbernard.com/twitter/TwitterCLI/nailMain
*/
public static void nailMain(NGContext context) { public static void nailMain(NGContext context) {
if (nailgunInst == null) if (nailgunInst == null)
nailgunInst = new TwitterCLI(new File( nailgunInst = new TwitterCLI(new File(
@ -52,16 +74,20 @@ public class TwitterCLI {
else else
nailgunInst.stdin = new Scanner(context.in) nailgunInst.stdin = new Scanner(context.in)
// trim the last argumnet, not all cli's are well-behaved // trim the last argumnet, as not all cli's are well-behaved
context.args[-1] = context.args[-1].trim() context.args[-1] = context.args[-1].trim()
nailgunInst.run((context.args as List) as LinkedList) nailgunInst.run((context.args as List) as LinkedList) }
}
/* ===================================== */ /// ## Configuration and Setup ##
/* ======== CONFIGURATION/SETUP ======== */ /// -----------------------------
/* ===================================== */
/**
* #### reconfigure
* Reload the configuration and pass the rest of the arguments back to be
* processed.
* @org jdbernard.com/twitter/TwitterCLI/reconfigure
*/
public static void reconfigure(LinkedList args) { public static void reconfigure(LinkedList args) {
if (nailgunInst == null) main(args as String[]) if (nailgunInst == null) main(args as String[])
else { else {
@ -69,10 +95,12 @@ public class TwitterCLI {
nailgunInst = new TwitterCLI(new File( nailgunInst = new TwitterCLI(new File(
System.getProperty("user.home"), ".gritterrc")) System.getProperty("user.home"), ".gritterrc"))
nailgunInst.run(args) nailgunInst.run(args) }}
}
}
/**
* #### TwitterCLI
* Initialize this instance based on the given configuration file.
*/
public TwitterCLI(File propFile) { public TwitterCLI(File propFile) {
// load the configuration // load the configuration
@ -101,11 +129,11 @@ public class TwitterCLI {
stdin = new Scanner(System.in) stdin = new Scanner(System.in)
} }
/* =================================== */ /// ## Parsing Functions ##
/* ======== PARSING FUNCTIONS ======== */ /// -----------------------
/* =================================== */
/** /**
| #### run
| Main entry to the command line parsing system. In general, the parsing | Main entry to the command line parsing system. In general, the parsing
| system (this method and the others dedicated to parsing arguments) | system (this method and the others dedicated to parsing arguments)
| follow some common conventions: | follow some common conventions:
@ -119,49 +147,49 @@ public class TwitterCLI {
| the default will be assumed and the current argument will not | the default will be assumed and the current argument will not
| be comsumed, but passed on to the refining command. | be comsumed, but passed on to the refining command.
| |
| For example: :: | For example:
| |
| gritter set colored off show mine | gritter set colored off show mine
| |
| is parsed: | is parsed:
| |
| * the first argument is expected to be a command | * the first argument is expected to be a command
| * the ``set`` command consumes two arguments, expecting both to | * the `set` command consumes two arguments, expecting both to
| be parameters | be parameters
| * the set command is finished, but there are still arguments, so the | * the set command is finished, but there are still arguments, so the
| parsing process starts again, expecting the next argument to be a | parsing process starts again, expecting the next argument to be a
| command. | command.
| * the ``show`` command consumes one argument and expects a command | * the `show` command consumes one argument and expects a command
| * ``mine`` does not match any of the possible refinements for ``show`` so | * `mine` does not match any of the possible refinements for `show` so
| the default command, `timeline`, is assumed. | the default command, `timeline`, is assumed.
| * the `show timeline` command consumes one argument, expecting a command | * the `show timeline` command consumes one argument, expecting a command
| * The `show timeline mine` command executes | * The `show timeline mine` command executes
| * No more arguments remain, so execution terminates. | * No more arguments remain, so execution terminates.
| |
| Recognized top-level commands are: | Recognized top-level commands are:
| |
| +-----------------+-------------------+----------------------------+ | `delete`
| | *Command* | *Aliases* | *Description* | | : Delete a post, status, list membership, etc.
| +-----------------+-------------------+----------------------------+ | *aliases: `destroy`, `remove`.*
| | ``delete`` | ``destroy``, | Delete a post, status, list|
| | | ``remove`` | membership, etc. |
| +-----------------+-------------------+----------------------------+
| | ``get`` | ``show`` | Display a list, timeline, |
| | | | list membership, etc. |
| +-----------------+-------------------+----------------------------+
| | ``help`` | | Display help for commands |
| +-----------------+-------------------+----------------------------+
| | ``post`` | `add`, ``create`` | Post a new status, add a |
| | | | new list subscription, etc.|
| +-----------------+-------------------+----------------------------+
| | ``reconfigure`` | | Cause the tool to reload |
| | | | its configuration file. |
| +-----------------+-------------------+----------------------------+
| | ``set`` | | Set a configurable value |
| | | | at runtime. |
| +-----------------+-------------------+----------------------------+
| |
| @param args A {@link java.util.LinkedList} of arguments to parse. | `get`
| : Display a list, timeline, list membership, etc.
| *aliases: `show`.*
|
| `help`
| : Display help for commands.
|
| `post`
| : Post a new status, add a new list subscription, etc.
| *aliases: `add`, `create`.*
|
| `reconfigure`
| : Cause the tool to reload its configuration file.
|
| `set`
| : Set a configurable value at runtime.
|
| `@param args A {@link java.util.LinkedList} of arguments to parse.`
*/ */
public void run(LinkedList args) { public void run(LinkedList args) {
if (args.size() < 1) printUsage() if (args.size() < 1) printUsage()
@ -180,35 +208,29 @@ public class TwitterCLI {
case ~/set/: set(args); break // set case ~/set/: set(args); break // set
default: // fallthrough default: // fallthrough
if (strict) { if (strict) {
log.error(color("Unrecognized command: '$command'", colors.error)) log.error(color("Unrecognized command: '$command'",
} else { colors.error)) }
else {
if (warnings) { if (warnings) {
println "Command '$command' unrecognized: " + println "Command '$command' unrecognized: " +
"assuming this is a parameter to 'show'" "assuming this is a parameter to 'show'" }
}
args.addFirst(command) args.addFirst(command)
get(args) get(args) }}}}
}
}
}
}
/* -------- DELETE Subparsing -------- */ /// ### `DELETE` Subparsing.
/** /**
| Parse a ``delete`` command. Valid options are: | #### delete
| Parse a `delete` command. Valid options are:
| |
| +-------------+--------------------------------------------------+ | `status`
| | *Argument* | *Description* | | : Destroy a status given a status id. *This is the default command.*
| +-------------+--------------------------------------------------+
| | ``status`` | Destroy a status given a status id. *This is the |
| | | default command.* |
| +-------------+--------------------------------------------------+
| | ``list`` | Delete a list, remove list members, etc. |
| +-------------+--------------------------------------------------+
| |
| @param args A {@link java.util.LinkedList} of arguments. | `list`
| : Delete a list, remove list members, etc.
|
| `@param args A {@link java.util.LinkedList} of arguments.`
*/ */
public void delete(LinkedList args) { public void delete(LinkedList args) {
def option = args.poll() def option = args.poll()
@ -219,24 +241,22 @@ public class TwitterCLI {
case "status": deleteStatus(args); break case "status": deleteStatus(args); break
case "list": deleteList(args); break case "list": deleteList(args); break
default: args.addFirst(option) default: args.addFirst(option)
deleteStatus(args) deleteStatus(args) }}
}
}
/** /**
| Parse a ``delete list`` command. Valid options are: | #### deleteList
| Parse a `delete list` command. Valid options are:
| |
| +------------------+---------------------------------------------+ | `member`
| | *Argument* | *Description* | | : Remove a member from a list.
| +------------------+---------------------------------------------+
| | ``member`` | Remove a member from a list. |
| +------------------+---------------------------------------------+
| | ``subscription`` | Unsubcribe from a given list. |
| +------------------+---------------------------------------------+
| | *list-reference* | Delete the list specified by the reference. |
| +------------------+---------------------------------------------+
| |
| @param args A {@link java.util.LinkedList} of arguments. | `subscription`
| : Unsubcribe from a given list.
|
| *list-reference*
| : Delete the list specified by the reference.
|
| `@param args A {@link java.util.LinkedList} of arguments.`
*/ */
public void deleteList(LinkedList args) { public void deleteList(LinkedList args) {
def option = args.poll() def option = args.poll()
@ -247,33 +267,30 @@ public class TwitterCLI {
case "member": deleteListMember(args); break case "member": deleteListMember(args); break
case "subscription": deleteListSubscription(args); break case "subscription": deleteListSubscription(args); break
default: args.addFirst(option) default: args.addFirst(option)
doDeleteList(args) doDeleteList(args) }}
}
}
/* -------- GET/SHOW Subparsing -------- */
/// ### `GET/SHOW` Subparsing
/** /**
| Parse a ``get`` command. Valid options are: | #### get
| Parse a `get` command. Valid options are:
| |
| +-------------------+-------------------------------------------------+ | `list`
| | *Argument* | *Description* | | : Show a list timeline, members, subs, etc.
| +-------------------+-------------------------------------------------+
| | ``list`` | Show a list timeline, members, subs, etc. |
| +-------------------+-------------------------------------------------+
| | ``lists`` | Show lists all lists owned by a given user |
| +-------------------+-------------------------------------------------+
| | ``subscriptions`` | Show all of the lists a given user is subcribed |
| | | to. |
| +-------------------+-------------------------------------------------+
| | ``timeline`` | Show a timeline of tweets. *This is the default |
| | | command.* |
| +-------------------+-------------------------------------------------+
| | ``user`` | Show information about a given users. |
| +-------------------+-------------------------------------------------+
| |
| @param args A {@link java.util.LinkedList} of arguments. | `lists`
| : Show lists all lists owned by a given user.
|
| `subscriptions`
| : Show all of the lists a given user is subcribed to.
|
| `timeline`
| : Show a timeline of tweets. *This is the default command.*
|
| `user`
| : Show information about a given users.
|
| `@param args A {@link java.util.LinkedList} of arguments.`
*/ */
public void get(LinkedList args) { public void get(LinkedList args) {
def option = args.poll() def option = args.poll()
@ -287,29 +304,27 @@ public class TwitterCLI {
case "timeline": showTimeline(args); break case "timeline": showTimeline(args); break
case "user": showUser(args); break case "user": showUser(args); break
default: args.addFirst(option) default: args.addFirst(option)
showTimeline(args) showTimeline(args) }}
}
}
/** /**
| Parse a ``show list`` command. Valid options are: | #### showList
| Parse a `show list` command. Valid options are:
| |
| +--------------------+-----------------------------------------------+ | `members`
| | *Argument* | *Description* | | : Show the members of a given list. This is the list of users who's
| +--------------------+-----------------------------------------------+ | tweets comprise the list.
| | ``members`` | Show the members of a given list. This is the |
| | | list of users who's tweets comprise the list. |
| +--------------------+-----------------------------------------------+
| | ``subscribers`` | Show the subscribers of a given list. This is |
| | | the list of users who are see the list. |
| +--------------------+-----------------------------------------------+
| | ``subscriptions`` | Show all of the lists a given user is |
| | | subscribed to. |
| +--------------------+-----------------------------------------------+
| | *list-reference* | Show the timeline for a given list. |
| +--------------------+-----------------------------------------------+
| |
| @param args a {@link java.util.LinkedList} of arguments. | `subscribers`
| : Show the subscribers of a given list. This is the list of users who
| are see the list.
|
| `subscriptions`
| : Show all of the lists a given user is subscribed to.
|
| *list-reference*
| : Show the timeline for a given list.
|
| `@param args a {@link java.util.LinkedList} of arguments.`
*/ */
public void showList(LinkedList args) { public void showList(LinkedList args) {
def option = args.poll() def option = args.poll()
@ -321,17 +336,16 @@ public class TwitterCLI {
case "subscribers": showListSubscribers(args); break case "subscribers": showListSubscribers(args); break
case "subscriptions": showListSubscriptions(args); break case "subscriptions": showListSubscriptions(args); break
default: args.addFirst(option) default: args.addFirst(option)
showListTimeline(args) showListTimeline(args) }}
}
}
/** /**
| Parse a ``show lists`` command. ``show lists`` consumes at most one | #### showLists
| Parse a `show lists` command. `show lists` consumes at most one
| argument, representing a user reference. It shows all of the lists | argument, representing a user reference. It shows all of the lists
| owned by the given user. If no user reference is given ``show lists`` | owned by the given user. If no user reference is given `show lists`
| shows the lists owned by the currently logged in user. | shows the lists owned by the currently logged in user.
| |
| @param args a {@link java.util.LinkedList} of arguments. | `@param args a {@link java.util.LinkedList} of arguments.`
*/ */
public void showLists(LinkedList args) { public void showLists(LinkedList args) {
def user = args.poll() def user = args.poll()
@ -340,14 +354,15 @@ public class TwitterCLI {
if (!user) user = twitter.screenName if (!user) user = twitter.screenName
printLists(twitter.getUserLists(user, -1)) // TODO paging // TODO paging
} printLists(twitter.getUserLists(user, -1)) }
/** /**
| Parse a ``show list members`` command. ``show list members`` consumes | #### showListMembers
| Parse a `show list members` command. `show list members` consumes
| one argument, a reference to the list in question. | one argument, a reference to the list in question.
| |
| @param args a {@util java.util.LinkedList} of arguments. | `@param args a {@util java.util.LinkedList} of arguments.`
*/ */
public void showListMembers(LinkedList args) { public void showListMembers(LinkedList args) {
def listRef = parseListReference(args) def listRef = parseListReference(args)
@ -360,20 +375,20 @@ public class TwitterCLI {
color(" command requires a list reference in the form of " + color(" command requires a list reference in the form of " +
"user/list: ", colors.error) + "user/list: ", colors.error) +
"gritter show list members <user/list>" "gritter show list members <user/list>"
return return }
}
def userList = twitter.getUserListMembers(listRef.username, def userList = twitter.getUserListMembers(listRef.username,
listRef.listId, -1) listRef.listId, -1)
printUserList(userList) // TODO paging // TODO paging
} printUserList(userList) }
/** /**
| Parse a ``show list subscribers`` command. ``show list subscribers | #### showListSubscribers
| Parse a `show list subscribers` command. `show list subscribers`
| consumes one argument, a reference to the list in question. | consumes one argument, a reference to the list in question.
| |
| @param args a {@util java.util.LinkedList} of arguments. | `@param args a {@util java.util.LinkedList} of arguments.`
*/ */
public void showListSubscribers(LinkedList args) { public void showListSubscribers(LinkedList args) {
def listRef = parseListReference(args) def listRef = parseListReference(args)
@ -386,18 +401,18 @@ public class TwitterCLI {
color(" command requires a list reference in the form of " + color(" command requires a list reference in the form of " +
"user/list: ", colors.error) + "user/list: ", colors.error) +
"gritter show list subscribers <user/list>" "gritter show list subscribers <user/list>"
return return }
}
// TODO: paging
printUserList(twitter.getUserListSubscribers( printUserList(twitter.getUserListSubscribers(
listRef.username, listRef.listId, -1)) // TODO: paging listRef.username, listRef.listId, -1)) }
}
/** /**
| Parse a ``show list members`` command. ``show list members consumes one | #### showListSubscriptions
| argument, a reference to the list in question. | Parse a `show list subscriptions` command. `show list subscriptions`
| consumes one argument, a reference to the list in question.
| |
| @param args a {@util java.util.LinkedList} of arguments. | `@param args a {@util java.util.LinkedList} of arguments.`
*/ */
public void showListSubscriptions(LinkedList args) { public void showListSubscriptions(LinkedList args) {
def user = args.poll() def user = args.poll()
@ -407,17 +422,23 @@ public class TwitterCLI {
if (!user) user = twitter.screenName if (!user) user = twitter.screenName
printLists(twitter.getUserListSubscriptions(user, -1)) // TODO: paging // TODO: paging
} printLists(twitter.getUserListSubscriptions(user, -1)) }
/**
| #### showListTimeline
| Parse a `show list timeline` command. `show list timeline` consumes one
| argument, a reference to a user's list.
|
| `@param args a {@util java.util.LinkedList} of arguments.`
*/
public void showListTimeline(LinkedList args) { public void showListTimeline(LinkedList args) {
if (args.size() < 1) { if (args.size() < 1) {
println color("show list", colors.option) + println color("show list", colors.option) +
color(" command requires a list reference in the form of " + color(" command requires a list reference in the form of " +
"user/list: ", colors.error) + "user/list: ", colors.error) +
"gritter show list <user/list>" "gritter show list <user/list>"
return return }
}
def listRef = parseListReference(args) def listRef = parseListReference(args)
@ -428,13 +449,16 @@ public class TwitterCLI {
color(" command requires a list reference in the form of " + color(" command requires a list reference in the form of " +
"user/list: ", colors.error) + "user/list: ", colors.error) +
"gritter show list <user/list>" "gritter show list <user/list>"
return return }
}
// TODO: paging
printTimeline(twitter.getUserListStatuses( printTimeline(twitter.getUserListStatuses(
listRef.username, listRef.listId, new Paging())) // TODO: paging listRef.username, listRef.listId, new Paging())) }
}
/**
| #### showTimeline
|
*/
public void showTimeline(LinkedList args) { public void showTimeline(LinkedList args) {
String timeline = args.poll() ?: "home" String timeline = args.poll() ?: "home"
@ -443,39 +467,37 @@ public class TwitterCLI {
timeline) timeline)
switch (timeline) { switch (timeline) {
// friends
case "friends": printTimeline(twitter.friendsTimeline); break case "friends": printTimeline(twitter.friendsTimeline); break
// home
case "home": printTimeline(twitter.homeTimeline); break case "home": printTimeline(twitter.homeTimeline); break
// mine
case "mine": printTimeline(twitter.userTimeline); break case "mine": printTimeline(twitter.userTimeline); break
// public
case "public": printTimeline(twitter.publicTimeline); break case "public": printTimeline(twitter.publicTimeline); break
// user
case "user": case "user":
String user = args.poll() String user = args.poll()
if (user) { if (user) {
if (user.isNumber()) if (user.isNumber())
printTimeline(twitter.getUserTimeline(user as int)) printTimeline(twitter.getUserTimeline(user as int))
else printTimeline(twitter.getUserTimeline(user)) else printTimeline(twitter.getUserTimeline(user)) }
} else println color("No user specified.", colors.error) else println color("No user specified.", colors.error)
break; break;
default: default:
println color("Unknown timeline: ", colors.error) + println color("Unknown timeline: ", colors.error) +
color(timeline, colors.option) color(timeline, colors.option)
break; break; }}
}
}
/**
* #### showUser
*/
public void showUser(LinkedList args) { public void showUser(LinkedList args) {
def user = args.poll() def user = args.poll()
log.debug("Processing a 'show user' command, user = '{}'", user) log.debug("Processing a 'show user' command, user = '{}'", user)
println color("show user", colors.option) + println color("show user", colors.option) +
color(" is not yet implemented.", colors.error) color(" is not yet implemented.", colors.error) }
}
/**
* #### createList
*/
public void createList(LinkedList args) { public void createList(LinkedList args) {
def option = args.poll() def option = args.poll()
@ -483,10 +505,11 @@ public class TwitterCLI {
case "member": addListMember(args); break case "member": addListMember(args); break
case "subscription": addListSubscription(args); break case "subscription": addListSubscription(args); break
default: args.addFirst(option) default: args.addFirst(option)
createNewList(args); break createNewList(args); break }}
}
}
/**
* #### post
*/
public void post(LinkedList args) { public void post(LinkedList args) {
def option = args.poll() def option = args.poll()
@ -497,17 +520,17 @@ public class TwitterCLI {
color(" command requires at least two parameters: ", color(" command requires at least two parameters: ",
colors.error) + "gritter post <status|retweet|list> " + colors.error) + "gritter post <status|retweet|list> " +
"<options>..." "<options>..."
return return }
}
switch (option) { switch (option) {
case "status": postStatus(args.poll()); break case "status": postStatus(args.poll()); break
case "retweet": retweetStatus(args.poll()); break case "retweet": retweetStatus(args.poll()); break
case "list": createList(args); break case "list": createList(args); break
default: postStatus(option) default: postStatus(option) }}
}
}
/**
* #### set
*/
public void set(LinkedList args) { public void set(LinkedList args) {
def option = args.poll() def option = args.poll()
def value = args.poll() def value = args.poll()
@ -519,8 +542,7 @@ public class TwitterCLI {
println color("set", colors.option) + println color("set", colors.option) +
color(" command requires two options: ", colors.error) + color(" command requires two options: ", colors.error) +
"gritter set <param> <value>" "gritter set <param> <value>"
return return }
}
switch (option) { switch (option) {
case "terminalWidth": terminalWidth = value as int; break case "terminalWidth": terminalWidth = value as int; break
@ -530,12 +552,14 @@ public class TwitterCLI {
default: default:
println color("No property named ", colors.error) + println color("No property named ", colors.error) +
color(option, colors.option) + color(option, colors.option) +
color(" exists.", colors.error) color(" exists.", colors.error) }}
}
}
/* ======== WORKER FUNCTIONS ========*/ /// ## Worker Functions ##
/// ----------------------
/**
* #### deleteListMember
*/
public void deleteListMember(LinkedList args) { public void deleteListMember(LinkedList args) {
def listRef = parseListReference(args) def listRef = parseListReference(args)
def user = args.poll() def user = args.poll()
@ -547,8 +571,7 @@ public class TwitterCLI {
println color("delete list member", colors.option) + println color("delete list member", colors.option) +
color(" requires two parameters: ", colors.error) + color(" requires two parameters: ", colors.error) +
"gritter delete list member <list-ref> <user>" "gritter delete list member <list-ref> <user>"
return return }
}
// look up the user id if neccessary // look up the user id if neccessary
if (user.isLong()) user = user as long if (user.isLong()) user = user as long
@ -558,10 +581,12 @@ public class TwitterCLI {
// TODO: error checking? print list name? // TODO: error checking? print list name?
println "Deleted " + color("@$user", colors.mentioned) + println "Deleted " + color("@$user", colors.mentioned) +
" from your list." " from your list." }
}
public void deleteListSubscribtion(LinkedList args) { /**
* #### deleteListSubscription
*/
public void deleteListSubscription(LinkedList args) {
def listRef = parseListReference(args) def listRef = parseListReference(args)
log.debug("Unsubscribing from a list: listRef='{}', user='{}'", log.debug("Unsubscribing from a list: listRef='{}', user='{}'",
@ -571,16 +596,17 @@ public class TwitterCLI {
println color("delete list subscription", colors.option) + println color("delete list subscription", colors.option) +
color(" requires a list reference: ", colors.error) + color(" requires a list reference: ", colors.error) +
"gritter delete list subscription <list-ref>" "gritter delete list subscription <list-ref>"
return return }
}
twitter.unsubscribeUserList(listRef.username, listRef.listId) twitter.unsubscribeUserList(listRef.username, listRef.listId)
// TODO: error checking? // TODO: error checking?
println "Unsubscribed from list: " + color(listRef.toString(), println "Unsubscribed from list: " + color(listRef.toString(),
colors.option) colors.option) }
}
/**
* #### doDeleteList
*/
public void doDeleteList(LinkedList args) { public void doDeleteList(LinkedList args) {
def listRef = parseListReference(args) def listRef = parseListReference(args)
@ -590,24 +616,23 @@ public class TwitterCLI {
println color("destroy list", colors.option) + println color("destroy list", colors.option) +
color(" requries a list reference: ", colors.error) + color(" requries a list reference: ", colors.error) +
"gritter destroy list <list-ref>" "gritter destroy list <list-ref>"
return return }
}
println "Really destroy list '" + color(listRef.toString(), println "Really destroy list '" + color(listRef.toString(),
colors.option) + "' ?" colors.option) + "' ?"
if (stdin.nextLine() ==~ /yes|y|true|t/) { if (stdin.nextLine() ==~ /yes|y|true|t/) {
try { try {
twitter.destroyUserList(listRef.listId) twitter.destroyUserList(listRef.listId)
println "List destroyed." println "List destroyed." }
} catch (Exception e) { catch (Exception e) {
println "An error occurred trying to delete the list: '" + println "An error occurred trying to delete the list: '" +
e.localizedMessage e.localizedMessage
log.error("Error destroying list:", e) log.error("Error destroying list:", e) }}
} else println "Destroy list canceled." }
} else println "Destroy list canceled."
}
/**
* #### deleteStatus
*/
public void deleteStatus(LinkedList args) { public void deleteStatus(LinkedList args) {
def statusId = args.poll() def statusId = args.poll()
@ -617,8 +642,7 @@ public class TwitterCLI {
println color("destroy status", colors.option) + println color("destroy status", colors.option) +
color(" requires a status id: ", colors.error) + color(" requires a status id: ", colors.error) +
"gritter delete status <status-id>" "gritter delete status <status-id>"
return return }
}
statusId = statusId as long statusId = statusId as long
@ -627,15 +651,16 @@ public class TwitterCLI {
if (stdin.nextLine() ==~ /yes|y|true|t/) { if (stdin.nextLine() ==~ /yes|y|true|t/) {
try { try {
twitter.destroyStatus(statusId) twitter.destroyStatus(statusId)
println "Status destroyed." println "Status destroyed." }
} catch (Exception e) { catch (Exception e) {
println "An error occurred trying to destroy the status: '" + println "An error occurred trying to destroy the status: '" +
e.localizedMessage e.localizedMessage
log.error("Error destroying status:", e) log.error("Error destroying status:", e) }}
} else println "Destroy status canceled." }
} else println "Destroy status canceled."
}
/**
* #### printLists
*/
public void printLists(def lists) { public void printLists(def lists) {
int colSize = 0 int colSize = 0
@ -813,7 +838,8 @@ public class TwitterCLI {
} else { println "List creation cancelled." } } else { println "List creation cancelled." }
} }
/* ======== HELP DISPLAY FUNCTIONS ======== */ /// ## Help and Display Functions ##
/// --------------------------------
public void help(LinkedList args) { public void help(LinkedList args) {
@ -967,7 +993,9 @@ public class TwitterCLI {
println " internal id number." println " internal id number."
println "" println ""
} }
/* ======== UTILITY FUNCTIONS ======== */
/// ## Utility Functions
/// --------------------
public def parseListReference(LinkedList args) { public def parseListReference(LinkedList args) {
def username = args.poll() def username = args.poll()