Merge branch 'master' into feat/time-profiler

Author: Vasileios Karakasis

docs/config_reference.rst

@@ -1295,11 +1295,10 @@ The options of an execution mode will be passed to ReFrame as if they were speci
    :required: No
    :default: ``["*"]``
 
-   A list of systems or system/partitions combinations that this execution mode is valid for.
+   A list of systems *only* that this execution mode is valid for.
    For a detailed description of this property, you may refer `here <#.environments[].target_systems>`__.
 
 
-
 General Configuration
 ---------------------
 
@@ -1356,6 +1355,17 @@ General Configuration
    .. versionadded:: 3.9.0
 
 
+.. js:attribute:: .general[].compress_report
+
+   :required: No
+   :default: ``false``
+
+   Compress the generated run report file.
+   See the documentation of the :option:`--compress-report` option for more information.
+
+   .. versionadded:: 3.12.0
+
+
 .. js:attribute:: .general[].git_timeout
 
   :required: No

docs/manpage.rst

@@ -263,6 +263,16 @@ If more than one action options are specified, the precedence order is the follo
 Options controlling ReFrame output
 ----------------------------------
 
+.. option:: --compress-report
+
+   Compress the generated run report (see :option:`--report-file`).
+   The generated report is a JSON file formatted in a human readable form.
+   If this option is enabled, the generated JSON file will be a single stream of text without additional spaces or new lines.
+
+   This option can also be set using the :envvar:`RFM_COMPRESS_REPORT` environment variable or the :js:attr:`compress_report` general configuration parameter.
+
+   .. versionadded:: 3.12.0
+
 .. option:: --dont-restage
 
    Do not restage a test if its stage directory exists.
@@ -1110,6 +1120,20 @@ Here is an alphabetical list of the environment variables recognized by ReFrame:
    .. versionadded:: 3.9.0
 
 
+.. envvar:: RFM_COMPRESS_REPORT
+
+   Compress the generated run report file.
+
+   .. table::
+      :align: left
+
+      ================================== ==================
+      Associated command line option     :option:`--compress-report`
+      Associated configuration parameter :js:attr:`compress_report` general configuration parameter
+      ================================== ==================
+
+   .. versionadded:: 3.12.0
+
 .. envvar:: RFM_CONFIG_FILE
 
    Set the configuration file for ReFrame.

reframe/frontend/cli.py

@@ -213,6 +213,11 @@ def main():
     misc_options = argparser.add_argument_group('Miscellaneous options')
 
     # Output directory options
+    output_options.add_argument(
+        '--compress-report', action='store_true',
+        help='Compress the run report file',
+        envvar='RFM_COMPRESS_REPORT', configvar='general/compress_report'
+    )
     output_options.add_argument(
         '--dont-restage', action='store_false', dest='clean_stagedir',
         help='Reuse the test stage directory',
@@ -1323,8 +1328,11 @@ def module_unuse(*paths):
             report_file = runreport.next_report_filename(report_file)
             try:
                 with open(report_file, 'w') as fp:
-                    jsonext.dump(json_report, fp, indent=2)
-                    fp.write('\n')
+                    if rt.get_option('general/0/compress_report'):
+                        jsonext.dump(json_report, fp)
+                    else:
+                        jsonext.dump(json_report, fp, indent=2)
+                        fp.write('\n')
 
                 printer.info(f'Run report saved in {report_file!r}')
             except OSError as e:

reframe/frontend/executors/__init__.py

@@ -111,7 +111,7 @@ def generate_testcases(checks, prepare=False):
     '''Generate concrete test cases from checks.
 
     If `prepare` is true then each of the cases will also be prepared for
-    being sent to the test pipeline. Note that setting this true may slow down
+    being sent to the test pipeline. Note that setting this to true may slow down
     the test case generation.
 
     '''

reframe/frontend/runreport.py

@@ -18,7 +18,7 @@
 # The schema data version
 # Major version bumps are expected to break the validation of previous schemas
 
-DATA_VERSION = '2.1'
+DATA_VERSION = '2.2'
 _SCHEMA = os.path.join(rfm.INSTALL_PREFIX, 'reframe/schemas/runreport.json')
 
 

reframe/frontend/statistics.py

@@ -191,6 +191,22 @@ def json(self, force=False):
                             'value': val
                         })
 
+                # Add any loggable variables and parameters
+                entry['check_vars'] = {}
+                test_cls = type(check)
+                for name, var in test_cls.var_space.items():
+                    if var.is_loggable():
+                        try:
+                            entry['check_vars'][name] = getattr(check, name)
+                        except AttributeError:
+                            entry['check_vars'][name] = '<undefined>'
+
+                entry['check_params'] = {}
+                test_cls = type(check)
+                for name, param in test_cls.param_space.items():
+                    if param.is_loggable():
+                        entry['check_params'][name] = getattr(check, name)
+
                 testcases.append(entry)
 
             self._run_data.append({

reframe/schemas/config.json

@@ -466,6 +466,7 @@
                     "clean_stagedir": {"type": "boolean"},
                     "colorize": {"type": "boolean"},
                     "compact_test_names": {"type": "boolean"},
+                    "compress_report": {"type": "boolean"},
                     "git_timeout": {"type": "number"},
                     "ignore_check_conflicts": {"type": "boolean"},
                     "keep_stage_files": {"type": "boolean"},
@@ -519,6 +520,7 @@
         "general/clean_stagedir": true,
         "general/colorize": true,
         "general/compact_test_names": false,
+        "general/compress_report": false,
         "general/git_timeout": 5,
         "general/ignore_check_conflicts": false,
         "general/keep_stage_files": false,

reframe/schemas/runreport.json

@@ -8,6 +8,8 @@
             "properties": {
                 "build_stderr": {"type": ["string", "null"]},
                 "build_stdout": {"type": ["string", "null"]},
+                "check_params": {"type": "object"},
+                "check_vars": {"type": "object"},
                 "dependencies_actual": {
                     "type": "array",
                     "items": {

unittests/resources/checks/frontend_checks.py

@@ -23,6 +23,15 @@ class BaseFrontendCheck(rfm.RunOnlyRegressionTest):
     executable = 'echo hello && echo perf: 10 Gflop/s'
     local = True
 
+    # Add two required variables that may affect the final run report
+    x = variable(int)
+    xlog = variable(int, loggable=True)
+
+    @run_after('setup')
+    def setx(self):
+        self.x = 1
+        self.xlog = 1
+
     @sanity_function
     def validate_output(self):
         return sn.assert_found('hello', self.stdout)

unittests/test_schedulers.py

@@ -616,6 +616,7 @@ def _read_pid(job, attempts=3):
                 f'{attempts} attempts')
 
 
+@pytest.mark.flaky(reruns=3)
 def test_cancel_with_grace(minimal_job, scheduler, local_only):
     # This test emulates a spawned process that ignores the SIGTERM signal
     # and also spawns another process: