codehealthanalyzer 1.1.0

Biblioteca Python para análise de qualidade e saúde de código

🔍 CodeHealthAnalyzer

Uma biblioteca Python completa para análise de qualidade e saúde de código

🇧🇷 Português | 🇺🇸 English

🚀 Visão Geral

CodeHealthAnalyzer é uma biblioteca Python moderna e abrangente para análise de qualidade de código. Ela combina múltiplas ferramentas de análise em uma interface unificada, fornecendo insights detalhados sobre a saúde do seu código.

✨ Principais Funcionalidades

• 🚨 Análise de Violações: Detecta funções, classes e módulos que excedem limites de tamanho
• 🎨 Análise de Templates: Identifica CSS/JS inline em templates HTML que podem ser extraídos
• ⚠️ Integração com Ruff: Analisa erros de linting e os categoriza por prioridade
• 📊 Score de Qualidade: Calcula um score de 0-100 baseado na saúde geral do código
• 🎯 Priorização Inteligente: Sugere ações baseadas na criticidade dos problemas
• 📈 Relatórios Múltiplos: Gera relatórios em JSON, HTML, Markdown e CSV
• 🖥️ CLI Amigável: Interface de linha de comando completa e intuitiva
• 🔧 Altamente Configurável: Personalize limites, regras e categorias

📦 Instalação

Instalação via pip (recomendado)

# Instalação básica
pip install codehealthanalyzer

# Instalação com dashboard web interativo
pip install codehealthanalyzer[web]

# Instalação completa (web + desenvolvimento)
pip install codehealthanalyzer[web,dev]

Instalação para desenvolvimento

git clone https://github.com/imparcialista/codehealthanalyzer.git
cd codehealthanalyzer
pip install -e .[web,dev]

Dependências

• Python 3.8+
• ruff >= 0.1.0
• click >= 8.0.0
• rich >= 12.0.0 (opcional, para saída colorida)

🎯 Uso Rápido

🌐 Dashboard Interativo

# Iniciar dashboard web com métricas em tempo real
codehealthanalyzer dashboard .

# Dashboard em host e porta específicos
codehealthanalyzer dashboard . --host 0.0.0.0 --port 8080

# Dashboard com reload automático para desenvolvimento
codehealthanalyzer dashboard . --reload

Funcionalidades do Dashboard:

• 📊 Métricas em tempo real com atualizações automáticas
• 📈 Gráficos interativos de tendência de qualidade
• 🎯 Visualização de violações por tipo
• 📋 Tabela de arquivos com problemas
• 🔄 WebSockets para atualizações instantâneas
• 📱 Interface responsiva e moderna

CLI (Interface de Linha de Comando)

# Análise completa do projeto atual
codehealthanalyzer analyze .

# Análise com saída em HTML
codehealthanalyzer analyze . --format html --output reports/

# Apenas score de qualidade
codehealthanalyzer score .

# Informações do projeto
codehealthanalyzer info .

# Análise específica de violações
codehealthanalyzer violations . --output violations.json

API Python

from codehealthanalyzer import CodeAnalyzer

# Inicializa o analisador
analyzer = CodeAnalyzer('/path/to/project')

# Gera relatório completo
report = analyzer.generate_full_report(output_dir='reports/')

# Obtém score de qualidade
score = analyzer.get_quality_score()
print(f"Score de Qualidade: {score}/100")

# Análises individuais
violations = analyzer.analyze_violations()
templates = analyzer.analyze_templates()
errors = analyzer.analyze_errors()

📊 Exemplo de Saída

📊 RESUMO DA ANÁLISE
==================================================
✅ Score de Qualidade: 85/100 - Excelente!
📁 Arquivos analisados: 124
⚠️  Arquivos com violações: 8
🎨 Templates: 15
🔍 Erros Ruff: 0
🔥 Issues de alta prioridade: 2

🎯 PRIORIDADES DE AÇÃO:
1. 🔴 Violações de Alta Prioridade (2)
2. 🟡 Templates com Muito CSS/JS Inline (3)

🔧 Configuração

Arquivo de Configuração JSON

