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
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
developmentHubs 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.