git-ez 1.0.0__py3-none-any.whl

git_ez/__init__.py

@@ -0,0 +1,4 @@
+from .main import app
+
+__version__ = "1.0.0"
+__all__ = ["app", "__version__"]

git_ez/__main__.py

@@ -0,0 +1,4 @@
+from .main import app
+
+if __name__ == "__main__":
+    app()

git_ez/main.py

@@ -0,0 +1,125 @@
+import subprocess
+import re
+import sys
+import typer
+import questionary
+from rich import print
+
+app = typer.Typer(help="CLI para generar commits inteligentes y rápidos.")
+
+
+@app.callback(invoke_without_command=True)
+def main(ctx: typer.Context):
+    """Ejecuta `commit` cuando no se indica subcomando (`git ez`)."""
+    if ctx.invoked_subcommand is None:
+        commit()
+
+
+def get_git_branch() -> str:
+    """Obtiene el nombre de la rama Git actual."""
+    try:
+        result = subprocess.run(
+            ["git", "rev-parse", "--abbrev-ref", "HEAD"],
+            capture_output=True, text=True, check=True
+        )
+        return result.stdout.strip()
+    except subprocess.CalledProcessError:
+        return ""
+
+def get_staged_files() -> list[str]:
+    """Obtiene la lista de archivos actualmente en staging."""
+    try:
+        result = subprocess.run(
+            ["git", "diff", "--cached", "--name-only"],
+            capture_output=True, text=True, check=True
+        )
+        files = [f for f in result.stdout.strip().split("\n") if f]
+        return files
+    except subprocess.CalledProcessError:
+        return []
+
+def extract_ticket_from_branch(branch_name: str) -> str:
+    """Extrae un ID de ticket (ej. ABC-123 o MELI-88) del nombre de la rama."""
+    match = re.search(r"([A-Za-z]+-\d+)", branch_name)
+    return match.group(1).upper() if match else ""
+
+def generate_suggestions(files: list[str], ticket: str) -> list[str]:
+    """Genera opciones de mensajes basados en los archivos en staging."""
+    if not files:
+        return []
+
+    ticket_prefix = f"[{ticket}] " if ticket else ""
+    
+    # Analizamos extensiones de archivos para inferir el 'scope'
+    has_docs = any(f.endswith(".md") or "docs/" in f for f in files)
+    has_tests = any("test" in f or "spec" in f for f in files)
+    has_config = any(f in ["package.json", "requirements.txt", "Dockerfile", "pyproject.toml"] for f in files)
+
+    suggestions = []
+
+    if has_docs and len(files) == 1:
+        suggestions.append(f"docs: {ticket_prefix}actualizar documentación ({files[0]})")
+    
+    if has_tests:
+        suggestions.append(f"test: {ticket_prefix}agregar o actualizar pruebas unitarias")
+        
+    if has_config:
+        suggestions.append(f"chore: {ticket_prefix}actualizar dependencias y configuración del proyecto")
+
+    # Opción genérica basada en la cantidad de archivos
+    file_summary = ", ".join([f.split("/")[-1] for f in files[:2]])
+    if len(files) > 2:
+        file_summary += f" y {len(files) - 2} más"
+
+    suggestions.append(f"feat: {ticket_prefix}actualizar {file_summary}")
+    suggestions.append(f"fix: {ticket_prefix}resolver problema en {file_summary}")
+
+    return suggestions
+
+@app.command()
+def commit():
+    """Analiza staging y abre el menú para hacer commit."""
+    staged_files = get_staged_files()
+
+    if not staged_files:
+        print("[bold yellow]⚠️  No hay archivos en staging.[/bold yellow] Usa [bold cyan]git add[/bold cyan] primero.")
+        raise typer.Exit()
+
+    branch = get_git_branch()
+    ticket = extract_ticket_from_branch(branch)
+    suggestions = generate_suggestions(staged_files, ticket)
+    
+    # Opción para escribir algo personalizado
+    CUSTOM_OPTION = "✏️  Escribir un mensaje personalizado..."
+    choices = suggestions + [CUSTOM_OPTION]
+
+    print(f"[bold green]✓[/bold green] {len(staged_files)} archivo(s) detectado(s) en staging.")
+    if ticket:
+        print(f"[bold blue]ℹ[/bold blue] Ticket detectado en la rama: [bold]{ticket}[/bold]\n")
+
+    # Interfaz interactiva en la terminal
+    selected_message = questionary.select(
+        "Selecciona el mensaje para tu commit:",
+        choices=choices
+    ).ask()
+
+    if not selected_message:
+        print("[yellow]Operación cancelada.[/yellow]")
+        raise typer.Exit(code=1)
+
+    if selected_message == CUSTOM_OPTION:
+        selected_message = questionary.text("Escribe tu mensaje de commit:").ask()
+        if not selected_message:
+            print("[red]El mensaje no puede estar vacío.[/red]")
+            raise typer.Exit(code=1)
+
+    # Ejecutar el commit
+    try:
+        subprocess.run(["git", "commit", "-m", selected_message], check=True)
+        print(f"\n[bold green]🚀 Commit realizado con éxito:[/bold green] \"{selected_message}\"")
+    except subprocess.CalledProcessError:
+        print("\n[bold red]❌ Error al ejecutar git commit.[/bold red]")
+        raise typer.Exit(code=1)
+
+if __name__ == "__main__":
+    app()

