homeassistant-stubs 2024.5.4__py3-none-any.whl → 2024.6.0__py3-none-any.whl

homeassistant-stubs/components/evil_genius_labs/diagnostics.pyi

@@ -1,5 +1,5 @@
-from . import EvilGeniusUpdateCoordinator as EvilGeniusUpdateCoordinator
 from .const import DOMAIN as DOMAIN
+from .coordinator import EvilGeniusUpdateCoordinator as EvilGeniusUpdateCoordinator
 from _typeshed import Incomplete
 from homeassistant.components.diagnostics import async_redact_data as async_redact_data
 from homeassistant.config_entries import ConfigEntry as ConfigEntry

homeassistant-stubs/components/evil_genius_labs/light.pyi

@@ -1,5 +1,6 @@
-from . import EvilGeniusEntity as EvilGeniusEntity, EvilGeniusUpdateCoordinator as EvilGeniusUpdateCoordinator
+from . import EvilGeniusEntity as EvilGeniusEntity
 from .const import DOMAIN as DOMAIN
+from .coordinator import EvilGeniusUpdateCoordinator as EvilGeniusUpdateCoordinator
 from .util import update_when_done as update_when_done
 from _typeshed import Incomplete
 from homeassistant.components import light as light

homeassistant-stubs/components/evil_genius_labs/util.pyi

@@ -1,9 +1,5 @@
 from . import EvilGeniusEntity as EvilGeniusEntity
-from collections.abc import Awaitable, Callable as Callable, Coroutine
-from typing import Any, Concatenate, ParamSpec, TypeVar
-
-_EvilGeniusEntityT = TypeVar('_EvilGeniusEntityT', bound=EvilGeniusEntity)
-_R = TypeVar('_R')
-_P = ParamSpec('_P')
+from collections.abc import Awaitable as Awaitable, Callable as Callable, Coroutine
+from typing import Any, Concatenate
 
 def update_when_done(func: Callable[Concatenate[_EvilGeniusEntityT, _P], Awaitable[_R]]) -> Callable[Concatenate[_EvilGeniusEntityT, _P], Coroutine[Any, Any, _R]]: ...

homeassistant-stubs/components/evohome/__init__.pyi

@@ -55,7 +55,7 @@ class EvoBroker:
     _location: Incomplete
     config: Incomplete
     tcs: Incomplete
-    tcs_utc_offset: Incomplete
+    loc_utc_offset: Incomplete
     temps: Incomplete
     def __init__(self, hass: HomeAssistant, client: evo.EvohomeClient, client_v1: ev1.EvohomeClient | None, store: Store[dict[str, Any]], params: ConfigType) -> None: ...
     async def save_auth_tokens(self) -> None: ...

homeassistant-stubs/components/feedreader/__init__.pyi

@@ -1,56 +1,14 @@
-import feedparser
+from .const import DOMAIN as DOMAIN
+from .coordinator import FeedReaderCoordinator as FeedReaderCoordinator, StoredData as StoredData
 from _typeshed import Incomplete
-from datetime import datetime, timedelta
-from homeassistant.const import CONF_SCAN_INTERVAL as CONF_SCAN_INTERVAL, EVENT_HOMEASSISTANT_START as EVENT_HOMEASSISTANT_START
-from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback
-from homeassistant.helpers.event import async_track_time_interval as async_track_time_interval
-from homeassistant.helpers.storage import Store as Store
+from homeassistant.const import CONF_SCAN_INTERVAL as CONF_SCAN_INTERVAL
+from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.typing import ConfigType as ConfigType
-from time import struct_time as struct_time
 
-_LOGGER: Incomplete
 CONF_URLS: str
 CONF_MAX_ENTRIES: str
 DEFAULT_MAX_ENTRIES: int
 DEFAULT_SCAN_INTERVAL: Incomplete
-DELAY_SAVE: int
-DOMAIN: str
-EVENT_FEEDREADER: str
-STORAGE_VERSION: int
 CONFIG_SCHEMA: Incomplete
 
 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
