Manual:Pywikibot/Gerrit/fr

Lexique

 * Git - système de contrôle de version. Il remplace SVN.
 * Gerrit - plate-forme de relecture de code (https://gerrit.wikimedia.org). Remplace Special:CodeReview
 * core - branche (master) actuelle connue précédemment comme "rewrite".



Pour les utilisateurs


Clients Git
Par exemple, pour télécharger la branche core en ligne de commande :
 * Utilisateurs de Windows : il est recommandé d'utiliser TortoiseGit avec Git for Windows. Il est recommandé d'installer d'abord TortoiseGit.
 * Utilisateurs de macOS ou de Linux : Git en ligne de commande - https://git-scm.com/ ou brew install git (Homebrew, macOS)

Pour mettre à jour :

Si vous êtes paresseux et que voulez pouvoir faire tout ça d'un seul coup, vous pouvez :

Notez que les dépôts peuvent être très gros quelques fois (> 100 Mo). Si cela pose problème, utilisez :

pour ne récupérer que les dernières versions.



Utilisateurs SVN
En janvier 2023, il est toujours possible d'utiliser SVN pour télécharger Pywikibot. Pour cela, suivez les instructions sur Manual:Pywikibot/Installation/SVN.

Notez cependant que cela ne fonctionnera plus à partir de janvier 2024. Nous vous suggérons à la place d'utiliser pip pour installer et mettre à jour Pywikibot.

URLs
Votre client vous demandera probablement l'URL du dépôt. Les urls sont construites sur le format : .

Ainsi pour le noyau :

.



Compilations de la nuit
Vous pouvez télécharger les paquets complets ou voir le code source via la page de téléchargement de Toolforge



Pour les développeurs
Comment soumettre des corrections (patches)... configurer git/gerrit. etc.

Lire ces indications, puis suivre les étapes dans et exécuter ceci :

et après que le code ait été modifié, suivre les étapes dans


 * Sous Windows: Les développeurs sous Windows peuvent également utiliser pour les informations supplémentaires.



Exemple (pas à pas)
Exécuter chacune des étapes suivantes :


 * 1) configurer son logiciel :
 * 2) si ce n'est pas déjà fait pour l'accès svn ; créer une clé SSH, un  compte développeur et ajoutez votre clé publique à Gerrit et à Wikitech
 * 3) installer le paquet 'git'
 * 4) installer le paquet 'git-review'
 * 5) * celui par openstack, et NON PAS celui par Facebook
 * 6) * toute version comme les 1.12, 1.21, mais PAS LA v1.18
 * 7) clôner et configurer son dépôt :
 * 8) clôner le dépôt Git avec tous les sous-modules en utilisant (comme  )   et attendre, cette étape dure quelques instants
 * 9) entrer dans le répertoire
 * 10) configurer les paramètres Git pour ce dépôt/répertoire uniquement (pas globalement, dans le cas par exemple ou vous auriez différents pseudo sur plusieurs projets)   et   pour configurer cela globalement, utiliser le paramètre
 * 11) configurer le terminal ou la console pour voir les messages en anglais (afin de travailler proprement durant la relecture de code Gerrit/git)   faire ceci à chaque ouverture d'une nouvelle console; pour configurer cela de manière permanente, ajouter ces lignes dans votre fichier   ou fichier de configuration équivalent
 * 12) configurer la revue Git sur ce dépôt uniquement   et entrez à nouveau votre  , c'est une étape importante - si vous la sautez, conformément au Tutoriel Gerrit/Push, le   final ci-dessous  va échouer (il faut valider vos modifications avec commit pour la relecture de code) - bien que vous puissiez encore sauver la situation puis
 * 13) travaillez sur le dépôt, par exemple validez vos corrections pour la relecture avec commit :
 * 14) passer sur la branche master (peut être pas utile)
 * 15) mettez à jour en ligne la branche courante à réviser (comme   )
 * 16) créez votre propre branche locale temporaire pour travailler  et essayez de choisir un   avec l'aide des  à disposition – la branche pourra être supprimée si elle n'est plus utile avec
 * 17) écrivez maintenant votre code; lorsque vous êtes prêt a passer à l'étape suivante, voyez les commandes Git ,   et   pour respectivement ajouter, supprimer ou renommer des fichiers
 * 18) validez vos modifcations avec commit sur votre branche locale temporaire avec   (vous pouvez utiliser   au lieu de   et   au lieu de  ) et, comme pour svn,  entrez un message de validation significatif, par exemple une courte description de vos modifications de code
 * 19) * Voir.
 * 20) vérifiez éventuelllement vos modifications en affichant les données que vous avez validées   et assurez-vous d'avoir envoyé ce que vous souhaitiez
 * 21) envoyez vos données sur le dépôt en ligne par gerrit for review (comme pour  )
 * 22) enfin rendez-vous sur Gerrit, cliquez sur vos modifications et insérez un nom de relecteur dans le champ de saisie à côté du bouton Add Reviewer
 * 23) optionnel /déclarer des paramètres supplémentaires :
 * 24) * permettre l'expansion des mots-clés RCS (tels que svn:keywords  ) en utilisant les accroches Git (détaillé ici - en allemand seulement)
 * 25) ** pour le noyau :
 * 26) ** (peut-être faudrait-il considérer le module git-rcs-keywords comme mentionné dans gérer l'expansion des mots-clés svn avec git svn)

Phabricator
Les corrections seront liées à une tâche automatiquement si vous mentionnez cette tâche dans le texte tel que 'Bug: T12345' sur une ligne juste avant 'Change-Id: ....'. Voir pour plus d'informations.



Problèmes, bogues et palliatifs


Messages du robot jenkins
https://integration.wikimedia.org/ci/job/pywikibot-core-tox-flake8/2591/console : FAILURE in ?s (non-voting)

Les corrections soumises n'ont pas passé les vérifications flake8 concernant le style du code. Cela dit rien sur la fonctionnalité du code mais indique qu'il y a des problèmes de syntaxe ou de style.

https://integration.wikimedia.org/ci/job/pywikibot-core-tox-flake8-docstrings-mandatory/560/console : FAILURE in ?s (non-voting)

Ces corrections validées ont échoué aux contrôles obligatoires du style du code pep257. Cela dit rien sur la fonctionnalité du code mais indique qu'il y a des problèmes avec la documentation en ligne.

https://integration.wikimedia.org/ci/job/pywikibot-core-tox-nose/1448/console : FAILURE in ?s (non-voting)

L'ensemble de corrections validé n'a pas passé avec succès les tests de contrôle qui précèdent la fusion. Cela indique que le code a échoué aux vérifications de base, mais cette passe ne renseigne en rien sur la fonctionnalité du code modifié. Il existe un ensemble plus fourni de tests que les développeurs devraient faire passer avant de soumettre leur code, et qui réalisera ultérieurement la fusion (merge).

This change could not be automatically merged with the current state of the repository. Please rebase your change and upload a new patchset.

L'ensemble des corrections ne peut pas être fusionné automatiquement dans le HEAD courant. Prenez en compte Echec de la construction dû aux conflits de fusion (merge) pour une solution possible.

Vous trouverez des informations complémentaires sur Comment soumettre un patch et Messages de relecture Git concernant les validations multiples.