Pytest-html-plus: CLI 로그를 넘어선 차세대 Pytest HTML 리포트

핵심 기술

pytest-html-plus는 기존 Pytest 리포트의 한계를 극복하고, 설정 및 사용의 번거로움 없이 간결하고 현대적인 HTML 테스트 리포트를 제공하는 Python 라이브러리입니다.

기술적 세부사항

• 간편한 설치 및 사용: pip install pytest-html-plus 명령어로 쉽게 설치 가능하며, 별도의 데코레이터, 훅, 설정 파일 없이 pytest 명령 실행만으로 보고서 생성.
• CI/CD 통합 용이성: YAML 설정 없이 CI 환경에 2분 내 통합 가능하며, SendGrid API 키 설정으로 이메일 보고서 발송.
• 병렬 실행 및 재시도 지원: pytest-xdist 또는 재시도 시 자동 통합 기능으로 개별 출력 합쳐진 단일 HTML 보고서 생성.
  • 휘청이는 테스트(flaky test) 감지
  • 테스트 소요 시간 및 메타데이터 포함
  • 워커 간 로그, 스크린샷, stdout/stderr 보존
• 추적성 강화: pytest.mark를 사용하여 Jira ID, GitHub 이슈 번호 등과 테스트 연결 및 검색 기능 제공.
• 다양한 데이터 내보내기: JSON 및 XML 형식으로 자동 내보내기 지원 (대시보드 구축, 테스트 관리 도구 연동 용이).
• 대화형 HTML 리포트: 단일 페이지 인터랙티브 HTML, 통과/실패/건너뜀 요약, 필터링 기능 (상태, 시간, 파일, 마커, 휘청이는 테스트), 실시간 검색 바.
• 자산 폴더 불필요: CSS/JS 클러터 없이 단일 HTML 파일로 제공.

개발 임팩트

• 테스트 리포트 생성 및 관리의 복잡성을 대폭 줄여 개발 생산성 향상.
• CI/CD 파이프라인에 쉽게 통합하여 테스트 결과 가시성 확보.
• 휘청이는 테스트 감지, 상세 로그, 추적성 기능으로 디버깅 및 품질 관리 효율 증대.
• 내보내기 기능을 활용하여 자체 대시보드 구축 및 테스트 관리 워크플로우 개선.

커뮤니티 반응

• "데코레이터나 설정 없이 바로 작동했다."
• "휘청이는 테스트 감지와 필터링 기능이 시간을 절약해줬다."
• "CI에 적용하고 XML 및 JSON을 쉽게 생성할 수 있었다. 훌륭하다."
• "JSON 내보내기 기능을 사용하여 몇 분 안에 자체 대시보드를 만들었다."