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

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.3
File	Size	Uploaded
lunatone_rest_api_client-0.10.3.tar.gz	79.4 kB	Oct 1, 2026	Details

Built distribution (wheel)

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

Total release size: 110.3 kB

Release files / lunatone_rest_api_client-0.10.3.tar.gz

Download URL	lunatone_rest_api_client-0.10.3.tar.gz
Size	79.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`237d51c0040ffac4a3f323870973ca199a9215d3829b0195ebde99b173af3a8b`
BLAKE2b-256 checksum How to use checksums	`a7c1e0e95803f0b0f666842076106411cabc5893e460c42fed7ccf760b14b394`
Upload date	Oct 1, 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.3-py3-none-any.whl

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