aioaxlevpp

An independent asynchronous client for Axle Energy's read-only Home Assistant grid-event endpoint.

The caller supplies an aiohttp.ClientSession and an Axle Home Assistant token. await AxleClient(session, token).get_event() returns a frozen GridEvent or None when the service returns JSON null, an empty object, or an object with explicitly null start_time, end_time, and import_export fields. No account, inverter, opt-in, payment, or dispatch operations are implemented.

Authentication failures raise AxleAuthenticationError; transport failures raise AxleConnectionError; unsuccessful responses and malformed events raise AxleError. Exceptions omit response bodies and credentials. The client uses a 10-second timeout, does not follow redirects, and never closes the supplied session. Polling belongs to the caller. Axle's example uses 600 seconds.

Contract source: https://vpp.axle.energy/landing/home-assistant

The public OpenAPI document does not currently include this endpoint. A real event was verified using a development account. The explicit-null no-event response was observed from the live API and verified in Home Assistant DEV. JSON null and empty objects also have synthetic coverage. No code has been copied from the unlicensed HACS repository.

Run uv run pytest, uv run ruff check ., and uv run mypy aioaxlevpp.