Swing UI Test Headless Guard
Testing & Qualityswing-ui-test-headless-guardSwing UI Test Headless Guard is an Agent Skill for testing & quality published in the lakernote/EasyPostman repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when adding or updating EasyPostman Swing/TestNG UI tests that may run in headless CI or no-display Linux environments.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/lakernote/EasyPostman/blob/HEAD/.codex/skills/swing-ui-test-headless-guard/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/swing-ui-test-headless-guard, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Swing UI Test Headless Guard
Use this skill for Swing UI tests under easy-postman-app/src/test/java.
Default pattern
- Put shared no-display skip logic in:
easy-postman-app/src/test/java/com/laker/postman/test/AbstractSwingUiTest.java - Make Swing/UI tests extend that base class.
- Use
@BeforeClass+SkipExceptionto skip tests when:GraphicsEnvironment.isHeadless()istrue- or Linux has neither
DISPLAYnorWAYLAND_DISPLAY
Guardrails
- Keep the base class narrow. Only put environment-skip behavior there unless multiple UI tests clearly need more.
- Do not add this base class to non-UI tests.
- Prefer
SkipExceptionover brittle per-test conditionals. - After changes, verify with:
mvn -q -pl easy-postman-app -am -DskipTests compilemvn -q -pl easy-postman-app -am -Dtest=<TestClass> -Dsurefire.failIfNoSpecifiedTests=false -Djava.awt.headless=true test