{
  "limits": {
    "python_function": {"yellow": 30, "red": 50},
    "python_class": {"yellow": 300, "red": 500},
    "python_module": {"yellow": 500, "red": 1000},
    "html_template": {"yellow": 150, "red": 200},
    "test_file": {"yellow": 400, "red": 600}
  },
  "target_dir": "src/",
  "file_rules": {
    "critical_files": ["main.py", "core.py"],
    "skip_patterns": [".git", "__pycache__", "node_modules"]
  }
}

Uso com Configuração

codehealthanalyzer analyze . --config config.json

import json
from codehealthanalyzer import CodeAnalyzer

with open('config.json') as f:
    config = json.load(f)

analyzer = CodeAnalyzer('/path/to/project', config)

📈 Tipos de Análise

🚨 Análise de Violações

Detecta:

• Funções muito longas (> 50 linhas)
• Classes muito grandes (> 500 linhas)
• Módulos muito extensos (> 1000 linhas)
• Templates HTML muito longos (> 200 linhas)

🎨 Análise de Templates

Identifica:

• CSS inline em atributos style
• JavaScript inline em eventos (onclick, etc.)
• Tags <style> com muito conteúdo
• Tags <script> com muito código

⚠️ Análise de Erros

Integra com Ruff para detectar:

• Erros de sintaxe
• Problemas de estilo
• Imports não utilizados
• Variáveis não definidas
• Complexidade excessiva

📊 Score de Qualidade

O score é calculado baseado em:

• Violações de alta prioridade: -10 pontos cada
• Erros de linting: -2 pontos cada
• Templates problemáticos: -5 pontos cada
• Base: 100 pontos

Interpretação

• 80-100: 🟢 Excelente
• 60-79: 🟡 Bom
• 0-59: 🔴 Precisa melhorar

🎯 Categorização Inteligente

Arquivos

• Arquivo Crítico: Arquivos essenciais do sistema
• Views Admin: Interfaces administrativas
• Blueprint Crítico: Rotas críticas da aplicação
• Template Base: Templates fundamentais

Prioridades

• Alta: Problemas que afetam funcionalidade
• Média: Problemas de manutenibilidade
• Baixa: Melhorias recomendadas

📋 Formatos de Relatório

JSON

{
  "metadata": {
    "generated_at": "2024-01-15T10:30:00",
    "generator": "CodeHealthAnalyzer v1.0.0"
  },
  "summary": {
    "quality_score": 85,
    "total_files": 124,
    "violation_files": 8
  },
  "priorities": [...],
  "violations": [...],
  "templates": [...],
  "errors": [...]
}

HTML

Relatório interativo com gráficos e métricas visuais.

Markdown

Relatório em formato Markdown para documentação.

CSV

Dados tabulares para análise em planilhas.

🛠️ API Avançada

Analisadores Individuais

from codehealthanalyzer.analyzers import (
    ViolationsAnalyzer,
    TemplatesAnalyzer,
    ErrorsAnalyzer
)

# Análise específica de violações
violations_analyzer = ViolationsAnalyzer('/path/to/project')
violations_report = violations_analyzer.analyze()

# Análise específica de templates
templates_analyzer = TemplatesAnalyzer('/path/to/project')
templates_report = templates_analyzer.analyze()

# Análise específica de erros
errors_analyzer = ErrorsAnalyzer('/path/to/project')
errors_report = errors_analyzer.analyze()

Geração de Relatórios

from codehealthanalyzer.reports import ReportGenerator, ReportFormatter

generator = ReportGenerator()
formatter = ReportFormatter()

# Gera relatório consolidado
full_report = generator.generate_full_report(
    violations=violations_report,
    templates=templates_report,
    errors=errors_report,
    output_dir='reports/'
)

# Converte para diferentes formatos
html_content = generator.generate_html_report(full_report, 'report.html')
markdown_content = formatter.to_markdown(full_report, 'report.md')
formatter.to_csv(full_report, 'report.csv')

Utilitários

from codehealthanalyzer.utils import (
    Categorizer,
    PathValidator,
    FileHelper,
    ColorHelper
)

# Categorização
categorizer = Categorizer()
category = categorizer.categorize_file(Path('src/main.py'))
priority = categorizer.determine_priority('file', {'lines': 150, 'type': 'python'})

# Validação
validator = PathValidator()
is_valid = validator.is_python_project('/path/to/project')
project_info = validator.get_project_info('/path/to/project')

