Catégories

Validateur de Nom de Branche Git

Valide les noms de branches Git selon les conventions de nommage Git

Validateur de Nom de Branche Git

Cet outil valide les noms de branches Git selon les conventions et meilleures pratiques de nommage Git.

Règles de Nommage des Branches Git:

  • Ne peut pas contenir : ~ ^ : espace tabulation nouvelle ligne ? * [ \
  • Ne peut pas commencer ou finir par /
  • Ne peut pas avoir de slashs consécutifs //
  • Ne peut pas finir par .lock
  • Ne peut pas contenir .. ou @{
  • Longueur maximale (généralement 255 caractères pour compatibilité système de fichiers)
  • Ne peut pas être un nom de branche réservé (HEAD, main, master)

Conventions Communes de Nommage:

  • feature/ - Nouvelles fonctionnalités
  • bugfix/ - Corrections de bugs
  • hotfix/ - Corrections urgentes de production
  • release/ - Préparation de version
  • develop/ - Branche de développement
  • test/ - Branches de test
  • docs/ - Mises à jour de documentation
  • refactor/ - Refactorisation de code

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 /)

Points clés

Catégorie
Development
Types d’entrée
text, checkbox, number
Type de sortie
json
Couverture des échantillons
4
API disponible
Yes

Vue d’ensemble

Le Validateur de Nom de Branche Git est un outil en ligne qui vérifie la conformité des noms de branches Git aux règles de nommage standard. Il permet de s'assurer que les noms respectent les conventions pour éviter les erreurs et maintenir un historique propre dans les projets de développement.

Quand l’utiliser

  • Lors de la création d'une nouvelle branche pour vérifier sa validité avant de commiter.
  • Pour imposer les conventions de nommage de l'équipe dans les projets collaboratifs.
  • Lors de la configuration de pipelines CI/CD pour valider automatiquement les noms de branches.

Comment ça marche

  • Entrez le nom de la branche Git dans le champ prévu.
  • Configurez les options telles que les préfixes autorisés ou les noms réservés si nécessaire.
  • L'outil analyse le nom et retourne un rapport de validation indiquant les erreurs ou la conformité.

Cas d’usage

Validation des noms de branches avant la création dans un dépôt Git.
Application automatique des conventions de nommage dans les hooks pre-commit.
Vérification des branches dans les pipelines de déploiement continu.

Exemples

1. Validation d'une branche de fonctionnalité

Développeur
Contexte
Un développeur travaille sur une nouvelle fonctionnalité et doit créer une branche.
Problème
S'assurer que le nom 'feature/user-auth' respecte les conventions Git.
Comment l’utiliser
Entrer 'feature/user-auth' dans le champ Nom de Branche et valider.
Résultat
Le nom est validé comme conforme, avec un message de succès indiquant le respect des conventions.

2. Détection d'un nom invalide avec slashs consécutifs

Contexte
Un chef de projet vérifie les noms de branches soumis par l'équipe.
Problème
Identifier les noms qui ne respectent pas les règles Git, comme les slashs consécutifs.
Comment l’utiliser
Entrer 'feature//double-slash' dans le champ et activer l'option 'Forcer la Convention de Nommage'.
Configuration d’exemple
enforceConvention: true
Résultat
L'outil signale une erreur due aux slashs consécutifs et suggère une correction.

Tester avec des échantillons

development

Hubs associés

FAQ

Quels caractères sont interdits dans un nom de branche Git ?

Les caractères interdits incluent ~ ^ : espace tabulation nouvelle ligne ? * [ \ et les slashs consécutifs //.

Puis-je utiliser des préfixes personnalisés ?

Oui, en activant l'option 'Autoriser Préfixes Personnalisés', vous pouvez définir vos propres préfixes.

Quelle est la longueur maximale recommandée ?

La longueur maximale est généralement de 255 caractères pour la compatibilité avec les systèmes de fichiers.

Comment gérer les noms de branches réservés ?

Vous pouvez spécifier une liste de noms réservés séparés par des virgules, comme HEAD, main, master.

L'outil peut-il être intégré dans des scripts ?

Oui, l'outil retourne des résultats au format JSON, ce qui facilite l'intégration dans des scripts automatisés.

Documentation de l'API

Point de terminaison de la requête

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

Paramètres de la requête

Nom du paramètre Type Requis Description
branchName text Oui -
allowCustomPrefixes checkbox Non Allow branch names without standard prefixes
enforceConvention checkbox Non Require branch names to follow naming conventions
reservedNames text Non Branch names that are reserved (comma-separated)
maxLength number Non Maximum length for branch names (filesystem compatibility)
allowedPrefixes text Non Valid branch name prefixes (comma-separated, end with /)

Format de réponse

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

Documentation de MCP

Ajoutez cet outil à votre configuration de serveur MCP:

{
  "mcpServers": {
    "elysiatools-git-branch-validator": {
      "name": "git-branch-validator",
      "description": "Valide les noms de branches Git selon les conventions de nommage Git",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=git-branch-validator",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Vous pouvez chaîner plusieurs outils, par ex.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 outils.

Si vous rencontrez des problèmes, veuillez nous contacter à [email protected]