Repolode
loeffel-io

loeffel-io/ls-lint

Um linter rápido de linha de comando que impõe convenções de nomenclatura para diretórios e arquivos do projeto, configurado por meio de arquivos .ls-lint.yml.

Estrelas
2,430
Forks
46
Issues abertas
43
Último commit
ontem

O que é?

O ls-lint verifica os nomes de diretórios e arquivos de um projeto de acordo com regras definidas por você, como kebab-case, camelCase ou PascalCase, e pode exigir que arquivos relacionados, como testes, existam junto dos arquivos-fonte. As regras são definidas em um ou mais arquivos .ls-lint.yml, que associam padrões de caminho às convenções de nomenclatura aplicáveis.

Ele oferece suporte a todas as extensões de arquivo e a nomes em Unicode, além de rodar no Windows, macOS e Linux. Além do binário independente, pode ser instalado via npm, Homebrew ou Docker, e há uma GitHub Action para executá-lo no CI. Padrões de exclusão permitem ignorar diretórios como node_modules.

A ferramenta é escrita em Go e depende de apenas algumas bibliotecas pequenas para analisar YAML e corresponder padrões glob.

Recursos principais

  • 01Defina regras de nomenclatura por padrão de caminho em arquivos .ls-lint.yml
  • 02Oferece suporte a kebab-case, camelCase, PascalCase e padrões baseados em regex
  • 03Pode exigir a existência de arquivos complementares, como testes
  • 04Lida com todas as extensões de arquivo e nomes totalmente em Unicode
  • 05Padrões de exclusão para ignorar diretórios como node_modules

Casos de uso

  • Impor uma nomenclatura consistente para arquivos em uma base de código frontend ou monorepo
  • Verificar convenções de nomenclatura de arquivos no CI antes de mesclar pull requests
  • Confirmar que cada diretório de componente contém os arquivos de teste necessários

Início rápido

  1. 1

    Instale o pacote npm @ls-lint/ls-lint, a fórmula do Homebrew ou a imagem do Docker, conforme indicado no README

  2. 2

    Crie um arquivo .ls-lint.yml para definir as regras de nomenclatura dos diretórios e nomes de arquivos

Tópicos

Perguntas frequentes

O que é ls-lint?
Um linter rápido de linha de comando que impõe convenções de nomenclatura para diretórios e arquivos do projeto, configurado por meio de arquivos .ls-lint.yml. O ls-lint verifica os nomes de diretórios e arquivos de um projeto de acordo com regras definidas por você, como kebab-case, camelCase ou PascalCase, e pode exigir que arquivos relacionados, como testes, existam junto dos arquivos-fonte. As regras são definidas em um ou mais arquivos .ls-lint.yml, que associam padrões de caminho às convenções de nomenclatura aplicáveis.
ls-lint é gratuito? Qual é a licença?
ls-lint é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
ls-lint ainda é mantido?
Manutenção ativa. O último commit de ls-lint foi em 21 de out. de 2026.
Para que posso usar ls-lint?
Impor uma nomenclatura consistente para arquivos em uma base de código frontend ou monorepo Verificar convenções de nomenclatura de arquivos no CI antes de mesclar pull requests Confirmar que cada diretório de componente contém os arquivos de teste necessários
Como instalar ls-lint?
Instale o pacote npm @ls-lint/ls-lint, a fórmula do Homebrew ou a imagem do Docker, conforme indicado no README Crie um arquivo .ls-lint.yml para definir as regras de nomenclatura dos diretórios e nomes de arquivos
Onde consigo ls-lint?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/loeffel-io/ls-lint

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados