holado 0.13.22__py3-none-any.whl

holado_report/report/builders/summary_scenario_report_builder.py

@@ -0,0 +1,81 @@
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+import logging
+from holado_report.report.builders.report_builder import ReportBuilder
+from holado_report.report.report_manager import ReportManager
+from holado_python.common.tools.datetime import FORMAT_DATETIME_ISO, DateTime
+from holado_system.system.filesystem.file import File
+from holado_core.common.exceptions.technical_exception import TechnicalException
+
+logger = logging.getLogger(__name__)
+
+
+
+class SummaryScenarioReportBuilder(ReportBuilder):
+    def __init__(self, filepath, file_format='txt', exclude_statuses=None, exclude_categories=None, with_scenario_end_date=True, with_scenario_period=False, with_step_period=False, use_compact_format=True):
+        self.__file_format = file_format.lower()
+        self.__exclude_statuses = exclude_statuses
+        self.__exclude_categories = exclude_categories
+        self.__with_scenario_end_date = with_scenario_end_date
+        self.__with_scenario_period = with_scenario_period
+        self.__with_step_period = with_step_period
+        self.__use_compact_format = use_compact_format
+        
+        if self.__file_format == 'txt':
+            self.__file = File(filepath, mode='wt')
+        else:
+            raise TechnicalException(f"Unmanaged format '{self.__file_format}' (possible formats: 'txt')")
+        
+    def build(self):
+        '''
+        The file is built after each scenario
+        '''
+        pass
+        
+    def after_scenario(self, scenario, scenario_report=None):
+        category_validation, status_validation, step_failed, step_number, scenario_context, step_context = ReportManager.get_current_scenario_status_information(scenario)
+        
+        # Manage excluded scenario on status
+        if self.__exclude_statuses and status_validation in self.__exclude_statuses:
+            return
+        
+        self.__file_add_scenario(scenario, category_validation, status_validation, step_failed, step_number, scenario_context, step_context)
+            
+    def after_all(self):
+        self.__file.close()
+        
+    def __file_add_scenario(self, scenario, category_validation, status_validation, step_failed, step_number, scenario_context, step_context):
+        self.__open_file_if_needed()
+        
+        # Manage excluded scenario on category
+        if category_validation:
+            ind = category_validation.find(' (')
+            category = category_validation[:ind] if ind > 0 else category_validation
+            if self.__exclude_categories and category in self.__exclude_categories:
+                return
+        
+        category_str = f" => {category_validation}" if category_validation else ""
+        scenario_prefix_str = f"{ReportManager.format_context_period(scenario_context)} " if self.__with_scenario_period \
+                              else f"{DateTime.datetime_2_str(scenario_context.end_datetime, FORMAT_DATETIME_ISO)} - " if self.__with_scenario_end_date else ""
+        if step_failed:
+            step_format_kwargs = {'step_context': step_context if self.__with_step_period else None,
+                                  'dt_ref': scenario_context.start_datetime if self.__use_compact_format else None}
+            self.__file.write(f"{scenario_prefix_str}{ReportManager.format_scenario_short_description(scenario)} - {ReportManager.format_step_short_description(step_failed, step_number, has_failed=True, **step_format_kwargs)} - {status_validation}{category_str}\n")
+        else:
+            self.__file.write(f"{scenario_prefix_str}{ReportManager.format_scenario_short_description(scenario)} - {status_validation}{category_str}\n")
+    
+    def __open_file_if_needed(self):
+        if not self.__file.is_open:
+            self.__file.open()
+    

holado_report/report/execution_historic.py

