Skip to main content

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 email@example.com -p password

# Custom number of days
pyeauidf -u email@example.com -p password --days 30

# Weekly aggregation
pyeauidf -u email@example.com -p password --days 90 --step weekly

# Credentials via environment variables
export EAUIDF_USERNAME=email@example.com
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("email@example.com", "password") as client:
        await client.login()

        # Active contracts; the number is stable, the API id can change
        for contract in await client.get_active_contracts():
            print(contract.number)

        # 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),
        )

        # A specific contract (the first active one is used by default)
        contracts = await client.get_active_contracts()
        result = await client.get_daily_consumption(contract=contracts[0])


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

get_active_contracts() returns a list of Contract:

Field Type Description
contract_id str Opaque API identifier, can change over time
number str Contract number shown to the customer, stable

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

Metadata

Release files for pyeauidf 2.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyeauidf 2.0.0
File Size Uploaded Provenance Actions
pyeauidf-2.0.0.tar.gz 22.9 kB With provenance Details for pyeauidf-2.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pyeauidf 2.0.0
File Interpreter ABI Platform Actions
pyeauidf-2.0.0-py3-none-any.whl Python 3 none any Details for pyeauidf-2.0.0-py3-none-any.whl

Total release size: 39.2 kB

Release files / pyeauidf-2.0.0.tar.gz

Download URL pyeauidf-2.0.0.tar.gz
Size 22.9 kB
Tags Source
SHA-256 checksum
How to use checksums
cc5239e542a8ba029d44f13cb5bdb6a4911e8219e38a2ca0a2d17103ead34fc0
BLAKE2b-256 checksum
How to use checksums
00dbad0c866249012b1fe5778f8fe4079f5b7189a86e9589191c64f8709b02d7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.

Transparency log

Release files / pyeauidf-2.0.0-py3-none-any.whl

Download URL pyeauidf-2.0.0-py3-none-any.whl
Size 16.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d5bbd7eb0a48ae98d6dcb8e278812c42852ea30d93dc4f7ef2a9f7b03a5b24e7
BLAKE2b-256 checksum
How to use checksums
9a7ce2b33af579578282cd448c8c3b96779f4aa3c97b2766cd25ac3a5b5c2a8c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.

Transparency log

Security for pyeauidf 2.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for pyeauidf-2.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page