Recent changes to Home

Home modified by Andreas Nyberg

Andreas Nyberg — Tue, 02 Sep 2014 12:25:36 -0000

Home modified by Andreas Nyberg

Andreas Nyberg — Tue, 02 Sep 2014 11:52:49 -0000

--- v8
+++ v9
@@ -6,6 +6,19 @@
 There are two versions that can be downloaded, a Jenkins plugin or as a stand alone tool.

 ## UnitTH Jenkins plugin ##
+For Jenkins users there is a light version of the tool that provides the test failure matrix for a given job.
+
+**Installing**
+Download the latest plugin from here: <https: sourceforge.net="" projects="" junitth="" files="" unitth-jenkins-plugin=""/>. Then on the manage plugins page in Jenkins there is an Advanced tab, where you can upload the unitth plugin, no further configuration needed.
+
+**Using it**
+In the job configuration UnitTH will surface as a Post-build action, select it together with publish JUnit test results which generates the slimmed down XML needed that UnitTH parses the test history.
+
+* As Post-build actions
+    1. Configure Publish JUnit test results
+    * Enable UnitTH
+
+The results will then be available from the job sidebar.

 ## UnitTH as a standalone tool ##
 For the test history report generated using the console it displays various different sortable test statistics, trends, graphs and references to the included JUnit test reports.

Home modified by Andreas Nyberg

Andreas Nyberg — Tue, 02 Sep 2014 11:42:56 -0000

--- v7
+++ v8
@@ -8,7 +8,6 @@
 ## UnitTH Jenkins plugin ##

 ## UnitTH as a standalone tool ##
-[[download_button]]
 For the test history report generated using the console it displays various different sortable test statistics, trends, graphs and references to the included JUnit test reports.

 ### Using UnitTH from the console ###
@@ -82,3 +81,6 @@
   </java>
 </target>
 
+
+## Downloads ##
+[[download_button]]

Home modified by Andreas Nyberg

Andreas Nyberg — Tue, 02 Sep 2014 11:42:14 -0000

--- v6
+++ v7
@@ -8,6 +8,7 @@
 ## UnitTH Jenkins plugin ##

 ## UnitTH as a standalone tool ##
+[[download_button]]
 For the test history report generated using the console it displays various different sortable test statistics, trends, graphs and references to the included JUnit test reports.

 ### Using UnitTH from the console ###
@@ -81,4 +82,3 @@
   </java>
 </target>
 
-[[download_button]]

Home modified by Andreas Nyberg

Andreas Nyberg — Tue, 02 Sep 2014 11:41:16 -0000

Home modified by Andreas Nyberg

Andreas Nyberg — Tue, 02 Sep 2014 11:39:54 -0000

--- v4
+++ v5
@@ -54,4 +54,31 @@
 </target>
 

+**Generating a test history**
+
+The generate.history target takes the input folders as a single argument. The rest of the test history generation parmeters will be picked up by the unitth.properties file in the current folder in $HOME. 
+
+
+<target name="generate.history" description="Generates a test history from existing Unit-reports.">
+  <java jar="${bin.dir}/unitth.jar" fork="true" failonerror="true" maxmemory="128m">
+    <arg value="${reportStorage}/report-*"/>
+  </java>
+</target>
+
+The properties read from the unitth.properties can be overridden by defining system properties. Include the sysproperty in your ant target.
+
+
+<-- Example where system properties are set -->
+<target name="generate.history" description="Generates a test history from existing Unit-reports.">
+  <java jar="${bin.dir}/unitth.jar" fork="true" failonerror="true" maxmemory="128m">
+  
+    <sysproperty key="unitth.html.report.path" value="."/>
+    <sysproperty key="unitth.report.dir" value="report.out"/>
+    <sysproperty key="unitth.generate.exectimegraphs" value="false"/>
+    <sysproperty key="unitth.xml.report.filter" value="TEST-"/>
+  
+    <arg value="${reportStorage}/report-*"/>
+  </java>
+</target>
+
 [[download_button]]

Home modified by Andreas Nyberg

Andreas Nyberg — Tue, 02 Sep 2014 11:37:54 -0000

--- v3
+++ v4
@@ -1,21 +1,16 @@
 [TOC]

-UnitTH
-======
+# UnitTH #
 UnitTH is a tool for generating a set of HTML test history pages from JUnit and TestNG test results.

 There are two versions that can be downloaded, a Jenkins plugin or as a stand alone tool.