git_ez-1.0.0.dist-info/METADATA

@@ -0,0 +1,188 @@
+Metadata-Version: 2.5
+Name: git-ez
+Version: 1.0.0
+Summary: Generador interactivo y local de mensajes de commit bajo Conventional Commits, en español.
+Project-URL: Homepage, https://github.com/AAMoralesC/GitEz
+Project-URL: Repository, https://github.com/AAMoralesC/GitEz
+Project-URL: Issues, https://github.com/AAMoralesC/GitEz/issues
+Author-email: Andrés Morales <andresdremc@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Andrés Morales C
+        
+        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.
+License-File: LICENSE
+Keywords: cli,commit,conventional-commits,git,typer
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Spanish
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Description-Content-Type: text/markdown
+
+# GitEz 🚀
+
+[![tests](https://github.com/AAMoralesC/GitEz/actions/workflows/tests.yml/badge.svg)](https://github.com/AAMoralesC/GitEz/actions/workflows/tests.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+
+> **Generador interactivo, ultrarrápido y local de mensajes de commit — en español.**
+
+`GitEz` analiza los archivos que agregaste a *staging* (`git add .`) y te sugiere mensajes
+estandarizados bajo **Conventional Commits**, redactados en español. Se ejecuta en milisegundos,
+funciona 100% offline y no requiere API keys.
+
+---
+
+## 📸 Demo
+
+![Demo de GitEz en acción](./gitez_demo.png)
+
+---
+
+## ⚡ Características
+
+- 🚀 **Ultra rápido:** sin llamadas a servicios externos ni LLMs de pago.
+- 🔒 **100% privado:** todo el análisis ocurre en tu máquina.
+- 🇪🇸 **Mensajes en español:** nativo, no traducciones automáticas.
+- 🎯 **Sugerencias por contexto:** infiere el tipo de commit (`feat`, `fix`, `docs`, `test`, `chore`) según extensiones, documentación, tests y configuración.
+- 🏷️ **Integración con tickets:** detecta el ID en el nombre de la rama (`feature/PROJ-42-login` → `PROJ-42`).
+- ⌨️ **TUI fluida:** flechas y `Enter`, o escribe tu propio mensaje.
+
+---
+
+## 🧠 Sin IA, a propósito
+
+GitEz no usa LLMs y es una decisión de diseño, no una limitación:
+
+- **Privacidad:** tu código y tus nombres de archivo no salen de tu máquina.
+- **Velocidad:** responde al instante, sin red ni latencia de modelo.
+- **Determinismo:** el mismo staging produce la misma sugerencia, siempre.
+
+Para un commit message el contexto útil son las rutas y extensiones de archivo, así que un LLM
+añade costo, latencia y una dependencia externa sin mejorar el resultado.
+
+---
+
+## 📦 Instalación
+
+```bash
+pipx install git-ez
+```
+
+Si el paquete aún no aparece en PyPI, instala directo desde el repositorio:
+
+```bash
+pipx install git+https://github.com/AAMoralesC/GitEz.git
+```
+
+Con `pip` convencional:
+
+```bash
+pip install git+https://github.com/AAMoralesC/GitEz.git
+```
+
+### Desarrollo local
+
+```bash
+git clone https://github.com/AAMoralesC/GitEz.git
+cd GitEz
+pip install -e .
+python -m unittest discover -s tests
+```
+
+### Actualización
+
+```bash
+pipx upgrade git-ez
+```
+
+---
+
+## 💻 Uso
+
+1. Agrega tus cambios al staging como siempre:
+
+   ```bash
+   git add .
+   ```
+
+2. Ejecuta GitEz:
+
+   ```bash
+   git ez
+   ```
+
+   También funciona como `git-ez`, como `git ez commit`, o como `python -m git_ez`.
+
+3. Navega con `↑`/`↓`, elige una sugerencia o escribe tu propio mensaje, y presiona `Enter`.
+   El commit se ejecuta solo.
+
+Ejemplo de mensajes generados:
+
+| Tipo | Ejemplo |
+|------|---------|
+| `feat` | `feat: actualizar main.py, utils.py` |
+| `fix` | `fix: resolver problema en auth.py` |
+| `docs` | `docs: actualizar documentación (README.md)` |
+| `test` | `test: agregar o actualizar pruebas unitarias` |
+| `chore` | `chore: actualizar dependencias y configuración del proyecto` |
+
+Con ticket en la rama (`feature/PROJ-42-login`):
+
+```
+feat: [PROJ-42] actualizar main.py, utils.py
+```
+
+**Requisitos:** Python 3.10+ y Git en el `PATH`. Probado en 3.10, 3.12 y 3.13.
+
+---
+
+## 🛠️ Stack
+
+Python · [Typer](https://typer.tiangolo.com/) · [Questionary](https://questionary.readthedocs.io/) · [Rich](https://rich.readthedocs.io/)
+
+---
+
+## 🤝 Contribuciones
+
+Issues y PRs son bienvenidos. Para cambios grandes, abre primero un issue.
+
+```bash
+git checkout -b feature/mi-aporte
+# ...cambios y tests...
+git ez   # 😉
+```
+
+---
+
+## 📄 Licencia
+
+MIT — ver [LICENSE](./LICENSE).

git_ez-1.0.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+git_ez/__init__.py,sha256=_AFgLphmHn1D_dXA0FYDOTqUh2rHLlm1LjiRw_YO3-A,78
+git_ez/__main__.py,sha256=RCZmmoCNOWC7rAfIDm_LaymsybXIzE6McYbUEEkf9P8,60
+git_ez/main.py,sha256=2Oou49fTbazOM9NXNjYXT7fHUZFecXYy5Ir1kDhzmH4,4480
+git_ez-1.0.0.dist-info/METADATA,sha256=DOUfL7V4iMgYq-5-ELoh0irGVJQg_am0cb8C6a5UNyo,6134
+git_ez-1.0.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+git_ez-1.0.0.dist-info/entry_points.txt,sha256=DdS_7kutyKDV7ULUIz8h6heV_o4GN_Ch6gtCRsOYI-4,43
+git_ez-1.0.0.dist-info/licenses/LICENSE,sha256=xrmhxLSpS2jRaNaPlbJBulMlaex6trzAUMKIE7Mw450,1074
+git_ez-1.0.0.dist-info/RECORD,,

git_ez-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

git_ez-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+git-ez = git_ez.main:app

git_ez-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrés Morales C
+
+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.