Add -t/--interval CLI argument

The -t/--interval argument specifies the number of seconds to wait
between two requests when displaying job console output in interactive
mode.

Author: radomirbosak

jenkins_cli/__init__.py

@@ -3,7 +3,7 @@
 import argparse
 from jenkins import JenkinsException
 
-from jenkins_cli.cli import JenkinsCli, CliException, get_jobs_legend
+from jenkins_cli.cli import JenkinsCli, CliException, get_jobs_legend, check_nonnegative
 from jenkins_cli.version import version
 
 
@@ -53,6 +53,7 @@ def main():
     console_parser.add_argument('-b', '--build', help='job build number to show console for (if omitted, last build number is used)', default='')
     console_parser.add_argument('-n', help='show first n lines only(if n is negative, show last n lines)', type=int)
     console_parser.add_argument('-i', help='interactive console', default=False, action='store_true')
+    console_parser.add_argument('-t', '--interval', help='refresh interval in seconds (in case of interactive console -i)', default=3, type=check_nonnegative)
 
     console_parser = subparsers.add_parser('changes', help="Show build's changes")
     console_parser.add_argument('job_name', help='Job to show changes for')

jenkins_cli/cli.py

@@ -3,6 +3,7 @@
 import sys
 import datetime
 from time import time, sleep
+import argparse
 import jenkins
 import socket
 from xml.etree import ElementTree
@@ -71,6 +72,22 @@ def xml_to_string(root):
     return ElementTree.tostring(root, encoding=('unicode' if sys.version_info[0] == 3 else None))
 
 
+def check_nonnegative(value):
+    """
+    Checks if (possibly string) value is non-negative integer and returns it.
+
+    Raise:
+        ArgumentTypeError: if value is not a non-negative integer
+    """
+    try:
+        ivalue = int(value)
+        if ivalue < 0:
+            raise ValueError()
+    except:
+        raise argparse.ArgumentTypeError("Value must be a non-negative integer: %s" % value)
+    return ivalue
+
+
 class CliException(Exception):
     pass
 
@@ -308,7 +325,7 @@ def console(self, args):
                     if new_line_num > last_line_num:
                         print("\n".join(console_out[last_line_num:]))
                         last_line_num = new_line_num
-                    sleep(3)
+                    sleep(args.interval)
                     build_info = self.jenkins.get_build_info(job_name, build_number)
 
     def building(self, args):