aelf-api-client 1.0.0

Python client for the AELF API (https://api.aelf.org/)

aelf-api-client

An unofficial Python client for interacting with the AELF API. This library provides an easy-to-use interface for fetching liturgical information from the AELF API.

Table of contents

• aelf-api-client
  • Table of contents
  • Features
  • Installation
  • Usage
  • Available Methods:
  • Development
    • Setting Up the Local Environment
    • Running Tests
    • Code Formatting and Linting
  • Contributing
  • License
  • Links

Features

• Fetch liturgical information for a specific date and zone.
• Retrieve liturgical entities (masses, complines, lauds, readings, none, sext, terce or vespers) for a specific date and zone.
• Built with aiohttp for asynchronous requests.
• Validates API responses using pydantic models.

Installation

Package is directly available from the Pypi repositories:

pip install aelf-api-client

Usage

Example: Fetch masses informations

from datetime import datetime

import asyncio

from aelf_api_client import AELFClient
from aelf_api_client.schemas.enums import ZonesEnum

async def main():
    client = AELFClient()
    date = datetime.now()
    zone = ZonesEnum.FRANCE

    # Fetch masses
    masses = await client.request_masses(date, zone)
    print(masses)

asyncio.run(main())

Available Methods:

The AELFClient provides the following methods:

• request_informations(date: datetime, zone: ZonesEnum) -> InformationsResponseModel
• request_masses(date: datetime, zone: ZonesEnum) -> MassesResponseModel
• request_complines(date: datetime, zone: ZonesEnum) -> CompliensResponseModel
• request_lauds(date: datetime, zone: ZonesEnum) -> LaudsResponseModel
• request_readings(date: datetime, zone: ZonesEnum) -> ReadingsResponseModel
• request_none(date: datetime, zone: ZonesEnum) -> NoneResponseModel
• request_sext(date: datetime, zone: ZonesEnum) -> SextResponseModel
• request_terce(date: datetime, zone: ZonesEnum) -> TerceResponseModel
• request_vespers(date: datetime, zone: ZonesEnum) -> VespersResponseModel

Each method fetches data for a specific liturgical endpoint and returns a validated response model.

Development

Setting Up the Local Environment

git clone [e-mail]:thamin-i/aelf-api-client.git
cd aef-client
make install

Running Tests

Tests are written using pytest. To run the tests:

poetry run pytest

Code Formatting and Linting

This project uses ruff, isort, and pylint for formatting and linting. To check the code:

make format_code && make check_code

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bugfix.
3. Write tests for your changes.
4. Run the tests to ensure everything works.
5. Submit a pull request.

License

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

Links

• Pypi: Project
• Homepage: AELF Python Client
• Issues: https://github.com/thamin-i/aelf-api-client/issues