---
name: eclipse-test
description: Run JUnit tests in Eclipse projects — all tests, by package, by class, or individual test methods. Also build Maven projects.
argument-hint: "[project] [class or package]"
allowed-tools: mcp__eclipse-ide__runAllTests, mcp__eclipse-ide__runPackageTests, mcp__eclipse-ide__runClassTests, mcp__eclipse-ide__runTestMethod, mcp__eclipse-ide__findTestClasses, mcp__eclipse-ide__runMavenBuild, mcp__eclipse-ide__getConsoleOutput, mcp__eclipse-ide__getEffectivePom, mcp__eclipse-ide__listMavenProjects, mcp__eclipse-ide__getProjectDependencies, mcp__eclipse-ide__getCompilationErrors, mcp__eclipse-pde__runJUnitPluginTests, mcp__eclipse-pde__runJUnitPluginTestClass, mcp__eclipse-pde__runJUnitPluginTestClasses, mcp__eclipse-pde__getActiveTarget, mcp__eclipse-pde__reloadTarget
---

# 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