tulit, The Universal Legal Informatics Toolkit
tulit retrieves legislation from official sources in the EU and its Member States and turns it into legalJSON: one structured, schema-validated representation of a legal act, whatever format it was published in.
- Retrieve documents from the EU Publications Office (Cellar) and from national and regional legislation portals.
- Parse Formex 4, Akoma Ntoso, EUR-Lex HTML and national formats into the same structure: preface, preamble (citations and recitals), divisions, articles, paragraphs, conclusions and annexes.
- Address divisions, articles, paragraphs and annexes with ELI-resolvable identifiers (
cpt_II,art_5,par_2,anx_1), so a JSON fragment maps directly onto its ELI subdivision URI. - Capture amendments as structured objects (action, target act, quoted text or structure) instead of plain prose.
The Formex parser has been verified against the complete corpus of in-force EU legislation (29,790 documents): every act keeps between 97% and 103% of the source text, with no parse errors and 100% schema-valid output.
Installation
pip install tulit
tulit requires Python 3.11 or later.
Quick start
Fetch an EU act as validated legalJSON in one call:
import tulit
doc = tulit.fetch("32024R0903") # Interoperable Europe Act
article = doc["articles"][0]
print(article["eId"], article["heading"]) # art_1 Subject matter and scope
print(doc["meta"]["eli"]) # http://data.europa.eu/eli/reg/2024/903/oj
fetch downloads the act from Cellar (Formex by default, or format="xhtml" / "html"), in any language (language="FRA"), parses it and attaches its metadata: ELI, document date, in-force status and the acts it amends, repeals or corrects.
From the command line:
tulit get 32024R0903 -o 32024R0903.json
tulit get 32016R0679 --format xhtml --language FRA
tulit parse --format akn 32014L0092.akn
tulit formats
Local files are parsed through the parser registry; Akoma Ntoso variants (AKN4EU, German LegalDocML, Luxembourg) are detected automatically:
from tulit.parser.registry import get_parser
parser = get_parser("akn", file_path="32014L0092.akn")
doc = parser.parse("32014L0092.akn").to_dict()
legalJSON at a glance
{
"preface": "Regulation (EU) 2024/903 of the European Parliament and of the Council ...",
"preamble": {
"formula": "THE EUROPEAN PARLIAMENT AND THE COUNCIL OF THE EUROPEAN UNION,",
"citations": [{"eId": "cit_1", "text": "Having regard to ..."}],
"recitals": [{"eId": "rct_1", "text": "It is necessary to strengthen ..."}],
"final": "HAVE ADOPTED THIS REGULATION:"
},
"structure": [
{"eId": "cpt_1", "type": "chapter", "num": "Chapter 1",
"children": [{"eId": "art_1", "type": "article"}]}
],
"chapters": [{"eId": "cpt_1", "type": "chapter", "num": "Chapter 1", "heading": "General provisions", "parent": null}],
"articles": [
{"eId": "art_1", "num": "Article 1", "heading": "Subject matter and scope", "parent": "cpt_1",
"children": [{"eId": "par_1", "text": "1. This Regulation lays down ...", "amendment": null}]}
],
"conclusions": {"conclusion_text": "...", "signature": "..."},
"annexes": [{"eId": "anx_1", "num": "ANNEX", "heading": "...", "children": []}],
"meta": {"celex": "32024R0903", "eli": "http://data.europa.eu/eli/reg/2024/903/oj",
"date_document": "2024-03-13", "in_force": true, "amends": [], "repeals": []}
}
chapters and articles are flat lists for easy iteration; structure holds the nested skeleton of the enacting terms. The full schema is in tulit/parser/legaljson_schema.json.
Supported sources
| Jurisdiction | Source | Client | Parsed formats |
|---|---|---|---|
| European Union | Cellar / EUR-Lex | CellarClient |
Formex 4, Akoma Ntoso (AKN4EU), XHTML, legacy HTML, legislative proposals |
| Finland | Finlex | FinlexClient |
Akoma Ntoso |
| France | Légifrance | LegifranceClient |
Légifrance JSON |
| Germany | Rechtsinformationssystem | GermanyClient |
LegalDocML (Akoma Ntoso) |
| Ireland | Irish Statute Book | IrishStatuteBookClient |
download only |
| Italy | Normattiva | NormattivaClient |
Akoma Ntoso |
| Italy (Veneto) | Bollettino Ufficiale | VenetoClient |
HTML |
| Luxembourg | Legilux | LegiluxClient |
Akoma Ntoso |
| Malta | Legislation Malta | MaltaLegislationClient |
download only |
| Portugal | Diário da República | PortugalDREClient |
download only |
| Spain | BOE | BOEClient |
BOE XML |
Documentation
Full documentation is available at tulit-docs.readthedocs.io. Release notes are in CHANGELOG.md.
Development
git clone https://github.com/AlessioNar/tulit.git
cd tulit
poetry install
poetry run pytest tests/unit
End-to-end tests in tests/e2e call the live sources and need network access.
License
tulit is released under the European Union Public Licence v1.2.
Metadata
Release files for tulit 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tulit-0.7.0.tar.gz | 207.6 kB | With provenance | Details for tulit-0.7.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tulit-0.7.0-py3-none-any.whl | Python 3 | none | any | Details for tulit-0.7.0-py3-none-any.whl |
Total release size: 442.2 kB
Release files / tulit-0.7.0.tar.gz
| Download URL | tulit-0.7.0.tar.gz |
|---|---|
| Size | 207.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fe63ee32621dac48af96fd5e9b55270fb623142b7abf2e6c4d09c757459ebf84
|
|
BLAKE2b-256 checksum How to use checksums |
a312c822fedb6576e37857b9a626c78bec08af5ede5bb18b2b087654b763854f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logRelease files / tulit-0.7.0-py3-none-any.whl
| Download URL | tulit-0.7.0-py3-none-any.whl |
|---|---|
| Size | 234.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c091b1f8899c271a859b30e8179c17315c2f7480bf5b66729b6687a768f14856
|
|
BLAKE2b-256 checksum How to use checksums |
e90bca87e61bb81f248f48e974e3bded9b72abfa0e9bc3bf7b688b57b3e8b610
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logSecurity for tulit 0.7.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for tulit-0.7.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.