android-gradle-analyzer 1.3.1__tar.gz

android_gradle_analyzer-1.3.1/.github/workflows/release.yml

@@ -0,0 +1,132 @@
+name: Release on main
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Setup Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[yaml]"
+          pip install pytest
+
+      - name: Run tests
+        run: pytest -q
+
+  release:
+    needs: test
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+      tag_created: ${{ steps.tag_check.outputs.exists == 'false' }}
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.10"
+
+      - name: Read version from pyproject.toml
+        id: version
+        run: |
+          VERSION=$(python -c "import re; print(re.search(r'(?m)^version\s*=\s*\"([^\"]+)\"', open('pyproject.toml').read()).group(1))")
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "Detected version: $VERSION"
+
+      - name: Check if tag already exists
+        id: tag_check
+        run: |
+          if git rev-parse "v${{ steps.version.outputs.version }}" >/dev/null 2>&1; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+            echo "Tag v${{ steps.version.outputs.version }} already exists — skipping release"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+            echo "Tag v${{ steps.version.outputs.version }} does not exist — will create"
+          fi
+
+      - name: Extract release notes from CHANGELOG
+        if: steps.tag_check.outputs.exists == 'false'
+        run: |
+          if python scripts/extract_changelog.py "${{ steps.version.outputs.version }}" > release_notes.md; then
+            echo "Release notes extracted:"
+            cat release_notes.md
+          else
+            echo "Sin entrada en CHANGELOG.md para v${{ steps.version.outputs.version }}." > release_notes.md
+          fi
+
+      - name: Create and push tag
+        if: steps.tag_check.outputs.exists == 'false'
+        run: |
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag -a "v${{ steps.version.outputs.version }}" -m "Release v${{ steps.version.outputs.version }}"
+          git push origin "v${{ steps.version.outputs.version }}"
+
+      - name: Create GitHub release
+        if: steps.tag_check.outputs.exists == 'false'
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "v${{ steps.version.outputs.version }}" \
+            --title "v${{ steps.version.outputs.version }}" \
+            --notes-file release_notes.md
+
+  publish-pypi:
+    name: Publicar en PyPI
+    needs: release
+    # Solo publica cuando el job 'release' creó un tag nuevo (versión nueva).
+    # En pushes sin bump de versión, tag_created es 'false' y este job se salta,
+    # evitando reintentos de subir una versión ya existente (que PyPI rechaza).
+    if: needs.release.outputs.tag_created == 'true'
+    runs-on: ubuntu-latest
+
+    # El environment debe coincidir con el configurado en el Trusted Publisher de PyPI.
+    environment:
+      name: pypi
+      url: https://pypi.org/p/android-gradle-analyzer
+
+    permissions:
+      id-token: write  # Obligatorio para Trusted Publishing (OIDC) — sin token ni password
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.10"
+
+      - name: Instalar dependencias de build
+        run: python -m pip install --upgrade pip build
+
+      - name: Construir paquete
+        run: python -m build
+
+      - name: Publicar en PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

android_gradle_analyzer-1.3.1/.gitignore

