wisehouse-client 0.1.2

Unofficial client for the WiseHouse building-management API. Not affiliated with, endorsed by, or supported by WiseHouse / Neware.

wisehouse-client

Unofficial. Not affiliated with, endorsed by, or supported by WiseHouse / Neware.

Python client for the WiseHouse API: doors, facility bookings, and info pages. Built for a separate Home Assistant integration, but works standalone too.

Install

uv add wisehouse-client
# or: pip install wisehouse-client

The .env/load_credentials convenience needs the optional dotenv extra:

uv add "wisehouse-client[dotenv]"

Usage

from wisehouse_client import WisehouseClient, Credentials

client = WisehouseClient(Credentials(username="...", password="...", brf="your-brf"))
client.login()
for door in client.list_available_doors():
    print(door.door_id, door.name)

The API base is per-association: https://<brf>.wisehouse.se/.

login() is optional (since 0.1.2): the client establishes a session automatically on the first request. Call it explicitly only when you want to validate credentials up front — it raises AuthError on a bad username/password.

Async

AsyncWisehouseClient mirrors the sync API with await and accepts an optional httpx.AsyncClient (e.g. Home Assistant's shared client). A client it creates itself is closed on aclose() / async with; an injected one is left open.

from wisehouse_client import AsyncWisehouseClient, Credentials

async with AsyncWisehouseClient(creds) as client:
    await client.login()
    doors = await client.list_available_doors()

The client establishes its session on first use and transparently re-logs in and retries once when the session token later expires (server codes E010/E011/E013). The side-effecting methods (open_door, make_booking, remove_booking, infopage_vote) act on the real building system, so call them deliberately.

Development

uv sync
uv run pytest

Tests run offline via httpx.MockTransport and recorded fixtures.