Um linter de prosa de linha de comando que aplica as regras de escrita da sua equipe em editores, no CI e no código, sem precisar de conexão com a internet.
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
Instale o pacote npm @ls-lint/ls-lint, a fórmula do Homebrew ou a imagem do Docker, conforme indicado no README
- 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
Black é um formatador determinístico e opinativo de código Python que reescreve arquivos no lugar e gera diffs mínimos.
Gerenciador rápido de Git hooks escrito em Go, que executa comandos de pre-commit e outros hooks em paralelo em projetos Node.js, Ruby, Python e outras tecnologias.
CLI de análise estática rápido e open source que encontra bugs e aplica padrões de código usando padrões semelhantes ao código, em vez de regex ou ASTs.
Linter de Dockerfile rápido, feito em Go, com mais de 60 regras de boas práticas, pontuação de qualidade e verificações de segurança para secrets e uso de ARG.
Uma alternativa rápida e fácil de usar ao comando Unix find para localizar arquivos e diretórios pelo nome.