Skip to content

Document running single test bundles and classes in AGENTS.md#2380

Open
vogella wants to merge 1 commit into
eclipse-pde:masterfrom
vogella:agents-md-test-commands
Open

Document running single test bundles and classes in AGENTS.md#2380
vogella wants to merge 1 commit into
eclipse-pde:masterfrom
vogella:agents-md-test-commands

Conversation

@vogella

@vogella vogella commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Adds a short 'Running Specific Tests Locally' section to AGENTS.md.

It documents how to run a single test bundle with -pl, a single test class with -Dtest=<ClassName> (which overrides the bundle's default suite), how to build a source bundle together with its test bundle, and the Wayland-safe headless invocation. The commands were verified locally against org.eclipse.pde.ui.tests, where -Dtest correctly ran a single class instead of the full AllPDETests suite. This makes local test iteration much faster than running the whole suite.

@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown

Test Results

  129 files  ±0    129 suites  ±0   37m 14s ⏱️ -41s
3 527 tests ±0  3 473 ✅ ±0   54 💤 ±0  0 ❌ ±0 
9 384 runs  ±0  9 254 ✅ ±0  130 💤 ±0  0 ❌ ±0 

Results for commit 0f996c1. ± Comparison against base commit dd790b2.

♻️ This comment has been updated with latest results.

@vogella

vogella commented Jun 19, 2026

Copy link
Copy Markdown
Contributor Author

@HannesWell pinging you as PDE project lead, no idea by the PR validation is failing but it is definitely not cause by this PR.

@HannesWell

Copy link
Copy Markdown
Member

no idea by the PR validation is failing but it is definitely not cause by this PR.

I assume it's because in I-builds the Javadoc in the pde.doc bundle is built with Java-25 while in the verification build it's build with Java-21. And that JDK's number is recorded in the generated files and also leads to other slightly different content.
So we we either have to run the PR verification builds with java-25 too or should make sure that the pde.doc bundle is always built with java-21.
I'm not in favor of the former since we generally not allow Java-25 yet and expect the latter to be implementable with a corresponding configuration of the maven-toolchains-plugin.
I'll look into it over the weekend as time permits.

@akurtakov

Copy link
Copy Markdown
Member

Run the PR verification build is inevitable - moving to Java 25 will be allowed for December release thus figuring build/releng things earlier could only benefit us.

Add a 'Running Specific Tests Locally' section covering how to run one
test bundle with -pl, a single test class with -Dtest, building a source
bundle together with its test bundle, and the Wayland-safe headless
invocation. Commands verified against org.eclipse.pde.ui.tests.
@HannesWell HannesWell force-pushed the agents-md-test-commands branch from 7e0d268 to 0f996c1 Compare June 20, 2026 13:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants