essent-dynamic-pricing 0.3.1

Async client for Essent dynamic energy prices

Essent dynamic pricing client

Async client for Essent's public dynamic price API, returning normalized electricity and gas tariffs ready for Home Assistant or other consumers. Tariff start/end values are returned as timezone-aware datetimes in the Europe/Amsterdam timezone.

Usage

import asyncio
from aiohttp import ClientSession
from essent_dynamic_pricing import EssentClient

async def main():
    async with ClientSession() as session:
        client = EssentClient(session=session)
        data = await client.async_get_prices()

        # Electricity data is always available
        print(f"Electricity: {data.electricity.min_price} - {data.electricity.max_price} €/{data.electricity.unit}")

        # Gas data may be None if unavailable from API
        if data.gas:
            print(f"Gas: {data.gas.min_price} - {data.gas.max_price} €/{data.gas.unit}")
        else:
            print("Gas data not available")

asyncio.run(main())

Breaking Changes in v0.3.0

The gas field in EssentPrices is now Optional[EnergyData] instead of required. This handles cases where the Essent API temporarily doesn't provide gas data. Electricity data is still required.

Before (v0.2.x):

data = await client.async_get_prices()
print(data.gas.min_price)  # Always worked

After (v0.3.0):

data = await client.async_get_prices()
if data.gas:
    print(data.gas.min_price)  # Check for None first

Development / tests

1. Install dev deps (adds pytest and pytest-asyncio):
   pip install -e .[test]
2. Run tests:
   pytest