Unref es una herramienta de línea de comandos diseñada para identificar código muerto en proyectos de Python, destacando por su alta velocidad y precisión. Desarrollada en Rust, esta solución supera en veinte veces la velocidad de Vulture, un detector de código muerto tradicional, al analizar la base de código de CPython (versión 3.15.0, aproximadamente 2.300 archivos) en menos de un segundo. Su principal ventaja técnica es la capacidad de detectar código no utilizado que otras herramientas pueden pasar por alto, manteniendo una coherencia de salida y opciones de configuración similar a la de Ruff, el linter de Python más popular actualmente.
La herramienta está diseñada para integrarse de forma nativa en los flujos de trabajo de los desarrolladores. Ofrece reglas integradas para frameworks populares como Pytest, Pydantic y SQLAlchemy, lo que permite su uso con mínima configuración en la mayoría de los proyectos. Unref opera mediante convenciones modernas, utilizando códigos de reglas estilo 'ty' y configurando sus opciones a través del archivo pyproject.toml, construido sobre el parser de Ruff. Esta arquitectura técnica garantiza una detección precisa al asociar los nombres con el módulo específico, evitando que el uso de una función en un módulo oculte su inactividad en otro.
En cuanto a la adopción, Unref está disponible para su ejecución inmediata mediante el gestor de paquetes uvx, así como como un hook pre-commit o prek, permitiendo su integración directa en GitHub Actions. El proyecto mantiene una documentación extensa en ReadTheDocs y fomenta la contribución de código y la reportación de errores falsos positivos a través de su repositorio en GitHub. Esta herramienta se posiciona como una alternativa eficiente y precisa para la limpieza de bases de código Python, complementando las herramientas existentes con un enfoque más rápido y moderno.
