robot.reporting package

Implements report, log, output XML, and xUnit file generation.

The public API of this package is the ResultWriter class. It can write result files based on XML output files on the file system, as well as based on the result objects returned by the ExecutionResult() factory method or an executed TestSuite.

It is highly recommended to use the public API via the robot.api package.

This package is considered stable.

Submodules

robot.reporting.jsbuildingcontext module

class robot.reporting.jsbuildingcontext.JsBuildingContext(log_path=None, split_log=False, prune_input=False)

Bases: object

string(string, escape=True, attr=False)

html(string)

relative_source(source)

timestamp(time)

message_level(level)

create_link_target(msg)

link(msg)

strings

start_splitting_if_needed(split=False)

end_splitting(model)

prune_input(**kwds)

robot.reporting.jsexecutionresult module

class robot.reporting.jsexecutionresult.JsExecutionResult(suite, statistics, errors, strings, basemillis=None, split_results=None, min_level=None)

Bases: object

remove_data_not_needed_in_report()

robot.reporting.jsmodelbuilders module

class robot.reporting.jsmodelbuilders.JsModelBuilder(log_path=None, split_log=False, prune_input_to_save_memory=False)

Bases: object

build_from(result_from_xml)

class robot.reporting.jsmodelbuilders.SuiteBuilder(context)

Bases: robot.reporting.jsmodelbuilders._Builder

build(suite)

class robot.reporting.jsmodelbuilders.TestBuilder(context)

Bases: robot.reporting.jsmodelbuilders._Builder

build(test)

class robot.reporting.jsmodelbuilders.KeywordBuilder(context)

Bases: robot.reporting.jsmodelbuilders._Builder

build(kw, split=False)

class robot.reporting.jsmodelbuilders.MessageBuilder(context)

Bases: robot.reporting.jsmodelbuilders._Builder

build(msg)

class robot.reporting.jsmodelbuilders.StatisticsBuilder

Bases: object

build(statistics)

class robot.reporting.jsmodelbuilders.ErrorsBuilder(context)

Bases: robot.reporting.jsmodelbuilders._Builder

build(errors)

class robot.reporting.jsmodelbuilders.ErrorMessageBuilder(context)

Bases: robot.reporting.jsmodelbuilders.MessageBuilder

build(msg)

robot.reporting.jswriter module

class robot.reporting.jswriter.JsResultWriter(output, start_block='<script type="text/javascript">n', end_block='</script>n', split_threshold=9500)

Bases: object

write(result, settings)

class robot.reporting.jswriter.SuiteWriter(write_json, split_threshold)

Bases: object

write(suite, variable)

class robot.reporting.jswriter.SplitLogWriter(output)

Bases: object

write(keywords, strings, index, notify)

robot.reporting.logreportwriters module

class robot.reporting.logreportwriters.LogWriter(js_model)

Bases: robot.reporting.logreportwriters._LogReportWriter

write(path, config)

class robot.reporting.logreportwriters.ReportWriter(js_model)

Bases: robot.reporting.logreportwriters._LogReportWriter

write(path, config)

class robot.reporting.logreportwriters.RobotModelWriter(output, model, config)

Bases: robot.htmldata.htmlfilewriter.ModelWriter

write(line)

handles(line)

robot.reporting.outputwriter module

class robot.reporting.outputwriter.OutputWriter(output, rpa=False)

Bases: robot.output.xmllogger.XmlLogger

start_message(msg)

Called when message starts. Default implementation does nothing.

Can return explicit False to stop visiting.

visit_keyword(kw)

Implements traversing through the keyword and its child keywords.

Can be overridden to allow modifying the passed in kw without calling start_keyword() or end_keyword() nor visiting child keywords.

close()

end_result(result)

end_errors(errors=None)

end_keyword(kw)

Called when keyword ends. Default implementation does nothing.

end_message(msg)

Called when message ends. Default implementation does nothing.

end_stat(stat)

end_statistics(stats)

end_suite(suite)

Called when suite ends. Default implementation does nothing.

end_suite_statistics(tag_stats)

end_tag_statistics(tag_stats)

end_test(test)

Called when test ends. Default implementation does nothing.

end_total_statistics(total_stats)

log_message(msg)

message(msg)

set_log_level(level)

start_errors(errors=None)

start_keyword(kw)

Called when keyword starts. Default implementation does nothing.

Can return explicit False to stop visiting.

start_result(result)

start_stat(stat)

start_statistics(stats)

start_suite(suite)

Called when suite starts. Default implementation does nothing.

Can return explicit False to stop visiting.

start_suite_statistics(tag_stats)

start_tag_statistics(tag_stats)

