Skip to content

Latest commit

 

History

History
164 lines (109 loc) · 9.69 KB

README.md

File metadata and controls

164 lines (109 loc) · 9.69 KB

Archéo Lex

Archéo LexPure Histoire de la Loi française – permet de naviguer facilement entre les différentes versions d’un texte législatif français, et vient en complément à la mise à disposition des textes offerte par Légifrance.

Ainsi, chaque texte législatif (loi, code, constitution, etc.) est :

  1. disponible sur un seul fichier, permettant des recherches faciles sur l’intégralité du texte,
  2. dans une syntaxe minimaliste permettant de structurer le texte, et pouvant être retransformée en page HTML si besoin,
  3. versionné sous Git, permettant d’utiliser toute sa puissance pour faire des comparaisons, pour rechercher dans l’historique et pour avoir une présentation lisible.

Site de présentation

Utilisation

Résultat et exemple d’utilisation

Pour l’exemple, le code de la propriété intellectuelle peut être consulté sur Github : https://github.com/Seb35/CPI/blob/master/Code%20de%20la%20propriété%20intellectuelle.md. Il est affiché ici dans sa dernière version.

Vous pouvez voir l’historique des versions du code en cliquant sur History dans l’en-tête du fichier, sur la droite, puis cliquer sur une des versions pour afficher les changements effectués et entrés en vigueur ce jour-là.

Sur une page affichant les différences entre versions (exemple), il est surtout affiché les modifications faites sur le texte, mais pas l’entièreté du texte. Les lignes sur fond blanc sont le contexte, identique entre une version et la suivante, et cela sert à se situer dans le texte. Il peut être ajouté plus de contexte en cliquant sur la flèche à côté des numéros de lignes. Les lignes sur fond rose correspondent au texte de l’ancienne version et celles sur fond vert correspondent au texte entrant en vigueur à partir de cette version. Pour voir l’entièreté de cette version (à cette date d’entrée en vigueur), cliquez sur View dans l’en-tête du fichier, à droite.

Installation

  • Installer les paquets Debian suivants :
    apt-get install -y libarchive13 python3-pip git htop sqlite3
    apt-get install -y python3-dev libxml2-dev libxslt1-dev zlib1g-dev python3-setuptools python3-wheel
    
  • Télécharger Archéo Lex :
    git clone https://github.com/Legilibre/Archeo-Lex.git
    
  • Installer les paquets Python avec
    sudo pip3 install -r requirements.txt
    

Pour information, les paquets suivants sont disponibles sur Debian stretch :

  • python3-tqdm
  • python3-docopt
  • python3-html2text
  • python3-gitlab

La liste complète des modules utilisés est disponible au moyen de scripts/liste-paquets.sh (sauf lxml, optionnel mais recommandé).

L’utilisation du programme legi.py est désormais obligatoire.

Lancement

Les données nécessaires (textes de loi et métadonnées associées) sont disponibles sur http://rip.journal-officiel.gouv.fr/index.php/pages/juridiques (données LEGI), données qui seront téléchargées au cours du processus (attention : environ 5 Gio).

La première étape est de télécharger la base LEGI et de créer la base de données avec legi.py:

    python3 -m legi.download ./tarballs
    python3 -m legi.tar2sqlite cache/sql/legi.sqlite ./tarballs

Le programme principal se lance en ligne de commande :

    ./archeo-lex --textes=LEGITEXT000006069414

La liste complète des paramètres s’affiche avec la commande ./archeo-lex --aide.

Chacune des étapes peut être appelée de façon indépendante :

  • --exporterlegi : assemble les textes et créer les versions

Noter que Archéo Lex avait auparavant plusieurs étapes, mais une grande partie a désormais été déléguée à legi.py.

Développement

