# Cometa Git Tools
Una colección de herramientas Git para mejorar el flujo de trabajo de desarrollo, incluyendo un generador de mensajes de commit basado en AI y un generador/creador de Pull Requests.
## Características
- 🤖 **AI Conventional Commits**: Genera mensajes de commit siguiendo la convención de Conventional Commits usando Google Gemini AI
- 📝 **PR Manager**: Genera y crea Pull Requests automáticamente con resúmenes inteligentes
- 🎨 **Interfaz Amigable**: Interfaz de línea de comandos intuitiva y colorida
- 🔧 **Fácil Configuración**: Comando `cz-setup` para configurar todo automáticamente
## Instalación
### Usando pip
```bash
pip install cometa-git-tools
```
### Instalación desde el código fuente ss
```bash
git clone https://github.com/cometa/cometa-git-tools.git
cd cometa-git-tools
pip install -e .
```
### Configuración
1. Configura tu API key de Google Gemini:
```bash
export GEMINI_API_KEY='your-api-key'
```
2. (Opcional) Agrega la variable a tu archivo .bashrc o .zshrc para hacerla permanente:
```bash
echo 'export GEMINI_API_KEY="your-api-key"' >> ~/.zshrc # o ~/.bashrc
```
3. Configura Commitizen para usar el plugin AI:
```bash
# Configuración rápida (recomendado)
cz-setup
# Opciones avanzadas:
cz-setup --help # Ver todas las opciones disponibles
cz-setup --no-global # Solo configurar el proyecto actual
cz-setup --no-project # Solo configurar globalmente
```
### Archivos de Configuración
El comando `cz-setup` creará/modificará dos archivos:
1. **~/.commitizen/config.toml**: Configuración global de commitizen
2. **./pyproject.toml**: Configuración local del proyecto
## Uso
### Commitizen AI
Este plugin extiende Commitizen para generar mensajes de commit usando AI:
```bash
# Agrega tus cambios
git add .
# Genera un mensaje de commit con AI
cz commit
```
### PR Summary Generator
Herramienta completa para gestionar Pull Requests:
```bash
# Genera un resumen del PR actual para poder visualizarlo en el editor de texto
pr-summary generate
# Crea un nuevo PR con resumen automático
pr-summary create
# Crea un PR especificando la rama base
pr-summary create --base main
# Ver todas las opciones disponibles
pr-summary --help
```
La herramienta permite:
- 📝 Generar resúmenes detallados de los cambios
- ✨ Crear PRs directamente desde la línea de comandos
- 🔄 Especificar la rama base del PR
- 🤖 Generar títulos y descripciones usando AI
## Licencia
MIT License - ver [LICENSE](LICENSE) para más detalles.
## Contribuir
Las contribuciones son bienvenidas! Por favor, lee [CONTRIBUTING.md](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](https://github.com/cometa/cometa-git-tools/issues).
Raw data
{
"_id": null,
"home_page": "https://github.com/cometa/cometa-git-tools",
"name": "cometa-git-tools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "git commitizen pr-summary ai gemini conventional-commits",
"author": "Cometa",
"author_email": "enzo@cometa.com",
"download_url": "https://files.pythonhosted.org/packages/f5/91/fb2f22fd62535cd4525809fa129a7630bedb06a94a44e21f32f0a1badee4/cometa_git_tools-0.1.13.tar.gz",
"platform": null,
"description": "# Cometa Git Tools\n\nUna colecci\u00f3n de herramientas Git para mejorar el flujo de trabajo de desarrollo, incluyendo un generador de mensajes de commit basado en AI y un generador/creador de Pull Requests.\n\n## Caracter\u00edsticas\n\n- \ud83e\udd16 **AI Conventional Commits**: Genera mensajes de commit siguiendo la convenci\u00f3n de Conventional Commits usando Google Gemini AI\n- \ud83d\udcdd **PR Manager**: Genera y crea Pull Requests autom\u00e1ticamente con res\u00famenes inteligentes\n- \ud83c\udfa8 **Interfaz Amigable**: Interfaz de l\u00ednea de comandos intuitiva y colorida\n- \ud83d\udd27 **F\u00e1cil Configuraci\u00f3n**: Comando `cz-setup` para configurar todo autom\u00e1ticamente\n\n## Instalaci\u00f3n\n\n### Usando pip\n\n```bash\npip install cometa-git-tools\n```\n\n### Instalaci\u00f3n desde el c\u00f3digo fuente ss\n\n```bash\ngit clone https://github.com/cometa/cometa-git-tools.git\ncd cometa-git-tools\npip install -e .\n```\n\n### Configuraci\u00f3n\n\n1. Configura tu API key de Google Gemini:\n```bash\nexport GEMINI_API_KEY='your-api-key'\n```\n\n2. (Opcional) Agrega la variable a tu archivo .bashrc o .zshrc para hacerla permanente:\n```bash\necho 'export GEMINI_API_KEY=\"your-api-key\"' >> ~/.zshrc # o ~/.bashrc\n```\n\n3. Configura Commitizen para usar el plugin AI:\n```bash\n# Configuraci\u00f3n r\u00e1pida (recomendado)\ncz-setup\n\n# Opciones avanzadas:\ncz-setup --help # Ver todas las opciones disponibles\ncz-setup --no-global # Solo configurar el proyecto actual\ncz-setup --no-project # Solo configurar globalmente\n```\n\n### Archivos de Configuraci\u00f3n\n\nEl comando `cz-setup` crear\u00e1/modificar\u00e1 dos archivos:\n\n1. **~/.commitizen/config.toml**: Configuraci\u00f3n global de commitizen\n2. **./pyproject.toml**: Configuraci\u00f3n local del proyecto\n\n## Uso\n\n### Commitizen AI\n\nEste plugin extiende Commitizen para generar mensajes de commit usando AI:\n\n```bash\n# Agrega tus cambios\ngit add .\n\n# Genera un mensaje de commit con AI\ncz commit\n```\n\n### PR Summary Generator\n\nHerramienta completa para gestionar Pull Requests:\n\n```bash\n# Genera un resumen del PR actual para poder visualizarlo en el editor de texto\npr-summary generate\n\n# Crea un nuevo PR con resumen autom\u00e1tico\npr-summary create\n\n# Crea un PR especificando la rama base\npr-summary create --base main\n\n# Ver todas las opciones disponibles\npr-summary --help\n```\n\nLa herramienta permite:\n- \ud83d\udcdd Generar res\u00famenes detallados de los cambios\n- \u2728 Crear PRs directamente desde la l\u00ednea de comandos\n- \ud83d\udd04 Especificar la rama base del PR\n- \ud83e\udd16 Generar t\u00edtulos y descripciones usando AI\n\n## Licencia\n\nMIT License - ver [LICENSE](LICENSE) para m\u00e1s detalles.\n\n## Contribuir\n\nLas contribuciones son bienvenidas! Por favor, lee [CONTRIBUTING.md](CONTRIBUTING.md) para detalles sobre nuestro c\u00f3digo de conducta y el proceso para enviar pull requests.\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/cometa-git-tools/issues). \n",
"bugtrack_url": null,
"license": null,
"summary": "Git tools for Commitizen and PR Summary Generation using AI",
"version": "0.1.13",
"project_urls": {
"Bug Reports": "https://github.com/cometa/cometa-git-tools/issues",
"Homepage": "https://github.com/cometa/cometa-git-tools",
"Source": "https://github.com/cometa/cometa-git-tools"
},
"split_keywords": [
"git",
"commitizen",
"pr-summary",
"ai",
"gemini",
"conventional-commits"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3d56473437827686431d733a9513caac9ad7e633e85db9fb6cd04b02018fca5a",
"md5": "37e5a88e9c12abd8ff93bd1521147546",
"sha256": "426484106bb97165aa85ce8ee32b5b7e6a64560fb98a90f7d12f5bd271687299"
},
"downloads": -1,
"filename": "cometa_git_tools-0.1.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "37e5a88e9c12abd8ff93bd1521147546",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 13212,
"upload_time": "2025-02-08T20:45:37",
"upload_time_iso_8601": "2025-02-08T20:45:37.837285Z",
"url": "https://files.pythonhosted.org/packages/3d/56/473437827686431d733a9513caac9ad7e633e85db9fb6cd04b02018fca5a/cometa_git_tools-0.1.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f591fb2f22fd62535cd4525809fa129a7630bedb06a94a44e21f32f0a1badee4",
"md5": "71f9f1e795b82e0b1756e11bf16a7371",
"sha256": "ee81f629822f8d2e1fa05a4bc711ebc25b5db9b2689615d069de2ade228763c8"
},
"downloads": -1,
"filename": "cometa_git_tools-0.1.13.tar.gz",
"has_sig": false,
"md5_digest": "71f9f1e795b82e0b1756e11bf16a7371",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 14017,
"upload_time": "2025-02-08T20:45:39",
"upload_time_iso_8601": "2025-02-08T20:45:39.679631Z",
"url": "https://files.pythonhosted.org/packages/f5/91/fb2f22fd62535cd4525809fa129a7630bedb06a94a44e21f32f0a1badee4/cometa_git_tools-0.1.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-08 20:45:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cometa",
"github_project": "cometa-git-tools",
"github_not_found": true,
"lcname": "cometa-git-tools"
}