Add --max_results option for 'ls'

This closes #10

Shifts the hardcoded maxResults value for the cmdList json body
into a 'max_results' option.

Note that testing against our JIRA instance, in a project with
more than 1000 open issues, suggests that the JIRA has an internal
limit of 1000 results in a single query.

jira/cli/commands.go

@@ -116,7 +116,7 @@ func (c *Cli) CmdList() error {
 	json, err := jsonEncode(map[string]interface{}{
 		"jql":        query,
 		"startAt":    "0",
-		"maxResults": "500",
+		"maxResults": c.opts["max_results"],
 		"fields":     fields,
 	})
 	if err != nil {

jira/main.go

@@ -19,9 +19,10 @@ var format = "%{color}%{time:2006-01-02T15:04:05.000Z07:00} %{level:-5s} [%{shor
 func main() {
 	user := os.Getenv("USER")
 	home := os.Getenv("HOME")
+	defaultMaxResults := "500"
 	usage := fmt.Sprintf(`
 Usage:
-  jira [-v ...] [-u USER] [-e URI] [-t FILE] (ls|list) ( [-q JQL] | [-p PROJECT] [-c COMPONENT] [-a ASSIGNEE] [-i ISSUETYPE] [-w WATCHER] [-r REPORTER]) [-f FIELDS] [-s ORDER]
+  jira [-v ...] [-u USER] [-e URI] [-t FILE] (ls|list) ( [-q JQL] | [-p PROJECT] [-c COMPONENT] [-a ASSIGNEE] [-i ISSUETYPE] [-w WATCHER] [-r REPORTER]) [-f FIELDS] [-s ORDER] [--max_results MAX_RESULTS]
   jira [-v ...] [-u USER] [-e URI] [-b] [-t FILE] view ISSUE
   jira [-v ...] [-u USER] [-e URI] [-b] [-t FILE] edit ISSUE [--noedit] [-m COMMENT] [-o KEY=VAL]... 
   jira [-v ...] [-u USER] [-e URI] [-b] [-t FILE] create [--noedit] [-p PROJECT] [-i ISSUETYPE] [-o KEY=VAL]...
@@ -73,7 +74,8 @@ Command Options:
   -s --sort=ORDER           For list operations, sort issues (default: priority asc, created)
   -w --watcher=USER         Watcher to add to issue (default: %s)
                             or Watcher to search for
-`, user, fmt.Sprintf("%s/.jira.d/templates", home), user)
+  --max_results=VAL         Maximum number of results to return in query (default: %s)
+`, user, fmt.Sprintf("%s/.jira.d/templates", home), user, defaultMaxResults)
 
 	args, err := docopt.Parse(usage, nil, true, "0.0.7", false, false)
 	if err != nil {
@@ -146,6 +148,9 @@ Command Options:
 	if _, ok := opts["sort"]; !ok {
 		opts["sort"] = "priority asc, created"
 	}
+	if _, ok := opts["max_results"]; !ok {
+		opts["max_results"] = defaultMaxResults
+	}
 
 	if _, ok := opts["endpoint"]; !ok {
 		log.Error("endpoint option required.  Either use --endpoint or set a enpoint option in your ~/.jira.d/config.yml file")