-
-class FeedManager:
-    _hass: Incomplete
-    _url: Incomplete
-    _scan_interval: Incomplete
-    _max_entries: Incomplete
-    _feed: Incomplete
-    _firstrun: bool
-    _storage: Incomplete
-    _last_entry_timestamp: Incomplete
-    _has_published_parsed: bool
-    _has_updated_parsed: bool
-    _event_type: Incomplete
-    _feed_id: Incomplete
-    def __init__(self, hass: HomeAssistant, url: str, scan_interval: timedelta, max_entries: int, storage: StoredData) -> None: ...
-    def async_setup(self) -> None: ...
-    def _log_no_entries(self) -> None: ...
-    async def _async_update(self, _: datetime | Event) -> None: ...
-    def _update(self) -> struct_time | None: ...
-    def _filter_entries(self) -> None: ...
-    def _update_and_fire_entry(self, entry: feedparser.FeedParserDict) -> None: ...
-    def _publish_new_entries(self) -> None: ...
-
-class StoredData:
-    _legacy_data_file: Incomplete
-    _data: Incomplete
-    _hass: Incomplete
-    _store: Incomplete
-    def __init__(self, hass: HomeAssistant, legacy_data_file: str) -> None: ...
-    async def async_setup(self) -> None: ...
-    def _legacy_fetch_data(self) -> dict[str, struct_time]: ...
-    def get_timestamp(self, feed_id: str) -> struct_time | None: ...
-    def async_put_timestamp(self, feed_id: str, timestamp: struct_time) -> None: ...
-    def _async_save_data(self) -> dict[str, str]: ...

homeassistant-stubs/components/feedreader/const.pyi

@@ -0,0 +1 @@
+DOMAIN: str

homeassistant-stubs/components/feedreader/coordinator.pyi

@@ -0,0 +1,39 @@
+import feedparser
+from .const import DOMAIN as DOMAIN
+from _typeshed import Incomplete
+from datetime import timedelta
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.storage import Store as Store
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator
+from time import struct_time as struct_time
+
+DELAY_SAVE: int
+EVENT_FEEDREADER: str
+STORAGE_VERSION: int
+_LOGGER: Incomplete
+
+class FeedReaderCoordinator(DataUpdateCoordinator[None]):
+    _url: Incomplete
+    _max_entries: Incomplete
+    _feed: Incomplete
+    _storage: Incomplete
+    _last_entry_timestamp: Incomplete
+    _event_type: Incomplete
+    _feed_id: Incomplete
+    def __init__(self, hass: HomeAssistant, url: str, scan_interval: timedelta, max_entries: int, storage: StoredData) -> None: ...
+    def _log_no_entries(self) -> None: ...
+    def _fetch_feed(self) -> feedparser.FeedParserDict: ...
+    async def _async_update_data(self) -> None: ...
+    def _filter_entries(self) -> None: ...
+    def _update_and_fire_entry(self, entry: feedparser.FeedParserDict) -> None: ...
+    def _publish_new_entries(self) -> None: ...
+
+class StoredData:
+    _data: Incomplete
+    hass: Incomplete
+    _store: Incomplete
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    async def async_setup(self) -> None: ...
+    def get_timestamp(self, feed_id: str) -> struct_time | None: ...
+    def async_put_timestamp(self, feed_id: str, timestamp: struct_time) -> None: ...
+    def _async_save_data(self) -> dict[str, str]: ...

homeassistant-stubs/components/filesize/__init__.pyi

