Categorías

Validador de Nombres de Rama Git

Valida nombres de ramas Git según las convenciones de nomenclatura de Git

Validador de Nombres de Rama Git

Esta herramienta valida nombres de ramas Git según las convenciones y mejores prácticas de nomenclatura de Git.

Reglas de Nomenclatura de Ramas Git:

  • No puede contener: ~ ^ : espacio tabulación nueva línea ? * [ \
  • No puede comenzar o terminar con /
  • No puede tener barras consecutivas //
  • No puede terminar con .lock
  • No puede contener .. o @{
  • Longitud máxima (típicamente 255 caracteres para compatibilidad de sistema de archivos)
  • No puede ser un nombre de rama reservado (HEAD, main, master)

Convenciones Comunes de Nomenclatura:

  • feature/ - Nuevas características
  • bugfix/ - Correcciones de errores
  • hotfix/ - Correcciones urgentes de producción
  • release/ - Preparación de lanzamiento
  • develop/ - Rama de desarrollo
  • test/ - Ramas de prueba
  • docs/ - Actualizaciones de documentación
  • refactor/ - Refactorización de código

Allow branch names without standard prefixes

Require branch names to follow naming conventions

Branch names that are reserved (comma-separated)

Maximum length for branch names (filesystem compatibility)

Valid branch name prefixes (comma-separated, end with /)

Datos clave

Categoría
Development
Tipos de entrada
text, checkbox, number
Tipo de salida
json
Cobertura de muestras
4
API disponible
Yes

Resumen

Esta herramienta valida nombres de ramas Git según las convenciones y reglas de nomenclatura de Git, ayudando a prevenir errores comunes y mantener un flujo de trabajo organizado en proyectos de desarrollo.

Cuándo usarlo

  • Antes de crear una nueva rama en un repositorio Git para asegurar que el nombre cumple con las reglas.
  • Cuando se necesita hacer cumplir convenciones de nomenclatura del equipo, como prefijos específicos para features o bugfixes.
  • Durante la configuración de hooks de pre-commit o pipelines de CI/CD para automatizar la validación de nombres de ramas.

Cómo funciona

  • Ingresa el nombre de la rama Git en el campo de texto proporcionado.
  • Configura opciones opcionales como permitir prefijos personalizados o forzar convenciones de nomenclatura.
  • La herramienta aplica automáticamente las reglas de Git, verificando caracteres prohibidos, longitud y nombres reservados.
  • Recibe un resultado en formato JSON que indica si el nombre es válido y detalla cualquier error encontrado.

Casos de uso

Validación automática de nombres de ramas en hooks de pre-commit para evitar errores antes de hacer commit.
Integración en pipelines de CI/CD para asegurar que las ramas cumplan con las convenciones antes de fusionar cambios.
Revisión de nombres de ramas en solicitudes de extracción (pull requests) para mantener consistencia en el repositorio.

Ejemplos

1. Validación de rama feature estándar

Desarrollador
Contexto
Un desarrollador está creando una rama para implementar una nueva función de autenticación en una aplicación.
Problema
Necesita confirmar que el nombre 'feature/autenticacion-usuario' cumple con las reglas de Git y las convenciones del equipo.
Cómo usarlo
Ingresa 'feature/autenticacion-usuario' en el campo 'Nombre de Rama' y deja las opciones predeterminadas.
Resultado
La herramienta valida que el nombre es correcto, sin caracteres prohibidos, y lo aprueba como válido.

2. Detección de nombre inválido con espacios

Contexto
Un nombre de rama como 'feature user auth' ha sido ingresado por error, conteniendo espacios.
Problema
El nombre no cumple con las reglas de Git, ya que los espacios no están permitidos en nombres de ramas.
Cómo usarlo
Ingresa 'feature user auth' en el campo 'Nombre de Rama' y activa la opción 'Forzar Convención de Nomenclatura'.
Configuración de ejemplo
{"enforceConvention": true}
Resultado
La herramienta muestra un error indicando que el nombre contiene espacios y no sigue el formato esperado, sugiriendo correcciones.

3. Validación con prefijos personalizados

Líder técnico
Contexto
Un equipo usa prefijos personalizados como 'dev/' para ramas de desarrollo, en lugar de los estándares.
Problema
Se necesita validar una rama 'dev/nueva-api' asegurando que se permitan prefijos no estándar.
Cómo usarlo
Ingresa 'dev/nueva-api' en el campo 'Nombre de Rama', activa 'Permitir Prefijos Personalizados' y configura 'Prefijos Permitidos' para incluir 'dev/'.
Configuración de ejemplo
{"allowCustomPrefixes": true, "allowedPrefixes": "dev/,feature/,bugfix/"}
Resultado
La herramienta acepta el nombre como válido, ya que cumple con los prefijos configurados y las reglas básicas de Git.

Probar con muestras

development

Hubs relacionados

Preguntas frecuentes

¿Qué caracteres no están permitidos en los nombres de ramas Git?

No se permiten caracteres como ~ ^ : espacios, tabulaciones, saltos de línea, ? * [ \, y no pueden comenzar o terminar con /.

¿Puedo usar nombres de rama sin los prefijos estándar como feature/ o bugfix/?

Sí, puedes activar la opción 'Permitir Prefijos Personalizados' para validar nombres sin restricciones de prefijo.

¿Cómo puedo definir nombres de rama reservados?

Ingresa los nombres reservados separados por comas en el campo 'Nombres de Rama Reservados', como HEAD, main, master.

¿Cuál es la longitud máxima recomendada para un nombre de rama?

La longitud máxima predeterminada es 255 caracteres para compatibilidad con sistemas de archivos, pero puedes ajustarla según sea necesario.

¿Esta herramienta valida convenciones de nomenclatura específicas del equipo?

Sí, al activar 'Forzar Convención de Nomenclatura' y configurar 'Prefijos Permitidos', puedes adaptar la validación a las reglas de tu equipo.

Documentación de la API

Punto final de la solicitud

POST /es/api/tools/git-branch-validator

Parámetros de la solicitud

Nombre del parámetro Tipo Requerido Descripción
branchName text -
allowCustomPrefixes checkbox No Allow branch names without standard prefixes
enforceConvention checkbox No Require branch names to follow naming conventions
reservedNames text No Branch names that are reserved (comma-separated)
maxLength number No Maximum length for branch names (filesystem compatibility)
allowedPrefixes text No Valid branch name prefixes (comma-separated, end with /)

Formato de respuesta

{
  "key": {...},
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Datos JSON: Datos JSON

Documentación de MCP

Agregue este herramienta a su configuración de servidor MCP:

{
  "mcpServers": {
    "elysiatools-git-branch-validator": {
      "name": "git-branch-validator",
      "description": "Valida nombres de ramas Git según las convenciones de nomenclatura de Git",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=git-branch-validator",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Puede encadenar múltiples herramientas, por ejemplo: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máximo 20 herramientas.

Si encuentra algún problema, por favor, póngase en contacto con nosotros en [email protected]