Skip to content

loggerapi

LoggerApi

Source code in src/robot/output/loggerapi.py
class LoggerApi:

    def start_suite(self, data: 'running.TestSuite', result: 'result.TestSuite'):
        pass

    def end_suite(self, data: 'running.TestSuite', result: 'result.TestSuite'):
        pass

    def start_test(self, data: 'running.TestCase', result: 'result.TestCase'):
        pass

    def end_test(self, data: 'running.TestCase', result: 'result.TestCase'):
        pass

    def start_keyword(self, data: 'running.Keyword', result: 'result.Keyword'):
        self.start_body_item(data, result)

    def end_keyword(self, data: 'running.Keyword', result: 'result.Keyword'):
        self.end_body_item(data, result)

    def start_user_keyword(self, data: 'running.Keyword',
                           implementation: 'running.UserKeyword',
                           result: 'result.Keyword'):
        self.start_keyword(data, result)

    def end_user_keyword(self, data: 'running.Keyword',
                         implementation: 'running.UserKeyword',
                         result: 'result.Keyword'):
        self.end_keyword(data, result)

    def start_library_keyword(self, data: 'running.Keyword',
                              implementation: 'running.LibraryKeyword',
                              result: 'result.Keyword'):
        self.start_keyword(data, result)

    def end_library_keyword(self, data: 'running.Keyword',
                            implementation: 'running.LibraryKeyword',
                            result: 'result.Keyword'):
        self.end_keyword(data, result)

    def start_invalid_keyword(self, data: 'running.Keyword',
                              implementation: 'running.KeywordImplementation',
                              result: 'result.Keyword'):
        self.start_keyword(data, result)

    def end_invalid_keyword(self, data: 'running.Keyword',
                            implementation: 'running.KeywordImplementation',
                            result: 'result.Keyword'):
        self.end_keyword(data, result)

    def start_for(self, data: 'running.For', result: 'result.For'):
        self.start_body_item(data, result)

    def end_for(self, data: 'running.For', result: 'result.For'):
        self.end_body_item(data, result)

    def start_for_iteration(self, data: 'running.ForIteration',
                            result: 'result.ForIteration'):
        self.start_body_item(data, result)

    def end_for_iteration(self, data: 'running.ForIteration',
                          result: 'result.ForIteration'):
        self.end_body_item(data, result)

    def start_while(self, data: 'running.While', result: 'result.While'):
        self.start_body_item(data, result)

    def end_while(self, data: 'running.While', result: 'result.While'):
        self.end_body_item(data, result)

    def start_while_iteration(self, data: 'running.WhileIteration',
                              result: 'result.WhileIteration'):
        self.start_body_item(data, result)

    def end_while_iteration(self, data: 'running.WhileIteration',
                            result: 'result.WhileIteration'):
        self.end_body_item(data, result)

    def start_if(self, data: 'running.If', result: 'result.If'):
        self.start_body_item(data, result)

    def end_if(self, data: 'running.If', result: 'result.If'):
        self.end_body_item(data, result)

    def start_if_branch(self, data: 'running.IfBranch', result: 'result.IfBranch'):
        self.start_body_item(data, result)

    def end_if_branch(self, data: 'running.IfBranch', result: 'result.IfBranch'):
        self.end_body_item(data, result)

    def start_try(self, data: 'running.Try', result: 'result.Try'):
        self.start_body_item(data, result)

    def end_try(self, data: 'running.Try', result: 'result.Try'):
        self.end_body_item(data, result)

    def start_try_branch(self, data: 'running.TryBranch', result: 'result.TryBranch'):
        self.start_body_item(data, result)

    def end_try_branch(self, data: 'running.TryBranch', result: 'result.TryBranch'):
        self.end_body_item(data, result)

    def start_var(self, data: 'running.Var', result: 'result.Var'):
        self.start_body_item(data, result)

    def end_var(self, data: 'running.Var', result: 'result.Var'):
        self.end_body_item(data, result)

    def start_break(self, data: 'running.Break', result: 'result.Break'):
        self.start_body_item(data, result)

    def end_break(self, data: 'running.Break', result: 'result.Break'):
        self.end_body_item(data, result)

    def start_continue(self, data: 'running.Continue', result: 'result.Continue'):
        self.start_body_item(data, result)

    def end_continue(self, data: 'running.Continue', result: 'result.Continue'):
        self.end_body_item(data, result)

    def start_return(self, data: 'running.Return', result: 'result.Return'):
        self.start_body_item(data, result)

    def end_return(self, data: 'running.Return', result: 'result.Return'):
        self.end_body_item(data, result)

    def start_error(self, data: 'running.Error', result: 'result.Error'):
        self.start_body_item(data, result)

    def end_error(self, data: 'running.Error', result: 'result.Error'):
        self.end_body_item(data, result)

    def start_body_item(self, data, result):
        pass

    def end_body_item(self, data, result):
        pass

    def log_message(self, message: 'model.Message'):
        pass

    def message(self, message: 'model.Message'):
        pass

    def output_file(self, path: Path):
        """Called when XML output file is closed.

        Calls :meth:`result_file` by default.
        """
        self.result_file('Output', path)

    def report_file(self, path: Path):
        """Called when report file is closed.

        Calls :meth:`result_file` by default.
        """
        self.result_file('Report', path)

    def log_file(self, path: Path):
        """Called when log file is closed.

        Calls :meth:`result_file` by default.
        """
        self.result_file('Log', path)

    def xunit_file(self, path: Path):
        """Called when xunit file is closed.

        Calls :meth:`result_file` by default.
        """
        self.result_file('XUnit', path)

    def debug_file(self, path: Path):
        """Called when debug file is closed.

        Calls :meth:`result_file` by default.
        """
        self.result_file('Debug', path)

    def result_file(self, kind: Literal['Output', 'Report', 'Log', 'XUnit', 'Debug'],
                    path: Path):
        """Called when any result file is closed by default.

        ``kind`` specifies the file type. This method is not called if a result
        file specific method like :meth:`output_file` is implemented.
        """
        pass

    def imported(self, import_type: str, name: str, attrs):
        pass

    def library_import(self, library: 'running.TestLibrary',
                       importer: 'running.Import'):
        pass

    def resource_import(self, resource: 'running.ResourceFile',
                        importer: 'running.Import'):
        pass

    def variables_import(self, attrs: dict, importer: 'running.Import'):
        pass

    def close(self):
        pass

