API de MediaWiki/Allusers : Différence entre versions
imported>Jacques Ducloy |
imported>Jacques Ducloy (→Voir aussi) |
||
(7 révisions intermédiaires par le même utilisateur non affichées) | |||
Ligne 1 : | Ligne 1 : | ||
− | Le module ''' | + | {{Titre page article|titre=API de MediaWiki, module Allusers}}Le module '''Allusers''' de l'[[API de MediaWiki]] permet d'obtenir une liste des contributeurs, triée par ordre alphabétique. |
==Exemple introductif== | ==Exemple introductif== | ||
Ligne 102 : | Ligne 102 : | ||
==Voir aussi== | ==Voir aussi== | ||
− | + | ;Articles connexes: | |
* [[Liste des inscrits sur un réseau MediaWiki]] | * [[Liste des inscrits sur un réseau MediaWiki]] | ||
− | + | ;Liens externes: | |
− | * [[mediawikiwiki:API: | + | * [[mediawikiwiki:API:Allusers|Ce module sur le site MediaWiki]]. |
[[Catégorie:Application cURL]] | [[Catégorie:Application cURL]] | ||
− | [[Catégorie:API de MediaWiki | + | [[Catégorie:API de MediaWiki]] |
[[Catégorie:Application lex]] | [[Catégorie:Application lex]] | ||
[[Catégorie:Réseau MediaWiki]] | [[Catégorie:Réseau MediaWiki]] |
Version actuelle datée du 13 juin 2020 à 19:41
API de MediaWiki, module Allusers
Le module Allusers de l'API de MediaWiki permet d'obtenir une liste des contributeurs, triée par ordre alphabétique.
Sommaire
Exemple introductif
Ce module peut être utilisé à partir d'un navigateur en utilisant une url du type :
<url du wiki>/api.php?paramètres
.
Exemple, pour ce wiki, dont l'url est : https://lorexplor.istex.fr/Wicri/Outils/fr, l'accès normal est :
L'accès au module allusers utilise l'URL :
Avec curl :
WIKI=https://lorexplor.istex.fr/Wicri/Europe/de
curl "$WIKI/api.php?action=query&format=xml&list=allusers" 2>nul \
| SxmlIndent
Paramètres
Les paramètres ont la forme identificateur = valeur
, ils sont séparés par des caractères « & ».
- Sélection de l'action liste des utilisateurs inscrits.
- ?action=query&list=allusers
aulimit
: longueur maximale de la liste des résultats (valeur implicite 10).
api.php?action=query&format=json&list=allusers
https://lorexplor.istex.fr/Wicri/Europe/de/api.php?action=query&format=xml&list=allusers
Résultats
En principe la commande renvoie une liste structurée en xml.
<?xml version="1.0"?>
<api batchcomplete="">
<continue aufrom="Anaïs Gravier" continue="-||"/>
<query>
<allusers>
<u userid="49" name="Alain Faron"/>
<u userid="186" name="Alexandrina Giorgi"/>
<u userid="188" name="Alexia Hiole"/>
<u userid="3" name="Ali Tebbakh"/>
<u userid="6" name="Aline Esparel"/>
<u userid="19" name="Aline Le Bihan"/>
<u userid="75" name="Allison Gnassou"/>
<u userid="76" name="Amandine Rivière"/>
<u userid="193" name="Amélie Perrin"/>
<u userid="30" name="Anaïs Capy"/>
</allusers>
</query>
</api>
Exemple d'utilisation dans le réseau Wicri
Le réseau Wicri est constitué de dizaines de wikis sur lesquels différents groupes d'utilisateurs sont inscrits. Pour évaluer leur nombre il faut consolider les listes obtenues sur plusieurs wikis. Voici un exemple réalisé depuis une station Unix.
Extraction des inscrits en lex
Un petit programme lex, nommé filtreUser, fonctionne avec un état (ou start condition) nommé USER.
%START USER
%%
"<u name="" BEGIN USER; /* 1 */
<USER>"" /></span>" {putchar ('\n'); /* 2 */
BEGIN 0;}
<USER>. ECHO; /* 3 */
. ; /* 4 */
\n ; /* 5 */
%%
main()
{
yylex();
}
- la règle 1 filtre le balisage précédent un auteur de la liste. L'action consiste à changer d'état pour imprimer le nom de l'utilisateur.
- la règle 2 filtre la fin d'une zone auteur. On revient à l'état 0 en imprimant un saut de ligne.
- la règle 3 provoque l'écriture d'un caractère de l'auteur.
- les règles 4 et 5 inhibent la copie des caractères non reconnus.
Sa compilation se réaliste comme suit :
lex filtreUsers.lex
gcc lex.yy.c -ll -o filtreUsers
Mise en œuvre
En pratique la majorité des wikis du réseau sont publics et la commande curl s'applique sans problème.
{
curl "http://maquettewicri.loria.fr/fr.wicri/api.php5?action=query&list=allusers&aulimit=500"
curl "http://maquettewicri.loria.fr/fr.ticri/api.php5?action=query&list=allusers&aulimit=500"
} | ./filtreUsers | sort -u | wc
Pour les wikis privés nous avons simplement réalisé un fichier à filtrer en utilisant l'option "code source de la sélection".
Voir aussi
- Articles connexes
- Liens externes