holado 0.13.22__py3-none-any.whl

holado_report/report/analyze/scenario_duration_manager.py

@@ -0,0 +1,245 @@
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2023 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 csv
+import json
+from holado_core.common.exceptions.technical_exception import TechnicalException
+import itertools
+from holado_core.common.exceptions.functional_exception import FunctionalException
+import os
+from holado_core.common.tools.converters.converter import Converter
+from holado_core.common.tools.tools import Tools
+
+logger = logging.getLogger(__name__)
+
+
+
+class ScenarioDurationManager(object):
+    def __init__(self):
+        self.__execution_historic = None
+    
+    def import_execution_historic(self, filepath):
+        with open(filepath, "r") as fin:
+            self.__execution_historic = json.load(fin)
+        
+    def create_file_scenario_duration_limits(self, filepath, scenario_duration_limits):
+        header = ["Duration Limit", "Nb of Scenarios", "Total Spent Time", "Nb of Scenarios (limit)", "Total Spent Time (limit)", "Mean Duration (limit)"]
+        with open(filepath, "w", newline='') as fout:
+            dw = csv.DictWriter(fout, fieldnames=header, delimiter=';')#, quoting=csv.QUOTE_NONE)
+            dw.writeheader()
+            
+            for sd in scenario_duration_limits:
+                dw.writerow(sd)
+        
+    def compute_scenario_duration_limits(self, duration_limits=None):
+        if duration_limits is None:
+            duration_limits = sorted(set(itertools.chain(*((0.1*x, x, 10*x, 60*x, 60*60*x) for x in range(1,10))))) + [60*60*24*30]
+
+        res = [self.__compute_scenario_duration_limit(dur_lim) for dur_lim in duration_limits]
+        
+        # Compute base data in limit: spent time, nb of scenario
+        res[0]["Total Spent Time (limit)"] = res[0]["Total Spent Time"]
+        res[0]["Nb of Scenarios (limit)"] = res[0]["Nb of Scenarios"]
+        for ind in range(1,len(res)):
+            res[ind]["Total Spent Time (limit)"] = res[ind]["Total Spent Time"] - res[ind-1]["Total Spent Time"]
+            res[ind]["Nb of Scenarios (limit)"] = res[ind]["Nb of Scenarios"] - res[ind-1]["Nb of Scenarios"]
+        
+        # Compute mean duration in limit
+        for ind in range(len(res)):
+            if res[ind]["Nb of Scenarios (limit)"] > 0:
+                res[ind]["Mean Duration (limit)"] = res[ind]["Total Spent Time (limit)"] / res[ind]["Nb of Scenarios (limit)"]
+            else:
+                res[ind]["Mean Duration (limit)"] = None
+        
+        return res
+    
+    def __compute_scenario_duration_limit(self, duration_limit):
+        res = {"Duration Limit" : duration_limit,
+               "Nb of Scenarios" : 0,
+               "Total Spent Time" : 0}
+        for eh_feat in self.__execution_historic:
+            for eh_sce in eh_feat['scenarios']:
+                if eh_sce['scenario']['status'] == 'passed':
+                    sce_dur = eh_sce['scenario']['duration']
+                    if sce_dur < duration_limit:
+                        res["Nb of Scenarios"] += 1
+                        res["Total Spent Time"] += sce_dur
+        return res
+        
+    def create_file_scenario_duration_tags(self, filepath, scenario_duration_tags):
+        header = ["Feature", "Scenario", "File", "Line", "Status", "Duration", "Current tag", "New tag"]
+        if scenario_duration_tags and len(scenario_duration_tags) > 0:
+            header.extend(set(scenario_duration_tags[0].keys()) - set(header))
+            
+        with open(filepath, "w", newline='') as fout:
+            dw = csv.DictWriter(fout, fieldnames=header, delimiter=';')#, quoting=csv.QUOTE_NONE)
+            dw.writeheader()
+            
+            for sd in scenario_duration_tags:
+                dw.writerow(sd)
+    
+    def compute_scenario_duration_tags(self, duration_limit_tags, default_tag, tag_prefix="ScenarioDuration=", missing_tag=True, new_tag=True, unchanged_tag=False, with_failed=False, add_apply=False):
+        if duration_limit_tags is None or not isinstance(duration_limit_tags, list):
+            raise TechnicalException("Parameter 'duration_limit_tags' must be specified as a list of tuples (limit, tag)")
+        if default_tag is None:
+            raise TechnicalException("Parameter 'default_tag' must be specified")
+            
+        res = []
+        for eh_feat in self.__execution_historic:
+            for eh_sce in eh_feat['scenarios']:
+                sce_res = {"Feature" : eh_feat['feature']['name'], 
+                           "Scenario" : eh_sce['scenario']['name'], 
+                           "File" : eh_sce['scenario']['filename'], 
+                           "Line" : eh_sce['scenario']['line'], 
+                           "Status" : eh_sce['scenario']['status'], 
+                           "Duration" : eh_sce['scenario']['duration'], 
+                           "Current tag" : None, 
+                           "New tag" : None}
+                
+                cur_tag = None
+                for tag in eh_sce['scenario']['tags']:
+                    tag = str(tag)
+                    if tag.startswith(tag_prefix):
+                        cur_tag = tag[len(tag_prefix):]
+                        break
+                sce_res["Current tag"] = cur_tag
+                    
+                cur_status = eh_sce['scenario']['status']
+                new_tag = None
+                if cur_status == "passed":
+                    sce_dur = float(eh_sce['scenario']['duration'])
+                    for lim_tag in duration_limit_tags:
+                        if sce_dur < lim_tag[0]:
+                            new_tag = lim_tag[1]
+                            break
+                    if new_tag is None:
+                        new_tag = default_tag
+                    sce_res["New tag"] = new_tag
+                    
+                if add_apply:
+                    apply = None
+                    if new_tag is not None:
+                        if cur_tag is None:
+                            apply = True
+                        elif new_tag != cur_tag:
+                            if cur_tag.endswith("!fixed"):
+                                apply = False
+                            else:
+                                apply = True
+                    sce_res["Apply"] = apply
+                    
+                if (with_failed and cur_status != "passed" 
+                    or cur_status == "passed" 
+                        and (missing_tag and cur_tag is None)):
+                    res.append(sce_res)
+        return res
+    
+    def update_scenario_durations(self, scenario_duration_tags_filepath, features_path, tag_prefix="ScenarioDuration=", dry_run=False):
+        sdt_by_file = {}
+        with open(scenario_duration_tags_filepath, 'r', newline='') as csvfile:
+            reader = csv.DictReader(csvfile, delimiter=';')
+            
+            # Verify presence of 'Apply' column
+            if 'Apply' not in reader.fieldnames:
+                raise FunctionalException(f"File '{scenario_duration_tags_filepath}' doesn't have column 'Apply'. Please regenerate it with column 'Apply'.")
+            
+            for row in reader:
+                file = row["File"]
+                if file not in sdt_by_file:
+                    sdt_by_file[file] = []
+                sdt_by_file[file].append(row)
+                
+        logger.info(f"Updating scenario duration tags with prefix '{tag_prefix}' for scenarios in folder '{features_path}'")
+        for file in sorted(sdt_by_file.keys()):
+            sorted_sdt = sorted(sdt_by_file[file], key=lambda x: -int(x["Line"]))
+            for sdt in sorted_sdt:
+                self.__update_scenario_duration(sdt, features_path, tag_prefix, dry_run)
+        
+    def __update_scenario_duration(self, scenario_duration_tag, features_path, tag_prefix, dry_run):
+        apply = scenario_duration_tag["Apply"]
+        if apply and Converter.is_boolean(apply) and Converter.to_boolean(apply):
+            file = scenario_duration_tag["File"]
+            line_nb = int(scenario_duration_tag["Line"])
+            cur_tag = scenario_duration_tag["Current tag"]
+            new_tag = scenario_duration_tag["New tag"]
+            
+            if file.startswith('features'):
+                file = file[len('features')+1:]
+            filepath = os.path.join(features_path, file)
+            
+            logger.info(f"    in {file} l.{line_nb}: '{cur_tag}' -> '{new_tag}'")
+            self.__update_scenario_duration_in_file(filepath, line_nb, cur_tag, new_tag, tag_prefix, dry_run)
+        
+    def __update_scenario_duration_in_file(self, filepath, line_nb, cur_tag, new_tag, tag_prefix, dry_run):
+        # Read file content
+        with open(filepath, 'r') as fin:
+            lines = fin.readlines()
+        
+        # Verify line line_nb is a scenario
+        if not lines[line_nb].strip().startswith("Scenario:"):
+            raise FunctionalException(f"In file '{filepath}', line {line_nb} is not a scenario. This happens when scenario duration tags file is not synchronized with feature files.")
+        
+        # Find current tag in file
+        index_duration = None
+        index = line_nb - 2
+        while index >= 0:
+            line_content = lines[index].strip()
+            if line_content.startswith("@" + tag_prefix):
+                index_duration = index
+                break
+            elif not self.__is_line_before_scenario(line_content):
+                break
+            else:
+                index += 1
+                
+        # Extract and verify current tag
+        if index_duration is not None:
+            scenario_tag = line_content[len("@" + tag_prefix):]
+            if scenario_tag != cur_tag:
+                logger.warning(f"        WARNING: Actual tag in file is '{scenario_tag}' (expected: '{cur_tag}')")
+        elif cur_tag:
+            logger.warning(f"        WARNING: Scenario has no actual tag in file (expected: '{cur_tag}')")
+            
+        # Compute new meta line
+        index_sce = lines[line_nb - 1].find("Scenario")
+        new_line = " " * index_sce + "@" + tag_prefix + new_tag + "\n"
+        
+        # Apply modification
+        if index_duration is not None:
+            if Tools.do_log(logger, logging.DEBUG):
+                logger.debug(f"{' '*8}Replacing line {index_duration+1}:\n{' '*12}old: [{lines[index_duration][:-1]}]\n{' '*12}new: [{new_line[:-1]}]")
+            if not dry_run:
+                lines[index_duration] = new_line
+        else:
+            index_insert = line_nb - 1
+            while True:
+                prev_content = lines[index_insert - 1].strip() if index_insert > 0 else None
+                if prev_content is not None and len(prev_content) > 2 and prev_content[1].isupper() and prev_content > new_line.strip():
+                    index_insert -= 1
+                else:
+                    break
+            if Tools.do_log(logger, logging.DEBUG):
+                logger.debug(f"{' '*8}Insert in line {index_insert+1}: [{new_line[:-1]}]")
+            if not dry_run:
+                lines.insert(index_insert, new_line)
+        
+        # Save in file 
+        if not dry_run:
+            with open(filepath, 'w') as fout:
+                fout.writelines(lines)
+        
+    def __is_line_before_scenario(self, line):
+        return not any((line.strip().startswith(txt) for txt in ['Given', 'When', 'Then', 'Feature', '|', '"""', "'''"]))
+        
+        

