Unref - Detector de código muerto en Python basado en el parser de Ruff
Show HN: Unref – A Python dead code finder built on Ruff's parser

Unref es una herramienta de análisis estático que encuentra código Python sin referencias: funciones, clases y variables que nadie usa y que solo añaden ruido a tu base de código. Construida sobre el parser de Ruff, aprovecha su velocidad y su soporte de sintaxis moderna, incluido Python 3.15, para rastrear referencias entre módulos y frameworks conocidos. Ideal para mantener proyectos limpios, reducir deuda técnica y agilizar revisiones de código. Se integra en flujos de CI, compara hallazgos entre PRs y ofrece benchmarks frente a otros buscadores de código muerto. Disponible en GitHub bajo licencia MIT.
Encuentra el código Python que nadie referencia y elimina el ruido de tu base de código, con la velocidad del parser de Ruff.
- selcuka
Proyecto interesante. Creo que los falsos positivos son más importantes que el código muerto que se le escapa en esta etapa. Por ejemplo, marca todas las configuraciones de Django como variables no utilizadas, probablemente porque las configuraciones normalmente no se importan directamente en los proyectos de Django. Por ejemplo:
from django.conf import settings
...
if settings.DEBUG:
...
Actualmente unref piensa que DEBUG no se usa.
De manera similar, la variable `application` en asgi.py (o wsgi.py) se pasa como argumento al ejecutable del servidor ASGI/WSGI, pero también se marca como no utilizada.
- tomtom1337
¿Cuál es la definición de código muerto que usa Unref? Yo distingo entre aplicaciones y bibliotecas. En las aplicaciones puedo ver cómo cualquier código que no sea invocable desde el punto de entrada está muerto, y para las bibliotecas supongo que la definición sería cualquier código que no sea invocable desde una API pública.
Sería bueno ver la definición utilizada en la documentación/readme de GitHub.
- athoscouto
También he estado intentando hacer algo así internamente. Empecé con Python, luego pasé a ruff. Sin embargo, mi objetivo es un poco más amplio. Quiero usar el grafo de dependencias para detectar las partes modificadas del proyecto y así activar selectivamente la construcción de imágenes y la ejecución de pruebas.
Los resultados siguen siendo pobres, especialmente en el lado de las pruebas. Hasta ahora, el principal aprendizaje ha sido que una base de código ordenada (grafo de dependencias) es esencial para que funcione correctamente.
Me sorprende no haber encontrado más herramientas de código abierto que aborden esto de manera efectiva.