Un linter de texto para la línea de comandos que aplica las reglas de estilo de escritura de tu equipo en editores, CI y código, sin conexión.
loeffel-io/ls-lint
Un linter de línea de comandos rápido que aplica convenciones de nombres a directorios y archivos del proyecto mediante archivos .ls-lint.yml.
- Estrellas
- 2,430
- Forks
- 46
- Issues abiertos
- 43
- Último commit
- ayer
¿Qué es?
ls-lint comprueba los nombres de los directorios y archivos de un proyecto según las reglas que definas, como kebab-case, camelCase o PascalCase, y puede exigir que haya archivos relacionados, como pruebas, junto a los archivos de código fuente. Las reglas se escriben en uno o varios archivos .ls-lint.yml, donde se asocian patrones de rutas con las convenciones de nombres correspondientes.
Es compatible con todas las extensiones de archivo y con nombres Unicode, y funciona en Windows, macOS y Linux. Además del binario independiente, se puede instalar mediante npm, Homebrew o Docker, y hay una GitHub Action para ejecutarlo en CI. Los patrones de exclusión permiten omitir directorios como node_modules.
La herramienta está escrita en Go y solo depende de un par de bibliotecas pequeñas para analizar YAML y buscar coincidencias con patrones glob.
Funciones clave
- 01Definir reglas de nombres por patrón de ruta en archivos .ls-lint.yml
- 02Compatible con kebab-case, camelCase, PascalCase y patrones basados en expresiones regulares
- 03Puede exigir la presencia de archivos complementarios, como pruebas
- 04Admite todas las extensiones de archivo y nombres Unicode completos
- 05Patrones de exclusión para omitir directorios como node_modules
Casos de uso
- Aplicar convenciones uniformes para nombrar archivos en un código base de frontend o monorepo
- Comprobar las convenciones de nombres de archivo en CI antes de fusionar pull requests
- Verificar que cada directorio de componentes contenga los archivos de prueba requeridos
Inicio rápido
- 1
Instala el paquete npm @ls-lint/ls-lint, la fórmula de Homebrew o la imagen de Docker, según se indica en el README
- 2
Crea un archivo .ls-lint.yml para definir las reglas de nomenclatura de tus directorios y nombres de archivo
Temas
Preguntas frecuentes
- ¿Qué es ls-lint?
- Un linter de línea de comandos rápido que aplica convenciones de nombres a directorios y archivos del proyecto mediante archivos .ls-lint.yml. ls-lint comprueba los nombres de los directorios y archivos de un proyecto según las reglas que definas, como kebab-case, camelCase o PascalCase, y puede exigir que haya archivos relacionados, como pruebas, junto a los archivos de código fuente. Las reglas se escriben en uno o varios archivos .ls-lint.yml, donde se asocian patrones de rutas con las convenciones de nombres correspondientes.
- ¿ls-lint es gratuito? ¿Qué licencia tiene?
- ls-lint es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿ls-lint sigue mantenido?
- Mantenimiento activo. El último commit de ls-lint fue el 21 oct 2026.
- ¿Para qué puedo usar ls-lint?
- Aplicar convenciones uniformes para nombrar archivos en un código base de frontend o monorepo Comprobar las convenciones de nombres de archivo en CI antes de fusionar pull requests Verificar que cada directorio de componentes contenga los archivos de prueba requeridos
- ¿Cómo se instala ls-lint?
- Instala el paquete npm @ls-lint/ls-lint, la fórmula de Homebrew o la imagen de Docker, según se indica en el README Crea un archivo .ls-lint.yml para definir las reglas de nomenclatura de tus directorios y nombres de archivo
- ¿Dónde consigo ls-lint?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/loeffel-io/ls-lint
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Black es un formateador de código Python con opiniones definidas y resultados deterministas que reescribe los archivos in situ con diffs mínimos.
Un gestor rápido de Git hooks escrito en Go que ejecuta en paralelo comandos de pre-commit y otros hooks en proyectos de Node.js, Ruby, Python y otros entornos.
CLI de análisis estático, rápido y de código abierto, que detecta errores y aplica estándares de codificación mediante patrones similares al código, en lugar de regex o AST.
Un linter rápido para Dockerfiles, escrito en Go, con más de 60 reglas de buenas prácticas, puntuación de calidad y comprobaciones de seguridad para secretos y el uso de ARG.
Una alternativa rápida y fácil de usar al comando Unix find para buscar archivos y directorios por nombre desde la línea de comandos.