Utilisateur:Thierry46/Finances Locales

Une page de Wikipédia, l'encyclopédie libre.
Aller à : navigation, rechercher
Logo de l'outil Finances locales version 2.

Bienvenue sur la page de description de l'outil Finances locales :

Cet outil a pour objectif de faciliter la rédaction de la section Finances locales des communes de France avec pour référence le site officiel alize2.finances.gouv.fr.

Introduction[modifier | modifier le code]

Au , la plupart des communes de France, même les grandes villes ou celles qui ont été évaluées articles de qualité, ne possèdent pas de sous-section Finances locales. Voir par exemple Lyon.

Le travail de rédaction est pénible car il faut synthétiser un grand nombre d'informations disponibles[1], mais difficilement accessibles du site alize2.finances.gouv.fr du Ministère de l'Économie et des Finances (pour Thégra)[2]. Il faut aussi générer un Wikicode complexe pour les tableaux et les graphiques. En bref, un travail de bot !

Pour le rayonnement de Wikipedia, Il me semblait bon que les sections Finances locales présentent une synthèse, claire, cohérente, neutre et basée sur des références officielles, de l'état de chaque commune de France.

Description[modifier | modifier le code]

Rôle[modifier | modifier le code]

Le projet Finances locales permet d'aider le contributeur à utiliser plus facilement les informations du site alize2.finances.gouv.fr pour compléter les sections Finances locales des communes de France.

Fichiers produits en V2[modifier | modifier le code]

On trouvera sur le site Web indépendant :

  • du wikicode qui pourra servir à enrichir Wikipédia
  • du code HTML et des graphiques au format SVG directement visibles sur le site Web
  • les données extraites sous forme de tableaux au format CSV français importables dans votre tableur.

Informations techniques[modifier | modifier le code]

Cet outil utilise Python pour extraire les données du site Web Alize2 et produire du Wikitexte.

Exécutables en V2[modifier | modifier le code]

Ce logiciel se compose de cinq parties :

  • genCle : génération des clés d'extraction ;
  • extractionWeb : extrait les informations demandées du site alize2.finances.gouv.fr et les stocke en local ;
  • genCode : génère les commentaires de traçabilité, le texte, les tableaux des données sur 4 ans, de pictogrammes, les graphiques ;
  • gensiteWeb : prépare les paquets par département pour transfert sur le Web ;
  • genListeDep : génère des listes de communes par département pour ne pas être tributaires des nombreux formats des listes de communes de Wikipédia.

Dépendances[modifier | modifier le code]

Il est basé sur les logiciels et composants suivants :

  • Python 3.x ;
  • la bibliothèque d'analyse XML/HTML lxml distribuée sous licence BSD pour extraire les données des pages Web du Ministère des Finances ;
  • la bibliothèque Matplotlib pour produire les graphiques au format SVG.

Notice d'installation et d'utilisation[modifier | modifier le code]

Une notice sommaire est incluse en format texte dans le paquet contenant les sources.

Qualité et mesures logicielles[modifier | modifier le code]

En version 2.4.1, le logiciel est constitué de 7 240 lignes de code.

  • Maintenabilité : le logiciel Pylint permet de vérifier le respect des standards et la détection de bugs. En version 2.0.0, l'outil obtient la note globale de 9,75/10 ; il subsiste cependant des problèmes (nombre d'instructions et de paramètres) nécessitant une reconception de certaines parties qui dépassent les seuils de complexité des métriques standards.
  • Test unitaire : py.test pour la vérification. En v2.4.1, cet outil permet de jouer les 213 tests unitaires. Il participent à la vérification des non-régression lors des modifications.
  • Couverture de code : en v2.0.0, Pycoverage mesure que 96 % des 2 859 instructions sont couvertes par la batterie de tests décrite au-dessus.
  • Portabilité : l'outil fonctionne sur tout ordinateur : Mac, PC Windows, Linux...

Format des fichiers[modifier | modifier le code]

Les fichiers de sortie sont tous en format SVG, HTML ou CSV encodés en UTF-8 et lisibles avec un éditeur simple ou un navigateur web :

Des Modèle définissent la génération du wikicode et du HTML.

Temps d'exécution, volumes[modifier | modifier le code]

Licence[modifier | modifier le code]

Finances locales est un logiciel libre distribué en copyleft sous licence GNU GPL version 3.

Je transmets les fichiers sources aux seules personnes de confiance qui en feront la demande.

Phase de test V0[modifier | modifier le code]

Statut : Fait Depuis le jusqu'au dans :

Phase de pré-déploiement V0[modifier | modifier le code]

Statut : FaitVote terminé et favorable (voir Archive du vote du 29 juillet au 9 août 2015).

Du au , dans un panel représentatif de communes ont été choisies :

Phase de déploiement V1[modifier | modifier le code]

Statut : Stop sur décision administrative.

Cette phase de déploiement dans les articles des communes de France dont les articles Wikipédia sont les plus avancés avait commencé suite au vote favorable du 29 juillet au 9 août 2015. Elle s'est arrêté le sur décision administrative des administrateurs de Wikipédia.

