Define a Test Suite for Scala or Java
Problem
You want to define a JUnit test target for your Scala or Java library so that you can run those tests using Pants.
For more info on running tests, see Run Tests for Your Project.
Solution
Create a junit_tests target definition for your library. With the test target definition in place, you can run the tests using the test goal:
$ ./pants test src/java/com/myorg/myproject/example:tests
Discussion
A junit_tests target definition should specify the following:
- A
namefor the test suite - A list of
sourcesspecifying which files contain the tests themselves - A list of
dependencies(which in some cases will only include the library being tested) - A list of
resources(optional). More info can be found in Create a Resource Bundle.
Here's an example:
junit_tests( name='tests', sources=['*.java'], dependencies=[ 'src/java/com/myorg/myproject/example:lib', ], )
With that target definition, you can then run the test using Pants:
$ ./pants test src/java/com/myorg/myproject/example:tests
When you run a test, Pants will compile any libraries being tested and then run the actual tests. You should see many lines of Pants-specific output followed by the test results. Here's an example:
18:12:43 00:00 [main]
See a report at: http://localhost:57466/run/pants_run_2015_05_22_18_12_43_104
18:12:43 00:00 [bootstrap]
18:12:43 00:00 [setup]
18:12:43 00:00 [parse]
Executing tasks in goals: bootstrap -> imports -> # etc.
#
# etc.
#
18:12:53 00:10 [junit]
18:12:53 00:10 [run]
..
Time: 0.573
OK (2 tests)
Waiting for background workers to finish.
SUCCESS
Included with the output is a URL to which you can navigate to see a report. In the example above, that URL is http://localhost:57466/run/pants_run_2015_05_22_18_12_43_104.