codehealthanalyzer 1.0.0__tar.gz

codehealthanalyzer-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Luarco Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codehealthanalyzer-1.0.0/MANIFEST.in

@@ -0,0 +1,18 @@
+# Include documentation and license files
+include README.md
+include LICENSE
+include requirements.txt
+include example.py
+
+# Include package data
+recursive-include codehealthanalyzer *.py
+recursive-include codehealthanalyzer *.json
+recursive-include codehealthanalyzer *.txt
+
+# Exclude development and cache files
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude *.egg-info
+global-exclude .git*
+global-exclude .DS_Store
+global-exclude *.log

codehealthanalyzer-1.0.0/PKG-INFO

@@ -0,0 +1,406 @@
+Metadata-Version: 2.4
+Name: codehealthanalyzer
+Version: 1.0.0
+Summary: Biblioteca Python para análise de qualidade e saúde de código
+Home-page: https://github.com/imparcialista/codehealthanalyzer
+Author: Luarco Team
+Author-email: contato@luarco.com.br
+Project-URL: Bug Reports, https://github.com/imparcialista/codehealthanalyzer/issues
+Project-URL: Source, https://github.com/imparcialista/codehealthanalyzer
+Project-URL: Documentation, https://codehealthanalyzer.readthedocs.io/
+Keywords: code-quality,static-analysis,code-health,linting,python,html,css,javascript,ruff,analysis,metrics,reporting
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ruff>=0.1.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: rich>=12.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: isort>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=5.0.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "docs"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 🔍 CodeHealthAnalyzer
+
+> Uma biblioteca Python completa para análise de qualidade e saúde de código
+
+🇧🇷 Português | [🇺🇸 English](README_EN.md)
+
+[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+## 🚀 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)
+
+```bash
+pip install codehealthanalyzer
+```
+
+### Instalação para desenvolvimento
+
+```bash
+git clone https://github.com/imparcialista/codehealthanalyzer.git
+cd codehealthanalyzer
+pip install -e .
+```
+
+### 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
+
+### CLI (Interface de Linha de Comando)
+
+```bash
+# 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
+
+```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
+
+```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
+
+```bash
+codehealthanalyzer analyze . --config config.json
+```
+
+```python
+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
+```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
+
+```python
+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
+
+```python
+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
+
+```python
+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
+
+```bash
+# 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](LICENSE) para detalhes.
+
+## 🙏 Agradecimentos
+
+- [Ruff](https://github.com/astral-sh/ruff) - Linter Python ultrarrápido
+- [Click](https://click.palletsprojects.com/) - Framework para CLI
+- [Rich](https://github.com/Textualize/rich) - Formatação rica para terminal
+
+## 📞 Suporte
+
+- 📧 Email: contato@luarco.com.br
+- 🐛 Issues: [GitHub Issues](https://github.com/imparcialista/codehealthanalyzer/issues)
+- 📖 Documentação: [ReadTheDocs](https://codehealthanalyzer.readthedocs.io/)
+
+---
+
+**Feito com ❤️ pela equipe Imparcialista**