Phase de déploiement externe V2[modifier | modifier le code]

Statut : Fait, version 2.4.1 réalisée et résultats accessibles sur site Web indépendant.

Cette phase concerne les 3 549 communes dont la rédaction est la plus avancée sur Wikipédia.

Justification du déploiement externe[modifier | modifier le code]

Les contributeurs de wikipédia disposeront du Wikicode à insérer avec des sources primaires et secondaires. Ils pourront aussi utiliser dans leur tableur les données brutes au format CSV pour présenter à leur façon les données.

Remarques et problèmes[modifier | modifier le code]

  • Si vous voulez faire part d'une remarque ou si vous détectez un problème pour une section générée par cet outil, n'hésitez pas à laisser un message dans la page de discussion.

Évolutions[modifier | modifier le code]

Nommage des versions[modifier | modifier le code]

La version de l'outil est nécessaire pour des raisons de traçabilité. Elle est définie dans le fichier FinancesLocales.properties. Elle est indiquée en commentaire du Wikitexte généré et dans la première note dans les références de l'article de la commune.

Le nommage des versions est défini par :

  • un numéro : voir l'article Version d'un logiciel :
    • les numéros de versions x.y commençant par 0 étaient réservées à la phase interne de test ;
    • les numéros de versions x.0.z étaient des candidates déployées sur les communes de Lunegarde, Issendolus, Cahors et Toulouse.
    • les numéros de versions suivants, stables et déployables sur Wikipédia ;
  • un nom mnémotechnique qui qualifie chaque version.

Version 0.4 vers version 0.5[modifier | modifier le code]

Version 0.5 vers version 0.6[modifier | modifier le code]

Version 0.6 vers version 0.7[modifier | modifier le code]

Version 0.7 vers version 0.8[modifier | modifier le code]

Version 0.8 vers version 0.9[modifier | modifier le code]

Version 0.9 vers version 0.10[modifier | modifier le code]

  • Version 0.10 ; nom de code : capitalo-simplette
  • Statut : Stop
  • Problème : cette version porte des jugements de valeur inadmissibles : détectés par Harrieta qui a reçu cette récompense :
Récompense Merci Harrieta pour ton aide, tes idées, remarques et conseils qui permettent la réalisation de l'outil Finances locales. Surgi de la nuit et du brouillard, tel l'archange Michel ou de façon plus prosaïquement un lanceur d'alerte, tu as terrassé la monstrueuse version 0.10, rebaptisée depuis la capitalo-simplette. Cette bête infâme ne prétendait-elle pas porter des jugements de valeur manichéens sur les finances locales avec son perfide système de couleurs et ternir à jamais l'image de Wikipédia ? Suite à tes remarques, elle sera métamorphosée en une v1.0 baptisée Yin yang en référence à ses pictogrammes tout en nuances. Gloire éternelle à toi ô Harrieta Clin d'œil. Additionnons nos forces, partageons nos connaissances --A+ Thierry (discuter) 18 juin 2015 à 08:45 (CEST).

Version 0.10 vers version 0.11[modifier | modifier le code]

Version 0.11 vers version 1.0.0[modifier | modifier le code]

Version 1.0.0 vers version 1.0.1[modifier | modifier le code]

Version 1.0.1 vers version 1.0.2[modifier | modifier le code]

Version 1.0.2 vers version 1.0.3[modifier | modifier le code]

Version 1.0.3 vers version 1.0.4[modifier | modifier le code]

Version 1.0.4 vers version 1.0.5[modifier | modifier le code]

Version 1.0.5 vers version 1.0.6[modifier | modifier le code]

Version 1.0.6 vers version 1.1.0[modifier | modifier le code]

Version 1.1.0 vers version 1.2.0[modifier | modifier le code]

Version 1.2.0 vers version 1.2.1[modifier | modifier le code]

Version 1.2.1 vers version 2.0.0[modifier | modifier le code]

Pour le futur[modifier | modifier le code]

  • Utilisateur:Arcyon37 6 juin 2015 à 11:45 :
    • Pas fait ! Attendre Est-il possible d'imaginer un système ou chacun pourrait, à partir d'une liste de données financières, sélectionner par exemple en cochant des cases pour générer automatiquement les tableaux et les graphiques des critères retenus ?

Articles en relation avec le sujet[modifier | modifier le code]

Notes et références[modifier | modifier le code]

  1. Pour tracer un graphique de deux variables sur une période de 13 ans, il faut consulter de 13 à 26 pages du site alize2.finances.gouv.fr
  2. Extrait d'url d'accès au site Alize2 : alize2.finances.gouv.fr/communes/eneuro/tableau.php?dep=046&type=BPS&icom=317&param=0&exercice=2013
  3. Nombre de requêtes pour une commune : 15 années (2000 à 2014) * 7 tableaux (6 tableaux de synthèse et 1 de détail) = 105