Files
VoiceStudio/backend/tests/test_win_subprocess.py
T
debpalashandClaude Opus 4.8 aa4b9382d3 fix(windows): backend subprocesses (ffmpeg, sidecars, yt-dlp) run window-less too
The bootstrap fix hid the console windows the Rust shell spawns, but the running
backend is a second, larger source: it makes 70+ subprocess spawns (ffmpeg for
dubbing, engine sidecars, yt-dlp, demucs, WhisperX), only one of which set any
creation flag — and third-party libraries (imageio-ffmpeg, yt-dlp) shell out to
ffmpeg themselves. Since the backend runs console-less, on Windows each console
child got a fresh cmd window flashed on screen during generation/dubbing.

Patch subprocess.Popen once at backend startup (before anything spawns) to OR
CREATE_NO_WINDOW into every child's creationflags — covering run/call/
check_output (all built on Popen) and every stdlib-using library, from a single
auditable choke point. Composes with the existing CREATE_NEW_PROCESS_GROUP and
honours an explicit CREATE_NEW_CONSOLE. No-op on macOS/Linux. Unit-tested.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-17 12:43:59 -07:00

54 lines
1.8 KiB
Python

"""Guard: every backend subprocess spawns without a console window on Windows.
Covers the flag logic (pure, runs on every platform) and the idempotent Popen
patch. The visible symptom this prevents — a storm of cmd windows during
dubbing/generation on Windows — can't be asserted in CI, so we pin the
mechanism instead. See core/win_subprocess.py. (#1178)
"""
import subprocess
import sys
from core.win_subprocess import (
CREATE_NEW_CONSOLE,
CREATE_NO_WINDOW,
add_no_window_flag,
install,
)
def test_adds_flag_to_empty_kwargs():
assert add_no_window_flag({})["creationflags"] == CREATE_NO_WINDOW
def test_ors_with_existing_flags_never_replaces():
# subprocess_backend.py passes CREATE_NEW_PROCESS_GROUP (0x200); the window
# flag must be added on top, not clobbered.
group = 0x00000200 # CREATE_NEW_PROCESS_GROUP
out = add_no_window_flag({"creationflags": group})["creationflags"]
assert out & group, "existing creationflags must be preserved"
assert out & CREATE_NO_WINDOW, "CREATE_NO_WINDOW must be added"
def test_honours_explicit_new_console():
# A caller that deliberately wants a visible console is left alone.
out = add_no_window_flag({"creationflags": CREATE_NEW_CONSOLE})
assert out["creationflags"] == CREATE_NEW_CONSOLE
assert not (out["creationflags"] & CREATE_NO_WINDOW)
def test_install_is_idempotent_and_safe():
# Safe to call repeatedly; a real spawn still works afterwards.
install()
install()
if sys.platform == "win32":
assert getattr(subprocess.Popen, "_omnivoice_no_window", False)
# A trivial spawn must still succeed with the patch installed.
out = subprocess.run(
[sys.executable, "-c", "print('ok')"],
capture_output=True,
text=True,
check=True,
)
assert out.stdout.strip() == "ok"