gradusnikov / eclipse-test

Run Tests & Build in Eclipse

Execute JUnit tests and Maven builds using Eclipse's built-in infrastructure.

Test Tools

• runAllTests — Run all tests in a project. Provide projectName and optional timeout (default: 60s).
• runPackageTests — Run tests in a specific package. Provide projectName and packageName.
• runClassTests — Run all tests in a specific test class. Provide projectName and className (fully qualified).
• runTestMethod — Run a single test method. Provide projectName, className, and methodName.
• findTestClasses — Find and classify tests as plain JUnit or PDE harness tests. PDE tests must use the *PDETest.java naming convention; likely harness-dependent misnamed tests are reported as warnings.

PDE Harness Tests

• runJUnitPluginTests — Run all plug-in tests in the PDE harness. Use for the classes listed under PDE harness tests (*PDETest).
• runJUnitPluginTestClass — Run one fully qualified *PDETest class.
• runJUnitPluginTestClasses — Run a comma-separated set of fully qualified *PDETest classes in one PDE launch. Prefer it after a change touches several harness tests because Eclipse workbench startup is paid only once. The initial batch tool does not provide coverage; use the single-class or whole-project tools when coverage is required.
• getActiveTarget / reloadTarget — Inspect or refresh the target platform when plug-in dependencies cannot resolve.
• Keep ordinary unit tests named *Test.java; any test using Eclipse workspace, JDT, UI, platform, or OSGi runtime services must be named *PDETest.java so discovery routes it to the PDE harness.

Build Tools

• runMavenBuild — Run Maven the way Run As > Maven build does. Provide projectName and goals written exactly as after mvn (e.g., clean install -DskipTests -pl module); optional profiles, properties, pomDirectory, offline, skipTests, and timeout (seconds to wait before an operationId is returned). The result carries the exit code, every [ERROR] line and the tail of the log; the full log is in the console named launchName.
• getEffectivePom — Get the effective POM for a Maven project.
• listMavenProjects — List all Maven projects in the workspace.
• getProjectDependencies — Get Maven dependencies for a project.

Typical Workflow

1. Find test classes:
   `
   findTestClasses(projectName="myapp")
   `

2. Run specific test after code change:
   `
   runClassTests(projectName="myapp", className="com.example.MyServiceTest", timeout="60")
   `

3. Run all tests before committing:
   `
   runAllTests(projectName="myapp", timeout="120")
   `

4. Build with Maven:
   `
   runMavenBuild(projectName="myapp", goals="clean verify -DskipTests", timeout="300")
   `

5. Check build output:
   `
   getConsoleOutput()
   `

Notes

• Tests run using JUnit 5 by default
• Run plain tests with runClassTests/runAllTests; run *PDETest classes with the eclipse-pde harness tools
• Test results include pass/fail status, execution time, and failure traces
• Use getCompilationErrors first to ensure code compiles before running tests
• Maven build output goes to the Eclipse console — use getConsoleOutput to retrieve it