Gerrit/Navigation
L'interface utilisateur de Gerrit peut être difficile à exploiter. La documentation suivante aide à trouver des éléments dans l'interface utilisateur web de Gerrit.
Afficher les projets
- Pour voir tous les projets, sélectionner Browse > Repositories dans la barre supérieure pour naviguer dans les répertoires.
- Le code source du noyau MediaWiki est dans le projet mediawiki/core.
- Utilisez Repository Browser > gitiles pour parcourir la base de code.
- Si vous souhaitez voir le code de la version de MediaWiki ou d'une extension déployée sur un wiki donné, allez sur la page $1 de ce wiki et cherchez la branche ou la validation (commit) correspondante. Sélectionner ensuite la branche correspondante dans la barre latérale des gitiles.
- Sélectionnez Changes > View all pour voir les dernières validations.
Voir le code dans un répertoire
Après avoir sélectionné Browse > Repositories dans la barre supérieure et choisi un dépôt de code, sélectionner Repository Browser > gitiles pour voir se base de code.
Requêtes de recherche
Gerrit propose un champ de recherche dans le coin supérieur droit. Il comprend une recherche en texte complet sur les messages de validation, les auteurs ou les relecteurs (noms et adresses électroniques), etc.
Pour rechercher des éléments de valeurs spécifiques, utilise les mots clés.
Exemple : liste des validations sur tous les dépôts MediaWiki qui ont été, ou doivent être, relues par l'utilisateur Gerrit appelé jforrester :
project:^mediawiki/.* reviewer:jforrester AND -owner:L10n-bot
Il exclut le L10n-bot qui modifie parfois les résultats.
Exemple : liste des validations réalisées par les membres du groupe des nouveaux venus et des validations ayant passé le CI (ayant une étiquette positive Verified) et qui ont reçu soit CR-1 ou CR-2 (correction qui nécessite un recodage) :
ownerin:newcomers status:open label:Verified>=1 label:Code-Review<0
Requêtes de recherche via SSH
Vous pouvez également exécuter des requêtes à partir de la ligne de commande.
Il faut pour cela un compte développeur.
Connectez-vous par ssh pour exécuter les commandes de la forme gerrit query ' paramètres du query ' sur l'hôte Gerrit.
Les opérateurs de recherche sont les mêmes que ceux de l'interface Web.
Voir la documentation de la commande Query.
Exemple : liste des validations non relues dans mediawiki :
ssh -p 29418 yourPersonalUsername@gerrit.wikimedia.org gerrit query 'status:open project:^mediawiki/.* AND NOT label:Code-Review<=-1'
Pour le nombre de correctifs non examinés, voir la valeur de rowCount dans les résultats de cette commande.
Réaliser une revue de code
Voir Revue de code dans Gerrit
Rapports
- Statistiques simples de révision du code, à chaque instant et le mois dernier (basé sur refs/notes/review, contenant uniquement les votes CodeReview du dernier ensemble de corrections de chaque validation)
- Rapport des ressources des développeurs
- API Gerrit REST: les points d'accès sont situés sur
https://gerrit.wikimedia.org/r/..., comme par exemplehttps://gerrit.wikimedia.org/r/projects/mediawiki%2Fcore/branches - code source du robot relecteur de code Gerrit de valhallasw
- XSSI — Cross-Site Script Inclusion : empêcher l'inclusion de scripts