Manual:Pywikibot/Installation/fr

Cette page vous aidera à débuter avec Pywikibot, sur votre propre ordinateur, sur les Labs, ou sur PAWS.

Installer Python
Télécharger Python et l'installer à partir de http://www.python.org/downloads/.

Si vous possédez déjà Python, la commande  permet d'afficher la version dans le terminal et de vérifier qu'elle est à jour. Si vous avez Python 2.7.2 ou plus, Python 3.3 ou une version plus récente, vous pouvez utiliser Pywikibot.

Install dependencies
An addidional package named requests is required to run pywikibot. Use pip, which is already installed if you have a Python release 2.7.9 or 3.4 or higher. Run the following commands to install this package:

Télécharger Pywikibot
Télécharger Pywikibot master branch: .tar.gz, .zip.

On peut aussi télécharger une version mise à jour chaque nuit sur https://tools.wmflabs.org/pywikibot/.

Décompresser ce fichier, par exemple dans le dossier  ou.

Alternatively you may retrieve the latest version as git client or svn client from gerrit, see. This is the recommended way for active bot operators and developers to use pywikibot.

Mettre à jour
Les versions stables sont diffusées régulièrement de façon mensuelle, au même endroit. Si vous utilisez SVN ou un client d'archivage Git vous pouvez sauter cette note. Sinon, soyez conscient que avant d'installer une nouvelle version, il vous appartient de sauver vos fichiers et vos scripts de configuration (, les fichiers de famille, ou les scripts adaptés que vous auriez pu créer, ainsi que les fichiers de dump XML courants que vous utilisez pour un wiki). Décompresser la nouvelle version en remplaçant l'ancienne et ses fichiers.

Configurer Pywikibot
Ou, ouvrir un terminal et changer de dossier (cd) pour aller où pywikibot a été décompressé :


 * Pour un système de type Unix (Linux/BSD/Solaris) : ouvrez 'Terminal' (le plus souvent dans 'Outils système' dans le menu) et lancez :


 * Windows : Démarrer 'Invite de commande' (dans le menu Démarrer), et lancer :

Évidemment il faut naviguer jusqu'au dossier où a été décompressé Pywikibot. Les indications affichées dans le terminal permettent de configurer le logiciel. Une fois l'identifiant et le mot de passe Wikimédia entrés, vous êtes connecté.

Après cela, créer quelque part un fichier en insérant du code sous cette forme, puis ouvrez user-config.py du dossier Pywikibot et insérez-y.

Utilisation sur des Wikis indépendants
Pywikibot est pré-configuré pour fonctionner sur une grande partie des Wikis, mais il est possible d'en ajouter d'autres. présente la démarche permettant ceci.

Plus d'options de configuration
Pywikibot propose de nombreux paramètres de configuration pour personnaliser votre bot. Vous pouvez les modifier dans le fichier 'user-config.py'. Les paramètres sont listés sur config2.py.

Utiliser les scripts
Pywikibot est installé avec de nombreux scripts dans le dossier scripts. Vous pouvez tous les utiliser à partir de la commande suivante :

Une liste complète de ces scripts est disponibles sur.

Autres dépendances
L'exécution de la plupart des scripts ne nécessite pas de package autre que ceux desquels ils dépendent, mais certains d'entre eux ne fonctionneront pas s'ils sont absents. Ils sont listés sur requirements.txt.

Pour installer ces dépendances, utilisez pip installé avec une version récente de Python. Les commandes suivantes permettent l'installation des paquets :

Ou cette commande permettant de les installer tous en une fois :