bulletin-fetcher 0.1.1

A Python library for programmatic access to EU official bulletins

bulletin-fetcher

Description

bulletin-fetcher is a Python library to query and fetch official bulletins. It makes easier to work with the Official Journal Data in python, providing a high-level API and data models. Current support:

• Official Journal of the European Union (DOUE) via EUR-Lex / Cellar SPARQL endpoint.

Key Features

• Query official acts from Legal Institutions.
• Works with Python objects instead of raw JSON and gets away from Web Services.
• Easier for data manipulation and integration in notebooks through Python models.
• Keep a clean architecture with a public API layer and a data connector layer.

Installation

Install from PyPI:

pip install bulletin-fetcher

Usage

Quick Example

Fetch acts for a publication date:

from bulletin.doue.api.client import DoueBulletinClient

client = DoueBulletinClient()
acts = client.get_acts(date="2025-03-31")

print(f"Total acts: {len(acts)}")
if acts:
 first = acts[0]
 print(first.celex_uri)
 print(first.title)

Standalone Script

The repository includes a runnable script:

python scripts/run_doue.py

Contributing

Contributions are welcome! Please follow the standard steps:

1. Fork the project.
2. Create a branch for your feature (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For any questions or suggestions, feel free to reach out to the author:

• Author: Diego González Suárez
• Email: [e-mail]
• GitHub: diegoglezsu

---