junitparser package

Submodules

• junitparser.cli module
  • main()
  • merge()
  • verify()
• junitparser.junitparser module
  • Attr
  • Element
    • Element.append()
    • Element.child()
    • Element.extend()
    • Element.fromelem()
    • Element.fromstring()
    • Element.iterchildren()
    • Element.remove()
    • Element.tostring()
  • Error
  • Failure
  • FinalResult
  • FloatAttr
  • IntAttr
  • JUnitXml
    • JUnitXml.name
    • JUnitXml.time
    • JUnitXml.tests
    • JUnitXml.failures
    • JUnitXml.errors
    • JUnitXml.skipped
    • JUnitXml.add_testsuite()
    • JUnitXml.errors
    • JUnitXml.failures
    • JUnitXml.fromfile()
    • JUnitXml.fromroot()
    • JUnitXml.fromstring()
    • JUnitXml.name
    • JUnitXml.skipped
    • JUnitXml.tests
    • JUnitXml.testsuite
    • JUnitXml.time
    • JUnitXml.update_statistics()
    • JUnitXml.write()
  • JUnitXmlError
  • Properties
    • Properties.add_property()
  • Property
    • Property.name
    • Property.value
    • Property.name
    • Property.value
  • Result
    • Result.message
    • Result.type
    • Result.message
    • Result.text
    • Result.type
  • Skipped
  • System
    • System.text
    • System.text
  • SystemErr
  • SystemOut
  • TestCase
    • TestCase.name
    • TestCase.classname
    • TestCase.time
    • TestCase.ITER_TYPES
    • TestCase.classname
    • TestCase.is_error
    • TestCase.is_failure
    • TestCase.is_passed
    • TestCase.is_skipped
    • TestCase.name
    • TestCase.result
    • TestCase.system_err
    • TestCase.system_out
    • TestCase.time
  • TestSuite
    • TestSuite.name
    • TestSuite.hostname
    • TestSuite.time
    • TestSuite.timestamp
    • TestSuite.tests
    • TestSuite.failures
    • TestSuite.errors
    • TestSuite.skipped
    • TestSuite.add_property()
    • TestSuite.add_testcase()
    • TestSuite.add_testcases()
    • TestSuite.add_testsuite()
    • TestSuite.errors
    • TestSuite.failures
    • TestSuite.hostname
    • TestSuite.name
    • TestSuite.properties()
    • TestSuite.remove_property()
    • TestSuite.remove_testcase()
    • TestSuite.skipped
    • TestSuite.testcase
    • TestSuite.tests
    • TestSuite.testsuites()
    • TestSuite.time
    • TestSuite.timestamp
    • TestSuite.update_statistics()
    • TestSuite.write()
  • attributed()
  • junitxml
  • write_xml()
• junitparser.xunit2 module
  • FlakyError
  • FlakyFailure
  • InterimResult
    • InterimResult.stack_trace
    • InterimResult.system_err
    • InterimResult.system_out
  • JUnitXml
    • JUnitXml.skipped
    • JUnitXml.testsuite
    • JUnitXml.update_statistics()
  • RerunError
  • RerunFailure
  • StackTrace
  • TestCase
    • TestCase.ITER_TYPES
    • TestCase.add_interim_result()
    • TestCase.flaky_errors()
    • TestCase.flaky_failures()
    • TestCase.group
    • TestCase.interim_result
    • TestCase.is_flaky
    • TestCase.is_rerun
    • TestCase.rerun_errors()
    • TestCase.rerun_failures()
  • TestSuite
    • TestSuite.file
    • TestSuite.group
    • TestSuite.id
    • TestSuite.log
    • TestSuite.package
    • TestSuite.system_err
    • TestSuite.system_out
    • TestSuite.testcase
    • TestSuite.url
    • TestSuite.version

Module contents

class junitparser.Attr(name: str = None)

Bases: object

An attribute for an XML element.

By default they are all string values. To support different value types, inherit this class and define your own methods.

Also see: IntAttr, FloatAttr.

class junitparser.Element(name: str = None)

Bases: object

Base class for all JUnit XML elements.

append(sub_elem)

Add the element subelement to the end of this elements internal list of subelements.

child(Child)

Find a single child of specified Child type.

extend(sub_elems)

Add elements subelement to the end of this elements internal list of subelements.

classmethod fromelem(elem)

Construct JUnit objects from an ElementTree element elem.

classmethod fromstring(text: str)

Construct JUnit object cls from XML string test.

iterchildren(Child)

Iterate through specified Child type elements.

remove(sub_elem)

Remove subelement sub_elem.

tostring()

Convert element to XML string.

class junitparser.Error(message: str = None, type_: str = None)

Bases: FinalResult

Test result when the case has errors during execution.

class junitparser.Failure(message: str = None, type_: str = None)

Bases: FinalResult

Test result when the case failed.

class junitparser.FloatAttr(name: str = None)

Bases: Attr

A float attribute for an XML element.

This class is used internally for counting test durations, but you could use it for any specific purpose.

class junitparser.IntAttr(name: str = None)

Bases: Attr

An integer attribute for an XML element.

This class is used internally for counting testcases, but you could use it for any specific purpose.

class junitparser.JUnitXml(name=None)

Bases: Element

The JUnitXml root object.

It may contain <TestSuites> or a <TestSuite>.

name

Name of the testsuite if it only contains one testsuite.

time

Time consumed by the testsuites.

tests

Total number of tests.

failures

Number of failed cases.

errors

Number of cases with errors.

skipped

Number of skipped cases.

add_testsuite(suite: TestSuite)

Add a testsuite.

errors

An integer attribute for an XML element.

