_pytest.junitxml module

Based on initial code from Ross Lawley.

Output conforms to https://github.com/jenkinsci/xunit-plugin/blob/master/ src/main/resources/org/jenkinsci/plugins/xunit/types/model/xsd/junit-10.xsd

class Junit

Bases: py._xmlgen.Namespace

bin_xml_escape(arg)

merge_family(left, right)

class _NodeReporter(nodeid, xml)

Bases: object

append(node)

add_property(name, value)

add_attribute(name, value)

make_properties_node()

Return a Junit node containing custom properties, if any.

record_testreport(testreport)

to_xml()

_add_simple(kind, message, data=None)

write_captured_output(report)

_prepare_content(content, header)

_write_content(report, content, jheader)

append_pass(report)

append_failure(report)

append_collect_error(report)

append_collect_skipped(report)

append_error(report)

append_skipped(report)

finalize()

_warn_incompatibility_with_xunit2(request, fixture_name)

Emits a PytestWarning about the given fixture being incompatible with newer xunit revisions

record_property(request)

Add an extra properties the calling test. User properties become part of the test report and are available to the configured reporters, like JUnit XML. The fixture is callable with (name, value), with value being automatically xml-encoded.

Example:

def test_function(record_property):
    record_property("example_key", 1)

record_xml_attribute(request)

Add extra xml attributes to the tag for the calling test. The fixture is callable with (name, value), with value being automatically xml-encoded

_check_record_param_type(param, v)

Used by record_testsuite_property to check that the given parameter name is of the proper type

record_testsuite_property(request)

Records a new <property> tag as child of the root <testsuite>. This is suitable to writing global information regarding the entire test suite, and is compatible with xunit2 JUnit family.

This is a session-scoped fixture which is called with (name, value). Example:

def test_foo(record_testsuite_property):
    record_testsuite_property("ARCH", "PPC")
    record_testsuite_property("STORAGE_TYPE", "CEPH")

name must be a string, value will be converted to a string and properly xml-escaped.

pytest_addoption(parser)

pytest_configure(config)

pytest_unconfigure(config)

mangle_test_address(address)

class LogXML(logfile, prefix, suite_name='pytest', logging='no', report_duration='total', family='xunit1', log_passing_tests=True)

Bases: object

finalize(report)

node_reporter(report)

add_stats(key)

_opentestcase(report)

pytest_runtest_logreport(report)

handle a setup/call/teardown report, generating the appropriate xml tags as necessary.

note: due to plugins like xdist, this hook may be called in interlaced order with reports from other nodes. for example:

usual call order:

-> setup node1 -> call node1 -> teardown node1 -> setup node2 -> call node2 -> teardown node2

possible call order in xdist:

-> setup node1 -> call node1 -> setup node2 -> call node2 -> teardown node2 -> teardown node1

update_testcase_duration(report)

accumulates total duration for nodeid from given report and updates the Junit.testcase with the new total if already created.

pytest_collectreport(report)

pytest_internalerror(excrepr)

pytest_sessionstart()

pytest_sessionfinish()

pytest_terminal_summary(terminalreporter)

add_global_property(name, value)

_get_global_properties_node()

Return a Junit node containing custom properties, if any.