maven-surefire-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From krosenv...@apache.org
Subject svn commit: r933532 - in /maven/surefire/trunk/maven-surefire-plugin/src/site: apt/examples/junit.apt.vm apt/index.apt site.xml
Date Tue, 13 Apr 2010 09:42:11 GMT
Author: krosenvold
Date: Tue Apr 13 09:42:11 2010
New Revision: 933532

URL: http://svn.apache.org/viewvc?rev=933532&view=rev
Log:
o Added documentation section on the junit providers, including info on concurrent junit

Added:
    maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/junit.apt.vm   (with
props)
Modified:
    maven/surefire/trunk/maven-surefire-plugin/src/site/apt/index.apt
    maven/surefire/trunk/maven-surefire-plugin/src/site/site.xml

Added: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/junit.apt.vm
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/junit.apt.vm?rev=933532&view=auto
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/junit.apt.vm (added)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/junit.apt.vm Tue Apr
13 09:42:11 2010
@@ -0,0 +1,70 @@
+ ------
+ Using Junit
+ ------
+ Kristian Rosenvold <krosenvold@apache.org>
+ ------
+ 2010-04-12
+ ------
+
+Using Junit
+
+* Configuring Junit
+
+  To get started with junit, you need to add the required version of junit to your project:
+
++---+
+  [...]
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>4.8.1</version>
+      <scope>test</scope>
+    </dependency>
+  [...]
++---+
+
+
+  This is the only step that is required to get started - you can now create tests in your
test source directory
+  (eg, <<<src/test/java>>>.
+
+* Generations of junit support
+
+  Surefire supports three different generations of junit: Junit3.8.x, Junit 4.x (serial provider)
and Junit 4.7 (junitcore provider
+   with parallel support). The provider is selected based on the junit version in your project
and the configuration parameters (for parallel).
+
+* Running tests in parallel
+
+  From junit 4.7 and onwards you can run your tests in parallel. To do this, you must set
the
+  <<<parallel>>> parameter, and may change the <<<threadCount>>>
or <<<useUnlimitedThreads>>> attribute.
+  For example:
+
++---+
+    [...]
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-surefire-plugin</artifactId>
+        <version>${project.version}</version>
+        <configuration>
+          <parallel>methods</parallel>
+          <threadCount>10</threadCount>
+        </configuration>
+      </plugin>
+    [...]
++---+
+
+* Using Junit core provider
+
+  If your tests specify any value for the "parallel" attribute and your project uses junit4.7+,
your request will be routed to
+  the concurrent junit provider, which uses the JUnit JUnitCore testrunner.
+
+  This is particularly useful for slow tests that can have high concurrency, or to quickly
and roughly assess the independance
+  and thread safety of your tests and code.
+
+  The JUnitCore test-runner has stricter test-compliance checking than earlier versions of
junit; with this provider
+  your test must be legitimate junit tests to be run, whereas the old 4.x provider would
also run tests that were not according to
+  junit spec.
+
+
+
+
+  For more information on JUnit, see the {{{http://www.junit.org}Junit web site}}.

Propchange: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/examples/junit.apt.vm
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: maven/surefire/trunk/maven-surefire-plugin/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/apt/index.apt?rev=933532&r1=933531&r2=933532&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/apt/index.apt (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/apt/index.apt Tue Apr 13 09:42:11
2010
@@ -77,6 +77,8 @@ Maven Surefire Plugin
 
   * {{{./examples/testng.html}Using TestNG}}
 
+  * {{{./examples/junit.html}Using JUnit}}
+
   * {{{./examples/skipping-test.html}Skipping Tests}}
 
   * {{{./examples/inclusion-exclusion.html}Inclusions and Exclusions of Tests}}

Modified: maven/surefire/trunk/maven-surefire-plugin/src/site/site.xml
URL: http://svn.apache.org/viewvc/maven/surefire/trunk/maven-surefire-plugin/src/site/site.xml?rev=933532&r1=933531&r2=933532&view=diff
==============================================================================
--- maven/surefire/trunk/maven-surefire-plugin/src/site/site.xml (original)
+++ maven/surefire/trunk/maven-surefire-plugin/src/site/site.xml Tue Apr 13 09:42:11 2010
@@ -31,6 +31,7 @@
     </menu>
     <menu name="Examples">
       <item name="Using TestNG" href="examples/testng.html"/>
+      <item name="Using JUnit" href="examples/junit.html"/>
       <item name="Skipping Tests" href="examples/skipping-test.html"/>
       <item name="Inclusions and Exclusions of Tests" href="examples/inclusion-exclusion.html"/>
       <item name="Running a Single Test" href="examples/single-test.html"/>



Mime
View raw message