-UnitTH Jenkins plugin
----------------------
+## UnitTH Jenkins plugin ##

-
-UnitTH as a standalone tool
----------------------------
+## UnitTH as a standalone tool ##
 For the test history report generated using the console it displays various different sortable test statistics, trends, graphs and references to the included JUnit test reports.

-**Using UnitTH from the console**
-
+### Using UnitTH from the console ###
 * Unzip the downloadable zip-file
 * Copy the unitth.properties file to $HOME or to the folder from where to execute UnitTH
 * Set the correct settings in the unitth.properties files
@@ -27,13 +22,36 @@
 * -v --version Shows the UnitTH version.

 **Example:**
-:::bash
-$ java -jar unzippedToFolder/unitth.jar storedAwayReports/report*
+
+$ java -jar unzippedToFolder/unitth.jar storedAwayReports/report∗
+
+The properties set in the unitth.properties file can be overridden using system properties as exemplified below.
+
+$ java -Dunitth.report.dir=<report to="" folder=""> -jar unzippedToFolder/unitth.jar storedAwayReports/report∗
+

-The properties set in the unitth.properties file can be overridden using system properties as exemplified below.
+### Integrating UnitTH with Ant scripts ###
+The top three targets below shall be well known. Storing the test report and generating the test history targets might be new targets to implement. Below are examples for how these can be implemented.

-$ java -Dunitth.report.dir=<report to="" folder=""> -jar unzippedToFolder/unitth.jar storedAwayReports/report*
+* build
+* test
+* generate test report
+* store test report
+* generate test history report

+**Storing the test report**

+Create a simple target that copies away the latest generated test report. Use the same folder for all stored away test reports to make it simpler to point out which folders to use as input for the test history generation. 
+
+
+<target name="store.junit.report" description="Saves away the generated JUnit test report.">
+  <tstamp>
+    <format property="start.timestamp" pattern="yyyyMMdd-HHmmss"/>
+  </tstamp>
+  <copy todir="${reportStorage}/report-${start.timestamp}">
+    <fileset dir="report"/>
+  </copy>
+</target>
+

 [[download_button]]

Home modified by Andreas Nyberg

Andreas Nyberg — Tue, 02 Sep 2014 10:21:33 -0000

--- v2
+++ v3
@@ -1,6 +1,7 @@
+[TOC]
+
 UnitTH
 ======
-
 UnitTH is a tool for generating a set of HTML test history pages from JUnit and TestNG test results.

 There are two versions that can be downloaded, a Jenkins plugin or as a stand alone tool.
@@ -25,5 +26,14 @@
 * -h --help Shows the UnitTH help.
 * -v --version Shows the UnitTH version.

+**Example:**
+:::bash
+$ java -jar unzippedToFolder/unitth.jar storedAwayReports/report*
+
+The properties set in the unitth.properties file can be overridden using system properties as exemplified below.
+
+$ java -Dunitth.report.dir=<report to="" folder=""> -jar unzippedToFolder/unitth.jar storedAwayReports/report*
+
+

 [[download_button]]

Home modified by Andreas Nyberg

Andreas Nyberg — Tue, 02 Sep 2014 10:14:16 -0000

--- v1
+++ v2
@@ -1,8 +1,29 @@
-Welcome to your wiki!
+UnitTH
+======

-This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].
+UnitTH is a tool for generating a set of HTML test history pages from JUnit and TestNG test results.

-The wiki uses [Markdown](/p/junitth/wiki/markdown_syntax/) syntax.
+There are two versions that can be downloaded, a Jenkins plugin or as a stand alone tool.

-[[members limit=20]]
+UnitTH Jenkins plugin
+---------------------
+
+
+UnitTH as a standalone tool
+---------------------------
+For the test history report generated using the console it displays various different sortable test statistics, trends, graphs and references to the included JUnit test reports.
+
+**Using UnitTH from the console**
+
+* Unzip the downloadable zip-file
+* Copy the unitth.properties file to $HOME or to the folder from where to execute UnitTH
+* Set the correct settings in the unitth.properties files
+* Run the jar file taking a set of JUnit test report folders as input (XML format)
+
+**Input flags**
+
+* -h --help Shows the UnitTH help.
+* -v --version Shows the UnitTH version.
+
+
 [[download_button]]

Home modified by Andreas Nyberg

Andreas Nyberg — Thu, 25 Apr 2013 18:32:44 -0000

Welcome to your wiki!

This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].

The wiki uses Markdown syntax.

Project Members:

Andreas Nyberg (admin)