본문으로 건너뛰기
AN INDEPENDENT ECONOMIC JOURNAL생활에서 시작하는 경제 읽기
가까이 두고 읽는 경제 이야기
CIN · CONNECT · INFORM · NEWS
경제의 흐름을,
생활의 언어로.

CIN ECONOMIC NOTES

깃허브, 풀 리퀘스트에서 테스트 커버리지 수치 공개 미리보기

깃허브 코드 퀄리티가 기존 테스트 보고서를 받아 코드 변경을 검토하는 화면에 커버리지를 표시한다. 실행 범위를 읽는 데 편리해졌지만 테스트가 검증한 동작은 코드와 테스트를 함께 봐야 알 수 있다.

핵심 먼저 읽기

AT A GLANCE
  • 깃허브는 5월 26일 코드 퀄리티 사용자가 풀 리퀘스트에서 테스트 커버리지를 볼 수 있는 공개 미리보기를 시작했다.
  • 저장소에서 기능을 켜고 기존 지속적 통합 작업에서 만든 Cobertura 형식의 보고서를 올리는 방식이다.
  • 커버리지는 측정 대상 코드 가운데 테스트 실행이 닿은 범위를 나타낸다. 같은 비율이어도 핵심 규칙의 예외 상황을 검증한 정도는 다를 수 있다.
코드를 나타낸 여러 줄 가운데 일부를 비추는 책상 조명과 테스트 보고서
본문의 이해를 돕기 위한 일러스트레이션
이 글의 순서 · 4개 주제

2026년 5월 26일 깃허브가 코드 퀄리티의 테스트 커버리지 표시 기능을 공개 미리보기로 내놨다. 풀 리퀘스트는 저장소에 코드 변경을 합치기 전에 변경 내역과 동료 리뷰, 자동 검사 결과를 모아 보는 화면이다. 깃허브는 이곳에서 테스트로 실행된 코드의 집계 비율을 바로 확인할 수 있으며, 기존 지속적 통합 작업에서 생성한 보고서를 사용한다고 밝혔다. [1]

테스트 결과가 검토 화면에 닿는 과정

테스트 커버리지는 테스트를 돌렸을 때 코드의 어느 부분이 실행됐는지를 측정한다. 코드에 어떤 줄이나 분기가 있는지 정하고 실제로 실행한 부분을 세어 보고서로 만든다. 5월 공지에서 깃허브가 안내한 방식은 저장소에서 커버리지 표시를 활성화하고, 기존 지속적 통합 작업에서 만들어진 Cobertura 보고서를 깃허브에 올리는 것이다. 집계 결과를 풀 리퀘스트에서 볼 수 있으므로 검토 대상 변경과 관련 검사 정보를 같은 화면에서 함께 읽을 수 있다. [1]

테스트 실행과 보고서 표시는 각자 다른 일을 한다. 저장소의 테스트 실행기는 프로그램을 정해 둔 환경과 입력에서 돌리고 결과를 검사한다. 커버리지 도구는 그때 실행된 코드를 기록한다. 깃허브의 이번 기능이 추가하는 부분은 그렇게 만들어진 보고서를 변경 검토 화면에 표시하는 과정이다. 테스트가 어떤 언어와 도구로 실행됐는지나 어떤 파일을 집계했는지는 팀이 사용한 기존 작업과 보고서의 설정에 달려 있다. [1]

가령 소규모 도서 대출 서비스를 고친다고 하자. 테스트가 함수 안의 대다수 줄을 실행하며 빌릴 수 있는 책의 정상 대출만 확인했다고 가정한다. 이미 대출된 책을 다시 요청하거나 대출 기한을 넘겼을 때의 처리가 별도 경로라면, 그 줄에 도달하지 않았을 수 있다. 정상 경로의 줄을 모두 실행했다고 해도 반환되는 값이 맞는지 검사를 써 두지 않았다면 데이터가 정확한지 알 수 없다. 이 예시는 실행된 코드의 범위와 기대 동작을 확인하는 작업의 차이를 보여준다.

2025년 미리보기에서 예고한 기능

깃허브의 2025년 10월 28일 코드 퀄리티 공개 미리보기 공지는 유지보수성과 신뢰성 관련 정적 분석 결과를 변경 검토 화면에서 확인하는 기능을 설명했다. 테스트 커버리지 지표는 그때 향후 제공할 항목에 들어갔다. 2026년 5월 26일 공지는 이 항목을 별도의 공개 미리보기로 제공하고 기존 테스트 작업의 보고서를 쓴다고 밝혔다. 두 발표를 비교하면 먼저 제공한 코드의 구조와 규칙 검토 기능에 이번에 테스트 실행 범위를 보여주는 기능이 추가된 것을 확인할 수 있다. [1] [2]

