pyeauidf 0.1.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.

Installation

pip install .

Requires Python 3.10+ and requests.

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

from pyeauidf import EauIDFClient
from pyeauidf.client import TimeStep
from datetime import date, timedelta

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

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

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

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

Data model

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