# Helpers
file_helper = FileHelper()
data = file_helper.read_json('config.json')
file_helper.write_json(data, 'output.json')

# Cores para terminal
print(ColorHelper.success("Sucesso!"))
print(ColorHelper.error("Erro!"))
print(ColorHelper.warning("Aviso!"))

🧪 Testes

# Instala dependências de desenvolvimento
pip install -e ".[dev]"

# Executa testes
pytest

# Executa testes com cobertura
pytest --cov=codehealthanalyzer

# Executa linting
ruff check codehealthanalyzer/
black --check codehealthanalyzer/

🤝 Contribuição

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

Diretrizes de Contribuição

• Siga o estilo de código existente
• Adicione testes para novas funcionalidades
• Atualize a documentação quando necessário
• Use commits semânticos

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

🙏 Agradecimentos

• Ruff - Linter Python ultrarrápido
• Click - Framework para CLI
• Rich - Formatação rica para terminal

📞 Suporte

• 📧 Email: [e-mail]
• 🐛 Issues: GitHub Issues
• 📖 Documentação: ReadTheDocs

---

Feito com ❤️ pela equipe Imparcialista

---

🔍 CodeHealthAnalyzer

A comprehensive Python library for code quality and health analysis

🇧🇷 Português | 🇺🇸 English

🚀 Overview

CodeHealthAnalyzer is a modern and comprehensive Python library for code quality analysis. It combines multiple analysis tools into a unified interface, providing detailed insights into your code's health.

✨ Key Features

• 🚨 Violations Analysis: Detects functions, classes, and modules that exceed size limits
• 🎨 Template Analysis: Identifies inline CSS/JS in HTML templates that can be extracted
• ⚠️ Ruff Integration: Analyzes linting errors and categorizes them by priority
• 📊 Quality Score: Calculates a 0-100 score based on overall code health
• 🎯 Smart Prioritization: Suggests actions based on problem criticality
• 📈 Multiple Reports: Generates reports in JSON, HTML, Markdown, and CSV
• 🖥️ Friendly CLI: Complete and intuitive command-line interface
• 🔧 Highly Configurable: Customize limits, rules, and categories

📦 Installation

Installation via pip (recommended)

# Basic installation
pip install codehealthanalyzer

# Installation with interactive web dashboard
pip install codehealthanalyzer[web]

# Complete installation (web + development)
pip install codehealthanalyzer[web,dev]

Development Installation

git clone https://github.com/imparcialista/codehealthanalyzer.git
cd codehealthanalyzer
pip install -e .[web,dev]

Dependencies

• Python 3.8+
• ruff >= 0.1.0
• click >= 8.0.0
• rich >= 12.0.0 (optional, for colored output)

🎯 Quick Start

🌐 Interactive Dashboard

# Start web dashboard with real-time metrics
codehealthanalyzer dashboard .

# Dashboard on specific host and port
codehealthanalyzer dashboard . --host 0.0.0.0 --port 8080

# Dashboard with auto-reload for development
codehealthanalyzer dashboard . --reload

Dashboard Features:

• 📊 Real-time metrics with automatic updates
• 📈 Interactive quality trend charts
• 🎯 Violations visualization by type
• 📋 Problem files table
• 🔄 WebSockets for instant updates
• 📱 Responsive and modern interface

CLI (Command Line Interface)

# Complete analysis of current project
codehealthanalyzer analyze .

# Analysis with HTML output
codehealthanalyzer analyze . --format html --output reports/

# Quality score only
codehealthanalyzer score .

# Project information
codehealthanalyzer info .

# Specific violations analysis
codehealthanalyzer violations . --output violations.json

Python API

from codehealthanalyzer import CodeAnalyzer

# Initialize analyzer
analyzer = CodeAnalyzer('/path/to/project')

# Generate complete report
report = analyzer.generate_full_report(output_dir='reports/')

# Get quality score
score = analyzer.get_quality_score()
print(f"Quality Score: {score}/100")

# Individual analyses
violations = analyzer.analyze_violations()
templates = analyzer.analyze_templates()
errors = analyzer.analyze_errors()

📊 Example Output

📊 ANALYSIS SUMMARY
==================================================
✅ Quality Score: 85/100 - Excellent!
📁 Files analyzed: 124
⚠️  Files with violations: 8
🎨 Templates: 15
🔍 Ruff Errors: 0
🔥 High priority issues: 2

