Manual:Pywikibot/Installation/fr

For installing or updating compat see Manual:Pywikibot/Installation/compat, To update or install via SVN see Manual:Pywikibot/Installation/SVN.

Installation initiale
There are the following basic steps to installing pywikibot:
 * 1) Download or update Python,
 * 2) Download pywikibot,
 * 3) Configure pywikibot's basic settings.

Télécharger Python

 * Unix systems: typically have a recent-enough version of Python installed. Check with.


 * Mac OS X 10.8+: has a version of Python that is recent enough to run pywikibot. If you run an older OS X, or are unsure, download and install Python 2.7.10 from http://www.python.org/downloads/


 * Windows: download and install the latest release Python 2.7.10 from http://www.python.org/downloads/


 * Version de Python : les versions suivantes de Python sont prises en charge :

Due to a Unicode bug in the underlying python library, Python 2.7.0 and 2.7.1 are not supported using the Core branch. See also the requirements for a bot, which describes needed python version and pywikibot branches.

Télécharger Pywikibot
La manière la plus simple de télécharger Pywikibot est d'utiliser la dernière version compilée. Téléchargez juste le fichier ZIP de Pywikibot sur votre ordinateur et décompressez-le - aucune installation n'est requise.

Télécharger Pywikibot avec Git
For installing with Git you need to run: With the  option it automatically installs the required submodules. Currently there is one submodules (i18n), which is really required even for English language bots.

Raccourci en ligne de commande
Pour que votre code puisse être développé à l'extérieur du répertoire pywikibot source, ajouter quelque chose comme: à un fichier qui est lancé à l'initialisation, par exemple ~/.bashrc - il n'est ainsi pas nécessaire de retaper l'export PYTHONPATH à chaque connexion. Adapter évidemment les chemins à votre installation.

Similarly, you can set the PYWIKIBOT2_DIR environment variable to specify the directory in which user-specific information is stored (in particular, user-config.py which contains login data for the bot).

Mise-à-jour
La suite logiciel pywikibot est un logiciel en perpétuelle version bêta. Des corrections de bogues, de nouvelles options, de nouveaux comportements et des changements dans le logiciel Mediawiki conduisent à la sortie régulière de nouvelles versions et nécessitent que le code soit mis à jour. Mettez donc à jour votre branche régulièrement (tous les jours ou au moins une fois par semaine).

Mettre à jour l'installation à partir des sauvegardes journalières

 * Si vous utilisez une version "journalière", le processus est un peu plus compliqué. Vous devez re-télécharger une archive de cette page. Avant de l'installer, sauvegardez votre fichier de configuration et vos scripts  (user-config.py, un fichier définition de famille de wiki, un script personnel que vous auriez créé, et tout export XML que vous utilisez pour un wiki). Remplacez votre répertoire pywikibot par la nouvelle version. Restaurez vos fichiers personnels. Si vous avez un doute, n'écrasez rien mais garder une sauvegarde entière de votre ancien répertoire, pour être sur de ne rien perdre d'important.

If you have changed some scripts of the framework, you have to merge the differences by yourself. Version control systems like git or svn does it automatically.

Mettre à jour avec git

 * Si vous avez utilisé Git pour télécharger Pywikibot, vous devrez aller dans son dossier et exécuter la commande suivante :


 * Si vous utilisez une version compilée, le processus est un peu plus compliqué. Vous devez re-télécharger une copie complète via [$pwb_nightly ce lien]. Avant de l'installer, sauvegardez vos fichiers de configuration et vos scripts (user-config.py, tout fichier "family" ou script personnalisé que vous auriez créé, et tout fichier XML de dump que vous utiliseriez actuellement pour un wiki). Remplacez votre dossier Pywikibot par la nouvelle version que vous venez de télécharger. Restaurez vos fichiers de configuration. Si vous n'êtes pas sûr de ce que vous faites, n'effacez rien mais gardez une sauvegarde de votre ancien dossier Pywikibot, pour éviter de perdre tout fichier important.

Dépendances
Use  package management system to install dependencies. It is included by Python 2.7.9 and Python 3.4. To install all dependencies just run the following command (keeping in mind that some dependencies will require MySQL Connector C++ Libraries):

For a single package use:

To uninstall a single package use:

Créer les fichiers utilisateurs
En guise de dernière étape, vous devez créer les fichiers de configurations utilisateurs. Le principal est. Si vous exécuter votre script favori juste après l'installation,  par exemple, pywikibot va vous poser des questions sur la manière de configurer votre copie locale et va créer ces fichiers. Vous pouvez aussi lancer generate user files.py pour le même résultat.

Lancer sous Windows
Référez vous à la page Manual:Pywikibot/Windows.

Vérifier votre installation
Avec la branche core, lancer la ligne de commande  devrait demander le login et le mot de passe de votre robot, puis notifier Logged in on "somewiki":"lang" as "bot username".