@@ -4,5 +4,7 @@ from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_FILE_PATH as CONF_FILE_PATH
 from homeassistant.core import HomeAssistant as HomeAssistant
 
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
+FileSizeConfigEntry = ConfigEntry[FileSizeCoordinator]
+
+async def async_setup_entry(hass: HomeAssistant, entry: FileSizeConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...

homeassistant-stubs/components/filesize/coordinator.pyi

@@ -9,8 +9,8 @@ from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as Da
 _LOGGER: Incomplete
 
 class FileSizeCoordinator(DataUpdateCoordinator[dict[str, int | float | datetime]]):
+    path: pathlib.Path
     _unresolved_path: Incomplete
-    _path: Incomplete
     def __init__(self, hass: HomeAssistant, unresolved_path: str) -> None: ...
     def _get_full_path(self) -> pathlib.Path: ...
     def _update(self) -> os.stat_result: ...

homeassistant-stubs/components/filesize/sensor.pyi

@@ -1,10 +1,10 @@
+from . import FileSizeConfigEntry as FileSizeConfigEntry
 from .const import DOMAIN as DOMAIN
 from .coordinator import FileSizeCoordinator as FileSizeCoordinator
 from _typeshed import Incomplete
 from datetime import datetime
 from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.const import CONF_FILE_PATH as CONF_FILE_PATH, EntityCategory as EntityCategory, UnitOfInformation as UnitOfInformation
+from homeassistant.const import EntityCategory as EntityCategory, UnitOfInformation as UnitOfInformation
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.device_registry import DeviceEntryType as DeviceEntryType, DeviceInfo as DeviceInfo
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
@@ -13,13 +13,13 @@ from homeassistant.helpers.update_coordinator import CoordinatorEntity as Coordi
 _LOGGER: Incomplete
 SENSOR_TYPES: Incomplete
 
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: FileSizeConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
 class FilesizeEntity(CoordinatorEntity[FileSizeCoordinator], SensorEntity):
     _attr_has_entity_name: bool
     _attr_unique_id: Incomplete
     entity_description: Incomplete
     _attr_device_info: Incomplete
-    def __init__(self, description: SensorEntityDescription, path: str, entry_id: str, coordinator: FileSizeCoordinator) -> None: ...
+    def __init__(self, description: SensorEntityDescription, entry_id: str, coordinator: FileSizeCoordinator) -> None: ...
     @property
     def native_value(self) -> float | int | datetime: ...

homeassistant-stubs/components/fitbit/api.pyi

@@ -10,12 +10,11 @@ from homeassistant.const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers import config_entry_oauth2_flow as config_entry_oauth2_flow
 from homeassistant.util.unit_system import METRIC_SYSTEM as METRIC_SYSTEM
-from typing import Any, TypeVar
+from typing import Any
 
 _LOGGER: Incomplete
 CONF_REFRESH_TOKEN: str
 CONF_EXPIRES_AT: str
-_T = TypeVar('_T')
 
 class FitbitApi(ABC, metaclass=abc.ABCMeta):
     _hass: Incomplete

homeassistant-stubs/components/fitbit/coordinator.pyi

@@ -12,7 +12,7 @@ _LOGGER: Incomplete
 UPDATE_INTERVAL: Final[Incomplete]
 TIMEOUT: int
 
-class FitbitDeviceCoordinator(DataUpdateCoordinator):
+class FitbitDeviceCoordinator(DataUpdateCoordinator[dict[str, FitbitDevice]]):
     _api: Incomplete
     def __init__(self, hass: HomeAssistant, api: FitbitApi) -> None: ...
     async def _async_update_data(self) -> dict[str, FitbitDevice]: ...

homeassistant-stubs/components/forecast_solar/__init__.pyi

@@ -1,4 +1,4 @@
-from .const import CONF_DAMPING as CONF_DAMPING, CONF_DAMPING_EVENING as CONF_DAMPING_EVENING, CONF_DAMPING_MORNING as CONF_DAMPING_MORNING, CONF_MODULES_POWER as CONF_MODULES_POWER, DOMAIN as DOMAIN
+from .const import CONF_DAMPING as CONF_DAMPING, CONF_DAMPING_EVENING as CONF_DAMPING_EVENING, CONF_DAMPING_MORNING as CONF_DAMPING_MORNING, CONF_MODULES_POWER as CONF_MODULES_POWER
 from .coordinator import ForecastSolarDataUpdateCoordinator as ForecastSolarDataUpdateCoordinator
 from _typeshed import Incomplete
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -6,8 +6,9 @@ from homeassistant.const import Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant
 
 PLATFORMS: Incomplete
+ForecastSolarConfigEntry = ConfigEntry[ForecastSolarDataUpdateCoordinator]
 
 async def async_migrate_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
+async def async_setup_entry(hass: HomeAssistant, entry: ForecastSolarConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
 async def async_update_options(hass: HomeAssistant, entry: ConfigEntry) -> None: ...

homeassistant-stubs/components/forecast_solar/diagnostics.pyi

@@ -1,13 +1,10 @@
-from .const import DOMAIN as DOMAIN
+from . import ForecastSolarConfigEntry as ForecastSolarConfigEntry
 from _typeshed import Incomplete
-from forecast_solar import Estimate as Estimate
 from homeassistant.components.diagnostics import async_redact_data as async_redact_data
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_API_KEY as CONF_API_KEY, CONF_LATITUDE as CONF_LATITUDE, CONF_LONGITUDE as CONF_LONGITUDE
 from homeassistant.core import HomeAssistant as HomeAssistant
-from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator
 from typing import Any
 
 TO_REDACT: Incomplete
 
-async def async_get_config_entry_diagnostics(hass: HomeAssistant, entry: ConfigEntry) -> dict[str, Any]: ...
+async def async_get_config_entry_diagnostics(hass: HomeAssistant, entry: ForecastSolarConfigEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/forecast_solar/energy.pyi

@@ -1,4 +1,4 @@
-from .const import DOMAIN as DOMAIN
+from .coordinator import ForecastSolarDataUpdateCoordinator as ForecastSolarDataUpdateCoordinator
 from homeassistant.core import HomeAssistant as HomeAssistant
 
 async def async_get_solar_forecast(hass: HomeAssistant, config_entry_id: str) -> dict[str, dict[str, float | int]] | None: ...

homeassistant-stubs/components/forecast_solar/sensor.pyi

@@ -1,3 +1,4 @@
+from . import ForecastSolarConfigEntry as ForecastSolarConfigEntry
 from .const import DOMAIN as DOMAIN
 from .coordinator import ForecastSolarDataUpdateCoordinator as ForecastSolarDataUpdateCoordinator
 from _typeshed import Incomplete
@@ -6,7 +7,6 @@ from dataclasses import dataclass
 from datetime import datetime
 from forecast_solar.models import Estimate as Estimate
 from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import UnitOfEnergy as UnitOfEnergy, UnitOfPower as UnitOfPower
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.device_registry import DeviceEntryType as DeviceEntryType, DeviceInfo as DeviceInfo
@@ -22,7 +22,7 @@ class ForecastSolarSensorEntityDescription(SensorEntityDescription):
 
 SENSORS: tuple[ForecastSolarSensorEntityDescription, ...]
 
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: ForecastSolarConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
 class ForecastSolarSensorEntity(CoordinatorEntity[ForecastSolarDataUpdateCoordinator], SensorEntity):
     entity_description: ForecastSolarSensorEntityDescription

homeassistant-stubs/components/fritz/__init__.pyi

@@ -1,5 +1,5 @@
-from .common import AvmWrapper as AvmWrapper, FritzData as FritzData
 from .const import DATA_FRITZ as DATA_FRITZ, DEFAULT_SSL as DEFAULT_SSL, DOMAIN as DOMAIN, FRITZ_AUTH_EXCEPTIONS as FRITZ_AUTH_EXCEPTIONS, FRITZ_EXCEPTIONS as FRITZ_EXCEPTIONS, PLATFORMS as PLATFORMS
+from .coordinator import AvmWrapper as AvmWrapper, FritzData as FritzData
 from .services import async_setup_services as async_setup_services, async_unload_services as async_unload_services
 from _typeshed import Incomplete
 from homeassistant.config_entries import ConfigEntry as ConfigEntry

homeassistant-stubs/components/fritz/binary_sensor.pyi

@@ -1,5 +1,6 @@
-from .common import AvmWrapper as AvmWrapper, ConnectionInfo as ConnectionInfo, FritzBoxBaseCoordinatorEntity as FritzBoxBaseCoordinatorEntity, FritzEntityDescription as FritzEntityDescription
 from .const import DOMAIN as DOMAIN
+from .coordinator import AvmWrapper as AvmWrapper, ConnectionInfo as ConnectionInfo
+from .entity import FritzBoxBaseCoordinatorEntity as FritzBoxBaseCoordinatorEntity, FritzEntityDescription as FritzEntityDescription
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
@@ -11,10 +12,10 @@ from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEnti
 
 _LOGGER: Incomplete
 
-@dataclass(frozen=True)
+@dataclass(frozen=True, kw_only=True)
 class FritzBinarySensorEntityDescription(BinarySensorEntityDescription, FritzEntityDescription):
     is_suitable: Callable[[ConnectionInfo], bool] = ...
-    def __init__(self, value_fn, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement, is_suitable) -> None: ...
+    def __init__(self, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement, value_fn, is_suitable) -> None: ...
 
 SENSOR_TYPES: tuple[FritzBinarySensorEntityDescription, ...]
 

homeassistant-stubs/components/fritz/button.pyi

@@ -1,5 +1,6 @@
-from .common import AvmWrapper as AvmWrapper, FritzData as FritzData, FritzDevice as FritzDevice, FritzDeviceBase as FritzDeviceBase, _is_tracked as _is_tracked
 from .const import BUTTON_TYPE_WOL as BUTTON_TYPE_WOL, CONNECTION_TYPE_LAN as CONNECTION_TYPE_LAN, DATA_FRITZ as DATA_FRITZ, DOMAIN as DOMAIN, MeshRoles as MeshRoles
+from .coordinator import AvmWrapper as AvmWrapper, FritzData as FritzData, FritzDevice as FritzDevice, _is_tracked as _is_tracked
+from .entity import FritzDeviceBase as FritzDeviceBase
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
@@ -10,13 +11,13 @@ from homeassistant.core import HomeAssistant as HomeAssistant, callback as callb
 from homeassistant.helpers.device_registry import CONNECTION_NETWORK_MAC as CONNECTION_NETWORK_MAC, DeviceInfo as DeviceInfo
 from homeassistant.helpers.dispatcher import async_dispatcher_connect as async_dispatcher_connect
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
-from typing import Final
+from typing import Any, Final
 
 _LOGGER: Incomplete
 
 @dataclass(frozen=True, kw_only=True)
 class FritzButtonDescription(ButtonEntityDescription):
-    press_action: Callable
+    press_action: Callable[[AvmWrapper], Any]
     def __init__(self, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement, press_action) -> None: ...
 
 BUTTONS: Final[Incomplete]

homeassistant-stubs/components/fritz/const.pyi

@@ -25,9 +25,6 @@ ERROR_CANNOT_CONNECT: str
 ERROR_UPNP_NOT_CONFIGURED: str
 ERROR_UNKNOWN: str
 FRITZ_SERVICES: str
-SERVICE_REBOOT: str
-SERVICE_RECONNECT: str
-SERVICE_CLEANUP: str
 SERVICE_SET_GUEST_WIFI_PW: str
 SWITCH_TYPE_DEFLECTION: str
 SWITCH_TYPE_PORTFORWARD: str

homeassistant-stubs/components/fritz/{common.pyi → coordinator.pyi}

@@ -1,4 +1,4 @@
-from .const import CONF_OLD_DISCOVERY as CONF_OLD_DISCOVERY, DEFAULT_CONF_OLD_DISCOVERY as DEFAULT_CONF_OLD_DISCOVERY, DEFAULT_DEVICE_NAME as DEFAULT_DEVICE_NAME, DEFAULT_HOST as DEFAULT_HOST, DEFAULT_SSL as DEFAULT_SSL, DEFAULT_USERNAME as DEFAULT_USERNAME, DOMAIN as DOMAIN, FRITZ_EXCEPTIONS as FRITZ_EXCEPTIONS, MeshRoles as MeshRoles, SERVICE_CLEANUP as SERVICE_CLEANUP, SERVICE_REBOOT as SERVICE_REBOOT, SERVICE_RECONNECT as SERVICE_RECONNECT, SERVICE_SET_GUEST_WIFI_PW as SERVICE_SET_GUEST_WIFI_PW
+from .const import CONF_OLD_DISCOVERY as CONF_OLD_DISCOVERY, DEFAULT_CONF_OLD_DISCOVERY as DEFAULT_CONF_OLD_DISCOVERY, DEFAULT_HOST as DEFAULT_HOST, DEFAULT_SSL as DEFAULT_SSL, DEFAULT_USERNAME as DEFAULT_USERNAME, DOMAIN as DOMAIN, FRITZ_EXCEPTIONS as FRITZ_EXCEPTIONS, MeshRoles as MeshRoles, SERVICE_SET_GUEST_WIFI_PW as SERVICE_SET_GUEST_WIFI_PW
 from _typeshed import Incomplete
 from collections.abc import Callable, ValuesView
 from dataclasses import dataclass
@@ -6,13 +6,12 @@ from datetime import datetime
 from fritzconnection.lib.fritzstatus import FritzStatus
 from homeassistant.components.device_tracker import CONF_CONSIDER_HOME as CONF_CONSIDER_HOME, DEFAULT_CONSIDER_HOME as DEFAULT_CONSIDER_HOME
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, callback as callback
+from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
-from homeassistant.helpers import entity_registry as er, update_coordinator as update_coordinator
-from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
+from homeassistant.helpers.device_registry import CONNECTION_NETWORK_MAC as CONNECTION_NETWORK_MAC
 from homeassistant.helpers.dispatcher import async_dispatcher_send as async_dispatcher_send
-from homeassistant.helpers.entity import EntityDescription as EntityDescription
 from homeassistant.helpers.typing import StateType as StateType
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
 from types import MappingProxyType
 from typing import Any, TypedDict
 
@@ -20,7 +19,6 @@ _LOGGER: Incomplete
 
 def _is_tracked(mac: str, current_devices: ValuesView) -> bool: ...
 def device_filter_out_from_trackers(mac: str, device: FritzDevice, current_devices: ValuesView) -> bool: ...
-def _cleanup_entity_filter(device: er.RegistryEntry) -> bool: ...
 def _ha_is_stopping(activity: str) -> None: ...
 
 class ClassSetupMissing(Exception):
@@ -56,7 +54,8 @@ class UpdateCoordinatorDataType(TypedDict):
     call_deflections: dict[int, dict]
     entity_states: dict[str, StateType | bool]
 
-class FritzBoxTools(update_coordinator.DataUpdateCoordinator[UpdateCoordinatorDataType]):
+class FritzBoxTools(DataUpdateCoordinator[UpdateCoordinatorDataType]):
+    config_entry: ConfigEntry
     _devices: Incomplete
     _options: Incomplete
     _unique_id: Incomplete
@@ -118,8 +117,7 @@ class FritzBoxTools(update_coordinator.DataUpdateCoordinator[UpdateCoordinatorDa
     async def async_trigger_reboot(self) -> None: ...
     async def async_trigger_reconnect(self) -> None: ...
     async def async_trigger_set_guest_password(self, password: str | None, length: int) -> None: ...
-    async def async_trigger_cleanup(self, config_entry: ConfigEntry | None = None) -> None: ...
-    def _async_remove_empty_devices(self, entity_reg: er.EntityRegistry, config_entry: ConfigEntry) -> None: ...
+    async def async_trigger_cleanup(self) -> None: ...
     async def service_fritzbox(self, service_call: ServiceCall, config_entry: ConfigEntry) -> None: ...
 
 class AvmWrapper(FritzBoxTools):
@@ -144,22 +142,6 @@ class FritzData:
     wol_buttons: dict = ...
     def __init__(self, tracked, profile_switches, wol_buttons) -> None: ...
 
-class FritzDeviceBase(update_coordinator.CoordinatorEntity[AvmWrapper]):
-    _avm_wrapper: Incomplete
-    _mac: Incomplete
-    _name: Incomplete
-    def __init__(self, avm_wrapper: AvmWrapper, device: FritzDevice) -> None: ...
-    @property
-    def name(self) -> str: ...
-    @property
-    def ip_address(self) -> str | None: ...
-    @property
-    def mac_address(self) -> str: ...
-    @property
-    def hostname(self) -> str | None: ...
-    async def async_process_update(self) -> None: ...
-    async def async_on_demand_update(self) -> None: ...
-
 class FritzDevice:
     _connected: bool
     _connected_to: Incomplete
@@ -200,34 +182,6 @@ class SwitchInfo(TypedDict):
     callback_switch: Callable
     init_state: bool
 
-class FritzBoxBaseEntity:
-    _avm_wrapper: Incomplete
-    _device_name: Incomplete
-    def __init__(self, avm_wrapper: AvmWrapper, device_name: str) -> None: ...
-    @property
-    def mac_address(self) -> str: ...
-    @property
-    def device_info(self) -> DeviceInfo: ...
-
-@dataclass(frozen=True)
-class FritzRequireKeysMixin:
-    value_fn: Callable[[FritzStatus, Any], Any] | None
-    def __init__(self, value_fn) -> None: ...
-
-@dataclass(frozen=True)
-class FritzEntityDescription(EntityDescription, FritzRequireKeysMixin):
-    def __init__(self, value_fn, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement) -> None: ...
-
-class FritzBoxBaseCoordinatorEntity(update_coordinator.CoordinatorEntity[AvmWrapper]):
-    entity_description: FritzEntityDescription
-    _attr_has_entity_name: bool
-    _device_name: Incomplete
-    _attr_unique_id: Incomplete
-    def __init__(self, avm_wrapper: AvmWrapper, device_name: str, description: FritzEntityDescription) -> None: ...
-    async def async_added_to_hass(self) -> None: ...
-    @property
-    def device_info(self) -> DeviceInfo: ...
-
 @dataclass
 class ConnectionInfo:
     connection: str

homeassistant-stubs/components/fritz/device_tracker.pyi

@@ -1,5 +1,6 @@
-from .common import AvmWrapper as AvmWrapper, FritzData as FritzData, FritzDevice as FritzDevice, FritzDeviceBase as FritzDeviceBase, device_filter_out_from_trackers as device_filter_out_from_trackers
 from .const import DATA_FRITZ as DATA_FRITZ, DOMAIN as DOMAIN
+from .coordinator import AvmWrapper as AvmWrapper, FritzData as FritzData, FritzDevice as FritzDevice, device_filter_out_from_trackers as device_filter_out_from_trackers
+from .entity import FritzDeviceBase as FritzDeviceBase
 from _typeshed import Incomplete
 from homeassistant.components.device_tracker import ScannerEntity as ScannerEntity, SourceType as SourceType
 from homeassistant.config_entries import ConfigEntry as ConfigEntry

homeassistant-stubs/components/fritz/diagnostics.pyi

@@ -1,5 +1,5 @@
-from .common import AvmWrapper as AvmWrapper
 from .const import DOMAIN as DOMAIN
+from .coordinator import AvmWrapper as AvmWrapper
 from _typeshed import Incomplete
 from homeassistant.components.diagnostics import async_redact_data as async_redact_data
 from homeassistant.config_entries import ConfigEntry as ConfigEntry

homeassistant-stubs/components/fritz/entity.pyi

@@ -0,0 +1,50 @@
+from .const import DEFAULT_DEVICE_NAME as DEFAULT_DEVICE_NAME, DOMAIN as DOMAIN
+from .coordinator import AvmWrapper as AvmWrapper, FritzDevice as FritzDevice
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from fritzconnection.lib.fritzstatus import FritzStatus as FritzStatus
+from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
+from homeassistant.helpers.entity import EntityDescription as EntityDescription
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+from typing import Any
+
+class FritzDeviceBase(CoordinatorEntity[AvmWrapper]):
+    _avm_wrapper: Incomplete
+    _mac: Incomplete
+    _name: Incomplete
+    def __init__(self, avm_wrapper: AvmWrapper, device: FritzDevice) -> None: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def ip_address(self) -> str | None: ...
+    @property
+    def mac_address(self) -> str: ...
+    @property
+    def hostname(self) -> str | None: ...
+    async def async_process_update(self) -> None: ...
+    async def async_on_demand_update(self) -> None: ...
+
+class FritzBoxBaseEntity:
+    _avm_wrapper: Incomplete
+    _device_name: Incomplete
+    def __init__(self, avm_wrapper: AvmWrapper, device_name: str) -> None: ...
+    @property
+    def mac_address(self) -> str: ...
+    @property
+    def device_info(self) -> DeviceInfo: ...
+
+@dataclass(frozen=True, kw_only=True)
+class FritzEntityDescription(EntityDescription):
+    value_fn: Callable[[FritzStatus, Any], Any] | None
+    def __init__(self, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement, value_fn) -> None: ...
+
+class FritzBoxBaseCoordinatorEntity(CoordinatorEntity[AvmWrapper]):
+    entity_description: FritzEntityDescription
+    _attr_has_entity_name: bool
+    _device_name: Incomplete
+    _attr_unique_id: Incomplete
+    def __init__(self, avm_wrapper: AvmWrapper, device_name: str, description: FritzEntityDescription) -> None: ...
+    async def async_added_to_hass(self) -> None: ...
+    @property
+    def device_info(self) -> DeviceInfo: ...

homeassistant-stubs/components/fritz/image.pyi

@@ -1,5 +1,6 @@
-from .common import AvmWrapper as AvmWrapper, FritzBoxBaseEntity as FritzBoxBaseEntity
 from .const import DOMAIN as DOMAIN
+from .coordinator import AvmWrapper as AvmWrapper
+from .entity import FritzBoxBaseEntity as FritzBoxBaseEntity
 from _typeshed import Incomplete
 from homeassistant.components.image import ImageEntity as ImageEntity
 from homeassistant.config_entries import ConfigEntry as ConfigEntry

homeassistant-stubs/components/fritz/sensor.pyi

@@ -1,5 +1,6 @@
-from .common import AvmWrapper as AvmWrapper, ConnectionInfo as ConnectionInfo, FritzBoxBaseCoordinatorEntity as FritzBoxBaseCoordinatorEntity, FritzEntityDescription as FritzEntityDescription
 from .const import DOMAIN as DOMAIN, DSL_CONNECTION as DSL_CONNECTION, UPTIME_DEVIATION as UPTIME_DEVIATION
+from .coordinator import AvmWrapper as AvmWrapper, ConnectionInfo as ConnectionInfo
+from .entity import FritzBoxBaseCoordinatorEntity as FritzBoxBaseCoordinatorEntity, FritzEntityDescription as FritzEntityDescription
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
@@ -33,10 +34,10 @@ def _retrieve_link_noise_margin_received_state(status: FritzStatus, last_value:
 def _retrieve_link_attenuation_sent_state(status: FritzStatus, last_value: str) -> float: ...
 def _retrieve_link_attenuation_received_state(status: FritzStatus, last_value: str) -> float: ...
 
-@dataclass(frozen=True)
+@dataclass(frozen=True, kw_only=True)
 class FritzSensorEntityDescription(SensorEntityDescription, FritzEntityDescription):
     is_suitable: Callable[[ConnectionInfo], bool] = ...
-    def __init__(self, value_fn, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement, last_reset, native_unit_of_measurement, options, state_class, suggested_display_precision, suggested_unit_of_measurement, is_suitable) -> None: ...
+    def __init__(self, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement, value_fn, last_reset, native_unit_of_measurement, options, state_class, suggested_display_precision, suggested_unit_of_measurement, is_suitable) -> None: ...
 
 SENSOR_TYPES: tuple[FritzSensorEntityDescription, ...]
 

homeassistant-stubs/components/fritz/services.pyi

@@ -1,6 +1,6 @@
 import voluptuous as vol
-from .common import AvmWrapper as AvmWrapper
-from .const import DOMAIN as DOMAIN, FRITZ_SERVICES as FRITZ_SERVICES, SERVICE_CLEANUP as SERVICE_CLEANUP, SERVICE_REBOOT as SERVICE_REBOOT, SERVICE_RECONNECT as SERVICE_RECONNECT, SERVICE_SET_GUEST_WIFI_PW as SERVICE_SET_GUEST_WIFI_PW
+from .const import DOMAIN as DOMAIN, FRITZ_SERVICES as FRITZ_SERVICES, SERVICE_SET_GUEST_WIFI_PW as SERVICE_SET_GUEST_WIFI_PW
+from .coordinator import AvmWrapper as AvmWrapper
 from _typeshed import Incomplete
 from homeassistant.config_entries import ConfigEntryState as ConfigEntryState
 from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall

homeassistant-stubs/components/fritz/switch.pyi

@@ -1,5 +1,6 @@
-from .common import AvmWrapper as AvmWrapper, FritzBoxBaseEntity as FritzBoxBaseEntity, FritzData as FritzData, FritzDevice as FritzDevice, FritzDeviceBase as FritzDeviceBase, SwitchInfo as SwitchInfo, device_filter_out_from_trackers as device_filter_out_from_trackers
 from .const import DATA_FRITZ as DATA_FRITZ, DOMAIN as DOMAIN, MeshRoles as MeshRoles, SWITCH_TYPE_DEFLECTION as SWITCH_TYPE_DEFLECTION, SWITCH_TYPE_PORTFORWARD as SWITCH_TYPE_PORTFORWARD, SWITCH_TYPE_PROFILE as SWITCH_TYPE_PROFILE, SWITCH_TYPE_WIFINETWORK as SWITCH_TYPE_WIFINETWORK, WIFI_STANDARD as WIFI_STANDARD
+from .coordinator import AvmWrapper as AvmWrapper, FritzData as FritzData, FritzDevice as FritzDevice, SwitchInfo as SwitchInfo, device_filter_out_from_trackers as device_filter_out_from_trackers
+from .entity import FritzBoxBaseEntity as FritzBoxBaseEntity, FritzDeviceBase as FritzDeviceBase
 from _typeshed import Incomplete
 from homeassistant.components.network import async_get_source_ip as async_get_source_ip
 from homeassistant.components.switch import SwitchEntity as SwitchEntity, SwitchEntityDescription as SwitchEntityDescription

homeassistant-stubs/components/fritz/update.pyi

@@ -1,5 +1,6 @@
-from .common import AvmWrapper as AvmWrapper, FritzBoxBaseCoordinatorEntity as FritzBoxBaseCoordinatorEntity, FritzEntityDescription as FritzEntityDescription
 from .const import DOMAIN as DOMAIN
+from .coordinator import AvmWrapper as AvmWrapper
+from .entity import FritzBoxBaseCoordinatorEntity as FritzBoxBaseCoordinatorEntity, FritzEntityDescription as FritzEntityDescription
 from _typeshed import Incomplete
 from dataclasses import dataclass
 from homeassistant.components.update import UpdateEntity as UpdateEntity, UpdateEntityDescription as UpdateEntityDescription, UpdateEntityFeature as UpdateEntityFeature
@@ -11,9 +12,9 @@ from typing import Any
 
 _LOGGER: Incomplete
 
-@dataclass(frozen=True)
+@dataclass(frozen=True, kw_only=True)
 class FritzUpdateEntityDescription(UpdateEntityDescription, FritzEntityDescription):
-    def __init__(self, value_fn, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement) -> None: ...
+    def __init__(self, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement, value_fn) -> None: ...
 
 async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 

homeassistant-stubs/components/fritzbox/__init__.pyi

@@ -1,12 +1,10 @@
 import abc
-from .const import CONF_CONNECTIONS as CONF_CONNECTIONS, CONF_COORDINATOR as CONF_COORDINATOR, DOMAIN as DOMAIN, LOGGER as LOGGER, PLATFORMS as PLATFORMS
-from .coordinator import FritzboxDataUpdateCoordinator as FritzboxDataUpdateCoordinator
+from .const import DOMAIN as DOMAIN, LOGGER as LOGGER, PLATFORMS as PLATFORMS
+from .coordinator import FritzboxConfigEntry as FritzboxConfigEntry, FritzboxDataUpdateCoordinator as FritzboxDataUpdateCoordinator
 from _typeshed import Incomplete
 from abc import ABC, abstractmethod
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.const import CONF_HOST as CONF_HOST, CONF_PASSWORD as CONF_PASSWORD, CONF_USERNAME as CONF_USERNAME, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, UnitOfTemperature as UnitOfTemperature
+from homeassistant.const import EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, UnitOfTemperature as UnitOfTemperature
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant
-from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, ConfigEntryNotReady as ConfigEntryNotReady
 from homeassistant.helpers.device_registry import DeviceEntry as DeviceEntry, DeviceInfo as DeviceInfo
 from homeassistant.helpers.entity import EntityDescription as EntityDescription
 from homeassistant.helpers.entity_registry import RegistryEntry as RegistryEntry, async_migrate_entries as async_migrate_entries
@@ -14,9 +12,9 @@ from homeassistant.helpers.update_coordinator import CoordinatorEntity as Coordi
 from pyfritzhome import FritzhomeDevice as FritzhomeDevice
 from pyfritzhome.devicetypes.fritzhomeentitybase import FritzhomeEntityBase as FritzhomeEntityBase
 
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
-async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
-async def async_remove_config_entry_device(hass: HomeAssistant, entry: ConfigEntry, device: DeviceEntry) -> bool: ...
+async def async_setup_entry(hass: HomeAssistant, entry: FritzboxConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: FritzboxConfigEntry) -> bool: ...
+async def async_remove_config_entry_device(hass: HomeAssistant, entry: FritzboxConfigEntry, device: DeviceEntry) -> bool: ...
 
 class FritzBoxEntity(CoordinatorEntity[FritzboxDataUpdateCoordinator], ABC, metaclass=abc.ABCMeta):
     ain: Incomplete