holado 0.13.22__py3-none-any.whl

holado_report/report/builders/failure_report_builder.py

@@ -0,0 +1,150 @@
+
+#################################################
+# 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_core.common.tools.tools import Tools
+from holado_core.common.exceptions.technical_exception import TechnicalException
+import json
+from holado_system.system.filesystem.file import File
+from holado_xml.xml.xml_file import XMLFile
+
+logger = logging.getLogger(__name__)
+
+
+
+class FailureReportBuilder(ReportBuilder):
+    """Failure report builder
+    Supported formats: 'txt', 'json', 'xml'
+    """
+    def __init__(self, filepath, file_format='xml', sort_by_nb_scenario=True, exclude_statuses=None, exclude_categories=None):
+        self.__file_format = file_format.lower()
+        self.__sort_by_nb_scenario = sort_by_nb_scenario
+        self.__exclude_statuses = exclude_statuses
+        self.__exclude_categories = exclude_categories
+        
+        if self.__file_format in ['txt', 'json']:
+            self.__file = File(filepath, mode='wt')
+        elif self.__file_format == 'xml':
+            self.__file = XMLFile(filepath, mode='wt')
+        else:
+            raise TechnicalException(f"Unmanaged format '{self.__file_format}' (possible formats: 'txt', 'json', 'xml')")
+        
+        self.__failures = {}
+        
+    def build(self):
+        '''
+        The file is built after each scenario
+        '''
+        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, scenario_context, step_context = ReportManager.get_current_scenario_status_information(scenario)
+        
+        # Manage excluded scenarios
+        if self.__exclude_statuses and status_validation in self.__exclude_statuses:
+            return
+        if category_validation is not None and self.__exclude_categories:
+            ind = category_validation.find(' (')
+            category = category_validation[:ind] if ind > 0 else category_validation
+            if category in self.__exclude_categories:
+                return
+        
+        self.__file_add_scenario(scenario, scenario_report, category_validation, status_validation, step_failed, step_number, scenario_context, step_context)
+    
+    def __file_add_scenario(self, scenario, scenario_report, category_validation, status_validation, step_failed, step_number, scenario_context, step_context):
+        if status_validation != "Passed" and step_failed is not None:
+            self.__add_failure(scenario, scenario_report, category_validation, status_validation, step_failed, step_number, scenario_context, step_context)
+            self.__update_file()
+            
+    def __add_failure(self, scenario, scenario_report, category_validation, status_validation, step_failed, step_number, scenario_context, step_context):
+        from holado_report.report.report_manager import ReportManager
+        
+        step_error_message = ReportManager.get_step_error_message(step_failed).strip()
+        if step_error_message not in self.__failures:
+            self.__failures[step_error_message] = []
+        
+        category_str = f" => {category_validation}" if category_validation else ""
+        if self.__file_format == 'txt':
+            msg_list = []
+            msg_list.append(f"scenario in {ReportManager.format_scenario_short_description(scenario)} - {ReportManager.format_step_short_description(step_failed, step_number, has_failed=True)} - {status_validation}{category_str}")
+            msg_list.append(f"    Feature/Scenario: {scenario.feature.name}  =>  {scenario.name}")
+            msg_list.append(f"    Report: {scenario_report.report_path}")
+            msg_list.append(f"    Tags: -t " + " -t ".join(scenario.feature.tags + scenario.tags))
+            if step_context and step_context.start_datetime is not None:
+                msg_list.append(f"    Scenario/Step periods: {ReportManager.format_context_period(scenario_context)} -> {ReportManager.format_context_period(step_context)}")
+            else:
+                msg_list.append(f"    Scenario period: {ReportManager.format_context_period(scenario_context)}")
+            msg_scenario = "\n".join(msg_list)
+            
+            self.__failures[step_error_message].append(msg_scenario)
+        elif self.__file_format in ['json', 'xml']:
+            scenario_info = {
+                'title': f"{ReportManager.format_scenario_short_description(scenario)} - {ReportManager.format_step_short_description(step_failed, step_number, has_failed=True)} - {status_validation}{category_str}",
+                'scenario': f"{scenario.feature.name}  =>  {scenario.name}",
+                'report': scenario_report.report_path,
+                'tags': "-t " + " -t ".join(scenario.feature.tags + scenario.tags)
+                }
+            if step_context and step_context.start_datetime is not None:
+                scenario_info['periods'] = f"{ReportManager.format_context_period(scenario_context)} -> {ReportManager.format_context_period(step_context)}"
+            else:
+                scenario_info['periods'] = f"{ReportManager.format_context_period(scenario_context)}"
+                
+            self.__failures[step_error_message].append(scenario_info)
+        else:
+            raise TechnicalException(f"Unmanaged format '{self.__file_format}' (possible formats: 'txt', 'json')")
+    
+    def __update_file(self):
+        failures = dict(sorted(self.__failures.items(), key=lambda item:-len(item[1]))) if self.__sort_by_nb_scenario else self.__failures
+        
+        with self.__file as fout:
+            if self.__file_format == 'txt':
+                for failure, scenarios_messages in failures.items():
+                    fout.write(failure + "\n")
+                    fout.write("\n")
+                    for msg in scenarios_messages:
+                        fout.write(Tools.indent_string(4, msg) + "\n")
+                        fout.write("\n")
+            elif self.__file_format == 'json':
+                json_str = json.dumps(failures, ensure_ascii=False, indent=4)
+                fout.write(json_str)
+            elif self.__file_format == 'xml':
+                self.__file_write_failures_xml(fout, failures)
+            else:
+                raise TechnicalException(f"Unmanaged format '{self.__file_format}' (possible formats: 'txt', 'json')")
+
+    def __file_write_failures_xml(self, fout, failures):
+        output_dict = {
+            'failures': {
+                'failure': [self.__convert_failure_to_output_dict(error_message, scenarios) for error_message, scenarios in failures.items()]
+                }
+            }
+        
+        fout.write_dict(output_dict, pretty=True, indent=Tools.indent_string(4, ''))
+    
+    def __convert_failure_to_output_dict(self, error_message, scenarios):
+        res = {}
+        
+        if "\n" in error_message:
+            res['error_message'] = "\n" + Tools.indent_string(12, error_message) + Tools.indent_string(8, "\n")
+        else:
+            res['error_message'] = error_message
+        
+        res['scenarios'] = {'scenario': scenarios}
+        
+        return res
+    
+
+
+

