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.4

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.4
File	Size	Uploaded
lunatone_rest_api_client-0.10.4.tar.gz	79.4 kB	Oct 5, 2026	Details

Built distribution (wheel)

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

Total release size: 110.3 kB

Release files / lunatone_rest_api_client-0.10.4.tar.gz

Download URL	lunatone_rest_api_client-0.10.4.tar.gz
Size	79.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`c7c3eccb739b5179b7864e6bb02f96c7fc1ba23ee81d03ca34e0dc12fb82765b`
BLAKE2b-256 checksum How to use checksums	`2221ee435257a8cb09ac2ee631847c84bdfb5431d835d866d03cc50326019c4b`
Upload date	Oct 5, 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.4-py3-none-any.whl

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