# Swing UI Test Headless Guard

> Swing 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.

- Skill name: `swing-ui-test-headless-guard`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/lakernote/EasyPostman/blob/HEAD/.codex/skills/swing-ui-test-headless-guard/SKILL.md
- Repository: lakernote/EasyPostman (685 GitHub stars when collected)

## SKILL.md

# Swing UI Test Headless Guard

Use this skill for Swing UI tests under `easy-postman-app/src/test/java`.

## Default pattern

1. Put shared no-display skip logic in:
   `easy-postman-app/src/test/java/com/laker/postman/test/AbstractSwingUiTest.java`
2. Make Swing/UI tests extend that base class.
3. Use `@BeforeClass` + `SkipException` to skip tests when:
   - `GraphicsEnvironment.isHeadless()` is `true`
   - or Linux has neither `DISPLAY` nor `WAYLAND_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 `SkipException` over brittle per-test conditionals.
- After changes, verify with:
  - `mvn -q -pl easy-postman-app -am -DskipTests compile`
  - `mvn -q -pl easy-postman-app -am -Dtest=<TestClass> -Dsurefire.failIfNoSpecifiedTests=false -Djava.awt.headless=true test`

---

Source: https://www.openparable.com/skill/testing-quality/swing-ui-test-headless-guard (OpenParable). Cite the canonical URL above.