holado_report/report/builders/detailed_scenario_report_builder.py

@@ -0,0 +1,172 @@
+
+#################################################
+# 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_core.common.tools.tools import Tools
+import logging
+from holado_report.report.builders.report_builder import ReportBuilder
+from holado_xml.xml.stream_xml_file import StreamXMLFile
+from holado_system.system.filesystem.file import File
+from holado_core.common.exceptions.technical_exception import TechnicalException
+
+logger = logging.getLogger(__name__)
+
+
+
+class DetailedScenarioReportBuilder(ReportBuilder):
+    """ Detailed scenario report
+    It is dedicated to have a convenient compromise between completeness and shortness.
+    
+    Notes: XML version of this report is mandatory by test-server as it uses CampaignManager that needs it in its campaign import process.
+           For this import process, all periods must be in uncompact format, thus this format is forced in XML format management.
+    """
+    def __init__(self, filepath, file_format='xml', 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 == 'xml':
+            self.__file = StreamXMLFile(filepath, mode='wt')
+        elif self.__file_format == 'txt':
+            self.__file = File(filepath, mode='wt')
+        else:
+            raise TechnicalException(f"Unmanaged format '{self.__file_format}' (possible formats: 'txt', 'xml')")
+        
+    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
+        self.__file.close()
+        
+    def __file_add_scenario(self, scenario, scenario_report, category_validation, status_validation, step_failed, step_number, scenario_context, step_context):
+        if self.__file_format == 'xml':
+            self.__file_add_scenario_xml(scenario, scenario_report, category_validation, status_validation, step_failed, step_number, scenario_context, step_context)
+        else:
+            self.__file_add_scenario_txt(scenario, scenario_report, category_validation, status_validation, step_failed, step_number, scenario_context, step_context)
+        
+    def __file_add_scenario_xml(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()
+        
+        data = {
+            'scenario': {
+                'file': ReportManager.format_scenario_short_description(scenario),
+                'feature': scenario.feature.name,
+                'scenario': scenario.name,
+                'scenario_period': ReportManager.format_context_period(scenario_context, use_compact_format=False),
+                'report': scenario_report.report_path,
+                'tags': "-t " + " -t ".join(scenario.feature.tags + scenario.tags),
+                }
+            }
+        if category_validation:
+            data['scenario']['validation_category'] = category_validation
+        data['scenario']['validation_status'] = status_validation
+        if step_failed is not None:
+            failure_data = {
+                'step_number': step_number,
+                'step_line': step_failed.line
+                }
+            if step_context and step_context.start_datetime is not None:
+                failure_data['step_period'] = ReportManager.format_context_period(step_context, use_compact_format=False)
+
+            step_descr = ReportManager.get_step_description(step_failed)
+            if "\n" in step_descr:
+                failure_data['step'] = "\n" + Tools.indent_string(12, step_descr) + Tools.indent_string(8, "\n")
+            else:
+                failure_data['step'] = step_descr
+                
+            step_error_message = ReportManager.get_step_error_message(step_failed)
+            if step_error_message:
+                if "\n" in step_error_message:
+                    failure_data['error_message'] = "\n" + Tools.indent_string(12, step_error_message) + Tools.indent_string(8, "\n")
+                else:
+                    failure_data['error_message'] = step_error_message
+            
+            step_error = ReportManager.get_step_error(step_failed)
+            if step_error and step_error != step_error_message:
+                if "\n" in step_error:
+                    failure_data['error'] = "\n" + Tools.indent_string(12, step_error) + Tools.indent_string(8, "\n")
+                else:
+                    failure_data['error'] = step_error
+            data['scenario']['failure'] = failure_data
+        elif status_validation != 'Passed':
+            data['scenario']['failure'] = "No step failed, it has probably failed on a missing step implementation"
+            
+        self.__file.write_element_dict(data, pretty=True, indent=Tools.indent_string(4, ''))
+        # Add 2 empty lines for more readability
+        self.__file.internal_file.writelines(['', ''])
+        
+    def __file_add_scenario_txt(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 = [f"{scenario.filename} - l.{scenario.line}"]
+        msg_list.append(f"    Feature: {scenario.feature.name}")
+        msg_list.append(f"    Scenario: {scenario.name}")
+        msg_list.append(f"    Report: {scenario_report.report_path}")
+        msg_list.append(f"    Scenario period: {ReportManager.format_context_period(scenario_context)}")
+        msg_list.append(f"    Tags: -t " + " -t ".join(scenario.feature.tags + scenario.tags))
+        if category_validation:
+            msg_list.append(f"    Validation category: {category_validation}")
+        msg_list.append(f"    Validation status: {status_validation}")
+        if step_failed is not None:
+            msg_list.append(f"    Failure:")
+            msg_list.append(f"        Step number-line: {step_number} - l.{step_failed.line}")
+            if step_context and step_context.start_datetime is not None:
+                msg_list.append(f"        Step period: {ReportManager.format_context_period(step_context)}")
+            step_descr = ReportManager.get_step_description(step_failed)
+            if "\n" in step_descr:
+                msg_list.append(f"        Step:")
+                msg_list.append(Tools.indent_string(12, step_descr))
+            else:
+                msg_list.append(f"        Step: {step_descr}")
+                
+            step_error = ReportManager.get_step_error(step_failed)
+            if step_error:
+                if "\n" in step_error:
+                    msg_list.append(f"        Error:")
+                    msg_list.append(Tools.indent_string(12, step_error))
+                else:
+                    msg_list.append(f"        Error: {step_error}")
+        else:
+            msg_list.append(f"    Failure: No step failed, it has probably failed on a missing step implementation")
+        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/execution_historic_report_builder.py

@@ -0,0 +1,132 @@
+
+#################################################
+# 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 json
+import logging
+from holado_report.report.builders.report_builder import ReportBuilder
+import weakref
+from holado_python.common.tools.datetime import FORMAT_DATETIME_ISO, DateTime
+from holado_core.common.exceptions.technical_exception import TechnicalException
+from holado_system.system.filesystem.file import File
+
+logger = logging.getLogger(__name__)
+
+
+
+class ExecutionHistoricReportBuilder(ReportBuilder):
+    def __init__(self, execution_historic, filepath, file_format='json'):
+        self.__execution_historic_weakref = weakref.ref(execution_historic)
+        self.__file_format = file_format.lower()
+        
+        if self.__file_format == 'json':
+            self.__file = File(filepath, mode='wt')
+        else:
+            raise TechnicalException(f"Unmanaged format '{self.__file_format}' (possible formats: 'json')")
+        
+    @property
+    def __execution_historic(self):
+        return self.__execution_historic_weakref()
+    
+    def build(self):
+        with self.__file as feh:
+            eh_json = self.__convert_execution_historic_to_json()
+            json_str = json.dumps(eh_json, ensure_ascii=False, indent=4)
+            feh.write(json_str)
+        
+    def __convert_execution_historic_to_json(self):
+        return [self.__convert_execution_historic_feature_to_json(eh_feat) for eh_feat in self.__execution_historic]
+    
+    def __convert_execution_historic_feature_to_json(self, eh_feature):
+        return {
+            'feature': self.__convert_feature_to_json(eh_feature.feature, eh_feature.feature_context, eh_feature.feature_report),
+            'scenarios': [self.__convert_execution_historic_scenario_to_json(eh_sce) for eh_sce in eh_feature.scenarios ]
+            }
+    
+    def __convert_feature_to_json(self, feature, feature_context, feature_report):
+        res = {
+            'name': feature.name,
+            'description': feature.description,
+            'tags': [str(tag) for tag in feature.tags],
+            'status': feature.status.name,
+            'duration': feature.duration,
+            'start_date': DateTime.datetime_2_str(feature_context.start_datetime, dt_format=FORMAT_DATETIME_ISO)
+            }
+        if feature_context.end_datetime:
+            res['end_date'] = DateTime.datetime_2_str(feature_context.end_datetime, dt_format=FORMAT_DATETIME_ISO)
+        res.update({
+            'filename': feature.filename,
+            'report': feature_report.report_path
+            })
+        return res
+    
+    def __convert_execution_historic_scenario_to_json(self, eh_scenario):
+        return {
+            'scenario': self.__convert_scenario_to_json(eh_scenario.scenario, eh_scenario.scenario_context, eh_scenario.scenario_report),
+            'steps_by_scope': {scope_name:[self.__convert_execution_historic_step_to_json(eh_step) for eh_step in steps] for scope_name, steps in eh_scenario.steps_by_scope.items()},
+            'status_validation': eh_scenario.status_validation,
+            'step_failed': self.__convert_step_to_json(eh_scenario.step_failed) if eh_scenario.step_failed is not None else None,
+            'step_failed_number': eh_scenario.step_failed_number
+            }
+        
+    def __convert_scenario_to_json(self, scenario, scenario_context, scenario_report):
+        res = {
+            'name': scenario.name,
+            'description': scenario.description,
+            'tags': [str(tag) for tag in scenario.tags],
+            'status': scenario.status.name,
+            'duration': scenario.duration,
+            'start_date': DateTime.datetime_2_str(scenario_context.start_datetime, dt_format=FORMAT_DATETIME_ISO)
+            }
+        if scenario_context.end_datetime:
+            res['end_date'] = DateTime.datetime_2_str(scenario_context.end_datetime, dt_format=FORMAT_DATETIME_ISO)
+        res.update({
+            'filename': scenario.filename,
+            'line': scenario.line,
+            'report': scenario_report.report_path
+            })
+        return res
+        
+    def __convert_execution_historic_step_to_json(self, eh_step):
+        if eh_step.step is not None:
+            res = self.__convert_step_to_json(eh_step.step)
+        else:
+            res = {}
+        if eh_step.step_context is not None:
+            if eh_step.step_context.status is not None:
+                res['status'] = eh_step.step_context.status
+            if eh_step.step_context.start_datetime:
+                res['start_date'] = DateTime.datetime_2_str(eh_step.step_context.start_datetime, dt_format=FORMAT_DATETIME_ISO)
+            if eh_step.step_context.end_datetime:
+                res['end_date'] = DateTime.datetime_2_str(eh_step.step_context.end_datetime, dt_format=FORMAT_DATETIME_ISO)
+            
+        res['description'] = eh_step.step_description
+        if eh_step.sub_steps:
+            res['sub_steps'] = [self.__convert_execution_historic_step_to_json(eh_sub_step) for eh_sub_step in eh_step.sub_steps ]
+        return res
+        
+    def __convert_step_to_json(self, step):
+        from holado_report.report.report_manager import ReportManager
+        res = {
+            'status': step.status.name,
+            'duration': step.duration,
+            }
+        step_error = ReportManager.get_step_error(step)
+        if step_error:
+            res['error'] = step_error
+        if isinstance(step.filename, str) and step.filename != "<string>":
+            res['filename'] = step.filename
+            res['line'] = step.line
+        return res
+        
+    
+