icartsh .NET Test Skill (Entry Map)
목표: 정확한 테스트 절차를 안내합니다.
빠른 시작 (택일)
- 유닛 테스트 실행 →
references/run-unit-tests.md - 커버리지 리포트 생성 →
references/generate-coverage.md - 벤치마크 실행 →
references/run-benchmarks.md
사용 시기
- 유닛 테스트 실행 (xUnit, NUnit)
- coverlet을 이용한 코드 커버리지 리포트 생성
- BenchmarkDotNet을 이용한 성능 벤치마크 수행
- 테스트 스위트를 통한 코드 변경 사항 검증
- 테스트 실행 시간 측정
다음의 경우에는 사용하지 마세요: 코드 빌드 (dotnet-build), 포맷팅 (code-format), 또는 정적 분석 (code-analyze)
입력 및 출력 (Inputs & Outputs)
입력: target (all/project/specific), configuration (Debug/Release), coverage (true/false), project_path (기본값: 모든 테스트 프로젝트)
출력: 테스트 결과 (성공/실패 카운트), 커버리지 리포트 (요청 시), 벤치마크 결과, 종료 코드 (0=성공)
가드레일: ./dotnet 디렉토리 내에서만 작업하며, 실패 사항을 명확히 보고하고, 허가 없이 테스트를 건너뛰지 않습니다.
탐색 (Navigation)
1. 유닛 테스트 실행 → references/run-unit-tests.md
- 모든 테스트 실행, 특정 프로젝트 테스트 실행, 테스트 실패 트러블슈팅
2. 커버리지 리포트 생성 → references/generate-coverage.md
- 커버리지 데이터 수집, 리포트 생성 (HTML/Cobertura), 커버리지 지표 분석
3. 벤치마크 실행 → references/run-benchmarks.md
- 성능 벤치마크 수행, 결과 비교, 데이터 기반 최적화
일반적인 패턴 (Common Patterns)
모든 테스트 실행 (빠른 속도)
cd ./dotnet
dotnet test
상세 출력을 포함한 테스트 실행
cd ./dotnet
dotnet test --verbosity normal
특정 테스트 프로젝트 실행
cd ./dotnet
dotnet test console-app.Tests/PigeonPea.Console.Tests.csproj
커버리지와 함께 테스트 실행
cd ./dotnet
dotnet test --collect:"XPlat Code Coverage"
테스트 실행 및 커버리지 리포트 생성
cd ./dotnet
dotnet test --collect:"XPlat Code Coverage" --results-directory ./TestResults
# 커버리지 파일: ./TestResults/{guid}/coverage.cobertura.xml
이름으로 테스트 필터링
cd ./dotnet
dotnet test --filter "FullyQualifiedName~FrameTests"
카테고리로 테스트 필터링
cd ./dotnet
dotnet test --filter "Category=Unit"
Release 구정으로 테스트 실행
cd ./dotnet
dotnet test --configuration Release
벤치마크 실행
cd ./dotnet/benchmarks
dotnet run -c Release
트러블슈팅 (Troubleshooting)
테스트 실패: Assertion 실패에 대한 테스트 출력을 확인하세요. 디버깅은 references/run-unit-tests.md를 참조하세요.
커버리지 미생성: coverlet.collector가 설치되어 있는지 확인하세요. references/generate-coverage.md를 참조하세요.
벤치마크 실행 실패: Release 구성을 사용해야 합니다. references/run-benchmarks.md를 참조하세요.
테스트 실행 속도 저하: 테스트 필터 사용, 병렬 실행 또는 빌드 후 --no-build 옵션을 사용하세요.
테스트 발견 실패: 프로젝트 참조를 확인하고 테스트 프레임워크 패키지가 설치되어 있는지 확인하세요.
성공 지표 (Success Indicators)
Passed! - Failed: 0, Passed: 42, Skipped: 0, Total: 42
테스트 아티팩트 위치: ./dotnet/TestResults/
커버리지 리포트 위치: ./dotnet/TestResults/coverage.cobertura.xml
통합 (Integration)
테스트 전: dotnet-build (코드가 빌드되었는지 확인) 테스트 후: code-analyze (정적 분석), code-review (품질 검사)
테스트 프레임워크
이 저장소는 다음을 사용합니다:
- 유닛 테스트를 위한 xUnit (console-app.Tests, shared-app.Tests, windows-app.Tests)
- 코드 커버리지를 위한 coverlet.collector
- 성능 벤치마크를 위한 BenchmarkDotNet
관련 링크 (Related)
./dotnet/README.md- 프로젝트 구조./dotnet/ARCHITECTURE.md- 아키텍처.pre-commit-config.yaml- Pre-commit hooksdotnet-buildskill - 빌드 스킬