OpenParable
Skip to content
← Back to skills

Swing UI Test Headless Guard

Testing & Quality
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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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

  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