Jenkins
Space shortcuts
Child pages
  • xUnit Plugin

Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
  • Created by Unknown User (gboissinot), last modified by Unknown User (gbois) on May 03, 2013
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 149 Next »

Plugin Information

View xUnit on the plugin site for more information.

This plugin makes it possible to publish the test results of an execution of a testing tool in Jenkins.

Features

  • Records xUnit tests
  • Mark the build unstable or fail according to threshold values

Supported tools

Embedded tools

* JUnit itself
* AUnit
* MSTest (imported from MSTest Plugin)
* NUnit (imported form NUnit Plugin)
* UnitTest++
* Boost Test Library
* PHPUnit
* Free Pascal Unit
* CppUnit
* MbUnit

Other plugins as an extension of the xUnit plugin:

* Gallio (Gallio plugin)
* Parasoft C++Test tool(Cpptest Plugin)
* JSUnit (JSUnit Plugin)
* JBehave

External contributions

For each xUnit tool, an embedded style sheet is used. However, the plugin also enables you to use a custom style sheet for your own tool such as :
* WebUI

Configuration

Job Configuration

* Execute your testing tools manually or as a step of your build chain
* Give a pattern that specifies your test results

Showing the details:

Manage Jenkins > System Log > Add new log recorder.

Give a name as 'xUnit Logger' and add the following logger:

  • "XUnitService" for a severity as 'all'

Provide User XSL

For tools using a stylesheet to convert into JUnit files, you are able to use your own XSL at Jenkins level.
Specify your XSLs in the JENKINS_HOME/useContent directory with the following convention
userContent/xunit/[toolName]/[version]/[your_xsl].

For example:
userContent/xunit/AUnit/3.1.1/aunit-to-junit.xsl

Note: The tool name and the version are taken from the label in the combo box from the UI.
If the tool doesn't have a version, do not create a version directory.

xUnit Architecture

Global Architecture

When this plugin is installed and configured, Jenkins can transform test result reports produced by different testing tools into JUnit test result format. The JUnit tests can then be recorded by Jenkins.
Jenkins can provide useful information about test results, such as the historical test result trend, web UI for viewing test reports, tracking failures, and so on.

Under the hood, xUnit Jenkins plugin delegates processing to DTKit.

DTKit Activities for XUnit

DTKit Packaging

Changelog

Version 1.55

* Fix JENKINS-17797 - x-unit option not to fail if there isn't a test results file

Version 1.54

* Fix JENKINS-17438 - xunit - Custom Tool - Custom stylesheet - Global Property specified does not get resolved

Version 1.53

* Fix JENKINS-17345 - generatedJUnitFiles does not exist

Version 1.52

* Fix JENKINS-16192 - xUnit plugin is using ancient XSL transform for NUnit, misses skipped tests
* Upgrade to

  • dtkit-metrics-parent 11
  • dtkit-junit-model 0.17
  • dtkit-metrics-parent 11
  • dtkit-metrics-default-parent 19
  • dtkit-default-junit 0.33

Version 1.51

* Add MbUnit support

Version 1.50

* Fix reopened JENKINS-11542 - Add support for QTestLib XML reports

Version 1.49

* Fix JENKINS-11542 - Add support for QTestLib XML reports
* Upgrade dependencies

  • dtkit-metrics-parent 10
  • dtkit-frmk 0.17 (fix typo for failIfFailure checkbox)
  • dtkit-plugin 0.13
  • dtkit-metrics-default-parent 18
  • dtkit-default-junit 0.32

Version 1.48

* Fix JENKINS-14628 - Fatal error on JSON parsing
* Fix JENKINS-15006 - Error while saving job configuration. Cannot update job configuration (1.464)

Version 1.47

* Fix JENKINS-14517 - xUnit does not store threshold mode in config.xml

Version 1.46

* Fix JENKINS-14052 - xUnit fails with NumberFormatException if threshold fields filled out in a certain way

Version 1.45

* Fix JENKINS-13967 - Xunit don't recognize cppunit report with time execution

Version 1.44

