Manuel:Pywikibot/Développement
Rapporter un bogue
Nous vous recommandons de tester si le bogue se produit encore avec la dernière version disponible présente dans Git. Si c'est le cas, rapportez le bogue en essayant d'inclure :
- Un titre concis de la tâche à réaliser.
- Une description complète du problème ou du rapport :
- expliquez la différence entre la sortie attendue et ce que vous obtenez réellement.
- Indiquez comment reproduire le bogue, avec toutes les informations dont vous disposez (les scripts, les ligne de commande, la famille, et la langue utilisée).
- La sortie console générée par le script (avec la trace Python associée si votre cas concerne un plantage).
- Incluez le résultat de
version.py.
Pour soumettre un nouveau bogue, allez sur le gestionnaire de bogues. Vous pouvez vérifier l'existence des rapports de bogue ici.
Développement
Si vous avez pensé à une fonction que vous souhaiteriez avoir et qui n'existe sur aucun des robots, vous pouvez demander à l'un des programmeurs de vous la coder. Ou encore mieux, vous pouvez essayer de travailler sur le robot lui-même. Python est un langage agréable, pas difficile à apprendre. Nous vous souhaitons la bienvenue.
Accès à la validation (commit)
Chacun peut obtenir un compte développeur. Une fois enregistré, si vous êtes intéressé pour travailler sur Pywikibot, veuillez envoyer un courriel à la liste de diffusion en vous présentant et en indiquant sur quoi vous souhaitez travailler de sorte à ce que les autres collaborateurs puissent vous accueillir.
Travailler avec le code source
Comment proposer des corrections
Configurer Git et Gerrit. Suivez les étapes du Tutoriel Gerrit et exécutez ceci :
$ git clone https://gerrit.wikimedia.org/g/pywikibot/core
et après avoir modifié le code, suivez les étapes sur Gerrit/Tutorial.
Règles
Voir les conventions de codage Python générales et les règles de développement Pywikibot.
Documentation
Ceci est le manuel de l'utilisateur et du développeur, tel qu'il se trouve sur Manuel:Pywikibot, merci de nous aider à le tenir à jour.
Le code lui-même est documenté en partie. Vous pouvez le voir sur :
de même que les rapports de tests unitaires et de couverture de code sur :
- Couverture de test (voir aussi phab:T74863)
Robots et proxy
Utilisez les variables d'environnement des requêtes. Voir phab:T111752.
Debogage des problèmes réseau
Voir Pywikibot/mitmproxy pour les pistes.
Voir aussi
- (Git) revue de code gerrit.wikimedia : https://gerrit.wikimedia.org/r/admin/repos/pywikibot,general