holado_report/report/builders/report_builder.py

@@ -0,0 +1,64 @@
+
+#################################################
+# 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
+import abc
+
+logger = logging.getLogger(__name__)
+
+
+
+class ReportBuilder():
+    __metaclass__ = abc.ABCMeta
+
+    def __init__(self):
+        pass
+
+    @abc.abstractmethod
+    def build(self):
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def before_all(self):
+        pass
+    
+    @abc.abstractmethod
+    def before_feature(self, feature_context, feature, feature_report=None):
+        pass
+    
+    @abc.abstractmethod
+    def before_scenario(self, scenario_context, scenario, scenario_report=None):
+        pass
+    
+    @abc.abstractmethod
+    def before_step(self, step_context, step, step_level):
+        pass
+    
+    @abc.abstractmethod
+    def after_step(self, step_context, step, step_level):
+        pass
+    
+    @abc.abstractmethod
+    def after_scenario(self, scenario, scenario_report=None):
+        pass
+        
+    @abc.abstractmethod
+    def after_feature(self, feature, feature_report=None):
+        pass
+    
+    @abc.abstractmethod
+    def after_all(self):
+        pass
+    
+    
+    

holado_report/report/builders/short_scenario_report_builder.py

@@ -0,0 +1,94 @@
+
+#################################################
+# 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_core.common.tools.tools import Tools
+from holado_core.common.exceptions.technical_exception import TechnicalException
+from holado_system.system.filesystem.file import File
+
+logger = logging.getLogger(__name__)
+
+
+
+class ShortScenarioReportBuilder(ReportBuilder):
+    def __init__(self, filepath, file_format='txt', exclude_statuses=None, exclude_categories=None, use_compact_format=True):
+        self.__file_format = file_format.lower()
+        self.__exclude_statuses = exclude_statuses
+        self.__exclude_categories = exclude_categories
+        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):
+        from holado_report.report.report_manager import ReportManager
+        category_validation, status_validation, step_failed, step_number, scenario_context, step_context = ReportManager.get_current_scenario_status_information(scenario)
+        
+        # Manage excluded scenarios
+        if self.__exclude_statuses and status_validation in self.__exclude_statuses:
+            return
+        if category_validation is not None and self.__exclude_categories:
+            ind = category_validation.find(' (')
+            category = category_validation[:ind] if ind > 0 else category_validation
+            if category in self.__exclude_categories:
+                return
+        
+        self.__file_add_scenario(scenario, scenario_report, category_validation, status_validation, step_failed, step_number, scenario_context, step_context)
+        
+    def after_all(self):
+        # Manage file fail
+        self.__file.close()
+        
+    def __file_add_scenario(self, scenario, scenario_report, category_validation, status_validation, step_failed, step_number, scenario_context, step_context):
+        from holado_report.report.report_manager import ReportManager
+        
+        self.__open_file_if_needed()
+        
+        msg_list = []
+        category_str = f" => {category_validation}" if category_validation else ""
+        if step_failed:
+            msg_list.append(f"scenario in {ReportManager.format_scenario_short_description(scenario)} - {ReportManager.format_step_short_description(step_failed, step_number, has_failed=True)} - {status_validation}{category_str}")
+        else:
+            msg_list.append(f"scenario in {ReportManager.format_scenario_short_description(scenario)} - {status_validation}{category_str}")
+        msg_list.append(f"    Feature/Scenario: {scenario.feature.name}  =>  {scenario.name}")
+        msg_list.append(f"    Report: {scenario_report.report_path}")
+        msg_list.append(f"    Tags: -t " + " -t ".join(scenario.feature.tags + scenario.tags))
+        if step_context and step_context.start_datetime is not None:
+            msg_list.append(f"    Scenario/Step periods: {ReportManager.format_context_period(scenario_context, use_compact_format=self.__use_compact_format)} -> {ReportManager.format_context_period(step_context, dt_ref=scenario_context.start_datetime, use_compact_format=self.__use_compact_format)}")
+        else:
+            msg_list.append(f"    Scenario period: {ReportManager.format_context_period(scenario_context, use_compact_format=self.__use_compact_format)}")
+        step_error_message = ReportManager.get_step_error_message(step_failed)
+        if step_error_message:
+            if "\n" in step_error_message:
+                msg_list.append(f"    Error message: ")
+                msg_list.append(Tools.indent_string(8, step_error_message))
+            else:
+                msg_list.append(f"    Error message: {step_error_message}")
+        msg_list.append(f"")
+        msg_list.append(f"")
+        
+        self.__file.writelines(msg_list)
+    
+    def __open_file_if_needed(self):
+        if not self.__file.is_open:
+            self.__file.open()
+    

