Running Tests

This page describes how to run Lucene/Solr tests and various options you can use.

Using Ant

Running the tests requires Apache Ant version 1.7.0 or 1.7.1.

Note: do not use higher versions (e.g. 1.8.1)

Tests run using the RandomizedTesting library. For usage instructions, run ant test-help.

Basic Operations

Running all tests

To run all tests, just run ant test.

You can run tests at the project, product, module, or sub-module level:

• At the top-level (containing lucene/ and solr/), all Lucene and Solr tests will be run.

• Under lucene/, all Lucene tests will be run.

• Under lucene/core/, only Lucene core tests will be run.

• etc.

Running only a specific test class

To run a specific test class, use -Dtests.class

tests.class filters full class names (including package) using a shell-like glob pattern.

For example, to run only TestIndexWriter: ant test -Dtests.class="*.TestIndexWriter"

(The quotations around the glob pattern prevent shell expansion.)

-Dtestcase=Xyz is an alias of -Dtests.class="*.Xyz"

Running only a specific test method

To run just a single method in a test, use -Dtests.method

tests.method filters method names using a shell-like glob pattern.

For example: ant test -Dtests.class="*.TestIndexWriter" -Dtests.method="test*Count"

testmethod is an alias of tests.method.

Running all tests in a specific package

To run tests in a specific package, use -Dtests.class

For example: ant test -Dtests.class="*.search.*"

Test Options

The following Lucene/Solr-specific options (not handled by the RandomizedTesting library) can be used to modify the behavior of tests.

From ant, you can set these on the command line by using -D.

From your IDE, you can set these by adding jvm arguments with -D.