Repolode
loeffel-io

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. 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. 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