Release 1.xx.x - xx. xxx 2026

Dieses Release ist ein Feature-Release. Es gibt eine Menge neuer Features im Core von SmartHomeNG und den Plugins.

Bemerkung

Diese Release Notes sind ein Arbeitsstand des develop Branches.

Berücksichtigt sind Commits im smarthome Repository bis inkl. x. xxxx 2026 (…)

Berücksichtigt sind Commits im plugins Repository bis inkl. x. xxxx 2026 (…)

Überblick

Dieses ist neues Release für SmartHomeNG. Die Änderungen gegenüber dem Release v1.12.0 sind im Folgenden in diesen Release Notes beschrieben.

Minimum Python Version

Die minimale Python-Version, die von SmartHomeNG unterstützt wird, ist Python 3.10.

Es ist ggf. möglich, SmartHomeNG auch auf früheren Python-Versionen laufen zu lassen. Dies ist aber nicht getestet, und möglicherweise nutzen z.B. einzelne Plugins Sprachfeatures, die erst ab Python 3.10 unterstützt werden. Insofern kann für Versuche in dieser Hinsicht kein Support geleistet werden.

Bei einer Neuinstallation wird jedoch empfohlen, auf einer der neueren Python-Versionen (3.12 oder 3.13) aufzusetzen.

Unterstützte Python Versionen

Offiziell unterstützt werden im SmartHomeNG Release 1.xx.0 die Python Versionen 3.10, 3.11, 3.12 und 3.13. Automatisierte Tests von SmartHomeNG werden nur in den unterstützten Python Versionen durchgeführt. (Siehe auch Hard- u. Software Anforderungen im Abschnitt Installation zu unterstützten Python Versionen)

Änderungen am Core

Allgmein

github:
- …

Bugfixes im CORE

lib.log: Meldungen der SmartHomeNG-eigenen Log-Level (NOTICE, DBGHIGH, DBGMED, DBGLOW, DEVELOP) nennen jetzt die aufrufende Funktion und Zeile statt logForLevel
lib.scheduler: Ein Task, der eingereiht wird während alle Worker beschäftigt sind, wartet nicht mehr bis zu einer Sekunde, nachdem ein Worker frei geworden ist
…

Updates in the CORE

…
bin
- smarthome
  - …
- shngversion:
  - Bumped core version to 1.10.0.2 -> added support for asyncio in plugins
Libs:
- lib.scheduler:
  - Laufende Tasks (Logiken, Item-Zyklen/Crontabs, Plugin-Scheduler) werden mit Laufzeit erfasst
  - Überschreitet ein Task die Laufzeit runtime_warn (Standard 120 s, global in smarthome.yaml, für Logiken auch pro Logik), wird eine Warnung mit seinem aktuellen Stacktrace geloggt, erneut bei jeder Verdopplung
  - Laufende Logiken können abgebrochen werden (Exception TaskCancelled), manuell über die Admin GUI oder automatisch über den neuen Logik-Parameter runtime_cancel
- …:
  - …
- lib.item: * …
Modules:
- modules.admin:
  - Threads-Seite zeigt Typ und Laufzeit laufender Tasks, überfällige Tasks hervorgehoben, den aktuellen Stack eines Tasks und erlaubt das Abbrechen von Logiken
  - REST-API: GET /api/threads liefert Informationen zu laufenden Tasks, GET /api/threads/<ident> deren Stack, POST /api/threads/<ident>/cancel bricht eine Logik ab
- modules. …:
  - …
tools:
- tools/…:
  - …

Änderungen bei Plugins

Allgmein

Workflows:
- …

Neue Plugins

Für Details zu den neuen Plugins, bitte die Dokumentation des jeweiligen Plugins unter http://www.smarthomeng.de/user/plugins_all.html konsultieren.

…: …

Plugin Updates

Für Details zu den Änderungen an den einzelnen Plugins, bitte die Dokumentation des jeweiligen Plugins unter http://www.smarthomeng.de/user/plugins_all.html konsultieren.

…:
- …

Outdated Plugins

Die folgenden Plugins wurden in das plugin_archive Repository verschoben:

Interface Plugins
- …

Die folgenden Plugins wurden als veraltet (deprecated markiert und werden in einem der nächsten Releases aus dem Plugin-Repo entfernt und in das Archive-Repo verschoben:

System Plugins
- …

Weitere Änderungen

Dokumentation

Admin GUI: Threads-Seite mit laufenden Tasks und dem Abbrechen von Logiken
Logiken: Exception TaskCancelled, Parameter runtime_warn und runtime_cancel
…