Lunatone REST API Client

lunatone-rest-api-client is a Python package providing access to the Lunatone REST API.

It includes async clients for Lunatones REST API endpoints.

The following devices are supported:

Installation

Use pip to install the latest stable version of lunatone-rest-api-client

pip install --upgrade lunatone-rest-api-client

The current development version is available on [GitLab.com] (https://gitlab.com/lunatone-public/lunatone-rest-api-client) and can be installed directly from the git repository:

pip install git+https://gitlab.com/lunatone-public/lunatone-rest-api-client.git

Usage

import asyncio

import aiohttp

from lunatone_rest_api_client import Auth, Devices


async def main() -> None:
    """Show example of fetching devices."""
    async with aiohttp.ClientSession() as session:
        auth = Auth(session, "http://10.0.0.31")
        devices = Devices(auth)
        await devices.async_update()
        print(devices.data)


if __name__ == "__main__":
    asyncio.run(main())

Setting up development environment

This Python project is fully managed using the uv dependency manager.

Requirements:

uv (See https://docs.astral.sh/uv/getting-started/installation/)

To install all packages, including all development requirements:

uv sync

To run just the Python tests:

uv run pytest

Scripts

API tests:

This script sends a POST request and right after two GET requests to check if the status is changed immediately.

uv run ./scripts/api_tests.py --ip <ip-address>

Metadata

Release files for lunatone-rest-api-client 0.10.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lunatone-rest-api-client 0.10.2
File	Size	Uploaded
lunatone_rest_api_client-0.10.2.tar.gz	79.4 kB	Sep 16, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for lunatone-rest-api-client 0.10.2
File	Interpreter	ABI	Platform	Reset
lunatone_rest_api_client-0.10.2-py3-none-any.whl 30.9 kB Sep 16, 2026	Python 3	none	any	Details

Total release size: 110.2 kB

Release files / lunatone_rest_api_client-0.10.2.tar.gz

Download URL	lunatone_rest_api_client-0.10.2.tar.gz
Size	79.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`7371ab350a3a353aec7ed4c478c9d63135429eb68e3e8e68f7d02d62c498d6e6`
BLAKE2b-256 checksum How to use checksums	`e4d8ea8fb40c37306f8c5d8eff144ce97689fc12e99772e6ced0ff41f11927fe`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.5`

Release files / lunatone_rest_api_client-0.10.2-py3-none-any.whl

Download URL	lunatone_rest_api_client-0.10.2-py3-none-any.whl
Size	30.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9b531c31348e6dad80d785e4fda445e1d8b1bdb7333efaf26f20ec471a886640`
BLAKE2b-256 checksum How to use checksums	`d95ed65689e4c6bd2b594ba932276cb478b2a26d7ad7ea11a074ef1a8fe635df`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.5`