Chris T. Ludwig: Die Seite wurde neu angelegt: „`future` ist kein Bestandteil von Home Assistant selbst, sondern ein spezielles Python-Modul. Es ermoeglicht, Sprachfunktionen einer neueren Python-Version bereits in aelteren Python-Versionen zu verwenden. Beispiel: from future import annotations Das wirst du in '''fast jeder modernen Home-Assistant-Integration''' ganz oben in der Datei finden. ----- == Was bewirkt `annotations…“`


2026-07-05T05:36:33Z
Die Seite wurde neu angelegt: „<code>__future__</code> ist kein Bestandteil von Home Assistant selbst, sondern ein spezielles Python-Modul. Es ermoeglicht, Sprachfunktionen einer neueren Python-Version bereits in aelteren Python-Versionen zu verwenden.  Beispiel:  <syntaxhighlight lang="python">from __future__ import annotations</syntaxhighlight> Das wirst du in '''fast jeder modernen Home-Assistant-Integration''' ganz oben in der Datei finden.   -----  == Was bewirkt <code>annotations…“
Neue Seite
<code>__future__</code> ist kein Bestandteil von Home Assistant selbst, sondern ein spezielles Python-Modul. Es ermoeglicht, Sprachfunktionen einer neueren Python-Version bereits in aelteren Python-Versionen zu verwenden.



Beispiel:



<syntaxhighlight lang="python">from __future__ import annotations</syntaxhighlight>

Das wirst du in '''fast jeder modernen Home-Assistant-Integration''' ganz oben in der Datei finden.





-----



== Was bewirkt <code>annotations</code>? ==



Nehmen wir dieses Beispiel:



<syntaxhighlight lang="python">class FoxAPI:

    pass





class Coordinator:



    def __init__(self, api: FoxAPI):

        self.api = api</syntaxhighlight>

Ohne



<syntaxhighlight lang="python">from __future__ import annotations</syntaxhighlight>

muss Python beim Einlesen der Datei bereits wissen, was <code>FoxAPI</code> ist.



Mit



<syntaxhighlight lang="python">from __future__ import annotations</syntaxhighlight>

werden alle Typangaben zunächst nur als '''Zeichenketten''' gespeichert und erst später ausgewertet.



Dadurch funktionieren auch sogenannte '''Forward References''':



<syntaxhighlight lang="python">from __future__ import annotations





class A:



    def test(self) -> B:

        ...</syntaxhighlight>

Obwohl <code>B</code> erst später definiert wird:



<syntaxhighlight lang="python">class B:

    pass</syntaxhighlight>

Ohne <code>__future__</code> würde das einen Fehler erzeugen.





-----



== Warum nutzt Home Assistant das? ==



Home Assistant verwendet sehr viele Typannotationen:



<syntaxhighlight lang="python">from homeassistant.core import HomeAssistant

from homeassistant.config_entries import ConfigEntry



async def async_setup_entry(

    hass: HomeAssistant,

    entry: ConfigEntry,

) -> bool:

    ...</syntaxhighlight>

Ebenso häufig findet man:



<syntaxhighlight lang="python">class FoxCoordinator(DataUpdateCoordinator[dict[str, Any]]):

    ...</syntaxhighlight>

oder



<syntaxhighlight lang="python">def __init__(

    self,

    coordinator: FoxCoordinator,

) -> None:</syntaxhighlight>

Mit



<syntaxhighlight lang="python">from __future__ import annotations</syntaxhighlight>

* werden Importabhängigkeiten reduziert,

* entstehen weniger zyklische Importe,

* verbessert sich die Performance beim Laden,

* und der Code wird einfacher wartbar.





-----



== Warum steht der Import immer ganz oben? ==



Python verlangt, dass alle <code>__future__</code>-Importe vor allen anderen Imports stehen:



<syntaxhighlight lang="python">from __future__ import annotations



import logging



from homeassistant.core import HomeAssistant</syntaxhighlight>

Das ist Pflicht.





-----



== Brauche ich das für eine neue Integration? ==



'''Ja.'''



Wenn du heute eine neue Home-Assistant-Integration schreibst, solltest du grundsätzlich jede Python-Datei mit



<syntaxhighlight lang="python">from __future__ import annotations</syntaxhighlight>

beginnen.



Das entspricht dem Stil des Home-Assistant-Core-Projekts und erleichtert den Einsatz moderner Typannotationen.





-----

== Wird das in Zukunft noch benoetigt? ==



Home Assistant setzt inzwischen auf aktuelle Python-Versionen. Seit Python 3.14 werden verzoegert ausgewertete Annotationen standardmaeszig unterstuetzt, sodass <code>from __future__ import annotations</code> langfristig ueberfluessig werden wird.



Bis dahin gilt jedoch:



* '''Für Home-Assistant-Integrationen:''' weiter verwenden.

* '''Für neuen Home-Assistant-Code:''' praktisch Standard.

* '''Für aeltere Tutorials:''' Wenn der Import fehlt, ist der Code oft älter oder richtet sich an fruehere Python-Versionen.



Man solltedie Codezeile unbedingt in jeder eigenen Home-Assistant-Geraeteintegrationen konsequent <code>.py</code>-Datei verwenden.

HomeAssistant Programmierung (dunder) future (dunder) - Versionsgeschichte