holado_report/report/builders/summary_by_category_report_builder.py

@@ -0,0 +1,103 @@
+
+#################################################
+# 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_system.system.filesystem.file import File
+from holado_core.common.exceptions.technical_exception import TechnicalException
+
+logger = logging.getLogger(__name__)
+
+
+
+class SummaryByCategoryReportBuilder(ReportBuilder):
+    def __init__(self, filepath, file_format='txt', exclude_statuses=None, exclude_categories=None):
+        self.__file_format = file_format.lower()
+        self.__exclude_statuses = exclude_statuses
+        self.__exclude_categories = exclude_categories
+        
+        if self.__file_format == 'txt':
+            self.__file = File(filepath, mode='wt')
+        else:
+            raise TechnicalException(f"Unmanaged format '{self.__file_format}' (possible formats: 'txt')")
+        
+        self.__counter_by_category = {}
+        self.__categories_order = [
+                'Regression',
+                'Always Failed',
+                'Random',
+                'Regression but Not Relevant',
+                'Always Not Relevant',
+                'Random but Not Relevant',
+                'Always Success',
+                'Fixed',
+                'Unknown'
+            ]
+        
+    def build(self):
+        '''
+        The file is built after each scenario
+        '''
+        pass
+        
+    def after_scenario(self, scenario, scenario_report=None):
+        from holado_report.report.report_manager import ReportManager
+        category_validation, status_validation, _, _, _, _ = ReportManager.get_current_scenario_status_information(scenario)
+        if category_validation is not None:
+            ind = category_validation.find(' (')
+            category = category_validation[:ind] if ind > 0 else category_validation
+        else:
+            category = None
+        
+        # Manage excluded scenarios
+        if self.__exclude_statuses and status_validation in self.__exclude_statuses:
+            return
+        if category is not None and self.__exclude_categories and category in self.__exclude_categories:
+            return
+        
+        if category is not None:
+            if category not in self.__counter_by_category:
+                self.__counter_by_category[category] = 0
+            self.__counter_by_category[category] += 1
+            
+            # Update categories order with unexpected category
+            if category not in self.__categories_order:
+                self.__categories_order.append(category)
+            
+            self.__update_file()
+        
+    def __update_file(self):
+        list_by_group = {
+            'Success': [(k,self.__counter_by_category[k]) for k in self.__categories_order 
+                        if k in self.__counter_by_category and k in ['Always Success', 'Fixed']],
+            'Failed': [(k,self.__counter_by_category[k]) for k in self.__categories_order 
+                       if k in self.__counter_by_category and k in ['Regression', 'Always Failed', 'Random']],
+            'Not Relevant': [(k,self.__counter_by_category[k]) for k in self.__categories_order 
+                             if k in self.__counter_by_category and k in ['Regression but Not Relevant', 'Always Not Relevant', 'Random but Not Relevant']]
+            }
+        others_list = [(k,v) for k,v in self.__counter_by_category.items() 
+                       if k not in ['Always Success', 'Fixed', 'Regression', 'Always Failed', 'Random', 'Regression but Not Relevant', 'Always Not Relevant', 'Random but Not Relevant']]
+        
+        lines = []
+        for group_name, group_list in list_by_group.items():
+            if group_list:
+                lines.append(f"{group_name:>12s}: {sum([x[1] for x in group_list]):5d}  ({' ; '.join([f'{x[0]}: {x[1]}' for x in group_list])})")
+            else:
+                lines.append(f"{group_name:>12s}: {0:5d}")
+        if others_list:
+            lines.append(f"{'Others':>12s}: {sum([x[1] for x in others_list]):5d}  ({' ; '.join([f'{x[0]}: {x[1]}' for x in others_list])})")
+
+        with self.__file as fout:
+            fout.writelines(lines)
+        
+        

