MetsLesLiens

Search links in French legal texts.

This version in JavaScript uses PEG.js. A live environment to debug and improve the grammar is available at https://archeo-lex.fr/metslesliens/.

The Python version (older) is available at https://framagit.org/parlement-ouvert/metslesliens.

Install

npm install metslesliens

Use

Library

API is still unstable.

The following code will return the semantic tree.

const util = require( "util" );
const metslesliens = require( "metslesliens" );
 
// Inputs
const expression = "l’article 7 du code pénal";
 
const links = metslesliens.getLinks( expression, metslesliens.getParser() );
console.log( util.inspect( links, { depth: null, colors: true } ) );

The semantic tree (DuraLex-like) is still in an alpha version, the specifications can still evolve.

Executable

Still unstable.

metslesliens [--semantic] EXPRESSION|FILE|DIRECTORY

Depending on the argument:

• EXPRESSION: returns the list of recognised links; the grammar results are fully expanded.
• FILE: returns the list of recognised links; only the first level of each JSON structure is displayed (captured expressions and locations).
• DIRECTORY: recursively search all .md files in the directory and subdirectories; displays number of recognised links in each file, and statistics for all files.

If --semantic is activated, the semantic tree (DuraLex-like) is returned (only useful when EXPRESSION or FILE is given).

If --tracer or --tracer-full is activated, the tracer is activated (either a light tracer for recognised rules, either the full tracer with recognised and failed rules (use not recommanded for FILE and DIRECTORY arguments).

Français

Recherche les liens dans les textes de loi français.

Cette version en JavaScript utilise PEG.js. Un environnement interactif pour débugger et améliorer la grammaire est disponible sur https://archeo-lex.fr/metslesliens/.

La version Python (plus ancienne) est disponible sur https://framagit.org/parlement-ouvert/metslesliens.

Licence

La licence est WTFPL 2.0. Au-delà du nom provocateur, cette licence permet une redistribution et réutilisation sans limites du code, permettant que les meilleures idées puissent être réutilisées et être utiles à la société.

Quoique la licence ne l’impose aucunement, les réutilisateurs de cette librairie sont invités à se faire connaître, dans les buts : 1) d’évaluer la popularité de la librairie – et donc de motiver les développeurs et donc de pérenniser le développement ; 2) d’éventuellement être prévenus avant un changement non-rétro-compatible ; 3) d’éviter que le premier contact ne soit pas à l’occasion d’un bug, ce qui n’est pas forcément agréable. Dans la mesure du possible et des envies, les réutilisateurs sont également encouragés à participer au développement de la librairie.