Michael Sauer
2c77b2d325
Aufgebaut wie ha-ninlight: die Abbilder liegen unter ninstrip_firmware im Konfigurationsverzeichnis, Home Assistant liefert sie selbst unter einer einmaligen Adresse aus, und zwar genau die Bytes, die vorher geprueft wurden. Dazu firmware.py (Anhaenger, Versionsreihenfolge, WLAN-Pruefung, Katalog), http.py, urls.py und shared.py. Drei Unterschiede zu ninlight, alle aus der Firmware heraus: * Verglichen wird device_type - die Platine -, nicht product. Letzteres ist bei allen Platinen 'ninstrip'; die Abbilder unterscheiden sich aber hart, die K1Y invertiert das Datensignal und die KL-RGBC3 nicht. Firmware ohne dieses Feld bekommt gar kein Angebot. * Die WLAN-Pruefung sucht die SSID unverpackt: ein ESP32-Abbild ist nicht gzip-verpackt wie das des W600. An einem mit sdkconfig.local gebauten Abbild gegengeprueft - die SSID steht genau einmal NUL-gerahmt drin. * Der Fehlerschluessel heisst device_url_too_long statt lamp_url_too_long. Dazu das Testgeruest, das es hier bisher gar nicht gab: 204 Tests in tests_unit/ (ohne HA-Instanz) und tests/ (mit), Abdeckung 97 %, dazu scripts/check.sh als Ersatz fuer die fehlende CI. Die Nutzdaten in tests_unit/samples.py sind an der Stehlampe abgefragt. Beim Gegenpruefen per Mutation fiel auf, dass die Platinenpruefung unmittelbar vor dem Senden ungeprueft war - der Test dazu ist jetzt da und faellt, wenn man die Pruefung entfernt.
35 lines
1.0 KiB
Python
35 lines
1.0 KiB
Python
"""Die Adresse, unter der Geraete Home Assistant erreichen. Frei von HA-Importen."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from urllib.parse import urlsplit
|
|
|
|
from .const import FIRMWARE_KEY_LENGTH, FIRMWARE_URL_PREFIX, MAX_DEVICE_URL_LENGTH
|
|
|
|
|
|
def firmware_url(base: str, key: str) -> str:
|
|
return f"{base.rstrip('/')}{FIRMWARE_URL_PREFIX}{key}"
|
|
|
|
|
|
def validate_device_base_url(url: str) -> str | None:
|
|
"""None, wenn brauchbar, sonst der Fehlerschluessel fuer das Formular."""
|
|
try:
|
|
parts = urlsplit(url)
|
|
port_ok = parts.port is None or parts.port > 0
|
|
except ValueError:
|
|
return "invalid_base_url"
|
|
if (
|
|
parts.scheme != "http"
|
|
or not parts.hostname
|
|
or not port_ok
|
|
or parts.username
|
|
or parts.password
|
|
or parts.query
|
|
or parts.fragment
|
|
or parts.path not in ("", "/")
|
|
):
|
|
return "invalid_base_url"
|
|
if len(firmware_url(url, "k" * FIRMWARE_KEY_LENGTH)) > MAX_DEVICE_URL_LENGTH:
|
|
return "base_url_too_long"
|
|
return None
|