Code Analyzer

Uma ferramenta CLI poderosa para analisar bases de código e identificar candidatos a refatoração usando análise AST (Abstract Syntax Tree). Desenvolva código mais limpo e mantenha a qualidade técnica do seu projeto com métricas precisas e relatórios detalhados.

🚀 Funcionalidades

📊 Análise Precisa de Código

• Parsing AST: Utiliza tree-sitter para análise precisa de código fonte
• Múltiplas Linguagens: Suporte para Rust, JavaScript, Python, Java, C, C++, Go e TypeScript
• Métricas Detalhadas: Conta linhas de código, funções, classes e calcula pontuação de complexidade
• Respeito ao .gitignore: Ignora automaticamente arquivos especificados no .gitignore

🎯 Filtragem e Personalização

• Filtros Flexíveis: Por número de linhas, funções, classes e tamanho de arquivo
• Ordenação Inteligente: Por linhas, funções, classes ou complexidade
• Seleção de Linguagens: Analise apenas as linguagens que importam
• Padrões de Exclusão: Adicione padrões personalizados além do .gitignore

📈 Saída Dupla

• Terminal Interativo: Tabelas formatadas com cores e informações claras
• Exportação JSON: Dados estruturados para integração CI/CD e automação
• Relatórios Customizáveis: Limite resultados e personalize a saída

⚡ Performance

• Processamento Paralelo: Análise rápida usando todos os cores disponíveis
• Barra de Progresso: Acompanhe o progresso em tempo real
• Otimizado para Grandes Projetos: Eficiente mesmo em bases de código extensas

🛠️ Instalação

Pré-requisitos

• Rust 1.70 ou superior
• Git (para clonagem do repositório)

Instalação via Cargo (Recomendado)

# Clone o repositório
git clone https://github.com/quantmind-br/code-analyzer.git
cd code-analyzer
# Instale localmente
cargo install --path .

Instalação via Crates.io (Em breve)

cargo install code-analyzer

Build Manual

# Clone e compile
git clone https://github.com/quantmind-br/code-analyzer.git
cd code-analyzer
cargo build --release
# O executável estará em target/release/code-analyzer

📋 Uso

Análise Básica

# Analisa o diretório atual
code-analyzer
# Analisa um diretório específico
code-analyzer /caminho/para/projeto
# Análise com saída detalhada
code-analyzer --verbose

Filtragem e Personalização

# Apenas arquivos com mais de 100 linhas
code-analyzer --min-lines 100
# Filtrar por múltiplos critérios
code-analyzer --min-lines 50 --min-functions 5 --max-lines 1000
# Analisar apenas linguagens específicas
code-analyzer --languages rust,python,javascript
# Ordenar por complexidade
code-analyzer --sort complexity

Opções de Saída

# Apenas saída JSON
code-analyzer --output json
# Salvar JSON em arquivo personalizado
code-analyzer --output-file meu-relatorio.json
# Limitar resultados exibidos no terminal
code-analyzer --limit 20
# Apenas arquivo JSON, sem saída no terminal
code-analyzer --json-only

Exclusão de Arquivos

# Excluir padrões adicionais
code-analyzer --exclude "*.test.js,*.spec.py"# Incluir arquivos ocultos
code-analyzer --include-hidden
# Limitar tamanho máximo de arquivo (em MB)
code-analyzer --max-file-size-mb 5

📊 Exemplo de Saída

Terminal

┌─────────────────────────────┬──────────┬────────┬─────────┬───────────┬─────────────────┐
│ File │ Language │ Lines │ Funcs │ Classes │ Complexity │
├─────────────────────────────┼──────────┼────────┼─────────┼───────────┼─────────────────┤
│ src/analyzer/parser.rs │ rust │ 450 │ 25 │ 3 │ 5.2 │
│ src/cli.rs │ rust │ 240 │ 15 │ 7 │ 5.1 │
│ src/lib.rs │ rust │ 210 │ 18 │ 2 │ 4.8 │
│ PRPs/scripts/prp_runner.py │ python │ 210 │ 5 │ 0 │ 3.2 │
└─────────────────────────────┴──────────┴────────┴─────────┴───────────┴─────────────────┘
Analysis completed: 45 files analyzed
Total lines: 15,420 | Total functions: 234 | Total classes: 45

JSON

{
"files": [
{
"path": "./src/analyzer/parser.rs",
"language": "rust",
"lines_of_code": 450,
"blank_lines": 65,
"comment_lines": 120,
"functions": 25,
"classes": 3,
"complexity_score": 5.2
}
],
"summary": {
"total_files": 45,
"total_lines": 15420,
"total_functions": 234,
"total_classes": 45,
"languages_found": ["rust", "python", "javascript"]
}
}

🎯 Casos de Uso

👨‍💼 Para Arquitetos e Tech Leads

• Identificação de Hot Spots: Encontre arquivos complexos que precisam de refatoração
• Planejamento de Sprint: Priorize tarefas de melhoria baseadas em métricas objetivas
• Code Review: Use métricas para guiar revisões de código mais efetivas

🏢 Para Equipes de Desenvolvimento

• Integração CI/CD: Monitore qualidade de código automaticamente
• Onboarding: Novos desenvolvedores podem entender rapidamente a estrutura do projeto
• Refatoração Orientada a Dados: Tome decisões baseadas em evidências, não intuição

📈 Para Análise de Technical Debt

• Baseline de Qualidade: Estabeleça métricas iniciais para acompanhar melhorias
• ROI de Refatoração: Quantifique o impacto de melhorias no código
• Relatórios para Stakeholders: Dados objetivos sobre saúde do código

🔧 Desenvolvimento

Configuração do Ambiente

# Clone o repositório
git clone https://github.com/example/code-analyzer.git
cd code-analyzer
# Instale as dependências e compile
cargo build

Executando Testes

# Todos os testes
cargo test# Apenas testes de integração
cargo test --test integration_tests
# Com saída detalhada
cargo test -- --nocapture

Verificação de Qualidade

# Formatação
cargo fmt
# Linting
cargo clippy
# Verificação completa (para CI)
cargo fmt --check && cargo clippy -- -D warnings && cargo test

🤝 Contribuindo

Contribuições são bem-vindas! Veja nosso guia de contribuição para começar.

Roadmap

• Suporte para mais linguagens (C#, PHP, Ruby)
• Interface web para visualização de métricas
• Integração com IDEs populares
• Análise histórica e tendências
• Suporte para métricas customizadas

📄 Licença

Este projeto está licenciado sob MIT ou Apache-2.0 - veja os arquivos de licença para detalhes.

📞 Suporte

• 🐛 Issues: GitHub Issues
• 📧 Email: suporte@code-analyzer.dev
• 💬 Discussões: GitHub Discussions

---

Desenvolvido com ❤️ em Rust

Transforme análise de código em insights acionáveis