Tricoteuses Légifrance

Library & tools to browse Légifrance legal open data from French Direction de l'information légale et administrative (Dila)

Tricoteuses Légifrance is free and open source software.

• software repository
• GNU Affero General Public License version 3 or greater

documentation

• Architecture
• TypeScript API
  • Main interfaces:
    • DossierLegislatif : Dossier de suivi du parcours parlementaire d'un texte législatif
    • Echeancier : Tableau de suivi des textes règlementaires nécessaires à l'application d'une loi
    • Jo : Journal officiel
    • JorfArticle : Article d'un texte publié au Journal officiel
    • JorfTexte : Texte (loi, décret, arrêté, etc) publié au Journal officiel
      • JorfTextelr : Sommaire d'un texte (loi, décret, arrêté, etc) publié au Journal officiel
      • JorfTexteVersion : texte (loi, décret, arrêté, etc) publié au Journal officiel, sans son sommaire
    • LegiArticle : Article d'un texte consolidé
    • LegiTexte : Texte (loi, décret, arrêté, etc) consolidé
      • LegiTextelr : Sommaire d'un texte (loi, décret, arrêté, etc) consolidé
      • LegiTexteVersion : texte (loi, décret, arrêté, etc) consolidé, sans son sommaire
• JSON Schemas

Legal data sources

• https://www.dila.premier-ministre.gouv.fr/repertoire-des-informations-publiques/les-donnees-juridiques
• DOLE: https://echanges.dila.gouv.fr/OPENDATA/DOLE/
• JORF: https://echanges.dila.gouv.fr/OPENDATA/JORF/
• KALI: https://echanges.dila.gouv.fr/OPENDATA/KALI/
• LEGI: https://echanges.dila.gouv.fr/OPENDATA/LEGI/

Main definitions used by these data: https://www.legifrance.gouv.fr/contenu/Media/files/lexique-api-lgf.docx Some documentation and the DTD of the XML files: https://echanges.dila.gouv.fr/OPENDATA/DTD_LEGIFRANCE/

Installation

Create database

Using Debian GNU/Linux, install PostgreSQL, then:

sudo su - postgres
createuser canutes -P # and enter the password
createdb -O canutes canutes
psql canutes
CREATE EXTENSION IF NOT EXISTS pg_trgm;
CREATE SCHEMA anomalies;
CREATE SCHEMA legifrance;
\q
exit

Install dependencies

npm install

# Since there is currently no binary build of nodegit, we need to remove it from dependencies
# to install and build it manually.
cd node_modules/
rm -Rf nodegit
git clone https://github.com/nodegit/nodegit.git
cd nodegit/
# Install dependencies & build nodegit:
npm install
cd ../../

Server Configuration

Create a .env file to set configuration variables (you can use example.env as a template). Then:

npm run configure

Datasets Initialization

mkdir -p ../dila-data/dole
cd ../dila-data/dole
git init
cd -

mkdir -p ../dila-data/jorf
cd ../dila-data/jorf
git init
cd -

mkdir -p ../dila-data/kali
cd ../dila-data/kali
git init
cd -

mkdir -p ../dila-data/legi
cd ../dila-data/legi
git init
cd -

Datasets Update

npx tsx src/scripts/download_dila_dataset.ts dole ../dila-data/
npx tsx src/scripts/download_dila_dataset.ts jorf ../dila-data/
npx tsx src/scripts/download_dila_dataset.ts kali ../dila-data/
npx tsx src/scripts/download_dila_dataset.ts legi ../dila-data/

Database Update

npx tsx src/scripts/import_dole.ts ../dila-data/
npx tsx src/scripts/import_jorf.ts ../dila-data/
npx tsx src/scripts/import_kali.ts ../dila-data/
npx tsx src/scripts/import_legi.ts ../dila-data/

# Note: Assemblee database must be updated before launching this script:
npx tsx src/scripts/associate_dossiers_legislatifs_with_assemblee.ts

Server Launch

In development mode:

npm run dev

In production mode:

npm run build
npm run preview

Development

JSON Schemas Generation

npx tsx src/scripts/generate_legifrance_json_schemas.ts
# Prettify generated JSON file.
npm run format

Note: JSON schemas are generated in file static/schemas.json from the TypeScript types re-exported by src/lib/legal/index.ts

Package Generation & Publishing

npm version patch # or major or minor
npm run package
npm publish