Ferramenta de linha de comando rápida que conta arquivos, linhas de código, comentários e linhas em branco, agrupados por linguagem.
AlDanial/cloc
cloc é uma ferramenta de linha de comando que conta linhas em branco, comentários e código-fonte em diversas linguagens de programação.
- Estrelas
- 23,645
- Forks
- 1,125
- Issues abertas
- 26
- Último commit
- há 13 dias
O que é?
cloc conta linhas em branco, linhas de comentário e linhas físicas de código-fonte em diversas linguagens de programação. Aceita arquivos individuais, diretórios, arquivos compactados como .tar, .zip, .whl e .deb, além de commits ou branches do git. Também pode comparar duas versões de uma base de código e informar as diferenças na contagem de linhas.
É escrito em Perl e usa apenas a distribuição padrão do Perl. Por isso, o script único funciona em Linux, BSD, macOS, Solaris e Windows; também há um executável independente para Windows. Os resultados podem ser gerados em texto simples, Markdown, SQL, JSON, XML, YAML ou CSV, e é possível somar várias execuções por linguagem ou projeto.
Pode ser instalado por gerenciadores de pacotes comuns, como apt, Homebrew, npm e winget, ou executado via Docker.
Recursos principais
- 01Conta linhas em branco, comentários e código em diversas linguagens de programação.
- 02Aceita arquivos, diretórios, arquivos compactados e commits ou branches do git como entrada.
- 03Compara duas versões do código para mostrar diferenças na contagem de linhas.
- 04Exporta os resultados como texto, Markdown, SQL, JSON, XML, YAML ou CSV.
- 05Funciona com Perl 5.6+ sem dependências adicionais e oferece um binário para Windows.
Casos de uso
- Estimar o tamanho de uma base de código antes de iniciar um projeto ou uma migração.
- Acompanhar quanto código mudou entre duas branches ou versões do git.
- Gerar relatórios de contagem de linhas em pipelines de CI usando saída em JSON ou CSV.
- Resumir a distribuição de linguagens de um repositório ou arquivo compactado baixado.
Início rápido
- 1
Instale o cloc pelo gerenciador de pacotes npm
npm install -g cloc - 2
Abra um terminal e execute o cloc em um diretório
cloc .
Antes de usar
- A versão do código-fonte requer um interpretador Perl; o binário para Windows não tem requisitos.
- Licenciado sob a GPL-2.0, uma licença copyleft que pode restringir alguns usos.
Em coleções
Tópicos
Perguntas frequentes
- O que é cloc?
- cloc é uma ferramenta de linha de comando que conta linhas em branco, comentários e código-fonte em diversas linguagens de programação. cloc conta linhas em branco, linhas de comentário e linhas físicas de código-fonte em diversas linguagens de programação. Aceita arquivos individuais, diretórios, arquivos compactados como .tar, .zip, .whl e .deb, além de commits ou branches do git. Também pode comparar duas versões de uma base de código e informar as diferenças na contagem de linhas.
- cloc é gratuito? Qual é a licença?
- cloc é open source sob a licença GPL-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- cloc ainda é mantido?
- Manutenção ativa. O último commit de cloc foi em 26 de out. de 2026.
- Para que posso usar cloc?
- Estimar o tamanho de uma base de código antes de iniciar um projeto ou uma migração. Acompanhar quanto código mudou entre duas branches ou versões do git. Gerar relatórios de contagem de linhas em pipelines de CI usando saída em JSON ou CSV. Resumir a distribuição de linguagens de um repositório ou arquivo compactado baixado.
- Como instalar cloc?
- Instale o cloc pelo gerenciador de pacotes npm: npm install -g cloc Abra um terminal e execute o cloc em um diretório: cloc .
- Onde consigo cloc?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/AlDanial/cloc
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um pacote Composer de desenvolvimento para Laravel e Lumen que contabiliza o código do app e classifica as classes por componente do Laravel.
Uma ferramenta de CLI que busca, verifica e reescreve código usando padrões de árvores sintáticas abstratas em vez de texto simples.
CLI de code review com IA que combina seleção determinística de arquivos e regras com um agente LLM para comentar linhas específicas em diffs do Git.
Uma ferramenta de linha de comando que percorre o histórico do git e acompanha como a complexidade e as métricas do código Python mudam ao longo do tempo.
Um clone do cat(1) para o terminal, com realce de sintaxe, indicadores de alterações do Git e paginação automática.