Introduce plist.err and parse --status

Currently, it is a problem to determine if the analysis
was successful or failed during execution.

With this patch, we will create plist.err files to
indicate a failed analysis action.
The parse --status command was also introduced to
get the analysis summary of an existing report directory.

Author: barnabasdomozi

analyzer/codechecker_analyzer/analyzers/clangsa/result_handler.py

@@ -14,7 +14,7 @@
 from typing import Optional
 
 from codechecker_report_converter.report.parser.base import AnalyzerInfo
-from codechecker_report_converter.report import report_file
+from codechecker_report_converter.report import report_file, error_file
 from codechecker_report_converter.report.hash import get_report_hash, HashType
 from codechecker_common.logger import get_logger
 from codechecker_common.skiplist_handler import SkipListHandlers
@@ -43,6 +43,11 @@ def postprocess_result(
         Generate analyzer result output file which can be parsed and stored
         into the database.
         """
+        error_file.create(
+            self.analyzer_result_file, self.analyzer_returncode,
+            self.analyzer_info, self.analyzer_cmd,
+            self.analyzer_stdout, self.analyzer_stderr)
+
         if os.path.exists(self.analyzer_result_file):
             reports = report_file.get_reports(
                 self.analyzer_result_file, self.checker_labels,
@@ -66,3 +71,4 @@ def postprocess_result(
             report_file.create(
                 self.analyzer_result_file, reports, self.checker_labels,
                 self.analyzer_info)
+

analyzer/codechecker_analyzer/analyzers/clangtidy/result_handler.py

@@ -15,7 +15,7 @@
     AnalyzerResult
 from codechecker_report_converter.analyzers.clang_tidy.parser import Parser
 from codechecker_report_converter.report.parser.base import AnalyzerInfo
-from codechecker_report_converter.report import report_file
+from codechecker_report_converter.report import report_file, error_file
 from codechecker_report_converter.report.hash import get_report_hash, HashType
 
 from codechecker_common.logger import get_logger
@@ -76,3 +76,8 @@ def postprocess_result(
         report_file.create(
             self.analyzer_result_file, reports, self.checker_labels,
             self.analyzer_info)
+
+        error_file.create(
+            self.analyzer_result_file, self.analyzer_returncode,
+            self.analyzer_info, self.analyzer_cmd,
+            self.analyzer_stdout, self.analyzer_stderr)

analyzer/codechecker_analyzer/analyzers/gcc/result_handler.py

@@ -118,3 +118,4 @@ def postprocess_result(
         report_file.create(
             self.analyzer_result_file, reports, self.checker_labels,
             self.analyzer_info)
+

analyzer/codechecker_analyzer/cli/parse.py

@@ -14,6 +14,7 @@
 import argparse
 import os
 import sys
+import re
 from typing import Dict, Optional, Set
 import fnmatch
 
@@ -208,6 +209,14 @@ def add_arguments_to_parser(parser):
                         help="Filter results by review statuses. Valid "
                              f"values are: {', '.join(REVIEW_STATUS_VALUES)}")
 
+    parser.add_argument('--status',
+                        dest="status",
+                        action="store_true",
+                        required=False,
+                        default=argparse.SUPPRESS,
+                        help="Print the number of successful and failed "
+                             "analysis actions.")
+
     group = parser.add_argument_group("file filter arguments")
 
     group.add_argument('-i', '--ignore', '--skip',
@@ -263,6 +272,51 @@ def get_metadata(dir_path: str) -> Optional[Dict]:
     return None
 
 
+def print_status(inputs):
+    if len(inputs) != 1:
+        LOG.error("Parse status can only be printed "
+                  "for one directory.")
+        sys.exit(1)
+
+    report_dir = inputs[0]
+
+    if not os.path.isdir(report_dir):
+        LOG.error("Input path '%s' is not a directory.",
+                  report_dir)
+        sys.exit(1)
+
+    analyzers = ["clangsa", "clang-tidy"]
+    successful = {}
+    failed = {}
+
+    report_dir_files = {os.fsdecode(e) for e in
+            os.listdir(os.fsencode(report_dir))}
+
+    for analyzer in analyzers:
+        plist_re = re.compile(f'.*_{analyzer}_[0-9a-f]+\.plist$')
+        plist_err_re = re.compile(f'.*_{analyzer}_[0-9a-f]+\.plist\.err$')
+        successful[analyzer] = 0
+        failed[analyzer] = 0
+
+        for file in report_dir_files:
+            if (plist_re.match(file)
+                and not f"{file}.err" in report_dir_files):
+                successful[analyzer] += 1
+
+            if plist_err_re.match(file):
+                failed[analyzer] += 1
+
+    LOG.info("----==== Summary ====----")
+    LOG.info("Successfully analyzed")
+    for analyzer in analyzers:
+        LOG.info("  %s: %s", analyzer, successful[analyzer])
+
+    LOG.info("Failed to analyze")
+    for analyzer in analyzers:
+        LOG.info("  %s: %s", analyzer, failed[analyzer])
+    LOG.info("----=================----")
+
+
 def main(args):
     """
     Entry point for parsing some analysis results and printing them to the
@@ -311,6 +365,10 @@ def main(args):
     if isinstance(args.input, str):
         args.input = [args.input]
 
+    if args.status:
+        print_status(args.input)
+        return
+
     src_comment_status_filter = args.review_status
 
     suppr_handler = None

tools/report-converter/codechecker_report_converter/report/error_file.py

@@ -0,0 +1,26 @@
+# -------------------------------------------------------------------------
+#
+#  Part of the CodeChecker project, under the Apache License v2.0 with
+#  LLVM Exceptions. See LICENSE for license information.
+#  SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
+#
+# -------------------------------------------------------------------------
+
+from codechecker_report_converter.report.parser import plist
+
+def create(output_path, return_code, analyzer_info,
+           analyzer_cmd, stdout, stderr):
+    if return_code == 0:
+        return
+
+    parser = plist.Parser()
+
+    data = {
+        'analyzer_info': analyzer_info,
+        'analyzer_cmd': analyzer_cmd,
+        'return_code': return_code,
+        'stdout': stdout,
+        'stderr': stderr
+    }
+
+    parser.write(data, output_path + ".err")