@@ -0,0 +1,63 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+ENV/
+env/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Output directories
+diagrams/
+external-calls/
+sanity/
+*.png
+*.pdf
+
+# Claude Code internal files
+.claude/
+
+# SVG generados (excluir diagrams de PlantUML pero no los assets del repo)
+*.svg
+!docs/*.svg
+
+# Logs
+*.log
+
+# PlantUML cache
+.plantuml
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Temporary files
+*.tmp
+*.bak

android_gradle_analyzer-1.3.1/CHANGELOG.md

@@ -0,0 +1,162 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [Unreleased]
+
+## [1.3.1] - 2026-06-06
+
+### Changed
+- **Distribución por PyPI**: la herramienta ahora se instala con `pipx install android-gradle-analyzer` (antes solo `git+https://...`). El install desde `git+` se mantiene documentado como vía de desarrollo
+- README y CONTRIBUTING actualizados: el flujo de desarrollo usa `pip install -e ".[kts,yaml]"` y el de release ya no crea el tag a mano (lo hace el CI)
+
+### Added
+- **Publicación automática a PyPI** vía Trusted Publishers (OIDC) en `release.yml`: el job `publish-pypi` sube el paquete sin tokens ni contraseñas, gateado a que el job `release` haya creado un tag nuevo (no publica en pushes sin bump de versión)
+
+### Removed
+- `setup.sh` y `requirements.txt`: `pyproject.toml` queda como fuente única de dependencias
+
+## [1.3.0] - 2026-06-06
+
+### Added
+- **Detector de "lógica compartida mal ubicada"** en `gradle-sanity`: identifica un módulo *hoja* (feature o app — `I` alto, en la punta del grafo de dependencias) del que sin embargo **otros módulos dependen** (`Ca` por encima del límite). Suele indicar código común atrapado en un feature en vez de estar en `core`/`shared`. Se basa solo en las métricas que el tool ya calcula (`I` y `Ca`) — **no depende de nombres de módulo ni de plugins**, y `core`/`common` quedan excluidos automáticamente por tener `I` bajo (su `Ca` alto es esperado)
+- **Advisory por default**: con `leaf_penalty`/`app_penalty` en `0` el detector solo aparece en el reporte y en el JSON (`coupling_issues`) sin afectar el score → cero regresión para proyectos existentes. Subir las penalizaciones activa el gate en CI
+- Nueva config `coupling_limits` (`leaf_instability`, `leaf_max_ca`, `leaf_penalty`, `app_max_ca`, `app_penalty`) — funciona sin `analyzer_config.json` usando los defaults internos
+- El punto de entrada (app) se detecta por el plugin `com.android.application` (única señal de plugin confiable; `com.android.library` no distingue rol). `coupling_overrides` permite forzar (`"app"`/`"leaf"`) o excluir (`"ignore"`) módulos puntuales cuando la métrica se equivoca
+- Nueva clase de test `TestLeafCoupling` y fixture `leaf_coupling`
+
+### Known limitations
+- La detección del plugin de app no resuelve `alias(libs.plugins.android.application)` (requiere leer el version catalog); solo el `id("com.android.application")` literal. El detector funciona igual sin esa señal — solo pierde el umbral más estricto del punto de entrada
+
+## [1.2.2] - 2026-05-27
+
+### Added
+- **Parser tree-sitter para `.gradle.kts`**: cuando `tree-sitter-kotlin` está instalado (`pip install "android-gradle-analyzer[kts]"`), los archivos KTS se parsean con un AST real en lugar de regex. Maneja correctamente: dependencias multilínea, comentarios de línea `//` y de bloque `/* */`, y parámetros nombrados `project(path = ":module")`. El fallback a regex es automático si la librería no está disponible
+- **Preprocesador Groovy** para archivos `.gradle`: antes de aplicar regex, se eliminan comentarios `//` y `/* */` y se colapsan declaraciones multilínea (e.g. `implementation(\n  project(":core")\n)`). Elimina falsos negativos por comentarios y falsos positivos desde dependencias comentadas
+- Nueva función `_strip_comments` (interna): limpia comentarios sin colapso de paréntesis — usada en el path KTS para los accessors `projects.*`
+- Nuevos fixtures de test: `kts_multiline`, `kts_commented`, `groovy_multiline`
+- Nuevas clases de test: `TestPreprocessGroovy` y `TestKtsTreeSitter` (se saltan automáticamente si `tree-sitter-kotlin` no está instalado)
+- Nueva dependencia opcional `kts`: `pip install "android-gradle-analyzer[kts]"` instala `tree-sitter>=0.22` y `tree-sitter-kotlin>=0.3`
+
+## [1.2.1] - 2026-05-26
+
+### Changed
+- `pyproject.toml`: `requires-python` actualizado de `>=3.8` a `>=3.10`. El código usa sintaxis PEP 604 (`str | None`, `list[str]`) que requiere Python 3.10 o superior. Antes el paquete se instalaba en 3.8/3.9 pero crashaba al primer import — ahora pip se niega antes con un mensaje claro
+- README: badge de Python actualizado a `3.10+` (antes mentía con `3.7+`)
+
+### Added
+- README: badges de **Tests** (estado del último workflow) y **Release** (última versión publicada) vía shields.io
+
+## [1.2.0] - 2026-05-26
+
+### Added
+- Soporte para **type-safe project accessors** (`projects.foo.barBaz`, Gradle 7+) en los 4 analizadores. El parser construye un mapa accessor → módulo a partir de `settings.gradle(.kts)` y resuelve referencias en Kotlin DSL (`implementation(projects.feature.paymentsCommon)`) y Groovy (`implementation projects.feature.paymentsCommon`). Análisis 100% estático, sin compilar
+- `module_to_accessor()` y `build_accessor_map()` expuestos en `analyzer_utils` para uso externo o testing
+- Detección de colisiones de accessor (raro en proyectos reales): si dos módulos mapean al mismo accessor, se emite un warning y gana el primero
+
+### Fixed
+- **Falsos positivos en `external_callers` y `gradle_analyzer`**: el matcher anterior usaba `endswith(':' + path)` bidireccional, lo que hacía que `project(":common")` matchera erróneamente cualquier submódulo `:foo:common`. Ahora el matcheo es exacto sobre el listado de módulos conocidos. Caso real afectado: cualquier proyecto con módulos raíz que comparten leaf-name con submódulos del target
+
+## [1.1.1] - 2026-05-26
+
+### Fixed
+- `generate_ascii`: usaba `module_set` (solo los módulos del scope analizado) como filtro de dependencias, mostrando "(sin dependencias internas)" cuando las deps apuntan a módulos del proyecto raíz fuera del subdirectorio. Ahora usa `known_modules`
+- `generate_report`: la sección "Módulos no utilizados por otros" se oculta cuando se analiza un subconjunto del proyecto (el Ca no puede calcularse sin analizar todos los módulos). En su lugar muestra una nota que apunta a "Llamadas externas"
+
+## [1.1.0] - 2026-05-26
+
+### Added
+- Auto-detección de raíz del proyecto: `find_project_root()` sube directorios desde el path analizado hasta encontrar `settings.gradle(.kts)`, permitiendo resolver dependencias `implementation(project(":..."))` a módulos fuera del subdirectorio analizado (ej. analizar `customer/` y ver dependencias a `view`, `mach-foundation:util`, etc.)
+- `known_modules` separado de `modules` en `GradleDependencyAnalyzer`: el registry completo del proyecto raíz se usa para el matching de dependencias, mientras `modules` sigue controlando qué módulos se analizan
+- Barra de progreso con porcentaje en el menú interactivo para proyectos con más de 10 módulos (`BarColumn` + `MofNCompleteColumn`); proyectos pequeños mantienen el spinner simple
+- `analyze_gradle_dependencies` acepta callback `on_progress(done, total)` para actualizar la UI; usa `as_completed` para progreso fluido conforme terminan los workers paralelos
+
+## [1.0.9] - 2026-05-25
+
+### Fixed
+- Mermaid: grafos grandes (>500 edges) fallaban silenciosamente por el límite default del parser. Se agrega header `%%{init}%%` con `maxEdges: 10000`, `maxTextSize: 200000`, `htmlLabels: true`, `curve: basis` y `wrappingWidth: 200`
+
+## [1.0.8] - 2026-05-25
+
+### Fixed
+- Mermaid: edge label `use` renombrado a `uses` — `use` es keyword reservado en Mermaid v11+ y causaba error de parsing
+- Mermaid: `base_path` resuelto con `.resolve()` para que el ID del subgraph no quede vacío al invocar el analyzer con ruta relativa (`.`)
+- Consola: `VERSION` en `menu/branding.py` desincronizado con `pyproject.toml` — ahora ambos se actualizan juntos en el bump
+
+## [1.0.7] - 2026-05-25
+
+### Fixed
+- `parse_settings_modules`: detección de módulos con sintaxis `include("modulo")` sin `:` inicial (común en proyectos Android Groovy DSL que adoptan convenciones tipo Kotlin). Antes devolvía 0 módulos silenciosamente. `includeBuild` ya no se cuenta como módulo del proyecto.
+
+## [1.0.6] - 2026-05-24
+
+### Added
+- Soporte para `analyzer.yml` en la raíz del proyecto analizado — configura defaults de CLI sin pasar flags manualmente
+
+## [1.0.5] - 2026-05-24
+
+### Fixed
+- Colones en nombres de archivo en Windows (`external_callers`) — módulos como `core:analytics:tracker` generaban `[Errno 22]`
+
+## [1.0.4] - 2026-05-24
+
+### Fixed
+- UnicodeEncodeError en Windows: todos los CLIs ahora fuerzan UTF-8 en stdout/stderr al arrancar (fix para terminales con encoding cp1252)
+
+## [1.0.3] - 2026-05-24
+
+### Fixed
+- Menú: al cancelar la selección de módulo focal ya no procede el análisis — vuelve correctamente al menú principal
+- Menú: selector de módulo focal muestra los nombres directamente en la lista (sin paso intermedio)
+
+## [1.0.2] - 2026-05-24
+
+### Added
+- Menú interactivo: formato DOT y ASCII disponibles en el selector de formato
+- Menú interactivo: prompt de zoom (`--focus`) en análisis de dependencias internas
+- Menú interactivo: ASCII se muestra inline en el panel del terminal
+- Menú interactivo: offer post-análisis para renderizar DOT a PNG/SVG con Graphviz local
+
+## [1.0.1] - 2026-05-24
+
+### Added
+- Graphviz DOT format (`--format dot` / `gradle-dot`) con colores por tipo de módulo
+- ASCII format (`--format ascii` / `gradle-ascii`) para visualización en terminal
+- `--focus <module[,module]>`: zoom al subgrafo de un módulo en todos los formatos
+- Entry points independientes `gradle-dot` y `gradle-ascii`
+- Parsing paralelo con `ThreadPoolExecutor` en los 3 analizadores (gradle-analyzer, gradle-externals, gradle-impact)
+
+### Fixed
+- Build files con nombre custom (ej. `chat.gradle.kts`) ahora se detectan correctamente — fix para proyectos como MEGA Android que no usan `build.gradle.kts` estándar
+
+## [1.0.0] - 2026-05-24
+
+### Added
+- `gradle-impact`: nuevo analizador de impacto de cambios — dado un módulo, muestra qué otros módulos se ven afectados (BFS sobre grafo invertido, niveles directos y transitivos)
+- `--quiet` en todos los CLIs para suprimir output de progreso (ideal para CI)
+- `--json` en todos los CLIs para salida estructurada a stdout
+- `--fail-on-cycle` en `gradle-sanity`: `exit 1` si se detecta algún ciclo (CI gate)
+- `--fail-on-score-below N` en `gradle-sanity`: `exit 1` si el score cae por debajo de N
+- Sección de módulos huérfanos en reporte de sanidad (Ca=0 y Ce=0, sin penalización)
+- Parsing de `settings.gradle.kts` / `settings.gradle` como fuente de verdad para módulos
+- HTML export con Mermaid embebido (renderizado inline via CDN)
+- `examples/github-actions-dependency-health.yml`: ejemplo de integración GitHub Actions
+- `scripts/bump_version.py`: script de versionado semántico
+- `CHANGELOG.md` con formato Keep a Changelog
+
+### Fixed
+- Falsos positivos en detección de versiones hardcodeadas: las versiones dentro de comentarios (`// "lib:x:1.2.3"`) ya no se reportan
+
+## [0.1.0] - 2026-05-24
+
+### Added
+- `gradle-analyzer`: análisis de dependencias internas con salida PlantUML, Mermaid y texto
+- `gradle-externals`: detección de callers externos a un módulo
+- `gradle-sanity`: métricas Ca/Ce/I, detección de ciclos, violaciones SDP y score 0–100
+- `gradle-analyzer-menu`: menú interactivo con Rich + questionary, historial y export
+- Export a HTML, Markdown, ZIP y PDF (opcional via weasyprint)
+- Configuración personalizable via `analyzer_config.json`
+- Detección automática de ciclos con DFS y coloreo de nodos
+- Soporte para Groovy DSL y Kotlin DSL (`build.gradle` y `build.gradle.kts`)
+- Scopes soportados: `implementation`, `api`, `kapt`, `compileOnly`, `testImplementation` y más

