Struct Report 

pub struct Report {
    pub name: XmlString,
    pub uuid: Option<ReportUuid>,
    pub timestamp: Option<DateTime<FixedOffset>>,
    pub time: Option<Duration>,
    pub tests: usize,
    pub failures: usize,
    pub errors: usize,
    pub test_suites: Vec<TestSuite>,
}

The root element of a JUnit report.

Fields

name: XmlString

The name of this report.

uuid: Option<ReportUuid>

A unique identifier associated with this report.

This is an extension to the spec that’s used by nextest.

timestamp: Option<DateTime<FixedOffset>>

The time at which the first test in this report began execution.

This is not part of the JUnit spec, but may be useful for some tools.

time: Option<Duration>

The overall time taken by the test suite.

This is serialized as the number of seconds.

tests: usize

The total number of tests from all TestSuites.

failures: usize

The total number of failures from all TestSuites.

errors: usize

The total number of errors from all TestSuites.

test_suites: Vec<TestSuite>

The test suites contained in this report.

Implementations

impl Report

pub fn deserialize<R: BufRead>(reader: R) -> Result<Self, DeserializeError>

Experimental: Deserializes a JUnit XML report from a reader.

The deserializer should work with JUnit reports generated by the quick-junit crate, but might not work with JUnit reports generated by other tools. Patches to fix this are welcome.

Errors

Returns an error if the XML is malformed, or if required attributes are missing.

pub fn deserialize_from_str(xml: &str) -> Result<Self, DeserializeError>

Deserializes a JUnit XML report from a string.

Errors

Returns an error if the XML is malformed, or if required attributes are missing.

Examples

use quick_junit::Report;

let xml = r#"<?xml version="1.0" encoding="UTF-8"?>
<testsuites name="my-test-run" tests="1" failures="0" errors="0">
    <testsuite name="my-test-suite" tests="1" disabled="0" errors="0" failures="0">
        <testcase name="success-case"/>
    </testsuite>
</testsuites>
"#;

let report = Report::deserialize_from_str(xml).unwrap();
assert_eq!(report.name.as_str(), "my-test-run");
assert_eq!(report.tests, 1);

impl Report

pub fn new(name: impl Into<XmlString>) -> Self

Creates a new Report with the given name.

pub fn set_report_uuid(&mut self, uuid: ReportUuid) -> &mut Self

Sets a unique ID for this Report.

This is an extension that’s used by nextest.

pub fn set_uuid(&mut self, uuid: Uuid) -> &mut Self

Sets a unique ID for this Report from an untyped Uuid.

This is an extension that’s used by nextest.

pub fn set_timestamp( &mut self, timestamp: impl Into<DateTime<FixedOffset>>, ) -> &mut Self

Sets the start timestamp for the report.

pub fn set_time(&mut self, time: Duration) -> &mut Self

Sets the time taken for overall execution.

pub fn add_test_suite(&mut self, test_suite: TestSuite) -> &mut Self

Adds a new TestSuite and updates the tests, failures and errors counts.

When generating a new report, use of this method is recommended over adding to self.TestSuites directly.

pub fn add_test_suites( &mut self, test_suites: impl IntoIterator<Item = TestSuite>, ) -> &mut Self

Adds several TestSuites and updates the tests, failures and errors counts.

When generating a new report, use of this method is recommended over adding to self.TestSuites directly.

pub fn serialize(&self, writer: impl Write) -> Result<(), SerializeError>

Serialize this report to the given writer.

pub fn to_string(&self) -> Result<String, SerializeError>

Serialize this report to a string.

Trait Implementations

impl Clone for Report

fn clone(&self) -> Report

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Report

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Report

fn eq(&self, other: &Report) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Report

impl StructuralPartialEq for Report