start_test(test)

Called when test starts. Default implementation does nothing.

Can return explicit False to stop visiting.

start_total_statistics(total_stats)

visit_errors(errors)

visit_message(msg)

Implements visiting the message.

Can be overridden to allow modifying the passed in msg without calling start_message() or end_message().

visit_result(result)

visit_stat(stat)

visit_statistics(stats)

visit_suite(suite)

Implements traversing through the suite and its direct children.

Can be overridden to allow modifying the passed in suite without calling start_suite() or end_suite() nor visiting child suites, tests or keywords (setup and teardown) at all.

visit_suite_statistics(stats)

visit_tag_statistics(stats)

visit_test(test)

Implements traversing through the test and its keywords.

Can be overridden to allow modifying the passed in test without calling start_test() or end_test() nor visiting keywords.

visit_total_statistics(stats)

robot.reporting.resultwriter module

class robot.reporting.resultwriter.ResultWriter(*sources)

Bases: object

A class to create log, report, output XML and xUnit files.

Parameters:sources – Either one Result object, or one or more paths to existing output XML files.

By default writes report.html and log.html, but no output XML or xUnit files. Custom file names can be given and results disabled or enabled using settings or options passed to the write_results() method. The latter is typically more convenient:

writer = ResultWriter(result)
writer.write_results(report='custom.html', log=None, xunit='xunit.xml')

write_results(settings=None, **options)

Writes results based on the given settings or options.

Parameters:

• settings – RebotSettings object to configure result writing.
• options – Used to construct new RebotSettings object if settings are not given.

class robot.reporting.resultwriter.Results(settings, *sources)

Bases: object

result

js_result

robot.reporting.stringcache module

class robot.reporting.stringcache.StringIndex

Bases: int

bit_length() → int

Number of bits necessary to represent self in binary. >>> bin(37) ‘0b100101’ >>> (37).bit_length() 6

conjugate()

Returns self, the complex conjugate of any int.

denominator

the denominator of a rational number in lowest terms

imag

the imaginary part of a complex number

numerator

the numerator of a rational number in lowest terms

real

the real part of a complex number

class robot.reporting.stringcache.StringCache

Bases: object

add(text)

dump()

robot.reporting.xunitwriter module

class robot.reporting.xunitwriter.XUnitWriter(execution_result, skip_noncritical)

Bases: object

write(output)

class robot.reporting.xunitwriter.XUnitFileWriter(xml_writer, skip_noncritical=False)

Bases: robot.result.visitor.ResultVisitor

Provides an xUnit-compatible result file.

Attempts to adhere to the de facto schema guessed by Peter Reilly, see: http://marc.info/?l=ant-dev&m=123551933508682

start_suite(suite)

Called when suite starts. Default implementation does nothing.

Can return explicit False to stop visiting.

end_suite(suite)

Called when suite ends. Default implementation does nothing.

visit_test(test)

Implements traversing through the test and its keywords.

Can be overridden to allow modifying the passed in test without calling start_test() or end_test() nor visiting keywords.

visit_keyword(kw)

Implements traversing through the keyword and its child keywords.

Can be overridden to allow modifying the passed in kw without calling start_keyword() or end_keyword() nor visiting child keywords.

visit_statistics(stats)

visit_errors(errors)

end_result(result)

end_errors(errors)

end_keyword(keyword)

Called when keyword ends. Default implementation does nothing.

end_message(msg)

Called when message ends. Default implementation does nothing.

end_stat(stat)

end_statistics(stats)

end_suite_statistics(suite_stats)

end_tag_statistics(stats)

end_test(test)

Called when test ends. Default implementation does nothing.

end_total_statistics(stats)

start_errors(errors)

start_keyword(keyword)

Called when keyword starts. Default implementation does nothing.

Can return explicit False to stop visiting.

start_message(msg)

Called when message starts. Default implementation does nothing.

Can return explicit False to stop visiting.

start_result(result)

start_stat(stat)

start_statistics(stats)

start_suite_statistics(stats)

start_tag_statistics(stats)

start_test(test)

Called when test starts. Default implementation does nothing.

Can return explicit False to stop visiting.

start_total_statistics(stats)

visit_message(msg)

Implements visiting the message.

Can be overridden to allow modifying the passed in msg without calling start_message() or end_message().

visit_result(result)

visit_stat(stat)

visit_suite(suite)

Implements traversing through the suite and its direct children.

Can be overridden to allow modifying the passed in suite without calling start_suite() or end_suite() nor visiting child suites, tests or keywords (setup and teardown) at all.

visit_suite_statistics(stats)

visit_tag_statistics(stats)

visit_total_statistics(stats)