Ouvrir le menu principal
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.

Sommaire

IntroductionModifier

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.

DescriptionModifier

RôleModifier

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 V2Modifier

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 techniquesModifier

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

Exécutables en V2Modifier

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épendancesModifier

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'utilisationModifier

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

Qualité et mesures logiciellesModifier

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 fichiersModifier

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, volumesModifier

LicenceModifier

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 V0Modifier

Statut :   Depuis le jusqu'au dans :

Phase de pré-déploiement V0Modifier

Statut :  Vote 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 V1Modifier

Statut :   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 V2Modifier

Statut :  , 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 externeModifier

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èmesModifier

  • 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.

ÉvolutionsModifier

Nommage des versionsModifier

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.5Modifier

Version 0.5 vers version 0.6Modifier

Version 0.6 vers version 0.7Modifier

Version 0.7 vers version 0.8Modifier

Version 0.8 vers version 0.9Modifier

Version 0.9 vers version 0.10Modifier

  • Version 0.10 ; nom de code : capitalo-simplette
  • Statut :  
  • Problème : cette version porte des jugements de valeur inadmissibles : détectés par Harrieta qui a reçu cette 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  . Additionnons nos forces, partageons nos connaissances --A+ Thierry (discuter) 18 juin 2015 à 08:45 (CEST).

Version 0.10 vers version 0.11Modifier

Version 0.11 vers version 1.0.0Modifier

Version 1.0.0 vers version 1.0.1Modifier

Version 1.0.1 vers version 1.0.2Modifier

Version 1.0.2 vers version 1.0.3Modifier

Version 1.0.3 vers version 1.0.4Modifier

Version 1.0.4 vers version 1.0.5Modifier

Version 1.0.5 vers version 1.0.6Modifier

Version 1.0.6 vers version 1.1.0Modifier

Version 1.1.0 vers version 1.2.0Modifier

Version 1.2.0 vers version 1.2.1Modifier

Version 1.2.1 vers version 2.0.0Modifier

Pour le futurModifier

  • Utilisateur:Arcyon37 6 juin 2015 à 11:45 :
    •     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 sujetModifier

Notes et référencesModifier

  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