정적 분석은 코드의 구조나 사용 패턴에서 검토할 점을 찾는 방식이다. 테스트 커버리지 보고는 준비한 테스트가 실제로 실행한 코드 범위를 기록한다. 특정 함수에 정적 분석이 지적한 사항이 없어도 그 함수가 테스트에서 실행됐는지는 별개의 문제다. 반대로 함수의 줄을 대부분 실행했어도 코드 작성 규칙과 유지보수에 관한 지적은 남을 수 있다. 같은 화면에서 보는 두 결과가 서로 다른 질문에 답하는 이유다. [1] [2]

깃허브는 5월 26일 발표 당시 이 기능을 github.com의 코드 퀄리티 사용자에게 공개 미리보기로 제공한다고 설명했다. 당시 공지에는 코드 퀄리티의 이용 환경이 깃허브 팀과 엔터프라이즈 클라우드이며 엔터프라이즈 서버에는 아직 제공되지 않는다는 설명이 실렸다. 미리보기 적용을 검토할 때 팀이 사용하는 호스팅 환경과 저장소에서 기능을 사용할 수 있는지 함께 확인하게 된다. [1]

집계 비율에서 더 살필 점

집계 비율 하나만으로는 변경된 코드의 주요 동작이 제대로 검증됐는지 판단하기 어렵다. 이미 테스트가 많은 큰 저장소에서는 작은 변경에 테스트를 추가하지 않아도 저장소 전체 수치가 거의 달라지지 않을 수 있다. 같은 수치가 나와도 신규 변경이 실행된 부분인지, 오래전에 작성된 테스트가 실행한 부분인지 검토 맥락은 다르다. 그래서 공식 발표에서 수치를 검토의 참고 신호로 설명한 것처럼 변경 내역과 테스트 케이스를 함께 읽어야 한다. [1]

줄마다 실행 여부를 보는 지표와 조건문에서 가능한 경로를 따라갔는지 측정하는 지표도 다르다. 예를 들어 같은 줄에 묶인 조건에서 결과가 참일 때와 거짓일 때 각각 동작이 달라질 수 있다. 줄 실행 여부만 높은 보고서로는 두 방향을 모두 확인했는지 알기 어렵다. 서로 다른 저장소나 테스트 작업의 수치를 비교할 때는 계산 대상에서 뺀 파일과 보고서를 생성한 도구의 측정 기준까지 맞는지 확인해야 한다.

보고서가 특정 실행에서 생성됐다는 정보도 검토에 쓰인다. 변경 요청에 코드가 더해진 뒤 테스트가 다시 돌아갔다면 그 실행에서 나온 보고서가 현재 검토 중인 코드와 연결되는지 확인할 수 있다. 여러 테스트 작업이 파일을 나눠 검사하는 곳이라면 표에 나타나는 범위가 일부 실행인지, 합쳐서 계산한 것인지도 중요하다. 깃허브가 5월에 발표한 기능은 팀이 이미 만든 보고서를 가져오므로 이러한 집계 전제가 제품의 표시 기능과 별도로 남는다. [1]

변경 검토에서 숫자를 쓰는 방법

검토 화면에 커버리지 정보가 있으면 해당 변경의 테스트 작업이 보고서를 남겼는지와 집계 범위가 달라졌는지를 찾는 시간이 줄어들 수 있다. 수치가 급격히 바뀌었다면 먼저 코드의 변화와 테스트 작업 설정의 변화를 확인할 수 있다. 수치가 비슷해도 새로 추가된 오류 처리나 경계 조건은 변경된 테스트 케이스와 기대 결과에서 확인한다. 2026년 5월 발표의 직접적인 변화는 기존 테스트 결과를 이런 검토 과정에서 찾기 쉬운 위치에 보여 주는 것이다. [1] [2]

5월 공개 미리보기는 코드 품질 도구와 테스트 측정 결과가 만나는 지점을 분명히 했다. 기존의 코드 퀄리티 화면이 변경에 관한 분석 내용을 보여줬다면, 이번 기능은 테스트 실행 범위를 같은 변경에 붙여 보여준다. 검토자는 어떤 질문에 답하려는지에 따라 보고서의 집계 기준, 변경 코드와 테스트의 관계, 테스트에서 검사한 결과를 각자 확인할 수 있다. [1] [2]

이 글에서 생긴 질문을 다른 관점으로 이어 읽어보세요.

CONNECTED NOTES

SOURCES & FURTHER READING

참고한 자료, 더 읽을 거리

글의 근거와 더 자세한 배경은 아래 원문에서 이어 읽을 수 있습니다.

01
GitHub

Code coverage on pull requests is now in public preview

↗
02
GitHub

GitHub Code Quality in public preview

↗
CIN

흩어진 소식을 연결하고,
일상의 질문에서 경제를 이해합니다.

블로그 소개 ↗