This class is used internally for counting testcases, but you could use it for any specific purpose.

failures

An integer attribute for an XML element.

This class is used internally for counting testcases, but you could use it for any specific purpose.

classmethod fromfile(file: str | IO, parse_func=None)

Construct JUnit objects from an XML file.

The file can be any of the following:

• a file name/path

• a file object

• a file-like object

• a URL using the HTTP or FTP protocol (with lxml only)

classmethod fromroot(root_elem: Element)

Construct JUnit objects from an elementTree root element.

classmethod fromstring(text: str | bytes)

Construct JUnit objects from an XML string (str or bytes).

name

An attribute for an XML element.

By default they are all string values. To support different value types, inherit this class and define your own methods.

Also see: IntAttr, FloatAttr.

skipped

An integer attribute for an XML element.

This class is used internally for counting testcases, but you could use it for any specific purpose.

tests

An integer attribute for an XML element.

This class is used internally for counting testcases, but you could use it for any specific purpose.

testsuite

alias of TestSuite

time

A float attribute for an XML element.

This class is used internally for counting test durations, but you could use it for any specific purpose.

update_statistics()

Update test count, time, etc.

write(file_or_filename: str | IO | None = None, *, pretty: bool = False)

Write the object into a JUnit XML file.

If file_or_filename is not specified, it will write to the original filename. If pretty is True, the result file will be more human friendly.

exception junitparser.JUnitXmlError

Bases: Exception

Exception for JUnit XML related errors.

class junitparser.Properties

Bases: Element

A list of properties inside a testsuite.

See Property

add_property(property_: Property)

class junitparser.Property(name: str = None, value: str = None)

Bases: Element

A key/value pare that’s stored in the testsuite.

Use it to store anything you find interesting or useful.

name

The property name.

value

The property value.

name

An attribute for an XML element.

By default they are all string values. To support different value types, inherit this class and define your own methods.

Also see: IntAttr, FloatAttr.

value

An attribute for an XML element.

By default they are all string values. To support different value types, inherit this class and define your own methods.

Also see: IntAttr, FloatAttr.

class junitparser.Skipped(message: str = None, type_: str = None)

Bases: FinalResult

Test result when the case is skipped.

class junitparser.SystemErr(content: str = None)

Bases: System

class junitparser.SystemOut(content: str = None)

Bases: System

class junitparser.TestCase(name: str = None, classname: str = None, time: float = None)

Bases: Element

Object to store a testcase and its result.

name

Name of the testcase.

classname

The parent class of the testcase.

time

The time consumed by the testcase.

ITER_TYPES = {'error': <class 'junitparser.junitparser.Error'>, 'failure': <class 'junitparser.junitparser.Failure'>, 'skipped': <class 'junitparser.junitparser.Skipped'>, 'system-err': <class 'junitparser.junitparser.SystemErr'>, 'system-out': <class 'junitparser.junitparser.SystemOut'>}

classname

An attribute for an XML element.

By default they are all string values. To support different value types, inherit this class and define your own methods.

Also see: IntAttr, FloatAttr.

property is_error

Whether this testcase errored.

property is_failure

Whether this testcase failed.

property is_passed

Whether this testcase was a success (i.e. if it isn’t skipped, failed, or errored).

property is_skipped

Whether this testcase was skipped.

name

An attribute for an XML element.

By default they are all string values. To support different value types, inherit this class and define your own methods.

Also see: IntAttr, FloatAttr.

property result: List[FinalResult]

A list of Failure, Skipped, or Error objects.

property system_err

stderr.

property system_out

stdout.

time

A float attribute for an XML element.

This class is used internally for counting test durations, but you could use it for any specific purpose.

class junitparser.TestSuite(name=None)

Bases: Element

The <testsuite> object.

name

The name of the testsuite.

hostname

Name of the test machine.

time

Time consumed by the testsuite.

timestamp

When the test was run.

tests

Total number of tests.

failures

Number of failed tests.

errors

Number of cases with errors.

skipped

Number of skipped cases.

add_property(name: str, value: str)

Add a property name = value to the testsuite.

See Property and Properties.

add_testcase(testcase: TestCase)

Add a testcase testcase to the testsuite.

add_testcases(testcases: List[TestCase])

Add testcases testcases to the testsuite.

add_testsuite(suite)

Add a testsuite suite to the testsuite.

errors

An integer attribute for an XML element.

This class is used internally for counting testcases, but you could use it for any specific purpose.

failures

An integer attribute for an XML element.

This class is used internally for counting testcases, but you could use it for any specific purpose.

hostname

An attribute for an XML element.

By default they are all string values. To support different value types, inherit this class and define your own methods.

Also see: IntAttr, FloatAttr.

name

An attribute for an XML element.

By default they are all string values. To support different value types, inherit this class and define your own methods.

Also see: IntAttr, FloatAttr.

properties()

Iterate through all Property elements in the testsuite.

remove_property(property_: Property)

Remove property property_ from the testsuite.

remove_testcase(testcase: TestCase)

Remove testcase testcase from the testsuite.

skipped

An integer attribute for an XML element.

This class is used internally for counting testcases, but you could use it for any specific purpose.

testcase

alias of TestCase

tests

An integer attribute for an XML element.

This class is used internally for counting testcases, but you could use it for any specific purpose.

testsuites()

Iterate through all testsuites.

time

A float attribute for an XML element.

This class is used internally for counting test durations, but you could use it for any specific purpose.

timestamp

An attribute for an XML element.

By default they are all string values. To support different value types, inherit this class and define your own methods.

Also see: IntAttr, FloatAttr.

update_statistics()

Update test count and test time.

write(file_or_filename: str | IO | None = None, *, pretty: bool = False)