코드 커버리지
테스트 스위트에 의해 유효성이 검증되는 소스 코드에 대한 통찰을 제공하기 위해 코드 커버리지를 사용합니다. 코드 커버리지는 소프트웨어 성능과 품질을 결정할 수 있는 많은 테스트 지표 중 하나입니다.
코드 커버리지 결과보기
코드 커버리지 결과는 다음 위치에 표시됩니다:
- Merge Request 위젯
- 프로젝트 리포지터리 분석
- 그룹 리포지터리 분석
- 리포지터리 뱃지
MR 파일의 파일 차이에 대한 테스트 커버리지 시각화에 대한 자세한 내용은 테스트 커버리지 시각화를 참조하십시오.
MR에서 코드 커버리지 결과보기
코드의 테스트 커버리지를 사용하는 경우 작업 로그에서 커버리지 결과를 정규 표현식을 사용하여 찾을 수 있습니다. 그런 다음 GitLab에서 Merge Request에 이러한 결과를 포함할 수 있습니다.
파이프라인이 성공하면 커버리지가 Merge Request 위젯 및 작업 테이블에 표시됩니다. 파이프라인의 여러 작업에 커버리지 보고서가 있는 경우 평균이 계산됩니다.
coverage 키워드를 사용하여 테스트 커버리지 결과 추가하기
프로젝트의 .gitlab-ci.yml 파일을 사용하여 Merge Request에 테스트 커버리지 결과를 추가하려면 coverage 키워드를 사용하여 정규 표현식을 제공하십시오.
테스트 커버리지 예제
다음 디렉터리은 많은 일반적인 테스트 커버리지 도구에 대한 샘플 정규 표현식 패턴을 보여줍니다. 이러한 샘플이 작성된 후에 도구가 변경되었거나 도구가 사용자 지정된 경우 정규 표현식이 작동하지 않을 수 있습니다. 정확한 커버리지를 올바르게 찾는지 신중하게 정규 표현식을 테스트하십시오.
프로젝트 코드 커버리지 이력보기
- GitLab 12.10에서 .csv를 다운로드할 수 있는 기능이 도입되었습니다.
- GitLab 13.1에서 그래프가 도입되었습니다(https://gitlab.com/gitlab-org/gitlab/-/issues/33743).
시간별로 프로젝트 코드 커버리지의 진화를 보려면, 해당 데이터가 포함된 CSV 파일을 다운로드하거나 그래프를 볼 수 있습니다.
- 좌측 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
- 분석 > 리포지터리 분석을 선택합니다.
그래프 위의 드롭다운 디렉터리에서 각 작업의 이력 데이터가 나열됩니다.
데이터의 CSV 파일을 보려면 원시 데이터 다운로드(.csv)를 선택합니다.
그룹 코드 커버리지 이력보기
그룹 내 모든 프로젝트의 코드 커버리지를 시간별로 보려면 그룹 리포지터리 분석을 확인하세요.
파이프라인 뱃지
프로젝트의 파이프라인 상태 및 테스트 커버리지를 나타내는 파이프라인 뱃지를 사용할 수 있습니다. 이러한 뱃지는 최신 성공적인 파이프라인에 따라 결정됩니다.
커버리지 확인 승인 규칙
- GitLab 14.0에서 도입되었습니다.
- GitLab 14.1에서 프로젝트 설정에서 구성 가능하도록 만들었습니다.
프로젝트의 테스트 커버리지가 감소할 수 있는 요청을 Merge할 때, 해당 Merge Request이 선택된 사용자 또는 그룹에 의해 승인되어야 한다고 지정할 수 있습니다.
Coverage-Check MR 승인 규칙을 활성화하려면 다음 단계를 따르세요:
- 전체 커버리지 값에 포함하려는 모든 작업에 대해
coverage정규 표현식을 설정합니다. - 프로젝트로 이동하여 설정 > Merge Request을 선택합니다.
-
Merge Request 승인 아래에서
Coverage-Check승인 규칙 옆의 활성화를 선택합니다. - 대상 브랜치를 선택합니다.
- 필요한 승인 수를 0보다 크게 설정합니다.
- 승인을 제공할 사용자 또는 그룹을 선택합니다.
- 승인 규칙 추가를 선택합니다.
문제 해결
코드 커버리지에서 색 코드 제거하기
일부 테스트 커버리지 도구는 ANSI 색 코드를 출력하여 정규 표현식에서 올바르게 파싱되지 않습니다. 이로 인해 커버리지 파싱이 실패합니다.
일부 커버리지 도구는 출력에서 색 코드를 비활성화할 수 있는 옵션을 제공하지 않습니다. 그렇다면 커버리지 도구의 출력을 색 코드를 제거하는 원라인 스크립트를 통해 파이핑하세요.
예시:
lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g'
도움말