maven :: run only single test in multi-module project

I assume you've read the docs about running a single test under surefire? What they don't tell you is how to do that in a sub-module:

mvn test -Dtest=testname -pl subproject

Where subproject is the project containing that test. From the mvn man page:

-pl,--projects arg Comma-delimited list of specified reactor projects to build instead of all projects. A project can be specified by [groupId]:artifactId or by its relative path.


Other answers I see are not fully complete, for projects that depend on other sub-modules to be built. One option is to run mvn install to have the required jars to be installed into ~/.m2/..., but that option is not very "clean".

Following command will build the sub-modules, and run only the test class that is specified. This is to be run at parent module level. Also, no need to specify sub-module name.

mvn test -DfailIfNoTests=false -Dtest={test_class_name} -am

As an aside, this can also be mvn clean test -Dfa...... I have a habit of always running clean when running tests.

References..
-am will make all the other sub-modules.
-DfailIfNoTests=false does not fail the entire process since we are not intending to run tests in other modules.
-pl option is not needed since -am is already building everything


In case the module to be tested depends on other projects, solution works by changing commands as:

mvn test -DfailIfNoTests=false -Dtest=testname -pl subproject