Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Legilibre/Archeo-Lex
Pure Histoire de la Loi française – Git + Markdown
https://github.com/Legilibre/Archeo-Lex
france git laws legi lois opendata python
Last synced: 3 months ago
JSON representation
Pure Histoire de la Loi française – Git + Markdown
- Host: GitHub
- URL: https://github.com/Legilibre/Archeo-Lex
- Owner: Legilibre
- License: wtfpl
- Created: 2014-08-04T13:33:28.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2019-03-10T21:25:16.000Z (over 5 years ago)
- Last Synced: 2024-07-15T15:37:59.248Z (4 months ago)
- Topics: france, git, laws, legi, lois, opendata, python
- Language: Python
- Homepage: https://archeo-lex.fr
- Size: 371 KB
- Stars: 98
- Watchers: 20
- Forks: 17
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Archéo Lex
==========
_Archéo Lex_ – _Pure 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](http://legifrance.gouv.fr).
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](https://archeo-lex.fr)**
Utilisation
-----------
### Résultat et exemple d’utilisation
Pour l’exemple, le code de la propriété intellectuelle peut être consulté sur Github : . 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](https://github.com/Seb35/CPI/commit/50283dda63cef5a45a992d649b4d2ff2b1f7b546)), 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](https://pypi.python.org/pypi/legi) est désormais obligatoire.
### Lancement
Les données nécessaires (textes de loi et métadonnées associées) sont disponibles sur (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:
```Shell
python3 -m legi.download ./tarballs
python3 -m legi.tar2sqlite cache/sql/legi.sqlite ./tarballs
```
Le programme principal se lance en ligne de commande :
```Shell
./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](http://www.lafabriquedelaloi.fr), à [Légifrance](http://legifrance.gouv.fr), aux sites du [Sénat](http://www.senat.fr) ou de l’[Assemblée nationale](http://www.assemblee-nationale.fr) (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](http://legifrance.gouv.fr) pour l’utile présentation actuelle de l’information légale et pour le guide de légistique
* [DILA](http://www.dila.premier-ministre.gouv.fr) 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](http://www.regardscitoyens.org) (et d’autres ?) pour avoir poussé à la [publication des bases de données de l’information légale](http://www.regardscitoyens.org/apprenons-des-echecs-de-la-dila-episode-1-comment-faire-de-lopen-data), 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](http://www.wtfpl.net) avec clause de non-garantie. Voir le fichier COPYING pour les détails.
### Contact
Sébastien Beyou ([courriel](mailto:[email protected])) ([site](http://blog.seb35.fr))
### Liens
* [Légifrance](http://legifrance.gouv.fr), service officiel de publication de l’information légale française sur l’internet
* [La Fabrique de la Loi](http://www.lafabriquedelaloi.fr), visualisation de l’évolution des projets de lois, comportant également un dépôt Git des projets de lois
* [Direction de l’information légale et administrative (DILA)](http://www.dila.premier-ministre.gouv.fr), direction responsable de la publication du JO et assurant la diffusion de l’information légale
* [Téléchargement des bases de données d’information légale française](http://rip.journal-officiel.gouv.fr/index.php/pages/juridiques)
* [Dépôt Git d’Archéo Lex](https://github.com/Seb35/Archeo-Lex)
* [Dépôt Git d’exemple avec le Code de la propriété intellectuelle](https://github.com/Seb35/CPI)
* [Billet de blog introductif](http://blog.seb35.fr/billet/Archéo-Lex,-Pure-Histoire-de-la-Loi-française,-pour-étudier-son-évolution)