Unref - Ruff 파서 기반 Python 데드 코드 탐지기
Show HN: Unref – A Python dead code finder built on Ruff's parser

Unref는 Ruff의 파서를 활용해 Python 프로젝트에서 참조되지 않는 코드를 찾아내는 정적 분석 도구입니다. 사용되지 않는 함수, 클래스, 변수를 정확하게 식별해 코드베이스를 깔끔하게 유지하도록 돕습니다. Python 3.15까지 지원하며, 여러 프레임워크를 인식해 오탐을 줄였습니다. PR마다 발견 사항과 성능 변화를 자동으로 비교해 코멘트로 남기는 CI 워크플로도 제공합니다. 오픈소스 프로젝트에서 데드 코드를 정리하고 유지보수 부담을 줄이고 싶은 개발자에게 유용합니다.
Unref는 Ruff의 파서 위에 구축되어 참조되지 않는 Python 코드를 정확하게 찾아내고, 코드베이스를 더 깔끔하고 관리하기 쉽게 만들어 줍니다.
HN 토론
17- selcuka
멋진 프로젝트네요. 이 단계에서는 놓치는 데드 코드보다 오탐이 더 중요하다고 생각합니다. 예를 들어, Django 설정을 모두 사용되지 않는 변수로 표시하는데, 아마도 Django 프로젝트에서는 설정이 보통 직접 임포트되지 않기 때문일 겁니다. 예를 들면:
from django.conf import settings
...
if settings.DEBUG:
...
현재 unref는 DEBUG가 사용되지 않는다고 생각합니다.
마찬가지로 asgi.py(또는 wsgi.py)의 `application` 변수는 ASGI/WSGI 서버 실행 파일에 인수로 전달되지만, 이것도 사용되지 않는 것으로 표시됩니다.
- peterabbitcook
만들어신 것을 nuitka의 내부 일부와 비교해 보셨나요? nuitka는 모듈 수준에서 데드 코드 검색을 중단하지만, 해당 제외/포함 플래그/규칙이 일반 패키지에 대한 오탐을 줄이는 방향으로 이끌어 줄 수 있습니다.
- athoscouto
저도 내부적으로 비슷한 것을 시도해 왔습니다. 역시 Python으로 시작해서 ruff로 넘어갔죠. 다만 제 목표는 조금 더 넓습니다. 의존성 그래프를 사용해 프로젝트에서 변경된 부분을 감지하여 이미지 빌드와 테스트 실행을 선택적으로 트리거하고 싶습니다.
결과는 아직 좋지 않습니다. 특히 테스트 쪽이요. 지금까지의 주요 교훈은 제대로 작동하려면 깔끔한 코드베이스(의존성 그래프)가 필수적이라는 것입니다.
이를 효과적으로 다루는 오픈소스 도구를 더 많이 찾지 못한 것이 놀랍습니다.