electricore-client 0.2.0

Client Python léger (httpx + pydantic) vers l'API facturiste electricore — sans polars/duckdb/fastapi

electricore-client

Client Python léger vers l'API facturiste electricore.

Dépendances de base : httpx + pydantic uniquement — pas de polars, duckdb ni fastapi. Pensé pour être consommé par souscriptions_odoo (Odoo 19) et tout intégrateur qui n'a pas besoin de tirer le moteur entier.

Lecture seule sur electricore (« Odoo tire d'electricore », ADR-0027/0012).

Installation

pip install electricore-client            # base : httpx + pydantic
pip install "electricore-client[arrow]"   # + client Arrow (DataFrames polars)

Usage

from electricore_client import ElectricoreClient

client = ElectricoreClient(url="https://electricore.example", api_key="…")

# Méta-périodes mensuelles (flux JSONL typé, sans pagination)
with client.meta_periodes(mois="2026-05-01") as stream:
    print(stream.contract_version)        # version de contrat (en-tête)
    for periode in stream:                # itère des PeriodeMeta typés
        ...

# Chronologie d'un point ou d'un contrat (union discriminée)
with client.chronologie(pdl="12345678901234") as stream:
    lignes = stream.collect()

# Calculateur TURPE variable (POST RPC, pas un stream)
resultats = client.turpe_variable([...])  # résultats indexés par id opaque

Le client Arrow historique (flux/releves/facturation/accise/cta → pl.DataFrame) vit dans electricore_client.arrow, derrière l'extra [arrow].

Conception

Voir ADR-0043.