example_api_use.py

import asyncio
import json
import logging
import sys

from aiodabpumps import DabPumpsApi

# Setup logging to StdOut
logging.basicConfig(stream=sys.stdout, level=logging.DEBUG)
logger = logging.getLogger(__name__)

TEST_USERNAME = "fill in your DConnect username here"
TEST_PASSWORD = "fill in your DConnect password here"
#
# Comment out the line below if username and password are set above
from tests import TEST_USERNAME, TEST_PASSWORD


async def main():
    api = None
    try:
        # Process these calls in the right order
        api = DabPumpsApi(TEST_USERNAME, TEST_PASSWORD)
        await api.async_login()

        # Retrieve translations (optional)
        # Possible languages:
        #    "cs": "Czech",
        #    "nl": "Dutch",
        #    "en": "English",
        #    "fr": "French",
        #    "de": "German",
        #    "it": "Italian",
        #    "pl": "Polish",
        #    "ro": "Romanian",
        #    "ru": "Russian",
        #    "sk": "Slovenian",
        #    "es": "Spanish",
        #    "sf": "Swedish",
        await api.async_fetch_strings('en')

        # Retrieve installations accessible by this user.
        # Usually only one and you can skip this call if you already know the install_id
        await api.async_fetch_install_list()

        logger.info(f"installs: {len(api.install_map)}")

        for install_id, install in api.install_map.items():
            logger.info("")
            logger.info(f"installation: {install.name} ({install.id})")

            # Retrieve installation details
            # This includes the list of devices and configuration meta data for each device
            await api.async_fetch_install(install_id)

            logger.info(f"devices: {len(api.device_map)}")

            for device in api.device_map.values():
                # Log the retrieved info
                logger.info("")
                logger.info(f"device: {device.name} ({device.serial})")                
                for k,v in device._asdict().items():
                    logger.info(f"    {k}: {v}")

                config = api.config_map[device.config_id]                     
                logger.info("")
                logger.info(f"config: {config.description} ({config.id})")
                logger.info(f"    meta_params: {len(config.meta_params)}")             
                for k,v in config.meta_params.items():
                    logger.info(f"        {k}: {v}")

                # Once the calls above have been perfomed, the call below can be repeated periodically
                # Retrieve device statusses
                await api.async_fetch_device_statusses(device.serial)
                logger.info("")
                logger.info(f"statusses: {len(api.status_map)}")

                for k,v in api.status_map.items():
                    value_with_unit = f"{v.value} {v.unit}" if v.unit is not None else v.value

                    if (v.value != v.code):
                        # Display real-life value and original encoded value
                        logger.info(f"    {v.key}: {value_with_unit} ('{v.code}')")
                    else:
                        # Display real-life value, original encoded value is the same
                        logger.info(f"    {v.key}: {value_with_unit}")

    except Exception as e:
        logger.info(f"Unexpected exception: {e}")

    finally:
        if api:
            await api.async_close()


asyncio.run(main())  # main loop