@@ -0,0 +1,144 @@
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+import logging
+from holado_core.common.exceptions.technical_exception import TechnicalException
+from typing import NamedTuple
+from holado.common.context.session_context import SessionContext
+
+logger = logging.getLogger(__name__)
+
+
+
+class ExecutionHistoric():
+    def __init__(self):
+        self.__execution_historic = []
+    
+    def __iter__(self):
+        return self.__execution_historic.__iter__()
+
+    def __next__(self):
+        return self.__execution_historic.__next__()
+
+    def __has_scenario_context(self):
+        return SessionContext.instance().has_scenario_context()
+    
+    @property
+    def __multitask_manager(self):
+        return SessionContext.instance().multitask_manager
+    
+    def before_all(self):
+        pass
+    
+    def before_feature(self, feature_context, feature, feature_report=None):
+        self.__execution_historic.append( self.__new_FeatureExecutionHistoric(feature_context, feature, feature_report) )
+    
+    def __new_FeatureExecutionHistoric(self, feature_context, feature, feature_report=None):
+        res = NamedTuple("FeatureExecutionHistoric", feature_context=object, feature=object, feature_report=object, scenarios=list)
+        res.feature_context = feature_context
+        res.feature = feature
+        res.feature_report = feature_report
+        res.scenarios = []
+        return res
+    
+    def before_scenario(self, scenario_context, scenario, scenario_report=None):
+        seh = self.__new_ScenarioExecutionHistoric(scenario_context, scenario, scenario_report)
+        self.__get_execution_historic_current_feature_scenarios().append(seh)
+    
+    def __new_ScenarioExecutionHistoric(self, scenario_context, scenario, scenario_report):
+        res = NamedTuple("ScenarioExecutionHistoric", scenario_context=object, scenario=object, scenario_report=object, steps_by_scope=dict, 
+                         category_validation=str, status_validation=str, step_failed=object, step_failed_number=int)
+        res.scenario_context = scenario_context
+        res.scenario = scenario
+        res.scenario_report = scenario_report
+        res.steps_by_scope = {}
+        res.category_validation = None
+        res.status_validation = None
+        res.step_failed = None
+        res.step_failed_number = None
+        return res
+    
+    def before_step(self, step_context, step, step_level):
+        seh = self.__new_StepExecutionHistoric(step_context, step)
+        self.__get_execution_historic_current_scenario_steps(step_level).append(seh)
+    
+    def __new_StepExecutionHistoric(self, step_context, step, step_description=None):
+        if step_description is None and step is not None:
+            from holado_report.report.report_manager import ReportManager
+            step_description = ReportManager.get_step_description(step)
+        
+        res = NamedTuple("StepExecutionHistoric", step_context=object, step=object, step_description=str, sub_steps=list)
+        res.step_context = step_context
+        res.step = step
+        res.step_description = step_description
+        res.sub_steps = []
+        return res
+    
+    def after_step(self, step_context, step, step_level):
+        pass
+    
+    def after_scenario(self, scenario, scenario_report=None):
+        from holado_report.report.report_manager import ReportManager
+        category_validation, status_validation, step_failed, step_number, _, _ = ReportManager.get_current_scenario_status_information(scenario)
+        
+        # Update execution historic
+        current_scenario = self.__get_execution_historic_current_scenario()
+        current_scenario.category_validation = category_validation
+        current_scenario.status_validation = status_validation
+        current_scenario.step_failed = step_failed
+        current_scenario.step_failed_number = step_number
+        
+        # Prepare after scenario steps
+        seh = self.__new_StepExecutionHistoric(step_context=None, step=None, step_description="After scenario steps")
+        self.__get_execution_historic_current_scenario_steps(0).append(seh)
+        
+        
+    def after_feature(self, feature, feature_report=None):
+        pass
+    
+    def after_all(self):
+        # logger.info(f"++++++++++ Execution historic size: {len(self.__execution_historic)}")
+        pass
+        
+    def __get_execution_historic_current_feature_scenarios(self):
+        if len(self.__execution_historic) > 0:
+            return self.__execution_historic[-1].scenarios
+        else:
+            raise TechnicalException(f"No feature in execution historic")
+        
+    def __get_execution_historic_current_scenario(self):
+        scenario_list = self.__get_execution_historic_current_feature_scenarios()
+        if len(scenario_list) > 0:
+            return scenario_list[-1]
+        else:
+            raise TechnicalException(f"No scenario in current feature in execution historic")
+        
+    def __get_execution_historic_current_scenario_steps(self, step_level):
+        steps_by_scope = self.__get_execution_historic_current_scenario().steps_by_scope
+        
+        if self.__multitask_manager.is_main_thread:
+            scope_name = "main"
+        else:
+            scope_name = self.__multitask_manager.get_thread_id()
+        if scope_name not in steps_by_scope:
+            steps_by_scope[scope_name] = []
+        res = steps_by_scope[scope_name]
+        
+        for level in range(step_level):
+            if len(res) == 0:
+                logger.warning(f"Failed to get current scenario step list of level {step_level} (step list of level {level}: {res}) ; Add a fake step with description '[Missing step]'")
+                res.append( self.__new_StepExecutionHistoric(None, None, "[Missing step]") )
+            res = res[-1].sub_steps
+        return res
+    
+    

holado_report/report/report_manager.py

