releases/.claude/rules/tests.md

paths
VideoDownloader.Tests/**

테스트 영역 규칙

배치

VideoDownloader.Tests/<영역>/<대상>Tests.cs — 영역은 Browser · E2E · Infrastructure · Mobile · Platform · Server. 새 영역을 만들기 전에 기존 영역에 맞는지 먼저 본다.

격리 (필수)

사용자 데이터 경로를 건드리는 테스트는 VD_DATA_DIR 을 임시 디렉터리로 지정하고 끝나면 null 로 되돌린다. E2E/MainWindowSmokeE2ETests.cs:17 이 기준 패턴이다. 이걸 빼면 테스트가 실사용자의 설정·세션·프로필을 덮어쓴다.

WPF 테스트

테스트 프로세스에는 App.xaml 리소스가 없다. WPF 요소를 만드는 테스트는 Infrastructure/WpfTestApp.Ensure(dispatcher) 를 먼저 호출해 테마 사전을 로드한다. 직접 new Application() 을 만들지 않는다.

금지

• 통과시키려고 테스트를 삭제하거나 Skip 처리하지 않는다. 회귀를 숨기는 것이다.
• 실제 네트워크에 의존하는 단정을 새로 만들지 않는다. 외부 사이트가 바뀌면 무작위로 깨진다. (Cli 의 --dashparse 같은 수동 검증 도구는 예외 — 테스트가 아니다.)
• 시간·순서에 의존하는 Thread.Sleep 기반 단정을 쓰지 않는다.

알려진 경고

이 프로젝트에 남아 있는 경고: CS8602(null 역참조) 몇 건, xUnit1031(블로킹 대기), xUnit2013(Assert.Equal 로 개수 확인). 개수를 늘리지 않는다. 새 테스트에서는 Assert.Single/Assert.Empty 와 async 대기를 쓴다.

실행

dotnet test VideoDownloader.Tests                                        # 전체 (~13초)
dotnet test VideoDownloader.Tests --filter "FullyQualifiedName~<이름>"   # 단건