Ce programme a été initialement (début août 2014) développé en 5 jours avec l’ambition d’être un prototype opérationnel et de qualité correcte. Toutefois, pour rendre ce programme et son résultat plus agréable à utiliser, les points suivants devraient être travaillés (par ordre d’importance approximatif) :

  1. téléchargement automatique des bases LEGI (et autres) et de leurs mises à jour incrémentales
  2. intégration des modifications d’historique (orthographe, typographie, coquilles, etc.) quand les mises à jour le demandent (à étudier)
  3. vérifier plus en profondeur la qualité des résultats (par exemple dans le code des assurances il y a actuellement une différence vide vers le début)
  4. faire expérimenter la syntaxe Markdown et autres éléments de syntaxe à des publics non-informaticiens et réfléchir à l’améliorer (cf point 6)
  5. écrire la grammaire exacte du sous-ensemble Markdown utilisé et des autres éléments de syntaxe utilisés (cf point 4)
  6. documenter plus et mieux
  7. ajouter des tests unitaires
  8. réfléchir à une façon d’intégrer à Git les textes pré-1970 (inféfieurs à l’epoch, refusés par Git, par ex LEGITEXT000006070666)
  9. création ou adaptation d’interfaces de visualisation (cf point 14)
  10. ajout de branches (orphelines) Git avec liens vers les autres textes (liens soit juste mentionnés en-dessous de l’article comme sur Légifrance, soit au sens Markdown+Git similairement à Légifrance)
  11. travail sur les autres bases (KALI pour les conventions collectives, JORF pour le journal officiel -- ce dernier n’a pas de versions à ma connaissance mais demanderait juste à être transformé en Markdown)
  12. mettre les dates de commit à la date d’écriture ou de publication du texte modificateur (à réfléchir) (attention : cette 2e date peut être avant, après ou identique à la date d’entrée en vigueur) pour créer des visualisations intégrant ces différences de dates
  13. mise en production d’un service web qui mettrait à jour quotidiennement les dépôts Git
  14. création d’un site web permettant la visualisation des modifications, proposerait des liens RSS, etc. de façon similaire à La Fabrique de la Loi, à Légifrance, aux sites du Sénat ou de l’Assemblée nationale (cf point 9)

Nouvelle interface

from __future__ import unicode_literals
import marcheolex.exports, legi.utils, datetime
from marcheolex.FabriqueArticle import FabriqueArticle
from marcheolex.FabriqueSection import FabriqueSection;

# Syntaxe utilisée
md = marcheolex.exports.Markdown()

# Organisation des fichiers utilisée
fu = marcheolex.exports.FichierUnique()
fu.syntaxe = md
fu.fichier = 'truc'
fu.extension = '.md'

# Stockage des fichiers utilisé
sf = marcheolex.exports.StockageGitFichiers()
sf.organisation = fu

db = legi.utils.connect_db('cache/sql/legi.sqlite')
fa = FabriqueArticle( db, sf, True )
fs = FabriqueSection( fa ); 

fa.obtenir_texte_article( 3, 'LEGIARTI000030127268', datetime.date(1970,1,1), datetime.date(2038,1,1), 'VIGUEUR')

fs.obtenir_texte_section( 3, 'LEGISCTA000018048141', 'LEGITEXT000006069565', datetime.date( 1997, 7, 27 ), None )

Informations complémentaires

Remerciements

  • Légifrance pour l’utile présentation actuelle de l’information légale et pour le guide de légistique
  • DILA pour la très bonne qualité des métadonnées et pour la publication de (presque toutes les) bases de données de l’information légale
  • Regards Citoyens (et d’autres ?) pour avoir poussé à la publication des bases de données de l’information légale, disponible depuis juillet 2014, la réalisation de ce programme s’en est trouvée grandement facilitée (par rapport au téléchargement de tout Légifrance) (note : au début de ce projet, je n’étais pas au courant que les bases de données n’étaient disponibles gratuitement que depuis un mois, j’arrive tout juste réellement dans le monde de l’Open Data)

Avertissements

Les dépôts Git résultats de ce programme n’ont en aucune manière un caractère officiel et n’ont reçu aucune reconnaissance de quelque sorte que ce soit d’une instance officielle. Il n’ont d’autre portée qu’informative et d’exemple. Pour les versions d’autorité, se référer au Journal officiel de la République française.

Licence

Ce programme est sous licence WTFPL 2.0 avec clause de non-garantie. Voir le fichier COPYING pour les détails.

Contact

Sébastien Beyou (courriel) (site)

Liens