Skip to main content

GitEz 🚀

tests License: MIT Python 3.10+

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


⚡ 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

pipx install git-ez

Si el paquete aún no aparece en PyPI, instala directo desde el repositorio:

pipx install git+https://github.com/AAMoralesC/GitEz.git

Con pip convencional:

pip install git+https://github.com/AAMoralesC/GitEz.git

Desarrollo local

git clone https://github.com/AAMoralesC/GitEz.git
cd GitEz
pip install -e .
python -m unittest discover -s tests

Actualización

pipx upgrade git-ez

💻 Uso

  1. Agrega tus cambios al staging como siempre:

    git add .
    
  2. Ejecuta GitEz:

    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 · Questionary · Rich


🤝 Contribuciones

Issues y PRs son bienvenidos. Para cambios grandes, abre primero un issue.

git checkout -b feature/mi-aporte
# ...cambios y tests...
git ez   # 😉

📄 Licencia

MIT — ver LICENSE.

Metadata

Release files for git-ez 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for git-ez 1.0.0
File Size Uploaded Provenance Actions
git_ez-1.0.0.tar.gz 33.8 kB Without provenance Details for git_ez-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for git-ez 1.0.0
File Interpreter ABI Platform Actions
git_ez-1.0.0-py3-none-any.whl Python 3 none any Details for git_ez-1.0.0-py3-none-any.whl

Total release size: 40.8 kB

Release files / git_ez-1.0.0.tar.gz

Download URL git_ez-1.0.0.tar.gz
Size 33.8 kB
Tags Source
SHA-256 checksum
How to use checksums
ffc525479c1f5c74eae6fb31e16c04a193e4b35098cd781c216d4243c7cee79e
BLAKE2b-256 checksum
How to use checksums
a456bbf76ea98b960b1afe9a140d45e61ab397c58baf0e36ea3b9f5690cd5a49
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.9

Release files / git_ez-1.0.0-py3-none-any.whl

Download URL git_ez-1.0.0-py3-none-any.whl
Size 7.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
94305a39964e2f909e12d6c967baee9dc4586d5d69277d0be4fc92e46fa1b0e7
BLAKE2b-256 checksum
How to use checksums
e39ba0e5c559c6575866ba3a107a406dc291a91ec6d9a71ddef34f48dfcccc79
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.9

Security for git-ez 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page