holado_report/report/builders/summary_report_builder.py

@@ -0,0 +1,110 @@
+
+#################################################
+# 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
+import weakref
+from holado_system.system.filesystem.file import File
+from holado_core.common.exceptions.technical_exception import TechnicalException
+
+logger = logging.getLogger(__name__)
+
+
+
+class ExecutionHistoricSummaryReportBuilder(ReportBuilder):
+    def __init__(self, execution_historic, filepath):
+        self.__execution_historic_weakref = weakref.ref(execution_historic)
+        self.__filepath = filepath
+
+    @property
+    def __execution_historic(self):
+        return self.__execution_historic_weakref()
+
+    def build(self):
+        features = {}
+        scenarios = {}
+        for eh_feat in self.__execution_historic:
+            status_name = eh_feat.feature.status.name
+            if status_name not in features:
+                features[status_name] = 0
+            features[status_name] += 1
+            
+            for eh_sce in eh_feat.scenarios:
+                status_name = eh_sce.status_validation
+                # status_name = eh_sce[0].status.name.lower()
+                if status_name not in scenarios:
+                    scenarios[status_name] = 0
+                scenarios[status_name] += 1
+            
+        with open(self.__filepath, "wt") as feh:
+            feh.write("features: " + ", ".join([f"{v} {k}" for k, v in dict(sorted(features.items())).items()]) + "\n")
+            feh.write("scenarios: " + ", ".join([f"{v} {k}" for k, v in dict(sorted(scenarios.items())).items()]) + "\n")
+        
+    
+class SummaryReportBuilder(ReportBuilder):
+    def __init__(self, filepath, file_format='txt', with_features=True, exclude_statuses=None, exclude_categories=None):
+        self.__file_format = file_format.lower()
+        self.__exclude_statuses = exclude_statuses
+        self.__exclude_categories = exclude_categories
+        self.__with_features = with_features
+        
+        if self.__file_format == 'txt':
+            self.__file = File(filepath, mode='wt')
+        else:
+            raise TechnicalException(f"Unmanaged format '{self.__file_format}' (possible formats: 'txt')")
+        
+        self.__features = {}
+        self.__scenarios = {}
+
+    def build(self):
+        '''
+        The file is built after each scenario
+        '''
+        pass
+        
+    def after_scenario(self, scenario, scenario_report=None):
+        from holado_report.report.report_manager import ReportManager
+        category_validation, status_validation, _, _, _, _ = ReportManager.get_current_scenario_status_information(scenario)
+        
+        # Manage excluded scenarios
+        if self.__exclude_statuses and status_validation in self.__exclude_statuses:
+            return
+        if category_validation is not None and self.__exclude_categories:
+            ind = category_validation.find(' (')
+            category = category_validation[:ind] if ind > 0 else category_validation
+            if category in self.__exclude_categories:
+                return
+        
+        if status_validation not in self.__scenarios:
+            self.__scenarios[status_validation] = 0
+        self.__scenarios[status_validation] += 1
+        
+        self.__update_file()
+    
+    def after_feature(self, feature, feature_report=None):
+        status_name = feature.status.name
+        if status_name not in self.__features:
+            self.__features[status_name] = 0
+        self.__features[status_name] += 1
+        
+        self.__update_file()
+    
+    def __update_file(self):
+        with self.__file as fout:
+            if self.__with_features:
+                fout.write("features: " + ", ".join([f"{v} {k}" for k, v in dict(sorted(self.__features.items())).items()]) + "\n")
+            fout.write("scenarios: " + ", ".join([f"{v} {k}" for k, v in dict(sorted(self.__scenarios.items())).items()]) + "\n")
+    
+    
+    
+    

