aiotrimlight 0.2.1__tar.gz

aiotrimlight-0.2.1/.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_call:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          persist-credentials: false
+      - name: Install uv and Python
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9
+        with:
+          python-version: "3.14"
+          enable-cache: true
+      - name: Install dependencies
+        run: uv sync --locked --group test
+      - name: Run tests
+        run: uv run --no-sync pytest --cov=aiotrimlight --cov-branch --cov-report=term-missing
+      - name: Run ruff
+        run: |
+          uv run --no-sync ruff check .
+          uv run --no-sync ruff format --check .
+      - name: Run mypy
+        run: uv run --no-sync mypy src tests
+      - name: Build distributions
+        run: uv build --no-sources
+      - name: Check distribution metadata
+        run: uv run --no-sync twine check dist/*
+      - name: Test wheel
+        run: uv run --isolated --no-project --with dist/*.whl tests/smoke_test.py
+      - name: Test source distribution
+        run: uv run --isolated --no-project --with dist/*.tar.gz tests/smoke_test.py

aiotrimlight-0.2.1/.github/workflows/release.yml

@@ -0,0 +1,79 @@
+name: Release
+
+on:
+  release:
+    types:
+      - released
+
+permissions:
+  contents: read
+
+concurrency:
+  group: release-${{ github.event.release.tag_name }}
+  cancel-in-progress: false
+
+jobs:
+  ci:
+    uses: ./.github/workflows/ci.yml
+    permissions:
+      contents: read
+
+  build:
+    name: Build distributions
+    needs: ci
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
+        with:
+          persist-credentials: false
+      - name: Install uv and Python
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9
+        with:
+          python-version: "3.14"
+          enable-cache: false
+      - name: Validate release tag
+        shell: bash
+        run: |
+          package_version="$(uv version --short)"
+          if [[ "${GITHUB_REF_NAME}" != "v${package_version}" ]]; then
+            echo "Release tag ${GITHUB_REF_NAME} does not match package version ${package_version}" >&2
+            exit 1
+          fi
+      - name: Install build dependencies
+        run: uv sync --locked --group test
+      - name: Build distributions
+        run: uv build --no-sources --clear
+      - name: Check distribution metadata
+        run: uv run --no-sync twine check dist/*
+      - name: Test wheel
+        run: uv run --isolated --no-project --with dist/*.whl tests/smoke_test.py
+      - name: Test source distribution
+        run: uv run --isolated --no-project --with dist/*.tar.gz tests/smoke_test.py
+      - name: Upload distributions
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+          retention-days: 7
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment:
+      name: pypi
+      url: https://pypi.org/p/aiotrimlight
+    permissions:
+      id-token: write # Used only for PyPI Trusted Publishing.
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish distributions
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33

aiotrimlight-0.2.1/.gitignore

@@ -0,0 +1,12 @@
+.venv/
+.coverage
+.DS_Store
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+__pycache__/
+*.egg-info/
+build/
+coverage.xml
+dist/
+htmlcov/

aiotrimlight-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aiotrimlight contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aiotrimlight-0.2.1/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.5
+Name: aiotrimlight
+Version: 0.2.1
+Summary: Asynchronous client for the Trimlight V3 local HTTP API
+Project-URL: Homepage, https://github.com/spdevpro/trimlight-ha-api
+Project-URL: Source, https://github.com/spdevpro/trimlight-ha-api
+Project-URL: Issues, https://github.com/spdevpro/trimlight-ha-api/issues
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Requires-Dist: aiohttp>=3.13.0
+Requires-Dist: yarl>=1.20.0
+Description-Content-Type: text/markdown
+
+# aiotrimlight
+
+[![CI](https://github.com/spdevpro/trimlight-ha-api/actions/workflows/ci.yml/badge.svg)](https://github.com/spdevpro/trimlight-ha-api/actions/workflows/ci.yml)
+
+`aiotrimlight` is an asynchronous Python client for the Trimlight V3 local HTTP API. It provides device metadata, runtime light state, and high-level power, brightness, and static color control.
+
+## Requirements
+
+- Python 3.14 or newer.
+- A Trimlight controller with the V3 local HTTP API.
+- The client and controller must be reachable on the same local network.
+
+## Installation
+
+```shell
+python -m pip install aiotrimlight
+```
+
+For source development:
+
+```shell
+git clone https://github.com/spdevpro/trimlight-ha-api.git
+cd aiotrimlight
+uv sync --locked --group test --python 3.14
+```
+
+## Usage
+
+```python
+import asyncio
+
+from aiohttp import ClientSession
+
+from aiotrimlight import TrimlightClient
+
+
+async def main() -> None:
+    async with ClientSession(trust_env=False) as session:
+        client = TrimlightClient("192.0.2.10", session)
+
+        device = await client.get_device_info()
+        state = await client.get_light_state()
+        print(device, state)
+
+        await client.set_light_state(
+            on=True,
+            brightness=64,
+            red=255,
+            green=255,
+            blue=255,
+            warm_white=0,
+            cold_white=0,
+        )
+
+
+asyncio.run(main())
+```
+
+Replace the example address with the controller's LAN IP address.
+
+`trust_env=False` prevents system proxy settings from routing local controller traffic through an HTTP proxy.
+
+## Development
+
+```shell
+uv sync --locked --group test --python 3.14
+uv run --no-sync pytest --cov=aiotrimlight --cov-branch --cov-report=term-missing
+uv run --no-sync ruff check .
+uv run --no-sync ruff format --check .
+uv run --no-sync mypy src tests
+uv build --no-sources --clear
+uv run --no-sync twine check dist/*
+```
+
+> [!WARNING]
+> `examples/turn_on.py` sends commands to real Trimlight hardware. Review the configured host and output values before running it.
+
+## Releases
+
+Stable releases are built and published through GitHub Actions using PyPI
+Trusted Publishing.
+
+## License
+
+`aiotrimlight` is distributed under the MIT License. See [LICENSE](LICENSE).

aiotrimlight-0.2.1/README.md

@@ -0,0 +1,85 @@
+# aiotrimlight
+
+[![CI](https://github.com/spdevpro/trimlight-ha-api/actions/workflows/ci.yml/badge.svg)](https://github.com/spdevpro/trimlight-ha-api/actions/workflows/ci.yml)
+
+`aiotrimlight` is an asynchronous Python client for the Trimlight V3 local HTTP API. It provides device metadata, runtime light state, and high-level power, brightness, and static color control.
+
+## Requirements
+
+- Python 3.14 or newer.
+- A Trimlight controller with the V3 local HTTP API.
+- The client and controller must be reachable on the same local network.
+
+## Installation
+
+```shell
+python -m pip install aiotrimlight
+```
+
+For source development:
+
+```shell
+git clone https://github.com/spdevpro/trimlight-ha-api.git
+cd aiotrimlight
+uv sync --locked --group test --python 3.14
+```
+
+## Usage
+
+```python
+import asyncio
+
+from aiohttp import ClientSession
+
+from aiotrimlight import TrimlightClient
+
+
+async def main() -> None:
+    async with ClientSession(trust_env=False) as session:
+        client = TrimlightClient("192.0.2.10", session)
+
+        device = await client.get_device_info()
+        state = await client.get_light_state()
+        print(device, state)
+
+        await client.set_light_state(
+            on=True,
+            brightness=64,
+            red=255,
+            green=255,
+            blue=255,
+            warm_white=0,
+            cold_white=0,
+        )
+
+
+asyncio.run(main())
+```
+
+Replace the example address with the controller's LAN IP address.
+
+`trust_env=False` prevents system proxy settings from routing local controller traffic through an HTTP proxy.
+
+## Development
+
+```shell
+uv sync --locked --group test --python 3.14
+uv run --no-sync pytest --cov=aiotrimlight --cov-branch --cov-report=term-missing
+uv run --no-sync ruff check .
+uv run --no-sync ruff format --check .
+uv run --no-sync mypy src tests
+uv build --no-sources --clear
+uv run --no-sync twine check dist/*
+```
+
+> [!WARNING]
+> `examples/turn_on.py` sends commands to real Trimlight hardware. Review the configured host and output values before running it.
+
+## Releases
+
+Stable releases are built and published through GitHub Actions using PyPI
+Trusted Publishing.
+
+## License
+
+`aiotrimlight` is distributed under the MIT License. See [LICENSE](LICENSE).

aiotrimlight-0.2.1/examples/turn_on.py

@@ -0,0 +1,46 @@
+"""Turn a physical Trimlight controller on through the high-level client API."""
+
+import argparse
+import asyncio
+
+from aiohttp import ClientSession
+
+from aiotrimlight import TrimlightClient
+
+
+async def async_main(host: str, brightness: int) -> None:
+    """Get device information and turn the whole installation on."""
+    async with ClientSession(trust_env=False) as session:
+        client = TrimlightClient(host, session)
+        device_info = await client.get_device_info()
+        print(
+            "Connected to",
+            host,
+            f"firmware={device_info.firmware_version}",
+            f"ic={device_info.ic_type.name}",
+        )
+        state = await client.set_light_state(
+            on=True,
+            brightness=brightness,
+            red=255,
+            green=255,
+            blue=255,
+            warm_white=0,
+            cold_white=0,
+        )
+        print(f"Controller reported state: {state}")
+
+
+def main() -> None:
+    """Run the physical-device command."""
+    parser = argparse.ArgumentParser(
+        description="Turn on a Trimlight controller; this changes a physical light."
+    )
+    parser.add_argument("--host", required=True)
+    parser.add_argument("--brightness", type=int, default=64)
+    args = parser.parse_args()
+    asyncio.run(async_main(args.host, args.brightness))
+
+
+if __name__ == "__main__":
+    main()

aiotrimlight-0.2.1/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["hatchling>=1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "aiotrimlight"
+version = "0.2.1"
+description = "Asynchronous client for the Trimlight V3 local HTTP API"
+readme = "README.md"
+requires-python = ">=3.14"
+license = "MIT"
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Framework :: AsyncIO",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.14",
+  "Typing :: Typed",
+]
+dependencies = [
+  "aiohttp>=3.13.0",
+  "yarl>=1.20.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/spdevpro/trimlight-ha-api"
+Source = "https://github.com/spdevpro/trimlight-ha-api"
+Issues = "https://github.com/spdevpro/trimlight-ha-api/issues"
+
+[dependency-groups]
+test = [
+  "mypy>=1.19.0",
+  "pytest>=8.4.0",
+  "pytest-asyncio>=1.2.0",
+  "pytest-cov>=7.0.0",
+  "ruff>=0.13.0",
+  "twine>=6.2.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/aiotrimlight"]
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers --strict-config"
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.coverage.run]
+branch = true
+source = ["aiotrimlight"]
+
+[tool.coverage.report]
+fail_under = 100
+show_missing = true
+
+[tool.mypy]
+python_version = "3.14"
+strict = true
+files = ["src", "tests"]
+
+[tool.ruff]
+target-version = "py314"
+line-length = 88
+
+[tool.ruff.lint]
+select = ["ASYNC", "B", "E", "F", "I", "RUF", "SIM", "UP"]

aiotrimlight-0.2.1/src/aiotrimlight/__init__.py

@@ -0,0 +1,35 @@
+"""Asynchronous Trimlight V3 HTTP client."""
+
+from .client import TrimlightClient
+from .discovery import parse_discovery_properties
+from .exceptions import (
+    TrimlightCommandError,
+    TrimlightConnectionError,
+    TrimlightDiscoveryError,
+    TrimlightError,
+    TrimlightHTTPError,
+    TrimlightProtocolError,
+    TrimlightUnsupportedICError,
+)
+from .models import (
+    TrimlightDeviceInfo,
+    TrimlightDiscoveryInfo,
+    TrimlightICType,
+    TrimlightLightState,
+)
+
+__all__ = [
+    "TrimlightClient",
+    "TrimlightCommandError",
+    "TrimlightConnectionError",
+    "TrimlightDeviceInfo",
+    "TrimlightDiscoveryError",
+    "TrimlightDiscoveryInfo",
+    "TrimlightError",
+    "TrimlightHTTPError",
+    "TrimlightICType",
+    "TrimlightLightState",
+    "TrimlightProtocolError",
+    "TrimlightUnsupportedICError",
+    "parse_discovery_properties",
+]