pyeauidf 1.2.0

Python client for L'eau d'Ile-de-France (SEDIF) water consumption data

pyeauidf

Python client for L'eau d'Île-de-France (SEDIF) water consumption data.

Fetches daily, weekly, or monthly water consumption history directly via the Salesforce Aura API — no browser or Selenium required.

Disclaimer

This integration relies on scraping the SEDIF customer portal. It is not based on an official API, so any change to the website's structure or authentication flow may break it without notice.

This integration was built with the help of Claude (Anthropic).

Home Assistant

A ready-to-use Home Assistant integration built on top of this library is available: ha_eauidf.

Installation

pip install .

Requires Python 3.10+ and aiohttp.

Usage

CLI

# Last 7 days (default)
pyeauidf -u [e-mail] -p password

# Custom number of days
pyeauidf -u [e-mail] -p password --days 30

# Weekly aggregation
pyeauidf -u [e-mail] -p password --days 90 --step weekly

# Credentials via environment variables
export EAUIDF_USERNAME=[e-mail]
export EAUIDF_PASSWORD=password
pyeauidf

Python

import asyncio
from pyeauidf import EauIDFClient
from pyeauidf.client import TimeStep
from datetime import date

async def main():
    async with EauIDFClient("[e-mail]", "password") as client:
        await client.login()

        # Daily consumption (last 90 days by default)
        result = await client.get_daily_consumption()
        for r in result.records:
            cost = result.daily_cost(r)
            print(f"{r.date:%Y-%m-%d}: {r.consumption_liters:.0f}L — {cost:.2f}€")

        # Total cost
        print(f"Total: {result.total_cost:.2f}€ ({result.price_per_m3:.4f} €/m³)")

        # Weekly or monthly
        result = await client.get_daily_consumption(time_step=TimeStep.WEEKLY)

        # Custom date range
        result = await client.get_daily_consumption(
            start_date=date(2026, 1, 1),
            end_date=date(2026, 3, 1),
        )

asyncio.run(main())

Data model

get_daily_consumption() returns a ConsumptionData object:

Field	Type	Description
records	list[ConsumptionRecord]	Individual consumption measurements
price_per_m3	float	Average water price (€/m³)
daily_cost(record)	float	Cost in euros for a single record
total_cost	float	Total cost in euros for all records

Each ConsumptionRecord contains:

Field	Type	Description
date	datetime	Timestamp of the reading
consumption_liters	float	Water consumed (liters)
meter_reading	float	Cumulative meter reading (m³)
is_estimated	bool	Whether the value is estimated

How it works

The library authenticates against the Salesforce Experience Cloud portal that powers L'eau d'Île-de-France, then calls the same Aura API endpoints that the website uses:

1. Login via LightningLoginFormController
2. Follow frontdoor.jsp to establish session cookies
3. Call Apex actions (LTN015_ICL_ContratConsoHisto.getData) for consumption data