Implement results issue command

Fetch KCIDB issue matching provided ID.
Also get associated builds and tests.
Sample command:
`kci-dev results issue --id <id> --origin <origin>`

Signed-off-by: Jeny Sadadia <[email protected]>

Author: Jeny Sadadia

kcidev/libs/dashboard.py

@@ -13,7 +13,9 @@
 
 def _dashboard_request(func):
     @wraps(func)
-    def wrapper(endpoint, params, use_json, body=None, max_retries=3):
+    def wrapper(
+        endpoint, params, use_json, body=None, max_retries=3, error_verbose=True
+    ):
         base_url = urllib.parse.urljoin(DASHBOARD_API, endpoint)
         url = "{}?{}".format(base_url, urllib.parse.urlencode(params))
         retries = 0
@@ -53,11 +55,12 @@ def wrapper(endpoint, params, use_json, body=None, max_retries=3):
                 logging.debug(f"Response data size: {len(json.dumps(data))} bytes")
 
                 if "error" in data:
-                    logging.error(f"API returned error: {data.get('error')}")
-                    if use_json:
-                        kci_msg(data)
-                    else:
-                        kci_msg("json error: " + str(data["error"]))
+                    if error_verbose:
+                        logging.error(f"API returned error: {data.get('error')}")
+                        if use_json:
+                            kci_msg(data)
+                        else:
+                            kci_msg("json error: " + str(data["error"]))
                     raise click.ClickException(data.get("error"))
 
                 logging.info(f"Successfully completed {func.__name__} request")
@@ -81,7 +84,7 @@ def dashboard_api_post(endpoint, params, use_json, body, max_retries=3):
 
 
 @_dashboard_request
-def dashboard_api_fetch(endpoint, params, use_json, max_retries=3):
+def dashboard_api_fetch(endpoint, params, use_json, max_retries=3, error_verbose=True):
     return requests.get(endpoint)
 
 
@@ -308,16 +311,20 @@ def dashboard_fetch_issue(issue_id, use_json):
     return dashboard_api_fetch(f"issue/{issue_id}", {}, use_json)
 
 
-def dashboard_fetch_issue_builds(origin, issue_id, use_json):
+def dashboard_fetch_issue_builds(origin, issue_id, use_json, error_verbose=True):
     logging.info(f"Fetching builds for issue ID: {issue_id}")
-    params = {"filter_origin": origin}
-    return dashboard_api_fetch(f"issue/{issue_id}/builds", params, use_json)
+    params = {"filter_origin": origin} if origin else {}
+    return dashboard_api_fetch(
+        f"issue/{issue_id}/builds", params, use_json, error_verbose=error_verbose
+    )
 
 
-def dashboard_fetch_issue_tests(origin, issue_id, use_json):
+def dashboard_fetch_issue_tests(origin, issue_id, use_json, error_verbose=True):
     logging.info(f"Fetching tests for issue ID: {issue_id}")
-    params = {"filter_origin": origin}
-    return dashboard_api_fetch(f"issue/{issue_id}/tests", params, use_json)
+    params = {"filter_origin": origin} if origin else {}
+    return dashboard_api_fetch(
+        f"issue/{issue_id}/tests", params, use_json, error_verbose=error_verbose
+    )
 
 
 def dashboard_fetch_issues_extra(issues, use_json):

kcidev/subcommands/results/__init__.py

@@ -6,14 +6,17 @@
 import click
 from tabulate import tabulate
 
-from kcidev.libs.common import kci_msg_green, kci_msg_red
+from kcidev.libs.common import kci_msg, kci_msg_green, kci_msg_red
 from kcidev.libs.dashboard import (
     dashboard_fetch_boot_issues,
     dashboard_fetch_boots,
     dashboard_fetch_build,
     dashboard_fetch_build_issues,
     dashboard_fetch_builds,
     dashboard_fetch_commits_history,
+    dashboard_fetch_issue,
+    dashboard_fetch_issue_builds,
+    dashboard_fetch_issue_tests,
     dashboard_fetch_issues_extra,
     dashboard_fetch_summary,
     dashboard_fetch_test,
@@ -36,6 +39,8 @@
     cmd_single_test,
     cmd_summary,
     cmd_tests,
+    print_issue,
+    print_issues,
 )
 
 
