Manual:Pywikibot/login.py

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Pywikibot/login.py and the translation is 39% complete.

Outdated translations are marked like this.
Other languages:
English • ‎català • ‎español • ‎français • ‎italiano • ‎suomi • ‎čeština • ‎русский • ‎العربية • ‎日本語 • ‎한국어
Git logo
Wikimedia Git repository has this file: scripts/login.py

login.py est le programme python qui connecte le compte utilisateur via les paramètres de user-config.py .

Connexion du robot

Le robot génère des résultats adaptés et nécessite donc moins d'attention. Avec un compte dédié pour les programmes automatiques, les modifications peuvent êtres masquées de la page changements récents. Le status de robot est donné par la communauté, si elle comporte déjà des dresseurs de robots.

Si vous voulez vous connecter en tant que administrateur (suppressions ou protections par exemple) vous devez ajouter

sysopnames['wikiproject']['languagecode'] = 'YourSysopUsername'

dans user-config.py et demarrer login.py' avec le paramètre -sysop.

Comment se déroule la connection

Dans user-config.py il y a trois composants :

  1. la langue : mylang
  2. la famille : family ; indiquant le nom du wiki, tel que Wikipedia ou Wiktionary
  3. le nom d'utilisateur : username ; pouvant être n'importe quel compte, mais il est préférable d'être enregistré avec un compte bot dédié.

In order to login to all the projects/languages mentioned in user-config.py, the option -all can be used, and if the same password is used throughout all these projects, it can be combined with -pass so that the program doesn't ask for a password for each site.

python login.py -all -pass

will login on all projects in user-config.py, using the same password for all. Pour l'instant, l'option -pass n'est pas utilisable. (T102477) You should use password file instead. Create file with text like '("en", "wikipedia", "User", "password")' (you can use more than one line). Then, insert in your user-config.py file 'password_file = "path_to_password_file"' line. After this Pywikibot should use data from this file when he need to login.

Déconnexion

python pwb.py login -logout

Conenxion avec OAuth

Pywikibot supports login using OAuth authentication instead of password. The OAuth feature needs the site with Extension:OAuth installed and configured properly. OAuth is more secure (passwords are not sent over the internet, can be invalidated at any time, and the permissions of the bot user can be restricted) and should generally be preferred over normal login. See Manual:Pywikibot/OAuth on how to use it (it does not involve login.py).

If for some reason you want to log your bot in as a multi-user OAuth app (not recommended, but e.g. older MediaWiki might not support owner-only apps), you can use login.py for that, with the option -oauth. The process contains the following steps:

  1. Create OAuth app at Special:OAuthConsumerRegistration/propose on meta if it does not exist yet, and record the consumer key and secret
  2. Run python login.py -oauth
  3. Input OAuth consumer key
  4. Input OAuth consumer secret
  5. Authenticate user via web browser. You may need to manually copy the url from the terminal if the web browser doesn't open up automatically.
  6. Input response query string to terminal when authentication succeeds. E.g.: oauth_verifier=xxx&oauth_token=yyy
  7. Copy and paste authentication entry generated into user-config.py .
-logout, -pass, -force, -pass:XXXX and -sysop are not compatible with -oauth.

Arguments globaux disponibles

Ces options remplaceront celles définies dans le fichier de configuration user-config.py .

Options globales
ParamètreDescriptionNom du paramètre de configuration dans user-config.py
-dir:PATH Lit les données de configuration du robot dans le dossier donné par PATH, au lieu du dossier par défaut.  
-lang:xx Définit la langue du wiki sur lequel vous voulez travailler, en outrepassant la configuration de user-config.py. xx doit être le code de la langue (exemple : fr). mylang
-family:xyz Définit la famille du wiki sur lequel vous voulez travailler, tel que wikipedia, wikitionary, wikitravel... Cela outrepassera la configuration de user-config.py. family
-user:xyz Se connecter en tant qu'utilisateur xyz au lieu du nom d'utilisateur par défaut. usernames
-daemonize:xyz Rend le contrôle immédiatement au terminal et redirige la sortie standard (stdout) et la sortie en erreur (stderr) vers le fichier xyz (seulement utilisé pour les robots qui n'ont pas besoin de l'entrée standard (stdin) ).  
-help Affiche le texte d'aide.  
-log Active l'enregistrement des journaux de connexion, en utilisant le nom de fichier par défaut "nom_du_script-bot.log" dans le sous dossier logs. log
-log:xyz Active l'enregistrement des logs dans un fichier avec xyz pour nom. logfilename
-nolog Désactive l'enregistrement des logs (activé par défaut)  
-maxlag Définir le maxlag, en secondes. Reporte les modifications du robot lors de périodes de latence du serveur. La valeur par défaut est celle de config.py. maxlag
-putthrottle:n
-pt:n
-put_throttle:n
Définit le temps minimum (en secondes) que le robot doit attendre entre deux enregistrements de pages. put_throttle
-debug:item
-debug
Active le fichier de log et incluant plus particulièrement les données de débuggage pour l'élément item (1er cas) ou pour tous les éléments (2nd cas) debug_log
-verbose
-v
Détaille le retour dans le terminal, en particulier concernant ses travaux actuels ou sa progression. Les données peuvent être utiles pour le débogage. verbose_output
-cosmeticchanges
-cc
Inverse et outrepasse la valeur du paramètre cosmetic_changes de config.py' ou user-config.py (si rien n'est mentionné dans ces fichiers, l'active). Tous les autre paramètres et restrictions restent inchangés. cosmetic_changes
-simulate Désactiver les modifications envoyées sur le serveur. Utile pour les tests et le débogage de nouveau code (si utilisé, ne fait aucun changement réel, et ne montre que ce qui aurait dû être changé). simulate
-<variable de configuration>:n Vous pouvez utilisez toutes les variables numériques de configuration données en tant qu'options et les modifier avec une ligne de commande.  


See also