android_gradle_analyzer-1.3.1/CONTRIBUTING.md

@@ -0,0 +1,153 @@
+# Contribuyendo a Android Gradle Analyzer
+
+¡Gracias por tu interés en contribuir! 🎉
+
+## 🚀 Cómo Contribuir
+
+### Reportar Bugs
+
+1. Verifica que el bug no haya sido reportado antes
+2. Abre un [issue](https://github.com/pfranccino/android-gradle-analyzer/issues/new)
+3. Incluye:
+   - Descripción clara del problema
+   - Pasos para reproducirlo
+   - Comportamiento esperado vs actual
+   - Versión de Python
+   - Sistema operativo
+   - Ejemplo de archivo gradle (si es relevante)
+
+### Sugerir Mejoras
+
+1. Abre un issue con el tag `enhancement`
+2. Describe la funcionalidad que te gustaría ver
+3. Explica por qué sería útil
+4. Proporciona ejemplos de uso si es posible
+
+### Enviar Pull Requests
+
+1. **Fork** el repositorio
+2. **Crea una rama** desde `main`:
+   ```bash
+   git checkout -b feature/mi-nueva-funcionalidad
+   ```
+3. **Haz tus cambios**:
+   - Sigue el estilo de código existente
+   - Agrega comentarios donde sea necesario
+   - Actualiza documentación si es relevante
+4. **Prueba tus cambios**:
+   ```bash
+   python3 gradle_analyzer.py /ruta/test
+   python3 external_callers.py /ruta/test modulo
+   ```
+5. **Commit** con mensajes descriptivos:
+   ```bash
+   git commit -m "Agrega soporte para formato Groovy DSL"
+   ```
+6. **Push** a tu fork:
+   ```bash
+   git push origin feature/mi-nueva-funcionalidad
+   ```
+7. **Abre un Pull Request** con:
+   - Descripción clara de los cambios
+   - Referencias a issues relacionados
+   - Screenshots si aplica
+
+## 📝 Guía de Estilo
+
+### Python
+
+- Usa **4 espacios** para indentación
+- Nombres de funciones y variables en **snake_case**
+- Nombres de clases en **PascalCase**
+- Docstrings para funciones públicas
+- Líneas máximo 100 caracteres
+
+**Ejemplo:**
+
+```python
+def analyze_dependencies(self):
+    """
+    Analiza las dependencias desde los archivos gradle
+
+    Returns:
+        self para encadenamiento
+    """
+    for module in self.modules:
+        self._parse_gradle_file(module)
+    return self
+```
+
+### Commits
+
+Usa mensajes claros y en presente:
+
+✅ **Bueno:**
+
+- `Agrega soporte para Gradle Kotlin DSL`
+- `Corrige detección de dependencias anidadas`
+- `Mejora documentación de instalación`
+
+❌ **Malo:**
+
+- `Fix`
+- `Changes`
+- `Updated stuff`
+
+## 🧪 Testing
+
+Antes de enviar un PR, prueba con:
+
+1. **Proyecto simple** (pocos módulos)
+2. **Proyecto complejo** (muchos módulos anidados)
+3. **Diferentes formatos** de gradle:
+   - `build.gradle` (Groovy)
+   - `build.gradle.kts` (Kotlin DSL)
+
+## 🏷️ Proceso de release
+
+1. Actualiza el `CHANGELOG.md` bajo `[Unreleased]` con los cambios del release
+2. Ejecuta el script de bump:
+   ```bash
+   python scripts/bump_version.py 0.2.0
+   ```
+3. Revisa el diff generado en `pyproject.toml` y `menu/branding.py`
+4. Commitea y haz push a `main` — el workflow se encarga del resto:
+   ```bash
+   git add pyproject.toml menu/branding.py CHANGELOG.md
+   git commit -m "chore: bump version to v0.2.0"
+   git push
+   ```
+   El CI crea el tag `v0.2.0`, publica el GitHub Release y sube el paquete a PyPI
+   (vía Trusted Publisher / OIDC) automáticamente. **No crees el tag a mano:** si el
+   tag ya existe, el workflow lo detecta y se salta el release y el publish.
+
+## 💡 Ideas para Contribuir
+
+### Features Buscadas
+
+- [ ] Análisis de performance de build
+- [ ] Sugerencias de optimización automáticas
+- [ ] Comparación de grafos entre ramas
+
+### Mejoras de Documentación
+
+- [ ] Tutorial en video
+- [ ] Más ejemplos de uso
+- [ ] Traducción a otros idiomas
+- [ ] Guía de arquitectura modular
+- [ ] Comparación con otras herramientas
+
+## 🤔 ¿Preguntas?
+
+Si tienes dudas sobre cómo contribuir, abre un issue con el tag `question` o únete a las discusiones.
+
+## 📜 Código de Conducta
+
+- Se respetuoso y constructivo
+- Acepta críticas constructivas
+- Enfócate en lo mejor para el proyecto
+- Sé paciente con otros colaboradores
+
+---
+
+¡Gracias por hacer este proyecto mejor! 🙏