giji 0.1.19

Git tools for Commitizen and PR Summary Generation using AI

Giji

Herramientas Git potenciadas por IA para optimizar tu flujo de trabajo de desarrollo. Crea commits inteligentes y pull requests con descripciones generadas por IA, con integración completa con Jira.

Características

• 🤖 Commits Inteligentes: Genera automáticamente mensajes de commit convencionales usando IA
• 📝 Pull Requests con IA: Crea PRs con descripciones generadas por IA
• 🎫 Integración con Jira: Gestión completa de tickets y comentarios automáticos
• 🚀 Interfaz Simple: Comandos CLI fáciles de usar
• ⚡️ Flujo Rápido: Automatiza tareas repetitivas de git

Instalación

pip install giji

Uso

Commits Inteligentes

Crea commits con mensajes convencionales generados por IA:

# Hacer commit de todos los cambios con mensajes inteligentes
giji commit

Pull Requests

Crea pull requests con descripciones generadas por IA:

# Crear un PR (auto-commit por defecto)
giji pr --base main

# Crear un PR sin auto-commit
giji pr --base main --no-commit

# Crear un PR borrador con ticket JIRA
giji pr --base main --draft --ticket SIS-123

# Crear PR y agregar comentario en Jira
giji pr --base main --comment

Integración con Jira

Gestiona tickets y mantén la documentación sincronizada:

# Ver descripción de un ticket
giji jira describe SIS-123

# Agregar comentario manual
giji jira comment SIS-123 "Actualizando estado..."

# Analizar PR y comentar automáticamente
giji jira analyze-pr --base main

# Buscar tickets
giji jira search "texto a buscar"

Opciones

Comando PR

• --base, -b: Rama base (ej: main, develop) [default: master]
• --ticket, -t: Número de ticket JIRA (ej: SIS-290)
• --draft, -d: Crear PR como borrador
• --no-commit, -n: Omitir auto-commit de cambios
• --comment, -c: Agregar comentario en Jira automáticamente

Comando Jira

• describe: Ver descripción de un ticket
• comment: Agregar comentario manual
• analyze-pr: Analizar PR y comentar automáticamente
• search: Buscar tickets
• config: Configurar conexión con Jira

Requisitos

• Python 3.7+
• Git
• GitHub CLI (gh)
• API key de Gemini
• Credenciales de Jira (para funcionalidades de Jira)

Configuración del Entorno

1. Obtén una API key de Gemini en Google AI Studio
2. Configura las variables de entorno:

# Configuración de Gemini
export GEMINI_API_KEY='your-api-key'

# Configuración de Jira (opcional, solo para funcionalidades de Jira)
export JIRA_SERVER_URL='https://your-domain.atlassian.net'
export JIRA_EMAIL='[e-mail]'
export JIRA_TOKEN='your-api-token'

Para obtener tu token de Jira:

1. Ve a Atlassian API Tokens
2. Crea un nuevo token
3. Copia el token y configúralo como JIRA_TOKEN

Licencia

MIT License - ver LICENSE para más detalles.

Contribuir

Las contribuciones son bienvenidas! Por favor, lee CONTRIBUTING.md para detalles sobre nuestro código de conducta y el proceso para enviar pull requests.

Soporte

Si encuentras algún problema o tienes una sugerencia, por favor crea un issue en el repositorio de GitHub.

Desarrollo

Construcción y Publicación

1. Actualizar la versión en src/cz_ai_conventional/version.py:

VERSION = "x.y.z"  # Incrementar según cambios

2. Construir el paquete:

# Instalar dependencias de desarrollo
pip install build twine

# Construir distribución
python -m build

3. Publicar en PyPI:

# Configurar .pypirc con credenciales
python -m twine upload --config-file .pypirc dist/*

También puedes usar el Makefile incluido:

# Construir y publicar
make build

# Solo actualizar versión existente
make update

Flujo de Desarrollo

1. Crear rama incluyendo el número de ticket JIRA

   El número de ticket se extraerá automáticamente de la rama. Formatos soportados:

   SIS-123                    ✓
   SIS-123/mi-feature        ✓
   feature/SIS-123           ✓
   fix/SIS-123-bug-fix       ✓
   feature/SIS-123/new-feat  ✓
   

2. Realizar cambios y usar los comandos:

# Commit de cambios
giji commit

# Crear PR con comentario en Jira
giji pr --base main --comment