Skip to content
Browse files

Add README.md

  • Loading branch information...
1 parent 175e956 commit f3e96d34c72babec7a877aad332b780b08d401f2 Erik Axling committed May 10, 2012
Showing with 19 additions and 0 deletions.
  1. +19 −0 README.md
View
19 README.md
@@ -0,0 +1,19 @@
+ct_surefire
+=============
+
+This is a surefire report generator that can be used to generate
+surefire xml reports for your Erlang Common Test Runs. Unlike the
+native support that is in Common Test (cth_surefire.erl), ct_surefire
+is installed as an event_handler instead of a CT Hook.
+
+You install the event handler as per usual for Common Test:
+ ct_run -suite /path/to/suite_SUITE.erl -event_handler ct_surefire -pa /path/to/ct_surefire.beam
+
+You can make sure there are HTTP links in the surefire testcase reports which can be browsed in e.g. Jenkins. For this to work you need to send in a parameter:
+ ct_run -suite /path/to/suite_SUITE.erl -event_handler_init ct_surefire http://base/path/to/your/logs/url -pa /path/to/ct_surefire.beam
+
+You can also control where the reports will be written by using the
+-surefire_dest_dir flag
+ ct_run -suite /path/to/suite_SUITE.erl -event_handler_init ct_surefire http://base/path/to/your/logs/url -pa /path/to/ct_surefire.beam -surefire_dest_dir /path/to/where/you/like
+
+The reports will have the name junit_report.xml

0 comments on commit f3e96d3

Please sign in to comment.
Something went wrong with that request. Please try again.