cometa-git-tools


Namecometa-git-tools JSON
Version 0.1.13 PyPI version JSON
download
home_pagehttps://github.com/cometa/cometa-git-tools
SummaryGit tools for Commitizen and PR Summary Generation using AI
upload_time2025-02-08 20:45:39
maintainerNone
docs_urlNone
authorCometa
requires_python>=3.7
licenseNone
keywords git commitizen pr-summary ai gemini conventional-commits
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 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"
}
        
Elapsed time: 0.58597s