Créez un slug URL depuis le nom d’une branche Git

La capacité reconnaît le premier segment du chemin comme type de branche, garde toute la suite comme partie descriptive et la normalise en mots minuscules séparés par des tirets. Son fonctionnement est déterministe, sans accès réseau, et signale clairement toute branche qui possède un préfixe mais aucune description exploitable.

Distinguez les métadonnées du flux de la description utile

Les équipes Git commencent souvent leurs noms de branche par un type de flux tel que feature, fix, chore, release ou docs. Ce premier segment aide les personnes et les automatismes à comprendre l’objectif de la branche, mais il encombre généralement une URL publique. Cette capacité considère le texte précédant la première barre oblique comme le préfixe de type et construit le slug uniquement à partir de la suite. Ainsi, feature/add-user-login devient add-user-login, tandis que fix/checkout/payment-timeout produit checkout-payment-timeout. Les chemins descriptifs imbriqués sont conservés sous forme de mots, ce qui permet à votre équipe de garder des périmètres pertinents sans afficher de barres obliques dans l’URL finale. Le préfixe facultatif refs/heads/, souvent renvoyé par les outils Git et les systèmes d’intégration continue, est supprimé avant l’analyse. L’opération ne dépend d’aucune liste fermée de types autorisés. Tout premier segment non vide peut servir de préfixe, afin que la même règle s’adapte à vos conventions comme spike, experiment, maintenance ou au circuit de tickets propre à votre organisation.

Comprenez précisément la normalisation du slug

Après avoir isolé la partie descriptive, l’algorithme applique une suite stable de transformations. Il retire les espaces périphériques, normalise les caractères latins accentués, passe les lettres en minuscules, remplace chaque série de caractères autres que des lettres ASCII ou des chiffres par un tiret, puis supprime les tirets initiaux et finaux. Barres obliques, espaces, tirets bas, ponctuation et séparateurs répétés convergent ainsi vers une même forme sûre pour une URL. Une branche telle que feature/Account Settings_v2 devient account-settings-v2. Le résultat reste volontairement prévisible : aucun modèle linguistique, dictionnaire, appel réseau, nombre aléatoire, horodatage ou état de dépôt n’intervient. La fonction n’invente pas de mots et n’interprète pas les identifiants de tickets. Les nombres présents dans la description sont conservés, notamment dans fix/PROJ-482-login-loop. Comme la normalisation peut éliminer certains symboles et systèmes d’écriture, la capacité vérifie qu’il subsiste au moins une lettre ou un chiffre utilisable. Une description composée uniquement de signes ou de caractères incompatibles avec le slug ASCII accepté entraîne une erreur de saisie, jamais un résultat vide silencieux.

Exploitez le résultat sans risque dans vos automatisations

L’objet renvoyé contient un seul champ, slug. Vous pouvez donc l’envoyer directement vers un aperçu de documentation, l’URL d’un environnement éphémère, un chemin de notes de version, une page de journal des modifications ou un flux de publication de pull request. Vérifiez le résultat avant de réserver une route si votre destination impose des règles supplémentaires, par exemple une longueur maximale, des chemins protégés ou une contrainte d’unicité. Cette capacité ne consulte ni votre routeur, ni votre hébergeur, ni votre service Git, ni votre base de contenu : elle ignore donc si le slug est déjà pris. Elle ne confirme pas non plus que la chaîne fournie correspond à une branche réelle du dépôt ; seule la convention documentée est appliquée. Les noms sans barre oblique, ceux qui s’arrêtent juste après le préfixe et les descriptions normalisées en slug vide sont refusés. Cette erreur stricte empêche une source mal formée de publier accidentellement vers une route vide ou générique. Pour une automatisation par API, chaque requête applique le prix de base publié de $0.002. La même transformation déterministe fonctionne dans le navigateur pour les conversions ponctuelles.