Pygame Headless: Test, Run, Release

Overview

pygame (SDL) refuses to start without a display. The dummy drivers make every pygame codepath — tests, CLI subcommands, even frame rendering — work headless.

Headless testing

Set the drivers in tests/conftest.py BEFORE pygame is imported, with setdefault so a real display still wins locally:

import os
os.environ.setdefault("SDL_VIDEODRIVER", "dummy")
os.environ.setdefault("SDL_AUDIODRIVER", "dummy")

Same trick for one-off CLI runs: