Author: vborja
Date: Tue Sep 23 12:12:40 2008
New Revision: 698291
URL: http://svn.apache.org/viewvc?rev=698291&view=rev
Log:
Documentation for JtestR testing framework
Modified:
incubator/buildr/trunk/CHANGELOG
incubator/buildr/trunk/doc/pages/languages.textile
Modified: incubator/buildr/trunk/CHANGELOG
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/CHANGELOG?rev=698291&r1=698290&r2=698291&view=diff
==============================================================================
--- incubator/buildr/trunk/CHANGELOG (original)
+++ incubator/buildr/trunk/CHANGELOG Tue Sep 23 12:12:40 2008
@@ -1,4 +1,5 @@
1.3.3 (Pending)
+* Added: JtestR support. Implemented pending jtestr specs.
* Added: Growl notifications (OS X only).
* Added: error, info and trace methods.
* Added: BUILDR-128 Emma support
Modified: incubator/buildr/trunk/doc/pages/languages.textile
URL:
http://svn.apache.org/viewvc/incubator/buildr/trunk/doc/pages/languages.textile?rev=698291&r1=698290&r2=698291&view=diff
==============================================================================
--- incubator/buildr/trunk/doc/pages/languages.textile (original)
+++ incubator/buildr/trunk/doc/pages/languages.textile Tue Sep 23 12:12:40 2008
@@ -328,7 +328,9 @@
h2. Ruby
-h3. Using RSpec
+h3. Testing with Ruby
+
+h4. RSpec
"RSpec":http://rspec.info/ is the de-facto BDD framework for ruby. It's the
framework used to test Buildr itself.
@@ -347,3 +349,31 @@
|_. Option |_. Value |
| @:properties@ | Hash of system properties available to the test case. |
| @:java_args@ | Arguments passed as is to the JVM. |
+
+h4. JtestR
+
+"JtestR":http://jtestr.codehaus.org is a tool that makes it easier to test
Java code with
+state of the art Ruby tools. Using JtestR you can describe your application
behaviour using many
+testing frameworks at the same time.
+
+To use this framework in your project you can select it with @test.using
:[EMAIL PROTECTED]
+
+When selected, Buildr will configure JtestR to use your project/testing
classpath and will search for
+the following test patterns for each framework supported by JtestR:
+
+|_. Framework |_. Patterns |
+| "RSpec":http://rspec.info | Files in @src/spec/ruby@ ending with
@*_spec.rb@ or @*_story.rb@ |
+|
"TestUnit":http://ruby-doc.org/stdlib/libdoc/test/unit/rdoc/classes/Test/Unit.html
| Files in @src/spec/ruby@ ending with @*_test.rb@, @*Test.rb@ |
+| "Expectations":http://expectations.rubyforge.org/ | Files in @src/spec/ruby@
ending with @*_expect.rb@ |
+| "JUnit":http://www.junit.org | Classes from @src/test/java@ that either
subclass @junit.framework.TestCase@, include methods annotated with
@org.junit.Test@, or test suites annotated with @[EMAIL PROTECTED] |
+| "TestNG":http://testng.org | Classes from @src/test/java@ annotated with
@org.testng.annotations.Test@ |
+
+If you create a @src/spec/ruby/jtestr_config.rb@ file, it will be loaded by
JtestR, just after being configured
+by Buildr, this way you can add helpers or anything described on the "JtestR
guide":http://jtestr.codehaus.org/Configuration
+
+Supports the following options:
+
+|_. Option |_. Value |
+| @:config@ | The JtestR config file to be loaded after being configured by
Buildr. |
+| @:output@ | A file path where to store JtestR output. @false@ to
suppress output, @true@ to use standard output. |
+
