aquavena-sdk 0.1.0

SDK Python pour scraper les régimes alimentaires Aquavena (Nouvelle-Calédonie)

aquavena-sdk

SDK Python + CLI pour scraper les menus et tarifs d'Aquavena — service de livraison de repas diététiques en Nouvelle-Calédonie.

Installation

pip install aquavena-sdk
# ou avec uv
uv add aquavena-sdk

CLI

# Lister tous les régimes disponibles
aquavena list

# Menus d'un régime (toutes les semaines publiées)
aquavena menus aqua-méditerranéen
aquavena menus aqua-chrono-diet

# Grille tarifaire complète (tous régimes)
aquavena tarifs

SDK

from aquavena_sdk import AquavenaClient

with AquavenaClient() as client:

    # Lister les régimes
    regimes = client.list_regimes()
    for r in regimes:
        print(r.name, r.slug, r.image_url)

    # Menus d'un régime
    menu = client.get_menus("aqua-méditerranéen")
    print(menu.description)
    for day in menu.days:
        print(day.date, day.label)
        for dish in day.midi():
            print("  midi :", dish.description)
        for dish in day.soir():
            print("  soir :", dish.description)

    # Tarifs
    tarifs = client.get_tarifs()
    for rt in tarifs:
        print(rt.regime)
        for item in rt.items:
            print(f"  {item.label}: {item.price_ttc} XPF TTC")

Filtrer les jours à venir

from datetime import date
from aquavena_sdk import AquavenaClient

with AquavenaClient() as client:
    menu = client.get_menus("aqua-chrono-diet")

upcoming = [d for d in menu.days if date.fromisoformat(d.date) >= date.today()]

Modèles

Classe	Champs principaux
Regime	name, slug, description, url, image_url
RegimeMenu	slug, description, days: list[DayMenu]
DayMenu	date, label, formule, plats, supplements, boissons
Dish	meal_time: MealTime, description
MealTime	MIDI, SOIR, GOURMET_MIDI, GOURMET_SOIR
RegimeTarif	regime, table_id, items: list[TarifItem]
TarifItem	label, price_ht, price_ttc (XPF)

Régimes disponibles

Slug	Régime
aqua-bien-être-family	Aqua Bien Être / Family
aqua-chrono-diet	Aqua Chrono Diet
aqua-chrono-végé	Aqua Chrono Végé
aqua-méditerranéen	Aqua Méditerranéen
aqua-gourmand	Aqua Gourmand
aqua-végé	Aqua Végé
aqua-low-carb	Aqua Low Carb
aquasportif	Aqua'Sportif

Développement

git clone https://github.com/adriens/aquavena
cd aquavena/aquavena-sdk
uv sync
uv run pytest
uv run aquavena list

Licence

MIT