Author: assaf
Date: Mon Sep 22 10:28:27 2008
New Revision: 697911
URL: http://svn.apache.org/viewvc?rev=697911&view=rev
Log:
Added documentation for setting the version of JUnit, TestNG or JBehave using
the build.yml file.
Added links from documentation to JUnit, JMock and TestNG sites.
Modified:
incubator/buildr/trunk/doc/pages/languages.textile
Modified: incubator/buildr/trunk/doc/pages/languages.textile
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/languages.textile?rev=697911&r1=697910&r2=697911&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/languages.textile (original)
+++ incubator/buildr/trunk/doc/pages/languages.textile Mon Sep 22 10:28:27 2008
@@ -28,9 +28,9 @@
h4. JUnit
-The default test framework for Java projects is JUnit 4.
+The default test framework for Java projects is "JUnit 4":http://www.junit.org.
-When you use JUnit, the dependencies includes JUnit, and Buildr picks up all
test classes from the project by looking for classes that either subclass
@junit.framework.TestCase@, include methods annotated with @org.junit.Test@, or
test suites annotated with @[EMAIL PROTECTED]
+When you use JUnit, the dependencies includes JUnit and
"JMock":http://www.jmock.org, and Buildr picks up all test classes from the
project by looking for classes that either subclass
@junit.framework.TestCase@, include methods annotated with @org.junit.Test@, or
test suites annotated with @[EMAIL PROTECTED]
The JUnit test framework supports the following options:
@@ -65,9 +65,17 @@
The @junit:report@ task generates a report from all tests run so far. If you
run tests in a couple of projects, it will generate a report only for these two
projects. The example above runs tests in all the projects before generating
the reports.
+You can use the @build.yaml@ settings file to specify a particular version of
JUnit or JMock. For example, to force your build to use JUnit version 4.4 and
JMock 2.0:
+
+{{{!yaml
+junit: 4.4
+jmock: 2.0
+}}}
+
+
h4. TestNG
-You can also use TestNG in your project by telling your project to use TestNG:
+You can use "TestNG":http://testng.org instead of JUnit. To select TestNG as
the test framework, add this to your project:
{{{!ruby
test.using :testng
@@ -75,7 +83,7 @@
Like all other options you can set with @test.using@, it affects the projects
and all its sub-projects, so you only need to do this once at the top-most
project to use TestNG throughout. You can also mix TestNG and JUnit by setting
different projects to use different frameworks, but you can't mix both
frameworks in the same project. (And yes, @test.using :junit@ will switch a
project back to using JUnit)
-TestNG works much like JUnit, it gets included in the dependency list, Buildr
picks test classes that contain methods annotated with
@org.testng.annotations.Test@, and generates test reports in the
@reports/testng@ directory. At the moment we don't have consolidated HTML
reports for TestNG.
+TestNG works much like JUnit, it gets included in the dependency list along
with JMock, Buildr picks test classes that contain methods annotated with
@org.testng.annotations.Test@, and generates test reports in the
@reports/testng@ directory. At the moment we don't have consolidated HTML
reports for TestNG.
The TestNG test framework supports the following options:
@@ -83,6 +91,13 @@
| @:properties@ | Hash of system properties available to the test case. |
| @:java_args@ | Arguments passed as is to the JVM. |
+You can use the @build.yaml@ settings file to specify a particular version of
TestNG, for example, to force your build to use TestNG 5.7:
+
+{{{!yaml
+testng: 5.7
+}}}
+
+
h4. JBehave
"JBehave":http://jbehave.org/ is a pure Java BDD framework, stories and
behaviour specifications are written in the Java language.
@@ -101,6 +116,12 @@
| @:properties@ | Hash of system properties available to the test case. |
| @:java_args@ | Arguments passed as is to the JVM. |
+You can use the @build.yaml@ settings file to specify a particular version of
JBehave, for example, to force your build to use JBehave 1.0.1:
+
+{{{!yaml
+jbehave: 1.0.1
+}}}
+
h2. Scala
