Metadata-Version: 2.2
Name: weheat
Version: 2025.2.13
Summary: Weheat Backend client
Home-page: https://github.com/wefabricate/wh-python
Author: Jesper Raemaekers
Author-email: jesper.raemaekers@wefabricate.com
License: MIT
Keywords: OpenAPI,OpenAPI-Generator,Weheat Backend
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: urllib3<2.1.0,>=1.25.3
Requires-Dist: python-dateutil
Requires-Dist: aiohttp>=3.0.0
Requires-Dist: aiohttp-retry>=2.8.3
Requires-Dist: pydantic>=2
Requires-Dist: typing-extensions>=4.7.1
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: requires-dist
Dynamic: summary

# Weheat backend client

This is a client for the Weheat backend. It is automatically generated from the OpenAPI specification.

## Requirements.

Python 3.7+

## Installation & Usage

You can install directly using:

```sh
pip install weheat
```

Then import the package:

```python
import weheat
```



## Getting Started

After installation, you can now use the client to interact with the Weheat backend. Note that all methods are async as of version 2025.1.15.

```python
import asyncio
import datetime
from keycloak import KeycloakOpenID  # install with pip install python-keycloak
from weheat import ApiClient, Configuration, HeatPumpApi, HeatPumpLogApi, EnergyLogApi, UserApi

auth_url = 'https://auth.weheat.nl/auth/'
api_url = 'https://api.weheat.nl'
realm_name = 'Weheat'
my_client_id = 'WeheatCommunityAPI' # client ID and secret provided by Weheat
my_client_secret = ''
username = '' # username and password used for the online portal
password = ''
my_heat_pump_id = '' # your heat pump UUID


async def demo():
    keycloak_open_id = KeycloakOpenID(server_url=auth_url,
                                      client_id=my_client_id,
                                      realm_name=realm_name,
                                      client_secret_key=my_client_secret)

    token_response = keycloak_open_id.token(username, password)
    keycloak_open_id.logout(token_response['refresh_token'])

    config = Configuration(host=api_url, access_token=token_response['access_token'])
    async with ApiClient(configuration=config) as client:
        response = await UserApi(client).api_v1_users_me_get_with_http_info()

        if response.status_code == 200:
            print(f'My user: {response.data}')

        response = await HeatPumpApi(client).api_v1_heat_pumps_get_with_http_info()

        if response.status_code == 200:
            print(f'My heat pump: {response.data}')

        response = await HeatPumpLogApi(client).api_v1_heat_pumps_heat_pump_id_logs_latest_get_with_http_info(
            heat_pump_id=my_heat_pump_id)

        if response.status_code == 200:
            print(f'My heat pump logs: {response.data}')

        response = await EnergyLogApi(client).api_v1_energy_logs_heat_pump_id_get_with_http_info(heat_pump_id=my_heat_pump_id,
                                                                                     start_time=datetime.datetime(2024, 6,
                                                                                                                  22, 0, 0,
                                                                                                                  0),
                                                                                     end_time=datetime.datetime(2024, 6, 22,
                                                                                                                15, 0, 0),
                                                                                     interval='Hour')

        if response.status_code == 200:
            print(f'My energy logs: {response.data}')

asyncio.get_event_loop().run_until_complete(demo())

```