debug_file(path)

Called when debug file is closed.

Calls :meth:result_file by default.

Source code in src/robot/output/loggerapi.py
def debug_file(self, path: Path):
    """Called when debug file is closed.

    Calls :meth:`result_file` by default.
    """
    self.result_file('Debug', path)

log_file(path)

Called when log file is closed.

Calls :meth:result_file by default.

Source code in src/robot/output/loggerapi.py
def log_file(self, path: Path):
    """Called when log file is closed.

    Calls :meth:`result_file` by default.
    """
    self.result_file('Log', path)

output_file(path)

Called when XML output file is closed.

Calls :meth:result_file by default.

Source code in src/robot/output/loggerapi.py
def output_file(self, path: Path):
    """Called when XML output file is closed.

    Calls :meth:`result_file` by default.
    """
    self.result_file('Output', path)

report_file(path)

Called when report file is closed.

Calls :meth:result_file by default.

Source code in src/robot/output/loggerapi.py
def report_file(self, path: Path):
    """Called when report file is closed.

    Calls :meth:`result_file` by default.
    """
    self.result_file('Report', path)

result_file(kind, path)

Called when any result file is closed by default.

kind specifies the file type. This method is not called if a result file specific method like :meth:output_file is implemented.

Source code in src/robot/output/loggerapi.py
def result_file(self, kind: Literal['Output', 'Report', 'Log', 'XUnit', 'Debug'],
                path: Path):
    """Called when any result file is closed by default.

    ``kind`` specifies the file type. This method is not called if a result
    file specific method like :meth:`output_file` is implemented.
    """
    pass

xunit_file(path)

Called when xunit file is closed.

Calls :meth:result_file by default.

Source code in src/robot/output/loggerapi.py
def xunit_file(self, path: Path):
    """Called when xunit file is closed.

    Calls :meth:`result_file` by default.
    """
    self.result_file('XUnit', path)