Add pagination feature with list

Now count and offset can be used to manage pagination for list feature.

Fixes #24

Author: amritghimire

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "jira-terminal"
-version = "1.4.0"
+version = "1.5.0"
 authors = ["Amrit Ghimire <[email protected]>"]
 edition = "2018"
 description = "This is a command line application that can be used as a personal productivity tool for interacting with JIRA"

Cargo.toml

@@ -59,7 +59,7 @@ jira-terminal help autocompletion
 ```
 
 ```
-JIRA Terminal 1.2.0
+JIRA Terminal 1.5.0
 Amrit Ghimire <[email protected]>
 This is a command line application that can be used as a personal productivity tool for interacting with JIRA
 
@@ -86,6 +86,7 @@ SUBCOMMANDS:
 
 ### List of Tickets
 ```
+
 jira-terminal-list 
 List the issues from JIRA.
 
@@ -101,8 +102,9 @@ OPTIONS:
     -A, --alias <ALIAS>               Save the applied options as an alias. You can use it with jql option later.
     -a, --assignee <ASIGNEE>...       Assignee username or email to filter with.
     -c, --component <COMPONENT>...    Component name or ID to filter with.
+    -C, --count <COUNT>               Total number of issues to show. (Default is 50)
     -d, --display <DISPLAY>            Comma separated list of fields to display.
-                                      Possible options for fields are: 
+                                      Possible options for fields are:
                                       key,resolution,priority,assignee,status,components,creator,reporter,issuetype,project,summary
                                       
                                       You can pass alias as option for display. You can save alias using alias
@@ -115,6 +117,7 @@ OPTIONS:
     -f, --filter <FILTER>...          Filter name or filter id that you saved in JIRA.
     -j, --jql <JQL>                   JQL Query or alias to JQL query to filter with.
     -l, --label <LABEL>...            Search for issues with a label or list of labels.
+    -o, --offset <OFFSET>             Offset to start the first item to return in a page of results. (Default is 0)
     -m, --main <PARENT>...            Search for subtask of a particular issue.
     -P, --priority <PRIORITY>...      Search for issues with a particular priority.
     -p, --project <PROJECT>...        Project Code to filter with.

README.md

@@ -84,7 +84,22 @@ fn form_jql(matches: &ArgMatches) -> String {
 
 pub fn list_issues(matches: &ArgMatches) {
     let jql = form_jql(matches);
-    let search_response = api::get_call_v3(format!("search?jql={}", jql));
+    let offset_result = matches.value_of("offset").unwrap_or("0").parse::<u32>();
+    if offset_result.is_err() {
+        eprintln!("Invalid option passed to offset. ");
+        std::process::exit(1);
+    }
+    let offset = offset_result.unwrap();
+    let count_result = matches.value_of("count").unwrap_or("50").parse::<u32>();
+    if count_result.is_err() {
+        eprintln!("Invalid option passed to count. ");
+        std::process::exit(1);
+    }
+    let count = count_result.unwrap();
+    let search_response = api::get_call_v3(format!(
+        "search?maxResults={}&startAt={}&jql={}",
+        count, offset, jql
+    ));
     if search_response.is_err() {
         eprintln!("Error occured when searching tickets. ");
         std::process::exit(1);

src/jira/lists.rs

@@ -38,7 +38,7 @@ pub fn subcommand() -> App<'static, 'static> {
                .short("d")
                .long("display")
                .long_help(" Comma separated list of fields to display.
-Possible options for fields are: 
+Possible options for fields are:
 key,resolution,priority,assignee,status,components,creator,reporter,issuetype,project,summary
 
 You can pass alias as option for display. You can save alias using alias subcommand for the application.
@@ -135,6 +135,20 @@ You can pass alias as option for display. You can save alias using alias subcomm
                .value_name("TEXT")
                .takes_value(true)
                )
+            .arg(Arg::with_name("count")
+               .help("Total number of issues to show. (Default is 50)")
+               .short("C")
+               .long("count")
+               .value_name("COUNT")
+               .takes_value(true)
+               )
+            .arg(Arg::with_name("offset")
+               .help("Offset to start the first item to return in a page of results. (Default is 0)")
+               .short("o")
+               .long("offset")
+               .value_name("OFFSET")
+               .takes_value(true)
+               )
             .arg(Arg::with_name("alias")
                .help("Save the applied options as an alias. You can use it with jql option later.")
                .short("A")
@@ -146,6 +160,6 @@ You can pass alias as option for display. You can save alias using alias subcomm
 assignee, component, epic, filter, label, main, priority, project, reporter, sprint, status, type.
 
 For example to fetch list of tickets in Backlog and In progress, you can use
-jira-terminal list -s Backlog -s 'In Progress' 
+jira-terminal list -s Backlog -s 'In Progress'
             ")
 }