* Update to dtkit-default-junit 0.30 (Fix CppTestUnit space)

Version 1.43

* Fix JENKINS-13036 - Boost-Test parsing (manage BuildInfo section)

Version 1.42

* Fix JENKINS-8460 - xUnit does not parse nested <testsuite>-tags from PHPUnit

Version 1.41

* Add threshold with percent values

Version 1.40

* Fix JENKINS-12832 - check XSLT is not good enough

Version 1.39

* Update to dtkit-default-junit 0.27 (aunit 3.x)

Version 1.38

* Update to dtkit.default.junit.version 0.26 (Add support exception element of the aunit tool)

Version 1.37

* Fix execution with the DryRun Plugin

Version 1.36

* Fix JENKINS-12026 - xunit fails to parse boost test XML log

Version 1.35

* Fix JENKINS-12336 - Fail the build if test results were not updated this run" has no effect for JUnit

Version 1.34

* Accept test results when the number of tests is 0
* Add a JUnit type (therefore, xUnit plugin is an alternative to the JUnit archiver option)

Version 1.33

* Update to DTKit 0.24 /- fix CppUnit format check

Version 1.32

* Fix JENKINS-11908 - PHPUnit results xml fails to parse

Version 1.31

* Fix JENKINS-11858 - xUnit v1.30 fails with NullPointerException when parsing cppnit results

Version 1.30

* Add a threshold for skipped tests and failed tests

Version 1.29

* Make it compatible to the DryRun Plugin
Note: Built against Jenkins 1.410 required by the dry-run plugin.
Without the dry-run feature, the plugin is compatible to 1.409 series (LTS)

Version 1.28

* Add the ability to override embedded XSLs at Jenkins level (look above for documentation)

Version 1.27

* Fix reponed JENKINS-11552 - xUnit don't work with NUnit test since 1.25

Version 1.26.1

* Add error messages when an issue occurs

Version 1.26

* Fix reponed JENKINS-9286 - xUnit plugin cannot parse XML output with exception from boost test 1.42

Version 1.25

* Introduce Alias for the job configuration file
* Update to dtkit-default-junit 0.22 (Removed unused descriptor method)

Version 1.24

* Fix JENKINS-11344 - xUnit fails to parse boost test log

Version 1.23

* Fix JENKINS-10909 - Added support of Check tool

Version 1.22

* Fix JENKINS-10717 - xUnit boost test log processing fails on nested test suites (BOOST_AUTO_TEST_SUITE)

Version 1.21 (technical release)

* Remove unused transitive dependencies

Version 1.20

* Fix JENKINS-10404 - UnitTest++ "time" element is ignored in results page, Duration field reported as 0ms

Version 1.19

* Fix JENKINS-9286 - xUnit plugin cannot parse XML output with exception from boost test 1.42

Version 1.18

* Update to DTKIT JUnit Format 0.16 - Added the support of skipped element

Version 1.17

* Update to DTKIT Default Junit 0.17
* Update to Jenkins 1.411 metadata

Version 1.16.2

* Fix JENKINS-9106 Custom type configuration does not pick up "Stop Processing If Error" flag

Version 1.16.1

* Fix reopen JENKINS-8843 The plugin hasn't been performed correctly: null
* Fix JENKINS-8901 The plugin hasn't been performed correctly: Unable to serialize hudson.FilePath$FileCallableWrapper@b749a3

Version 1.16

* Fix JENKINS-8843 The plugin hasn't been performed correctly: null

Version 1.15

* Fix JENKINS-6344 - fail build if any empty files exist, or provide option to do it
* Fix JENKINS-7612 - Superfluous INFO messages in console output
* Update to Jenkins 1.397 API and metadata

Version 1.14

* Fix JENKINS-8492 - NUnit test suites is not parsed correctly
* Fix JENKINS-8553 - BoostTest output coverting to JUnit format can't be recognized if contains Exceptions in boostTest result
* Fix JENKINS-8485 and JENKINS-8516
* Fix JENKINS-8787 CustomTypeDescriptor throws a RuntimeExcetion at startup
* Update to DTKIT Default Junit 0.15
* Update to DTKIT DEFAULT FRMK 0.12
* Update to DTKIT FORMAT 0.13
* Update to Jenkins 1.396 API and metadata