holado_report/report/builders/summary_scenario_by_category_report_builder.py

@@ -0,0 +1,109 @@
+
+#################################################
+# 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_system.system.filesystem.file import File
+from holado_python.common.tools.datetime import DateTime, FORMAT_DATETIME_ISO
+from holado_core.common.exceptions.technical_exception import TechnicalException
+
+logger = logging.getLogger(__name__)
+
+
+
+class SummaryScenarioByCategoryReportBuilder(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, auto_flush=False, mode='wt')
+        else:
+            raise TechnicalException(f"Unmanaged format '{self.__file_format}' (possible formats: 'txt')")
+        
+        self.__scenarios_by_category = {}
+        self.__categories_order = [
+                'Regression',
+                'Always Failed',
+                'Random',
+                'Regression but Not Relevant',
+                'Always Not Relevant',
+                'Random but Not Relevant',
+                'Fixed',
+                'Always Success',
+                'Unknown'
+            ]
+        
+    def build(self):
+        '''
+        The file is built after each scenario
+        '''
+        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, scenario_context, step_context = ReportManager.get_current_scenario_status_information(scenario)
+        if category_validation is not None:
+            ind = category_validation.find(' (')
+            category = category_validation[:ind] if ind > 0 else category_validation
+        else:
+            category = None
+        
+        # Manage excluded scenario
+        if self.__exclude_statuses and status_validation in self.__exclude_statuses:
+            return
+        if self.__exclude_categories and category in self.__exclude_categories:
+            return
+        
+        if category is not None:
+            # Add scenario information into category
+            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}
+                scenario_txt = 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}"
+            else:
+                scenario_txt = f"{scenario_prefix_str}{ReportManager.format_scenario_short_description(scenario)} - {status_validation}{category_str}"
+            
+            if category not in self.__scenarios_by_category:
+                self.__scenarios_by_category[category] = []
+            self.__scenarios_by_category[category].append(scenario_txt)
+            
+            # Update categories order with unexpected category
+            if category not in self.__categories_order:
+                self.__categories_order.append(category)
+            
+            self.__update_file()
+        
+    def __update_file(self):
+        with self.__file as fout:
+            for category in self.__categories_order:
+                if category in self.__scenarios_by_category:
+                    fout.writelines([
+                        f"## {category}",
+                        ""
+                        ])
+                    fout.writelines(self.__scenarios_by_category[category])
+                    fout.writelines([
+                        ""
+                        ""
+                        ])
+