juris

Swedish Parliament

Swedish Government

Courts

Authorities

EU Law

A command-line tool for collecting and normalizing Swedish legal documents from official government sources.

Sweden has a wealth of public legal information — laws, government bills, public inquiries, court decisions — scattered across multiple government websites and APIs with inconsistent formats. juris collects documents from these sources, normalizes them into a unified format, and saves them as browsable, version-controlled files (Markdown + JSON). Think of it as a git-native open database for Swedish law.

Features

• 8 data sources covering Swedish parliament, government, courts, authorities, and EU law
• 21 document types from bills and motions to court decisions and EU regulations
• Dual output format — Markdown (human-readable, browsable on GitHub) and JSON (machine-parseable)
• Incremental collection with state tracking to resume where you left off
• Async I/O with built-in rate limiting to respect source servers
• PDF text extraction from document attachments
• Date and session filtering for targeted collection

Data sources

Document types

Swedish Parliament

Swedish Government

Courts

Authorities

EU law

Installation

pip install -e .

Requires Python 3.11 or later.

Usage

# Collect government bills from the 2024/25 parliamentary session
juris collect riksdagen --type prop --session 2024/25

# Collect SOU reports published since a specific date
juris collect riksdagen --type sou --since 2024-01-01

# Collect from the government website with a limit
juris collect regeringen --type prop --session 2024/25 --limit 5

# Collect Supreme Court decisions
juris collect domstol --type nja --since 2024-01-01

# Collect agency regulations
juris collect lagrummet --type foreskrift --limit 10

# Collect EU regulations
juris collect eur_lex --type eu_reg --since 2024-01-01

# Check collection progress
juris status

# Count collected documents
juris stats

Options

Output format

Each document is saved in two formats:

Markdown (human-readable, browsable on GitHub):

---
doc_id: "prop-2024/25:208"
doc_type: prop
title: "Ett mer heltäckande straffansvar vid angrepp på företagshemligheter"
date: "2025-09-08"
source: riksdagen
department: Justitiedepartementet
session: "2024/25"
source_url: "https://..."
---

# Ett mer heltäckande straffansvar vid angrepp på företagshemligheter

Proposition 2024/25:208

[full text...]

JSON (machine-readable, full metadata):

{
  "doc_id": "prop-2024/25:208",
  "doc_type": "prop",
  "title": "Ett mer heltäckande straffansvar...",
  "date": "2025-09-08",
  "text": "...",
  "source": "riksdagen",
  "attachments": [...]
}

Documents are organized by type and session:

data/
├── prop/
│   └── 2024-25/
│       ├── prop-2024-25_208.json
│       └── prop-2024-25_208.md
├── sou/
│   └── 2024/
├── nja/
└── .state/

Project structure

src/juris/
├── cli.py              # Command-line interface (Click)
├── models.py           # Document data models (Pydantic)
├── storage.py          # File storage (JSON + Markdown)
├── state.py            # Incremental collection state
├── pdf.py              # PDF text extraction
├── utils.py            # Shared utilities
└── collectors/
    ├── base.py         # Abstract base collector
    ├── riksdagen.py    # Riksdagen API
    ├── regeringen.py   # Regeringen.se scraper
    ├── domstol.py      # Court decisions API
    ├── jo_jk.py        # JO/JK decisions
    ├── lagrummet.py    # Agency regulations
    ├── eurlex.py       # EUR-Lex SPARQL
    ├── curia.py        # CJEU SPARQL
    └── hudoc.py        # ECtHR API

Development

# Install with dev dependencies (or use: make install)
pip install -e ".[dev]"

# Lint and format check
ruff check src/ tests/
ruff format --check src/ tests/

# Type check (strict mode)
mypy src/

# Run unit tests
pytest tests/ --ignore=tests/test_e2e.py

# Or use the Makefile shortcuts
make lint        # Lint + format check
make typecheck   # Type check
make test        # Unit tests
make format      # Auto-format code
make test-e2e    # End-to-end tests (hits live APIs)

Contributing

See CONTRIBUTING.md for development setup, coding standards, and how to add new collectors.

Please report security vulnerabilities via GitHub's private reporting — see SECURITY.md for details.

This project follows the Contributor Covenant v2.1.

License

MIT