Validateur CODEOWNERS

Vérifiez un fichier CODEOWNERS pour les modèles invalides, les propriétaires manquants et les règles qui ne peuvent jamais prendre effet.

Entrée

Chemins à vérifier (un par ligne)

PlateformeSignaler les chemins sans propriétaireTrier les résultats par ordre de règleAfficher le nombre de règles par propriétaire

Sortie

Validateur CODEOWNERS

Collez le contenu d'un fichier CODEOWNERS et cet outil le vérifie ligne par ligne, comme le ferait un relecteur. Il signale les modèles qui ne peuvent pas être analysés, les noms d'utilisateur et les équipes mal écrits, les adresses e-mail malformées, et les règles qui silencieusement se dupliquent ou se masquent l'une l'autre — y compris une règle enterrée au-dessus d'un modèle générique ultérieur qui a silencieusement repris chaque chemin qu'elle possédait autrefois.

Choisissez la plateforme utilisée par votre référentiel — GitHub, GitLab ou Bitbucket — car les en-têtes de section facultatifs de GitLab ("[Frontend]") ne sont pas reconnus sur les deux autres, et un fichier écrit pour une plateforme peut silencieusement ne rien faire sur une autre. Activez "Signaler les chemins sans propriétaire" pour identifier tout chemin testé qu'aucune règle ne couvre, "Trier les résultats par ordre de règle" pour regrouper les résultats du deuxième champ par la ligne qui a décidé au lieu de l'ordre dans lequel vous les avez collés, et "Afficher le nombre de règles par propriétaire" pour voir en un coup d'œil qui possède la majorité du fichier.

Collez une liste de chemins de fichiers dans le deuxième champ pour les tester contre les règles : CODEOWNERS utilise la même logique « la dernière règle correspondante gagne » que .gitignore, ainsi l'outil signale exactement quelle ligne et quel propriétaire s'appliquent à chaque chemin — pas seulement si un modèle semble valide. Les fins de ligne Windows et Unix sont traitées de la même manière, et le rapport reste un fichier CODEOWNERS valide et commenté que vous pouvez lire directement à partir de la sortie.

Tout s'exécute localement dans votre navigateur. Votre fichier et les chemins que vous testez ne sont jamais téléchargés nulle part, ce qui importe pour un fichier qui peut lister la structure privée de l'équipe et du référentiel. Copiez le résultat annoté, téléchargez-le en tant que fichier .txt, ou renvoyez-le à l'entrée pour corriger un problème et vérifier à nouveau.

FAQ

Qu'est-ce qui compte comme une règle qui "ne peut jamais prendre effet"?

Deux cas : un duplicata exact d'un modèle antérieur (la ligne ultérieure gagne toujours, donc la précédente est un poids mort), et un large modèle générique comme "*" placé après une règle plus spécifique, qui silencieusement annule tout ce qui est au-dessus.

Comment l'outil décide-t-il quel propriétaire s'applique à un chemin?

De la même façon que GitHub, GitLab et Bitbucket le font : il parcourt les règles dans l'ordre du fichier et le dernier modèle correspondant à un chemin donné gagne, même si une règle antérieure, qui semble plus spécifique, correspondait également.

Pourquoi le choix de la plateforme importe-t-il si la syntaxe semble identique?

La plupart de la syntaxe CODEOWNERS est partagée, mais les fonctionnalités spécifiques à GitLab comme les en-têtes de section ne sont simplement que du texte inerte sur GitHub et Bitbucket — l'outil les signale pour que vous remarquiez avant qu'une exigence de révision ne soit silencieusement appliquée.

Vérifie-t-il que les noms d'utilisateur ou les équipes existent vraiment?

Non — il ne vérifie que s'ils sont bien formés (caractères valides, un "/" pour une équipe, un e-mail qui semble réel). Confirmer qu'un nom d'utilisateur ou une équipe existe toujours dans votre organisation nécessite une vérification directe avec GitHub, GitLab ou Bitbucket.

Mon fichier CODEOWNERS est-il téléchargé quelque part?

Non. La validation s'exécute entièrement dans votre navigateur — le fichier et tous les chemins que vous testez ne quittent jamais votre appareil.

Validateur CODEOWNERS

Outils connexes

Validateur CODEOWNERS

FAQ