Bazel을 사용한 코드 적용 범위

문제 신고 소스 보기 나이틀리 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

Bazel에는 bazel coverage로 테스트할 수 있는 저장소에서 코드 커버리지 보고서를 생성하는 coverage 하위 명령어가 있습니다. 다양한 언어 생태계의 특성으로 인해 특정 프로젝트에서 이를 작동시키는 것이 항상 간단하지는 않습니다.

이 페이지에서는 커버리지 보고서를 만들고 보는 일반적인 프로세스를 설명하며, 구성이 잘 알려진 언어에 관한 언어별 참고사항도 제공합니다. 먼저 일반 섹션을 읽고 특정 언어의 요구사항을 읽는 것이 좋습니다. 추가 고려사항이 필요한 원격 실행 섹션도 참고하세요.

많은 맞춤설정이 가능하지만 이 문서에서는 현재 가장 잘 지원되는 경로인 lcov 보고서 생성 및 사용에 중점을 둡니다.

범위 보고서 만들기

준비

범위 보고서를 생성하는 기본 워크플로에는 다음이 필요합니다.

  • 테스트 타겟이 있는 기본 저장소
  • 언어별 코드 커버리지 도구가 설치된 도구 모음
  • 올바른 '계측' 구성

전자의 두 가지는 언어에 따라 다르며 대부분 간단하지만 후자는 복잡한 프로젝트에서 더 어려울 수 있습니다.

여기서 '계측'은 특정 타겟에 사용되는 커버리지 도구를 의미합니다. Bazel에서는 계측이 사용 설정된 상태로 테스트되는 타겟의 필터를 지정하는 --instrumentation_filter 플래그를 사용하여 특정 파일 하위 집합에 대해 이를 사용 설정할 수 있습니다. 테스트를 위한 계측을 사용 설정하려면 --instrument_test_targets 플래그가 필요합니다.

기본적으로 Bazel은 타겟 패키지를 일치시키려고 시도하고 관련 필터를 INFO 메시지로 출력합니다.

러닝 보도

범위 보고서를 생성하려면 bazel coverage --combined_report=lcov [target]를 사용합니다. 이렇게 하면 타겟의 테스트가 실행되어 각 파일의 lcov 형식으로 커버리지 보고서가 생성됩니다.

완료되면 Bazel은 생성된 모든 커버리지 파일을 수집하고 이를 하나로 병합하는 작업을 실행하며, 이 파일은 최종적으로 $(bazel info output_path)/_coverage/_coverage_report.dat 아래에 생성됩니다.

테스트가 실패하는 경우에도 커버리지 보고서가 생성되지만 실패한 테스트에는 적용되지 않습니다. 통과한 테스트만 보고됩니다.

보도 보기

커버리지 보고서는 사람이 읽을 수 없는 lcov 형식으로만 출력됩니다. 여기에서 genhtml 유틸리티 (lcov 프로젝트의 일부)를 사용하여 웹브라우저에서 볼 수 있는 보고서를 생성할 수 있습니다.

genhtml --branch-coverage --output genhtml "$(bazel info output_path)/_coverage/_coverage_report.dat"

genhtml는 소스 코드도 읽어 이러한 파일에서 누락된 커버리지를 주석으로 표시합니다. 이 작업을 수행하려면 genhtml가 Bazel 프로젝트의 루트에서 실행되어야 합니다.

결과를 보려면 genhtml 디렉터리에 생성된 index.html 파일을 웹브라우저에서 열면 됩니다.

genhtml 도구 또는 lcov 커버리지 형식에 관한 자세한 도움말과 정보는 lcov 프로젝트를 참고하세요.

원격 실행

원격 테스트 실행에는 현재 몇 가지 주의사항이 있습니다.

  • 보고서 조합 작업은 아직 원격으로 실행할 수 없습니다. 이는 Bazel이 커버리지 출력 파일을 그래프의 일부로 간주하지 않기 때문입니다 (이 문제 참고). 따라서 Bazel은 이를 조합 작업의 입력으로 올바르게 처리할 수 없습니다. 이 문제를 해결하려면 --strategy=CoverageReport=local을 사용하세요.
    • 참고: Bazel이 전략을 해결하는 방식 때문에 Bazel이 local,remote를 시도하도록 설정된 경우 --strategy=CoverageReport=local,remote와 같은 항목을 대신 지정해야 할 수도 있습니다.
  • --remote_download_minimal 및 유사한 플래그도 전자의 결과로 사용할 수 없습니다.
  • 현재 Bazel은 이전에 테스트가 캐시된 경우 커버리지 정보를 생성하지 못합니다. 이 문제를 해결하기 위해 --nocache_test_results를 커버리지 실행에 맞게 특별히 설정할 수 있지만, 테스트 시간 측면에서 비용이 많이 듭니다.
  • --experimental_split_coverage_postprocessing--experimental_fetch_all_coverage_outputs
    • 일반적으로 커버리지는 테스트 작업의 일부로 실행되므로 기본적으로 원격 실행의 출력으로 모든 커버리지가 반환되지는 않습니다. 이러한 플래그는 기본값을 재정의하고 커버리지 데이터를 가져옵니다. 자세한 내용은 이 문제를 참고하세요.

언어별 구성

자바

Java는 기본 구성으로 즉시 작동해야 합니다. Bazel 도구 모음에는 JUnit을 비롯해 원격 실행에 필요한 모든 항목이 포함되어 있습니다.

Python

Python에서 커버리지 지원을 사용 설정하는 데 필요한 추가 단계는 rules_python 커버리지 문서를 참고하세요.