@@ -677,5 +682,55 @@ def detect(
             print_stats(stats, headers, max_col_width, table_fmt)
 
 
+@results.command(
+    name="issue",
+    help="""Fetch KCIDB issue matching provided ID.
+Also get associated builds and tests.
+
+\b
+Examples:
+  # Get issue information and associated builds/tests
+  kci-dev results issue --id <id> --origin <origin>
+""",
+)
+@click.option(
+    "--id",
+    "issue_id",
+    required=True,
+    help="Issue ID to get information for",
+)
+@click.option(
+    "--origin",
+    help="Select KCIDB origin",
+)
+@results_display_options
+def issue(issue_id, origin, use_json):
+    """Get issue matching ID command handler"""
+    # Get issue information
+    data = dashboard_fetch_issue(issue_id, use_json)
+    kci_msg_green("Issue information:")
+    print_issue(data)
+
+    # Get associated builds and tests
+    item_types = ["builds", "tests"]
+    for item_type in item_types:
+        if item_type == "builds":
+            dashboard_func = dashboard_fetch_issue_builds
+        else:
+            dashboard_func = dashboard_fetch_issue_tests
+
+        try:
+            kci_msg_green(f"Associated {item_type}:")
+            data = dashboard_func(origin, issue_id, use_json, error_verbose=False)
+            item_ids = [item["id"] for item in data]
+            for item_id in item_ids:
+                kci_msg(f"- {item_id}")
+            kci_msg("")
+        except click.ClickException as e:
+            if f"No {item_type}" in e.message:
+                kci_msg(f"No associated {item_type} found")
+                kci_msg("")
+
+
 if __name__ == "__main__":
     main_kcidev()

kcidev/subcommands/results/parser.py

@@ -2,12 +2,13 @@
 import json
 import logging
 import re
+from urllib.parse import urlparse
 
 import requests
 import yaml
 
 from kcidev.libs.common import *
-from kcidev.libs.dashboard import dashboard_fetch_tree_list
+from kcidev.libs.dashboard import DASHBOARD_API, dashboard_fetch_tree_list
 from kcidev.libs.files import download_logs_to_file
 from kcidev.libs.filters import (
     CompatibleFilter,
@@ -937,3 +938,51 @@ def format_item_json(regression):
 
         if total_regressions == 0:
             kci_msg("✅ No regressions found - all status changes are expected")
+
+
+def print_issue_information(issue, dashboard_url):
+    """Extract and print issue information"""
+
+    if not isinstance(issue, dict):
+        kci_err("Please provide issue dictionary to extract information")
+        return
+
+    kci_msg_bold(f"- {issue.get('comment')}")
+    kci_msg(f"  {dashboard_url}/issue/{issue.get('id')}]")
+    kci_msg(f"  origin: {issue.get('origin')}")
+    kci_msg(f"  version: {issue.get('version')}")
+    kci_msg(f"  field_timestamp: {issue.get('field_timestamp')}")
+
+    for field in ["culprit_code", "culprit_tool", "culprit_harness"]:
+        if not issue.get(field):
+            continue
+        if issue[field]:
+            kci_msg_nonl(f"  {field}: ")
+            kci_msg_red(issue[field])
+        else:
+            kci_msg(f"  {field}: {issue[field]}")
+
+    if issue.get("categories"):
+        kci_msg_nonl("  categories:")
+        kci_msg(issue["categories"])
+
+
+def print_issue(issue):
+    """Print issue information
+    issue (dict): KCIDB issue dictionary"""
+
+    parsed = urlparse(DASHBOARD_API)
+    dashboard_url = f"{parsed.scheme}://{parsed.netloc}"
+
+    print_issue_information(issue, dashboard_url)
+
+    extra = issue.get("extra")
+    if extra.get(issue["id"]):
+        incident = extra.get(issue["id"]).get("first_incident")
+        if incident:
+            tree_branch = (
+                f'{incident.get("tree_name")}/{incident.get("git_repository_branch")}'
+            )
+            kci_msg_nonl("  First incident seen on ")
+            kci_msg_bold(tree_branch)
+    kci_msg("")