Utilisateur:Denis Gagne52/Ws-RubanQual.py
Apparence
(Redirigé depuis Utilisateur:Denis Gagne52/Ws-AIDG-Bandeau.py)
"""
Script pour la mise à jour des rubans de qualité
2026-04-30 : Denis Gagne52 avec Google Genesis
Objectif : permettre la mise à jour de rubans de qualité dans le cadre de projets communautaires ou pour le suivi de projets personnels quand la page de suivi contient de nombreux livres non complétés dont on veut afficher la progression.
À quel moment ce script doit-il être utilisé ?
Lorsque le quantité de rubans sur une page ralentit son chargement de façon significative. On peut alors remplacer le modèle {{ruban par titre}} par {{ruban de qualité}}. La mise à jour des données de qualité ne se fera plus au chargement de la page mais à intervalle régulier en se servant de ce script. N-B : À partir de 50 livres, le chargement de la page va ralentir suffisamment pour envisager cette approche mieux adaptée aux pages volumineuses. Le script traite environ 100 rubans par minute.
Syntaxe wikicode minimale à insérer sur votre page wikisource :
{{ruban de qualité|index=Livre:Nom_du_fichier.djvu}}
Syntaxe wikicode complète (le script remplira le reste) :
{{ruban de qualité
|index=Livre:Votre_Fichier.pdf
|date=
|q0=0
|q1=0
|q2=0
|q3=0
|q4=0
|total=0
}}
Voici une documentation condensée, conçue pour accompagner votre script. Elle explique la logique de l'outil et les étapes pour le faire fonctionner sur un nouvel ordinateur.
________________________________________
Documentation du Script « Rubans de Qualité »
1. Architecture et Logique du Code
Le script est découpé en trois blocs principaux pour maximiser la vitesse et la fiabilité :
• L’Analyse de la Page (mwparserfromhell) : Au lieu de lire la page comme un simple texte, le code utilise un « parseur » qui identifie uniquement les modèles {{ruban de qualité}}. Cela garantit que le reste de la page (texte, images, autres balises) reste intact.
• La Double Requête API (Vitesse Optimisée) :
o Phase 1 (Le Total) : Une requête ultra-légère demande la liste de toutes les pages prévues dans l'index. C'est ce qui donne le chiffre total (incluant les liens rouges).
o Phase 2 (La Qualité) : Une seconde requête cible uniquement les pages ayant un contenu (pageid). On trie ces pages par niveau (q0 à q4).
• La Logique de Transformation (Le Panache) : Le script compare le total aux pages validées. Si l'ouvrage est fini (q0 + q4 = total), il remplace le modèle complexe par le modèle léger {{5/4}}.
2. Avantages de cette Méthode
• Rapidité extrême : En évitant de charger le texte des pages et en utilisant les nouvelles fonctions de l'API Wikisource (gprppiititle), le script traite chaque index en environ 0,5 seconde.
• Précision chirurgicale : Il distingue parfaitement les pages créées mais vides (q0) des pages qui n'existent pas encore sur le wiki.
• Auto-optimisation : Plus vous finissez de livres, plus le script devient rapide, car il ignore les modèles {{5/4}} lors des passages suivants.
________________________________________
Guide d'installation (pour les nouveaux utilisateurs)
Pour faire fonctionner ce script, vous devez préparer votre environnement Python en trois étapes simples :
Étape 1 : Installer les outils nécessaires
Ouvrez votre terminal (ou invite de commande) et installez les deux bibliothèques indispensables :
bash
pip install pywikibot mwparserfromhell
Étape 2 : Configurer Pywikibot
Si c'est votre première utilisation de Pywikibot :
1. Créez un dossier pour votre projet.
2. Créez un fichier nommé user-config.py.
3. Ajoutez-y ces lignes :
# -*- coding: utf-8 -*-
family = 'wikisource'
mylang = 'fr'
usernames['wikisource']['fr'] = 'VotreNomDUtilisateur'
Étape 3 : Lancer le script
1. Enregistrez le code fourni dans un fichier nommé update_rubans.py et ajouter le nom de la page qui contient les rubans à mettre à jour. Il suffit de remplacer "Nom de ma Page Wikisource" au début du code.
2. Lancez-le script via le terminal :
bash
python update_rubans.py
3. Si, avant de lancer le script, vous n’avez pas ouvert une session sur Wikisource à partir de votre navigateur, on vous demandera votre mot de passe Wikisource lors de la première connexion (ou un mot de passe d'application si vous en avez un).
Voir en page de discussion comment créer un mot de passe d’application ce qui évite de vous connecter avec votre pseudonyme et permet de protéger votre mot de passe personnel. Quand on lance le script manuellement, le plus simple demeure d’ouvrir une session wikisource et le script ira récupérer un cookie pour accéder à Wikisource.
"""
import pywikibot
import mwparserfromhell
import time
from collections import Counter
from datetime import datetime
site = pywikibot.Site('fr', 'wikisource')
page_cible = pywikibot.Page(site, "Nom de ma Page Wikisource")
def get_index_data_fast(index_title):
"""Extraction optimisée : Total via 'list' et Qualités via 'generator'."""
try:
# 1. Total (liens bleus + rouges) via list
req_list = pywikibot.data.api.Request(site=site, parameters={
'action': 'query',
'list': 'proofreadpagesinindex',
'prppiititle': index_title
})
data_list = req_list.submit()
pages_liste = data_list.get('query', {}).get('proofreadpagesinindex', [])
total_pages = len(pages_liste)
if total_pages == 0: return None
# 2. Qualités (uniquement pages créées) via generator
stats = Counter()
req_gen = pywikibot.data.api.Request(site=site, parameters={
'action': 'query',
'generator': 'proofreadpagesinindex',
'gprppiititle': index_title,
'prop': 'proofread'
})
data_gen = req_gen.submit()
if 'query' in data_gen and 'pages' in data_gen['query']:
for pg in data_gen['query']['pages'].values():
if 'pageid' in pg: # On ignore les pages non créées
q = pg.get('proofread', {}).get('quality', 0)
stats[q] += 1
return {'stats': stats, 'total': total_pages}
except Exception as e:
pywikibot.error(f"Erreur sur {index_title}: {e}")
return None
def update_rubans():
start_time = time.time()
text = page_cible.text
wikicode = mwparserfromhell.parse(text)
templates = [t for t in wikicode.filter_templates() if t.name.matches("ruban de qualité") and t.has("index")]
total_to_do = len(templates)
print(f"🚀 Décollage ! {total_to_do} index à analyser.\n")
current_date = datetime.now().strftime('%d/%m/%Y')
updated_count = 0
finished_count = 0
for i, temp in enumerate(templates, 1):
idx_name = str(temp.get("index").value).strip()
# Progression sur une seule ligne
print(f" ⏳ [{i}/{total_to_do}] {idx_name[:50]}...", end='\r')
data = get_index_data_fast(idx_name)
if data:
# Condition de succès : q0 + q4 == total
if (data['stats'][0] + data['stats'][4]) == data['total']:
temp.name = "5/4"
for param in list(temp.params):
if param.name.strip() != "index":
temp.remove(param)
print(f"\n 🎉 BRAVO ! {idx_name} est terminé et passe en {{5/4}}")
finished_count += 1
else:
# Mise à jour des paramètres du ruban
temp.add("date", current_date)
temp.add("total", str(data['total']))
for q in range(5):
temp.add(f"q{q}", str(data['stats'][q]))
updated_count += 1
# Enregistrement
if str(wikicode) != text:
print("\n💾 Sauvegarde en cours...")
page_cible.text = str(wikicode)
page_cible.save(f"Mise à jour auto : {updated_count} index ({finished_count} terminés)")
duration = time.time() - start_time
print(f"\n" + "-"*40)
print(f" ✅ Mission accomplie en {duration:.1f} secondes.")
print(f" 📊 {updated_count} rubans traités ({finished_count} nouveaux modèles {{5/4}}).")
print(f" ⚡ Moyenne : {duration/total_to_do:.2f}s par index.")
print("-"*40)
if __name__ == "__main__":
update_rubans()