Job ID: utility/command to find job results by ID

Simple contrib script to find the Job results directory of a given Job
identified by the Job (partial) ID.

Reference: https://trello.com/c/vrp2F5n4
Signed-off-by: Amador Pahim <[email protected]>

contrib/scripts/avocado-get-job-results-dir.py

@@ -0,0 +1,52 @@
+#!/usr/bin/env python
+
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; specifically version 2 of the License.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+#
+# See LICENSE for more details.
+#
+# Copyright: Red Hat Inc. 2016
+# Author: Amador Pahim <[email protected]>
+
+#
+# Simple script that, given the Job (partial) ID, returns the job
+# results directory.
+#
+# $ python avocado-get-job-results-dir.py <job_id>
+#
+
+import sys
+
+from avocado.core import jobdata
+from avocado.core.settings import settings
+
+if __name__ == '__main__':
+    if len(sys.argv) < 2:
+        sys.stderr.write("Please inform the Job ID.\n")
+        sys.exit(-1)
+
+    logdir = settings.get_value(section='datadir.paths',
+                                key='logs_dir', key_type='path',
+                                default=None)
+
+    if logdir is None:
+        sys.sterr.write("Log directory not configured in Avocado settings.\n")
+        sys.exit(-1)
+
+    try:
+        resultsdir = jobdata.get_resultsdir(logdir, sys.argv[1])
+    except ValueError as exception:
+        sys.stderr.write('%s\n' % exception.message)
+        sys.exit(-1)
+    else:
+        if resultsdir is None:
+            sys.stderr.write("Can't find job results directory in '%s'\n" %
+                             logdir)
+            sys.exit(-1)
+
+        sys.stdout.write('%s\n' % resultsdir)