@@ -0,0 +1,424 @@
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+# The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.
+#################################################
+
+from holado.common.context.session_context import SessionContext
+from holado_core.common.tools.tools import Tools
+import logging
+from holado_report.report.reports.base_report import BaseReport
+from holado_scripting.common.tools.evaluate_parameters import EvaluateParameters
+from holado_python.common.tools.datetime import DateTime, FORMAT_DATETIME_ISO, FORMAT_TIME_ISO
+from holado.common.handlers.undefined import default_value, undefined_argument
+from holado.holado_config import Config
+# from holado_core.scenario.scenario_duration_manager import ScenarioDurationManager
+
+logger = logging.getLogger(__name__)
+
+
+
+
+class ReportManager(BaseReport):
+    """ Manage reports of current session
+    """
+    TFeatureReport = None
+    TStepTools = None
+    
+    _scenario_status_information_by_uid = {}
+    
+    def __init__(self):
+        super().__init__()
+        
+        self.__multitask_manager = None
+        
+        # Auto configuration
+        self.configure()
+    
+    def configure(self):
+        from holado_report.report.reports.feature_report import FeatureReport
+        ReportManager.TFeatureReport = FeatureReport
+        
+        from holado_test.behave.scenario.behave_step_tools import BehaveStepTools
+        ReportManager.TStepTools = BehaveStepTools
+    
+    def initialize(self, multitask_manager):
+        self.__multitask_manager = multitask_manager
+        
+    def initialize_reports(self):
+        from holado_report.report.builders.detailed_scenario_report_builder import DetailedScenarioReportBuilder
+        from holado_report.report.builders.summary_report_builder import SummaryReportBuilder
+        from holado_report.report.builders.summary_scenario_report_builder import SummaryScenarioReportBuilder
+        from holado_report.report.builders.short_scenario_report_builder import ShortScenarioReportBuilder
+        from holado_report.report.builders.failure_report_builder import FailureReportBuilder
+        from holado_report.report.builders.summary_scenario_by_category_report_builder import SummaryScenarioByCategoryReportBuilder
+        from holado_report.report.builders.summary_by_category_report_builder import SummaryByCategoryReportBuilder
+        
+        # self.set_execution_historic()
+        
+        if self.has_report_path:
+            # fn = self.get_path("execution_historic.json")
+            # self.add_report_builder(ExecutionHistoricReportBuilder(self.execution_historic, fn))
+            
+            fn = self.get_path("report_summary_scenario_failed.txt")
+            self.add_report_builder(SummaryScenarioReportBuilder(fn, exclude_statuses=['Passed']))
+            
+            fn = self.get_path("report_summary_scenario_failed_by_category.txt")
+            self.add_report_builder(SummaryScenarioByCategoryReportBuilder(fn, exclude_categories=['Always Success']))
+            
+            fn = self.get_path("report_summary_scenario_all.txt")
+            self.add_report_builder(SummaryScenarioReportBuilder(fn))
+            
+            fn = self.get_path("report_failures.xml")
+            self.add_report_builder(FailureReportBuilder(fn))
+            
+            fn = self.get_path("report_short_scenario_failed.txt")
+            self.add_report_builder(ShortScenarioReportBuilder(fn, exclude_statuses=['Passed']))
+            
+            fn = self.get_path(Config.campaign_manager_import_report_name)  # @UndefinedVariable
+            self.add_report_builder(DetailedScenarioReportBuilder(fn))
+            
+            fn = self.get_path("report_summary.txt")
+            self.add_report_builder(SummaryReportBuilder(fn))
+        
+            fn = self.get_path("report_summary_by_category.txt")
+            self.add_report_builder(SummaryByCategoryReportBuilder(fn))
+        
+    @property
+    def __feature_reports(self):
+        return self.children_reports("feature")
+    
+    @property
+    def current_feature_report(self):
+        # if self.__feature_reports:
+        #     return self.__feature_reports[-1][1]
+        # else:
+        #     return None
+        if SessionContext.instance().has_feature_context():
+            feature_context = SessionContext.instance().get_feature_context()
+            if feature_context.has_object("feature_report"):
+                return feature_context.get_object("feature_report")
+        return None
+    
+    @property
+    def current_scenario_report(self):
+        cfr = self.current_feature_report
+        if cfr:
+            return cfr.current_scenario_report
+        else:
+            return None
+    
+    def new_session(self, report_path):
+        self.report_path = report_path
+        if self.has_report_path:
+            SessionContext.instance().path_manager.makedirs(self.report_path, is_directory=True)
+        
+        self.initialize_reports()
+    
+    def before_all(self):
+        super().before_all()
+    
+    def before_feature(self, feature_context, feature):
+        # Create new feature report
+        fr = ReportManager.TFeatureReport(self, feature_context, feature)
+        self.add_child_report(fr, "feature", feature.name, feature.filename)
+        fr.initialize_reports()
+        
+        # Process self reports
+        super().before_feature(feature_context, feature, feature_report=fr)
+        
+        # Store feature report in current feature context
+        self.__multitask_manager.get_feature_context().set_object("feature_report", fr)
+        
+    def before_scenario(self, scenario_context, scenario):
+        # Create new scenario report in feature report
+        sr = self.current_feature_report.new_scenario_report(scenario_context, scenario)
+        
+        # Process feature report
+        self.current_feature_report.before_scenario(scenario_context, scenario, scenario_report=sr)
+        
+        # Process self reports
+        super().before_scenario(scenario_context, scenario, scenario_report=sr)
+        
+        # Change active log file to scenario one
+        self.__enter_current_scenario_log_file()
+    
+    def before_step(self, step_context, step, step_level):
+        super().before_step(step_context, step, step_level)
+        
+        # Note: A step can be executed without scenario report (ex: post processes after scenario) 
+        if self.current_scenario_report:
+            self.current_scenario_report.before_step(step_context, step, step_level)
+    
+    def after_step(self, step_context, step, step_level):
+        super().after_step(step_context, step, step_level)
+        
+        # Note: A step can be executed without scenario report (ex: post processes after scenario) 
+        if self.current_scenario_report:
+            self.current_scenario_report.after_step(step_context, step, step_level)
+    
+    def after_scenario(self, scenario):
+        self.current_feature_report.after_scenario(scenario, self.current_scenario_report)
+        super().after_scenario(scenario, self.current_scenario_report)
+        
+        # Change active log file to root one
+        self.__leave_current_scenario_log_file()
+        
+        self.current_scenario_report.release_resources()
+    
+    def after_feature(self, feature):
+        super().after_feature(feature, self.current_feature_report)
+        
+        self.current_feature_report.release_resources()
+    
+    def after_all(self):
+        super().after_all(build_reports=True)
+            
+        # Create files using execution historic as input
+        # fn_eh = self.get_path("execution_historic.json")
+        # sdm = ScenarioDurationManager()
+        # sdm.import_execution_historic(fn_eh)
+        #
+        # fn = self.get_path("scenario_durations.csv")
+        # scenario_duration_limits = sdm.compute_scenario_duration_limits()
+        # sdm.create_file_scenario_duration_limits(fn, scenario_duration_limits)
+        #
+        # fn = self.get_path("scenario_duration_tags.csv")
+        # duration_limit_tags = [(1, "fast"), (5, "rapid"), (60, "slow")]
+        # scenario_duration_tags = sdm.compute_scenario_duration_tags(duration_limit_tags, "long", missing_tag=True, new_tag=True, unchanged_tag=True, with_failed=True)
+        # sdm.create_file_scenario_duration_tags(fn, scenario_duration_tags)
+        
+        # Update campaigns stored in test server
+        if self._get_test_server_client().is_available:
+            self._get_test_server_client().update_stored_campaigns()
+        
+    def __enter_current_scenario_log_file(self):
+        if SessionContext.instance().log_manager.in_file and self.has_report_path:
+            log_filename = self.current_scenario_report.get_path("logs", "report.log")
+            SessionContext.instance().path_manager.makedirs(log_filename)
+            # Note: do_remove_other_file_handlers is set to True, in case leaving previous scenario log file has failed.
+            #       Normally this case shouldn't appear but it was already observed. And when it appeared, execution slowdowned drastically.
+            SessionContext.instance().log_manager.enter_log_file(log_filename, do_remove_other_file_handlers=True)
+        
+    def __leave_current_scenario_log_file(self):
+        if SessionContext.instance().log_manager.in_file and self.has_report_path:
+            log_filename = self.current_scenario_report.get_path("logs", "report.log")
+            SessionContext.instance().log_manager.leave_log_file(log_filename, do_remove_log_file=True)
+    
+    @classmethod
+    def _get_test_server_client(cls):
+        return SessionContext.instance().test_server_client
+    
+    @classmethod
+    def _get_scenario_uid(cls, scenario):
+        return f"{scenario.filename} at l.{scenario.line}"
+    
+    @classmethod
+    def get_current_scenario_status_information(cls, scenario):
+        scenario_uid = cls._get_scenario_uid(scenario)
+        if scenario_uid not in cls._scenario_status_information_by_uid:
+            step_failed, step_nb = cls.get_step_failed_info(scenario)
+            
+            # Define scenario status
+            if step_failed is not None and hasattr(SessionContext.instance().get_scenario_context(), "is_in_preconditions") and SessionContext.instance().get_scenario_context().is_in_preconditions:
+                status = "Failed in Preconditions"
+            elif step_failed is not None and step_failed.keyword == "Given":
+                status = "Failed in Given"
+            elif step_failed is not None or scenario.status.has_failed():
+                status = "Failed"
+            else:
+                status = scenario.status.name.capitalize()
+            
+            # Define scenario category
+            category = None
+            if cls._get_test_server_client().is_available:
+                category = cls._compute_category_validation(scenario, status)
+            
+            cls._scenario_status_information_by_uid[scenario_uid] = [category, status, step_failed, step_nb, 
+                                                                     SessionContext.instance().get_scenario_context(),
+                                                                     SessionContext.instance().get_scenario_context().get_step(step_nb-1) if step_nb is not None else None]
+        
+        return cls._scenario_status_information_by_uid[scenario_uid]
+    
+    @classmethod
+    def _compute_category_validation(cls, scenario, status):
+        res = None
+        
+        # Get scenario execution statuses
+        scenario_name = cls.format_scenario_short_description(scenario)
+        sce_hist = cls._get_test_server_client().get_scenario_history(scenario_name=scenario_name, size=29)
+        statuses = [s['status'] for s in reversed(sce_hist[0]['statuses'])] if sce_hist else []
+        statuses.append(status)
+        
+        # Get scenario status sequences
+        passed_sequences = []
+        is_failed_relevant = None
+        for status in statuses:
+            if status == 'Passed':
+                passed = True
+            elif status.startswith("Failed"):
+                passed = False
+                if status == "Failed":
+                    is_failed_relevant = True
+                elif is_failed_relevant is None:
+                    is_failed_relevant = False
+            else:
+                continue
+            
+            if len(passed_sequences) == 0 or passed != passed_sequences[-1][0]:
+                passed_sequences.append([passed, 1])
+            else:
+                passed_sequences[-1][1] += 1
+        
+        # Compute category
+        if passed_sequences:
+            nb_exec = sum([x[1] for x in passed_sequences])
+            last_passed, last_nb_times = passed_sequences[-1]
+            if len(passed_sequences) == 1:
+                if last_passed:
+                    res = f'Always Success ({last_nb_times})'
+                elif is_failed_relevant:
+                    res = f'Always Failed ({last_nb_times})'
+                else:
+                    res = f'Always Not Relevant ({last_nb_times})'
+            elif last_passed and len(passed_sequences) in [2, 3]:
+                res = f'Fixed ({last_nb_times} success / {nb_exec})'
+            elif len(passed_sequences) > 2:
+                nb_fail = sum([x[1] for x in passed_sequences if not x[0]])
+                if is_failed_relevant:
+                    res = f'Random ({nb_fail} fails / {nb_exec})'
+                else:
+                    res = f'Random but Not Relevant ({nb_fail} fails / {nb_exec})'
+            elif not last_passed:
+                if is_failed_relevant:
+                    res = f'Regression ({last_nb_times} fails / {nb_exec})'
+                else:
+                    res = f'Regression but Not Relevant ({last_nb_times} fails / {nb_exec})'
+            else:
+                res = f'Unknown (unmanaged sequence: {passed_sequences})'
+        
+        logger.debug(f"Category of scenario '{scenario}': {res}  (computed from last statuses: {statuses})")
+        return res
+        
+    @classmethod
+    def get_step_failed_info(cls, scenario):
+        res_step, res_step_number = None, None
+        for ind, step in enumerate(scenario.steps):
+            if step.status.has_failed():
+                res_step, res_step_number = step, ind+1
+                break
+        return res_step, res_step_number
+    
+    @classmethod
+    def get_step_description(cls, step):
+        res = "{} {}".format(step.keyword, step.name)
+        text = cls.TStepTools.get_step_multiline_text(step, eval_params=EvaluateParameters.nothing(), raise_exception_if_none=False, log_level=logging.TRACE)  # @UndefinedVariable
+        if text is not None:
+            res += "\n\"\"\"\n{}\n\"\"\"".format(text) 
+        if step.table:
+            res += "\n{}".format(cls.TStepTools.represent_step_table(step.table, 4)) 
+        return res
+    
+    @classmethod
+    def get_step_error_message(cls, step):
+        if step:
+            if step.exception:
+                return str(step.exception)
+            elif step.error_message:
+                return step.error_message
+            elif step.status.is_undefined():
+                return "Undefined step"
+            elif step.status.is_pending():
+                return "Step exists but is not implemented"
+            elif step.status.has_failed():
+                return "Unknown error (unexpected error case)"
+        return None
+    
+    @classmethod
+    def get_step_error(cls, step):
+        if step:
+            if step.exception:
+                formatted_exception = Tools.represent_exception(step.exception)
+                return "exception:\n{}".format(Tools.indent_string(4, formatted_exception))
+            elif step.error_message:
+                return "error_message:\n{}".format(Tools.indent_string(4, step.error_message))
+            else:
+                return cls.get_step_error_message(step)
+        return None
+    
+    @classmethod
+    def format_context_period(cls, context, format_precision_nsec=None, dt_ref=None, use_compact_format=default_value):
+        dt_start, dt_end = context.start_datetime, context.end_datetime
+        
+        # Prepare format of start datetime
+        if format_precision_nsec is not None:
+            dt_start = DateTime.truncate_datetime(dt_start, precision_nanoseconds=format_precision_nsec)
+        dt_format_start = cls._get_datetime_format_compared_to_reference(dt_start, dt_ref, use_compact_format=use_compact_format)
+        
+        # Prepare format of end datetime
+        if dt_end is not None:
+            if format_precision_nsec is not None:
+                dt_end = DateTime.truncate_datetime(dt_end, precision_nanoseconds=format_precision_nsec)
+            dt_format_end = cls._get_datetime_format_compared_to_reference(dt_end, dt_start, use_compact_format=use_compact_format)
+            if len(dt_format_end) > len(dt_format_start):
+                dt_format_start = dt_format_end
+        else:
+            dt_format_end = None
+        
+        # Format datetimes
+        start_txt = DateTime.datetime_2_str(dt_start, dt_format=dt_format_start)
+        end_txt = DateTime.datetime_2_str(dt_end, dt_format=dt_format_end) if dt_end is not None else ''
+        
+        # Truncate formatted datetimes if needed
+        if format_precision_nsec is not None:
+            trunc_len = len(f'{int(format_precision_nsec)}') - 4
+            if trunc_len > 0:
+                start_txt = start_txt[:-trunc_len-1]+'Z' if start_txt.endswith('Z') else start_txt[:-trunc_len]
+                if len(end_txt) > 0:
+                    end_txt = end_txt[:-trunc_len-1]+'Z' if end_txt.endswith('Z') else end_txt[:-trunc_len]
+        
+        return f"[{start_txt} - {end_txt}]"
+    
+    @classmethod
+    def _get_datetime_format_compared_to_reference(cls, dt, dt_ref=None, use_compact_format=default_value):
+        if use_compact_format is default_value:
+            use_compact_format = Config.report_compact_datetime_period  # @UndefinedVariable
+        
+        if dt_ref is None:
+            return FORMAT_DATETIME_ISO
+        
+        if not use_compact_format or dt.date() != dt_ref.date():
+            return FORMAT_DATETIME_ISO
+        elif dt.hour != dt_ref.hour:
+            return FORMAT_TIME_ISO
+        elif dt.minute != dt_ref.minute:
+            return '%M:%S.%f'
+        elif dt.second != dt_ref.second:
+            return '%S.%f'
+        else:
+            return '.%f'
+    
+    @classmethod
+    def format_scenario_short_description(cls, scenario):
+        return f"{scenario.filename} at l.{scenario.line}"
+    
+    @classmethod
+    def format_step_short_description(cls, step, step_number, step_context=None, dt_ref=None, has_failed=undefined_argument):
+        if step:
+            if step_context and step_context.start_datetime is not None:
+                return f"step {step_number} (l.{step.line} on {cls.format_context_period(step_context, dt_ref=dt_ref)})"
+            else:
+                return f"step {step_number} (l.{step.line})"
+        elif has_failed is not undefined_argument and has_failed:
+            return "step ? (missing step implementation ?)"
+        else:
+            return None
+            
+