Version 1.13

* Update to DTKIT Default Junit 0.13
* Update to DTKIT DEFAULT FRMK 0.11

Version 1.12

* Update to DTKIT Default Junit 0.12
* Update to DTKIT DEFAULT FORMAT 0.12

Version 1.11

* Update to DTKIT FRMK 0.10
* Update to DTKIT FORMAT 0.10
* Fix JENKINS-7943 - BOOST TestType hides master suites in the hierachy
* Fix JENKINS-7925 - BOOST TestType fail during validation

Version 1.10

* Update to DTKIT FRMK 0.9
* Update to DTKIT FORMAT 0.9
* Remove Guice injection on slave mode due to classloading issues.

Version 1.9

* Update to DTKIT Default Junit 0.9
* Update to DTKIT FRMK 0.8
* Fix JENKINS-7463 - BoosTest XSD enhanced
* Fix JENKINS-7323 - Can't create the report path

Version 1.8

* Update to DTKIT Default Junit 0.7
* Update to DTKIT FRMK 0.6
* Fix JENKINS-7336

Version 1.7

* Update to DTKIT Default Junit 0.6
* Update to DTKIT FRMK 0.5
* Restore the CustomType (enables users to provide a custom XSL) removed from 1.0

Version 1.6

* Update to DTKIT Default Junit 0.4 (Fixed reopened JENKINS-6951)
* Update to DTKIT FRMK 0.2

Verision 1.5

* Updated to DTKIT Default Junit 0.3 (Fixed JENKINS-6951)

Verision 1.4

* Fix the help file

Verision 1.3

* Update to DTKit 0.2 (Fixed PHPUnit xsd and xsl)
* Add the display of validation errors in the console for input and output files.

Version 1.2

* Fix big regression issue for backward compatibility with xUnit 0.6 JENKINS-6946

Version 1.1

* Improve deletion algorithm.

Version 1.0

* xUnit currently follows a new model based on dtkit

Version 0.6.1

* Spelling Correction

Version 0.6

* Remove Embedded Cppunit plugin (Cppunit plugin extends xUnit plugin)
* Remove Embedded Gallio plugin (Gallio plugin extends xUnit plugin)

Version 0.5.3

* Add 'Delete Temporary JUnit files' option

Version 0.5.2.1

* Fix JENKINS-5680 : Fixed regression introduced in 0.5.2: Added backward compatibility with a previous
configuration before 0.5.2

Version 0.5.2

* Fix JENKINS-4945 : Show one graph when JUnit publisher is actived
* Fix JENKINS-4931 : Adding a check-box option 'Fail the build if test results were not
updated this run'

Version 0.5.1

* Fix some labels

Version 0.5

* Add the support of Free Pascal Unit

Version 0.4

* Remove the AUnit support.
AUnit (Ada test framework) is provided by the Gnat Plugin.
Note: Gnat plugin extends the xUnit plugin

Version 0.3.1

* Restore the removed feature in xUnit 0.2 : Added the ability to use a custom xUnit tool with a custom style sheet.
* You can override the embedded stylesheet by a one at the workspace level.

Version 0.3

* Fix issue 4416

Version 0.2

* The plugin use @Extension and ExtensionPoint to allow other plugins to add a Descriptor (issue 4315)
* [BoostTest Library] - Display the output of the macros MESSAGE,INFO and WARNING in Hudson test results
* [PHPUnit] - Fixed stylesheet
* Fix bug on suite name content with special character

Version 0.1.3

* [BoostTest Library] - Flatten root package

Version 0.1.2

* Fix "java.lang.NoSuchMethodError: java.lang.String.isEmpty()"
* Add the ability to work on slaves

Version 0.1.1

* Fix java.util.MissingResourceException on Linux Plateform
* [BoostTest] - Fixed tests duration issue with Boost Test Library

Version 0.1

* Initial release

  • No labels