| Name | giji JSON |
| Version |
0.4.0
JSON |
| download |
| home_page | https://github.com/cometa/giji |
| Summary | Git tools for Commitizen and PR Summary Generation using AI |
| upload_time | 2025-03-18 22:14:14 |
| maintainer | None |
| docs_url | None |
| author | Cometa |
| requires_python | >=3.7 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Giji - Herramientas de Desarrollo
Colección de herramientas para optimizar el flujo de desarrollo:
- 🤖 Commits inteligentes con IA
- 📝 Generación de PRs con descripción automática
- 🎫 Integración con Jira
- 🔔 Integración con Slack
## Instalación
```bash
pip install giji
```
## Configuración
### Configurar Gemini (Requerido)
```bash
export GEMINI_API_KEY='your-api-key'
```
### Configurar Jira (Opcional)
```bash
export JIRA_SERVER_URL='https://your-domain.atlassian.net'
export JIRA_EMAIL='your.email@company.com'
export JIRA_TOKEN='your-api-token'
```
### Configurar Slack (Opcional)
Para recibir notificaciones en Slack, necesitas configurar un Incoming Webhook:
1. Ve a tu Slack workspace en el navegador
2. Haz click en el nombre del canal donde quieres recibir las notificaciones
3. En el menú del canal, selecciona "Configuración > Integraciones"
4. Click en "Añadir una aplicación"
5. Busca y selecciona "Incoming WebHooks"
6. Click en "Añadir a Slack"
7. Elige el canal y click en "Añadir integración"
8. Copia el Webhook URL y configúralo:
```bash
export SLACK_WEBHOOK_URL='https://hooks.slack.com/services/XXX/YYY/ZZZ'
```
Para verificar tu configuración:
```bash
giji config # Verificar toda la configuración
giji config -t slack # Verificar solo configuración de Slack
```
## Comandos
### Pull Requests
Crear un PR con descripción generada por IA:
```bash
# PR básico
giji pr -b main
# PR como borrador
giji pr -b main -d
# PR con ticket Jira
giji pr -b main -t SIS-123
# PR sin auto-commit
giji pr -b main -n
# PR con notificación a Slack
giji pr -b main -s
# PR con notificación a Slack y mensaje personalizado
giji pr -b main -s -m "Por favor revisar los cambios en el componente X"
# PR completo con todas las integraciones
giji pr -b main -s -m "Listo para review" -t SIS-123 -c -d
```
Opciones disponibles:
- `-b, --base`: Rama base (default: master)
- `-t, --ticket`: Número de ticket JIRA
- `-d, --draft`: Crear PR como borrador
- `-n, --no-commit`: No hacer commit automático
- `-c, --comment`: Agregar comentario en Jira
- `-s, --slack`: Enviar notificación a Slack
- `-m, --message`: Mensaje adicional para la notificación de Slack
### Slack
Enviar mensajes directamente a Slack:
```bash
# Mensaje simple
giji slack send "Hola equipo!"
# Mensaje con emojis
giji slack send "Deploy completado ✅"
# Mensaje con múltiples líneas
giji slack send "🚀 Nueva versión desplegada
• Feature 1
• Feature 2"
```
## Notificaciones de Slack
Las notificaciones de PR en Slack incluyen:
- URL del Pull Request
- Número de ticket Jira (con enlace directo)
- Mensaje personalizado (opcional)
Ejemplo de notificación:
```
🎉 *Nuevo Pull Request creado*
• *URL:* https://github.com/...
• *Ticket:* SIS-123 (enlace a Jira)
💬 *Mensaje:* Por favor revisar los cambios en el componente X
```
## Ejemplos y Ayuda
Ver ejemplos detallados:
```bash
giji examples
```
Ver ayuda de cualquier comando:
```bash
giji --help
giji pr --help
giji slack --help
```
## Requisitos
- Python 3.7+
- Git
- GitHub CLI (`gh`)
- API key de Gemini
- Credenciales de Jira (para funcionalidades de Jira)
## Licencia
MIT License - ver [LICENSE](LICENSE) para más detalles.
## Soporte
Si encuentras algún problema o tienes una sugerencia, por favor crea un issue en el [repositorio de GitHub](https://github.com/cometa/giji/issues).
Raw data
{
"_id": null,
"home_page": "https://github.com/cometa/giji",
"name": "giji",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "Cometa",
"author_email": "Cometa <apps@getcometa.com>",
"download_url": "https://files.pythonhosted.org/packages/31/39/39f78254aad2af15c46696731e5824f8a6b36df55d84b3ad0e710b35b611/giji-0.4.0.tar.gz",
"platform": null,
"description": "# Giji - Herramientas de Desarrollo\n\nColecci\u00f3n de herramientas para optimizar el flujo de desarrollo:\n- \ud83e\udd16 Commits inteligentes con IA\n- \ud83d\udcdd Generaci\u00f3n de PRs con descripci\u00f3n autom\u00e1tica\n- \ud83c\udfab Integraci\u00f3n con Jira\n- \ud83d\udd14 Integraci\u00f3n con Slack\n\n## Instalaci\u00f3n\n\n```bash\npip install giji\n```\n\n## Configuraci\u00f3n\n\n### Configurar Gemini (Requerido)\n```bash\nexport GEMINI_API_KEY='your-api-key'\n```\n\n### Configurar Jira (Opcional)\n```bash\nexport JIRA_SERVER_URL='https://your-domain.atlassian.net'\nexport JIRA_EMAIL='your.email@company.com'\nexport JIRA_TOKEN='your-api-token'\n```\n\n### Configurar Slack (Opcional)\nPara recibir notificaciones en Slack, necesitas configurar un Incoming Webhook:\n\n1. Ve a tu Slack workspace en el navegador\n2. Haz click en el nombre del canal donde quieres recibir las notificaciones\n3. En el men\u00fa del canal, selecciona \"Configuraci\u00f3n > Integraciones\"\n4. Click en \"A\u00f1adir una aplicaci\u00f3n\"\n5. Busca y selecciona \"Incoming WebHooks\"\n6. Click en \"A\u00f1adir a Slack\"\n7. Elige el canal y click en \"A\u00f1adir integraci\u00f3n\"\n8. Copia el Webhook URL y config\u00faralo:\n```bash\nexport SLACK_WEBHOOK_URL='https://hooks.slack.com/services/XXX/YYY/ZZZ'\n```\n\nPara verificar tu configuraci\u00f3n:\n```bash\ngiji config # Verificar toda la configuraci\u00f3n\ngiji config -t slack # Verificar solo configuraci\u00f3n de Slack\n```\n\n## Comandos\n\n### Pull Requests\n\nCrear un PR con descripci\u00f3n generada por IA:\n```bash\n# PR b\u00e1sico\ngiji pr -b main\n\n# PR como borrador\ngiji pr -b main -d\n\n# PR con ticket Jira\ngiji pr -b main -t SIS-123\n\n# PR sin auto-commit\ngiji pr -b main -n\n\n# PR con notificaci\u00f3n a Slack\ngiji pr -b main -s\n\n# PR con notificaci\u00f3n a Slack y mensaje personalizado\ngiji pr -b main -s -m \"Por favor revisar los cambios en el componente X\"\n\n# PR completo con todas las integraciones\ngiji pr -b main -s -m \"Listo para review\" -t SIS-123 -c -d\n```\n\nOpciones disponibles:\n- `-b, --base`: Rama base (default: master)\n- `-t, --ticket`: N\u00famero de ticket JIRA\n- `-d, --draft`: Crear PR como borrador\n- `-n, --no-commit`: No hacer commit autom\u00e1tico\n- `-c, --comment`: Agregar comentario en Jira\n- `-s, --slack`: Enviar notificaci\u00f3n a Slack\n- `-m, --message`: Mensaje adicional para la notificaci\u00f3n de Slack\n\n### Slack\n\nEnviar mensajes directamente a Slack:\n```bash\n# Mensaje simple\ngiji slack send \"Hola equipo!\"\n\n# Mensaje con emojis\ngiji slack send \"Deploy completado \u2705\"\n\n# Mensaje con m\u00faltiples l\u00edneas\ngiji slack send \"\ud83d\ude80 Nueva versi\u00f3n desplegada\n\u2022 Feature 1\n\u2022 Feature 2\"\n```\n\n## Notificaciones de Slack\n\nLas notificaciones de PR en Slack incluyen:\n- URL del Pull Request\n- N\u00famero de ticket Jira (con enlace directo)\n- Mensaje personalizado (opcional)\n\nEjemplo de notificaci\u00f3n:\n```\n\ud83c\udf89 *Nuevo Pull Request creado*\n\u2022 *URL:* https://github.com/...\n\u2022 *Ticket:* SIS-123 (enlace a Jira)\n\ud83d\udcac *Mensaje:* Por favor revisar los cambios en el componente X\n```\n\n## Ejemplos y Ayuda\n\nVer ejemplos detallados:\n```bash\ngiji examples\n```\n\nVer ayuda de cualquier comando:\n```bash\ngiji --help\ngiji pr --help\ngiji slack --help\n```\n\n## Requisitos\n\n- Python 3.7+\n- Git\n- GitHub CLI (`gh`)\n- API key de Gemini\n- Credenciales de Jira (para funcionalidades de Jira)\n\n## Licencia\n\nMIT License - ver [LICENSE](LICENSE) para m\u00e1s detalles.\n\n\n## Soporte\n\nSi encuentras alg\u00fan problema o tienes una sugerencia, por favor crea un issue en el [repositorio de GitHub](https://github.com/cometa/giji/issues).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Git tools for Commitizen and PR Summary Generation using AI",
"version": "0.4.0",
"project_urls": {
"Bug Tracker": "https://github.com/cometa/giji/issues",
"Homepage": "https://github.com/cometa/giji"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "54679daa73a07f4e50c1548cfb715d8b79b191c980fd929adeca2e124f347518",
"md5": "34a71aa5c1f58c5b5416df9202438d4f",
"sha256": "300c670b31be19e6928e29541459f5fcac2d39f54567ed7b9a61d120a3e21be6"
},
"downloads": -1,
"filename": "giji-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "34a71aa5c1f58c5b5416df9202438d4f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 41037,
"upload_time": "2025-03-18T22:14:13",
"upload_time_iso_8601": "2025-03-18T22:14:13.586472Z",
"url": "https://files.pythonhosted.org/packages/54/67/9daa73a07f4e50c1548cfb715d8b79b191c980fd929adeca2e124f347518/giji-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "313939f78254aad2af15c46696731e5824f8a6b36df55d84b3ad0e710b35b611",
"md5": "7489091202e960ee9cdc3ef9a6d85536",
"sha256": "df3a78609c7e36b764f22bb8d84f07ffc08fae33bab21c71265df16a4db9828a"
},
"downloads": -1,
"filename": "giji-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "7489091202e960ee9cdc3ef9a6d85536",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 34430,
"upload_time": "2025-03-18T22:14:14",
"upload_time_iso_8601": "2025-03-18T22:14:14.489815Z",
"url": "https://files.pythonhosted.org/packages/31/39/39f78254aad2af15c46696731e5824f8a6b36df55d84b3ad0e710b35b611/giji-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-03-18 22:14:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cometa",
"github_project": "giji",
"github_not_found": true,
"lcname": "giji"
}
