What is causing "java.lang.Exception: … contains itself as a SuiteClass"

[pluess]

I see a number of people on Stackoverflow (http://stackoverflow.com/questions/tagged/classpathsuite) getting a

 java.lang.Exception: class 'com.foo.bar.AllTests' (possibly indirectly) contains itself as a SuiteClass

I don't see this as a bug of cpsuite, but It would be helpfull to give a hint in the docs what the exception means and how to resolve it.

[mjball]

Agreed, this is confusing. When combined with something like

@ClasspathSuite.SuiteTypes({SuiteType.TEST_CLASSES, SuiteType.RUN_WITH_CLASSES})

perhaps the @ClasspathSuite-annotated class itself is found while the runner scans for test classes?

[mjball]

Indeed if you use ClassnameFilters to exclude com.foo.bar.AllTests, it solves the problem:

@ClasspathSuite.ClassnameFilters("!.*AllTests.*")

(that example may be too aggressive in its name matching)