🎯 ACTION PRIORITIES:
1. 🔴 High Priority Violations (2)
2. 🟡 Templates with Too Much Inline CSS/JS (3)

🔧 Configuration

JSON Configuration File

{
  "limits": {
    "python_function": {"yellow": 30, "red": 50},
    "python_class": {"yellow": 300, "red": 500},
    "python_module": {"yellow": 500, "red": 1000},
    "html_template": {"yellow": 150, "red": 200},
    "test_file": {"yellow": 400, "red": 600}
  },
  "target_dir": "src/",
  "file_rules": {
    "critical_files": ["main.py", "core.py"],
    "skip_patterns": [".git", "__pycache__", "node_modules"]
  }
}

Usage with Configuration

codehealthanalyzer analyze . --config config.json

import json
from codehealthanalyzer import CodeAnalyzer

with open('config.json') as f:
    config = json.load(f)

analyzer = CodeAnalyzer('/path/to/project', config)

📈 Analysis Types

🚨 Violations Analysis

Detects:

• Functions too long (> 50 lines)
• Classes too large (> 500 lines)
• Modules too extensive (> 1000 lines)
• HTML templates too long (> 200 lines)

🎨 Template Analysis

Identifies:

• Inline CSS in style attributes
• Inline JavaScript in events (onclick, etc.)
• <style> tags with too much content
• <script> tags with too much code

⚠️ Error Analysis

Integrates with Ruff to detect:

• Syntax errors
• Style issues
• Unused imports
• Undefined variables
• Excessive complexity

📊 Quality Score

The score is calculated based on:

• High priority violations: -10 points each
• Linting errors: -2 points each
• Problematic templates: -5 points each
• Base: 100 points

Interpretation

• 80-100: 🟢 Excellent
• 60-79: 🟡 Good
• 0-59: 🔴 Needs improvement

🌐 Internationalization

Language Support

CodeHealthAnalyzer supports multiple languages:

• Portuguese (Brazil): Default language
• English: Full translation available

Setting Language

from codehealthanalyzer.i18n import set_language

# Set to English
set_language('en')

# Set to Portuguese (Brazil)
set_language('pt_BR')

# Auto-detect system language
from codehealthanalyzer.i18n import auto_configure_language
auto_configure_language()

Environment Variable

# Set language via environment
export CODEHEALTHANALYZER_LANG=en
codehealthanalyzer analyze .

🛠️ Advanced API

Individual Analyzers

from codehealthanalyzer.analyzers import (
    ViolationsAnalyzer,
    TemplatesAnalyzer,
    ErrorsAnalyzer
)

# Specific violations analysis
violations_analyzer = ViolationsAnalyzer('/path/to/project')
violations_report = violations_analyzer.analyze()

# Specific templates analysis
templates_analyzer = TemplatesAnalyzer('/path/to/project')
templates_report = templates_analyzer.analyze()

# Specific errors analysis
errors_analyzer = ErrorsAnalyzer('/path/to/project')
errors_report = errors_analyzer.analyze()

Report Generation

from codehealthanalyzer.reports import ReportGenerator, ReportFormatter

generator = ReportGenerator()
formatter = ReportFormatter()

# Generate consolidated report
full_report = generator.generate_full_report(
    violations=violations_report,
    templates=templates_report,
    errors=errors_report,
    output_dir='reports/'
)

# Convert to different formats
html_content = generator.generate_html_report(full_report, 'report.html')
markdown_content = formatter.to_markdown(full_report, 'report.md')
formatter.to_csv(full_report, 'report.csv')

🧪 Testing

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run tests with coverage
pytest --cov=codehealthanalyzer

# Run linting
ruff check codehealthanalyzer/
black --check codehealthanalyzer/

🤝 Contributing

1. Fork the project
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Contribution Guidelines

• Follow existing code style
• Add tests for new features
• Update documentation when necessary
• Use semantic commits

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Ruff - Ultra-fast Python linter
• Click - CLI framework
• Rich - Rich terminal formatting

📞 Support

• 📧 Email: [e-mail]
• 🐛 Issues: GitHub Issues
• 📖 Documentation: ReadTheDocs

---

Made with ❤️ by the Imparcialista team