homeassistant-stubs 2025.4.0b9__py3-none-any.whl → 2026.1.0b0__py3-none-any.whl

homeassistant-stubs/components/portainer/config_flow.pyi

@@ -0,0 +1,25 @@
+from .const import DOMAIN as DOMAIN
+from _typeshed import Incomplete
+from collections.abc import Mapping
+from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
+from homeassistant.const import CONF_API_TOKEN as CONF_API_TOKEN, CONF_URL as CONF_URL, CONF_VERIFY_SSL as CONF_VERIFY_SSL
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from typing import Any
+
+_LOGGER: Incomplete
+STEP_USER_DATA_SCHEMA: Incomplete
+
+async def _validate_input(hass: HomeAssistant, data: dict[str, Any]) -> None: ...
+
+class PortainerConfigFlow(ConfigFlow, domain=DOMAIN):
+    VERSION: int
+    async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
+    async def async_step_reauth_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_reconfigure(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+
+class CannotConnect(HomeAssistantError): ...
+class InvalidAuth(HomeAssistantError): ...
+class PortainerTimeout(HomeAssistantError): ...

homeassistant-stubs/components/portainer/const.pyi

@@ -0,0 +1,3 @@
+DOMAIN: str
+DEFAULT_NAME: str
+ENDPOINT_STATUS_DOWN: int

homeassistant-stubs/components/portainer/coordinator.pyi

@@ -0,0 +1,44 @@
+from .const import DOMAIN as DOMAIN, ENDPOINT_STATUS_DOWN as ENDPOINT_STATUS_DOWN
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import CONF_URL as CONF_URL
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, ConfigEntryNotReady as ConfigEntryNotReady
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from pyportainer import Portainer as Portainer
+from pyportainer.models.docker import DockerContainer as DockerContainer, DockerContainerStats as DockerContainerStats
+from pyportainer.models.docker_inspect import DockerInfo as DockerInfo, DockerVersion as DockerVersion
+from pyportainer.models.portainer import Endpoint as Endpoint
+
+type PortainerConfigEntry = ConfigEntry[PortainerCoordinator]
+_LOGGER: Incomplete
+DEFAULT_SCAN_INTERVAL: Incomplete
+
+@dataclass
+class PortainerCoordinatorData:
+    id: int
+    name: str | None
+    endpoint: Endpoint
+    containers: dict[str, PortainerContainerData]
+    docker_version: DockerVersion
+    docker_info: DockerInfo
+
+@dataclass(slots=True)
+class PortainerContainerData:
+    container: DockerContainer
+    stats: DockerContainerStats
+    stats_pre: DockerContainerStats | None
+
+class PortainerCoordinator(DataUpdateCoordinator[dict[int, PortainerCoordinatorData]]):
+    config_entry: PortainerConfigEntry
+    portainer: Incomplete
+    known_endpoints: set[int]
+    known_containers: set[tuple[int, str]]
+    new_endpoints_callbacks: list[Callable[[list[PortainerCoordinatorData]], None]]
+    new_containers_callbacks: list[Callable[[list[tuple[PortainerCoordinatorData, PortainerContainerData]]], None]]
+    def __init__(self, hass: HomeAssistant, config_entry: PortainerConfigEntry, portainer: Portainer) -> None: ...
+    async def _async_setup(self) -> None: ...
+    async def _async_update_data(self) -> dict[int, PortainerCoordinatorData]: ...
+    def _async_add_remove_endpoints(self, mapped_endpoints: dict[int, PortainerCoordinatorData]) -> None: ...

homeassistant-stubs/components/portainer/diagnostics.pyi

@@ -0,0 +1,12 @@
+from . import PortainerConfigEntry as PortainerConfigEntry
+from .coordinator import PortainerCoordinator as PortainerCoordinator
+from _typeshed import Incomplete
+from homeassistant.components.diagnostics import async_redact_data as async_redact_data
+from homeassistant.const import CONF_API_TOKEN as CONF_API_TOKEN
+from homeassistant.core import HomeAssistant as HomeAssistant
+from typing import Any
+
+TO_REDACT: Incomplete
+
+def _serialize_coordinator(coordinator: PortainerCoordinator) -> dict[str, Any]: ...
+async def async_get_config_entry_diagnostics(hass: HomeAssistant, config_entry: PortainerConfigEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/portainer/entity.pyi

@@ -0,0 +1,25 @@
+from .const import DEFAULT_NAME as DEFAULT_NAME, DOMAIN as DOMAIN
+from .coordinator import PortainerContainerData as PortainerContainerData, PortainerCoordinator as PortainerCoordinator, PortainerCoordinatorData as PortainerCoordinatorData
+from _typeshed import Incomplete
+from homeassistant.const import CONF_URL as CONF_URL
+from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+
+class PortainerCoordinatorEntity(CoordinatorEntity[PortainerCoordinator]):
+    _attr_has_entity_name: bool
+
+class PortainerEndpointEntity(PortainerCoordinatorEntity):
+    _device_info: Incomplete
+    device_id: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, device_info: PortainerCoordinatorData, coordinator: PortainerCoordinator) -> None: ...
+
+class PortainerContainerEntity(PortainerCoordinatorEntity):
+    _device_info: Incomplete
+    device_id: Incomplete
+    endpoint_id: Incomplete
+    device_name: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, device_info: PortainerContainerData, coordinator: PortainerCoordinator, via_device: PortainerCoordinatorData) -> None: ...
+    @property
+    def container_data(self) -> PortainerContainerData: ...

homeassistant-stubs/components/portainer/sensor.pyi

@@ -0,0 +1,40 @@
+from .coordinator import PortainerConfigEntry as PortainerConfigEntry, PortainerContainerData as PortainerContainerData, PortainerCoordinator as PortainerCoordinator
+from .entity import PortainerContainerEntity as PortainerContainerEntity, PortainerCoordinatorData as PortainerCoordinatorData, PortainerEndpointEntity as PortainerEndpointEntity
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.sensor import EntityCategory as EntityCategory, SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass, StateType as StateType
+from homeassistant.const import PERCENTAGE as PERCENTAGE, UnitOfInformation as UnitOfInformation
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+
+@dataclass(frozen=True, kw_only=True)
+class PortainerContainerSensorEntityDescription(SensorEntityDescription):
+    value_fn: Callable[[PortainerContainerData], StateType]
+
+@dataclass(frozen=True, kw_only=True)
+class PortainerEndpointSensorEntityDescription(SensorEntityDescription):
+    value_fn: Callable[[PortainerCoordinatorData], StateType]
+
+CONTAINER_SENSORS: tuple[PortainerContainerSensorEntityDescription, ...]
+ENDPOINT_SENSORS: tuple[PortainerEndpointSensorEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: PortainerConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class PortainerContainerSensor(PortainerContainerEntity, SensorEntity):
+    entity_description: PortainerContainerSensorEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: PortainerCoordinator, entity_description: PortainerContainerSensorEntityDescription, device_info: PortainerContainerData, via_device: PortainerCoordinatorData) -> None: ...
+    @property
+    def available(self) -> bool: ...
+    @property
+    def native_value(self) -> StateType: ...
+
+class PortainerEndpointSensor(PortainerEndpointEntity, SensorEntity):
+    entity_description: PortainerEndpointSensorEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: PortainerCoordinator, entity_description: PortainerEndpointSensorEntityDescription, device_info: PortainerCoordinatorData) -> None: ...
+    @property
+    def available(self) -> bool: ...
+    @property
+    def native_value(self) -> StateType: ...

homeassistant-stubs/components/portainer/switch.pyi

@@ -0,0 +1,34 @@
+from . import PortainerConfigEntry as PortainerConfigEntry
+from .const import DOMAIN as DOMAIN
+from .coordinator import PortainerContainerData as PortainerContainerData, PortainerCoordinator as PortainerCoordinator
+from .entity import PortainerContainerEntity as PortainerContainerEntity, PortainerCoordinatorData as PortainerCoordinatorData
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable, Coroutine
+from dataclasses import dataclass
+from homeassistant.components.switch import SwitchDeviceClass as SwitchDeviceClass, SwitchEntity as SwitchEntity, SwitchEntityDescription as SwitchEntityDescription
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from pyportainer import Portainer as Portainer
+from typing import Any
+
+@dataclass(frozen=True, kw_only=True)
+class PortainerSwitchEntityDescription(SwitchEntityDescription):
+    is_on_fn: Callable[[PortainerContainerData], bool | None]
+    turn_on_fn: Callable[[str, Portainer, int, str], Coroutine[Any, Any, None]]
+    turn_off_fn: Callable[[str, Portainer, int, str], Coroutine[Any, Any, None]]
+
+async def perform_action(action: str, portainer: Portainer, endpoint_id: int, container_id: str) -> None: ...
+
+SWITCHES: tuple[PortainerSwitchEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: PortainerConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class PortainerContainerSwitch(PortainerContainerEntity, SwitchEntity):
+    entity_description: PortainerSwitchEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: PortainerCoordinator, entity_description: PortainerSwitchEntityDescription, device_info: PortainerContainerData, via_device: PortainerCoordinatorData) -> None: ...
+    @property
+    def is_on(self) -> bool | None: ...
+    async def async_turn_on(self, **kwargs: Any) -> None: ...
+    async def async_turn_off(self, **kwargs: Any) -> None: ...

homeassistant-stubs/components/powerwall/sensor.pyi

@@ -56,7 +56,6 @@ class PowerWallBackupReserveSensor(PowerWallEntity, SensorEntity):
     _attr_translation_key: str
     _attr_state_class: Incomplete
     _attr_native_unit_of_measurement = PERCENTAGE
-    _attr_device_class: Incomplete
     @property
     def unique_id(self) -> str: ...
     @property

homeassistant-stubs/components/prometheus/__init__.pyi

@@ -1,6 +1,6 @@
 from _typeshed import Incomplete
 from aiohttp import web
-from collections.abc import Callable as Callable
+from collections.abc import Callable as Callable, Sequence
 from dataclasses import dataclass
 from homeassistant.components.alarm_control_panel import AlarmControlPanelState as AlarmControlPanelState
 from homeassistant.components.climate import ATTR_CURRENT_TEMPERATURE as ATTR_CURRENT_TEMPERATURE, ATTR_FAN_MODE as ATTR_FAN_MODE, ATTR_FAN_MODES as ATTR_FAN_MODES, ATTR_HVAC_ACTION as ATTR_HVAC_ACTION, ATTR_HVAC_MODES as ATTR_HVAC_MODES, ATTR_TARGET_TEMP_HIGH as ATTR_TARGET_TEMP_HIGH, ATTR_TARGET_TEMP_LOW as ATTR_TARGET_TEMP_LOW, HVACAction as HVACAction
@@ -12,9 +12,12 @@ from homeassistant.components.light import ATTR_BRIGHTNESS as ATTR_BRIGHTNESS
 from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass
 from homeassistant.const import ATTR_BATTERY_LEVEL as ATTR_BATTERY_LEVEL, ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_MODE as ATTR_MODE, ATTR_TEMPERATURE as ATTR_TEMPERATURE, ATTR_UNIT_OF_MEASUREMENT as ATTR_UNIT_OF_MEASUREMENT, CONTENT_TYPE_TEXT_PLAIN as CONTENT_TYPE_TEXT_PLAIN, EVENT_STATE_CHANGED as EVENT_STATE_CHANGED, PERCENTAGE as PERCENTAGE, STATE_CLOSED as STATE_CLOSED, STATE_CLOSING as STATE_CLOSING, STATE_ON as STATE_ON, STATE_OPEN as STATE_OPEN, STATE_OPENING as STATE_OPENING, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN, UnitOfTemperature as UnitOfTemperature
 from homeassistant.core import Event as Event, EventStateChangedData as EventStateChangedData, HomeAssistant as HomeAssistant, State as State
-from homeassistant.helpers import entityfilter as entityfilter
+from homeassistant.helpers import area_registry as ar, device_registry as dr, entity_registry as er, entityfilter as entityfilter, floor_registry as fr
+from homeassistant.helpers.area_registry import AreaEntry as AreaEntry, EVENT_AREA_REGISTRY_UPDATED as EVENT_AREA_REGISTRY_UPDATED, EventAreaRegistryUpdatedData as EventAreaRegistryUpdatedData
+from homeassistant.helpers.device_registry import EVENT_DEVICE_REGISTRY_UPDATED as EVENT_DEVICE_REGISTRY_UPDATED, EventDeviceRegistryUpdatedData as EventDeviceRegistryUpdatedData
 from homeassistant.helpers.entity_registry import EVENT_ENTITY_REGISTRY_UPDATED as EVENT_ENTITY_REGISTRY_UPDATED, EventEntityRegistryUpdatedData as EventEntityRegistryUpdatedData
 from homeassistant.helpers.entity_values import EntityValues as EntityValues
+from homeassistant.helpers.floor_registry import EVENT_FLOOR_REGISTRY_UPDATED as EVENT_FLOOR_REGISTRY_UPDATED, EventFloorRegistryUpdatedData as EventFloorRegistryUpdatedData, FloorEntry as FloorEntry
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from homeassistant.util.dt import as_timestamp as as_timestamp
 from homeassistant.util.unit_conversion import TemperatureConverter as TemperatureConverter
@@ -55,10 +58,21 @@ class PrometheusMetrics:
     _metrics: dict[str, MetricWrapperBase]
     _metrics_by_entity_id: dict[str, set[MetricNameWithLabelValues]]
     _climate_units: Incomplete
-    def __init__(self, entity_filter: entityfilter.EntityFilter, namespace: str, climate_units: UnitOfTemperature, component_config: EntityValues, override_metric: str | None, default_metric: str | None) -> None: ...
+    _area_info_metrics: dict[str, MetricNameWithLabelValues]
+    _floor_info_metrics: dict[str, MetricNameWithLabelValues]
+    area_registry: Incomplete
+    device_registry: Incomplete
+    entity_registry: Incomplete
+    floor_registry: Incomplete
+    def __init__(self, entity_filter: entityfilter.EntityFilter, namespace: str, climate_units: UnitOfTemperature, component_config: EntityValues, override_metric: str | None, default_metric: str | None, area_registry: ar.AreaRegistry, device_registry: dr.DeviceRegistry, entity_registry: er.EntityRegistry, floor_registry: fr.FloorRegistry) -> None: ...
     def handle_state_changed_event(self, event: Event[EventStateChangedData]) -> None: ...
     def handle_state(self, state: State) -> None: ...
     def handle_entity_registry_updated(self, event: Event[EventEntityRegistryUpdatedData]) -> None: ...
+    def handle_device_registry_updated(self, event: Event[EventDeviceRegistryUpdatedData]) -> None: ...
+    def handle_area_registry_updated(self, event: Event[EventAreaRegistryUpdatedData]) -> None: ...
+    def handle_area(self, area: AreaEntry) -> None: ...
+    def handle_floor_registry_updated(self, event: Event[EventFloorRegistryUpdatedData]) -> None: ...
+    def handle_floor(self, floor: FloorEntry) -> None: ...
     def _remove_labelsets(self, entity_id: str, ignored_metric_names: set[str] | None = None) -> None: ...
     def _handle_attributes(self, state: State) -> None: ...
     def _metric[_MetricBaseT: MetricWrapperBase](self, metric_name: str, factory: type[_MetricBaseT], documentation: str, labels: dict[str, str]) -> _MetricBaseT: ...
@@ -68,20 +82,34 @@ class PrometheusMetrics:
     def state_as_number(state: State) -> float | None: ...
     @staticmethod
     def _labels(state: State, extra_labels: dict[str, str] | None = None) -> dict[str, Any]: ...
-    def _battery(self, state: State) -> None: ...
+    def _remove_entity_info(self, entity_id: str) -> None: ...
+    def _add_entity_info(self, entity_id: str, area_id: str) -> None: ...
+    def _find_area_id(self, entity_id: str) -> str | None: ...
+    def _battery_metric(self, state: State) -> None: ...
+    def _temperature_metric(self, state: State, attr: str, metric_name: str, metric_description: str) -> None: ...
+    def _bool_metric(self, state: State, attr: str, metric_name: str, metric_description: str, true_values: set[Any] | None = None) -> None: ...
+    def _float_metric(self, state: State, attr: str, metric_name: str, metric_description: str) -> None: ...
+    def _enum_metric(self, state: State, current_value: Any | None, values: Sequence[str] | None, metric_name: str, metric_description: str, enum_label_name: str) -> None: ...
+    def _numeric_metric(self, state: State, domain: str, title: str) -> None: ...
     def _handle_binary_sensor(self, state: State) -> None: ...
     def _handle_input_boolean(self, state: State) -> None: ...
-    def _numeric_handler(self, state: State, domain: str, title: str) -> None: ...
     def _handle_input_number(self, state: State) -> None: ...
     def _handle_number(self, state: State) -> None: ...
     def _handle_device_tracker(self, state: State) -> None: ...
     def _handle_person(self, state: State) -> None: ...
+    def _handle_lock(self, state: State) -> None: ...
     def _handle_cover(self, state: State) -> None: ...
     def _handle_light(self, state: State) -> None: ...
-    def _handle_lock(self, state: State) -> None: ...
-    def _handle_climate_temp(self, state: State, attr: str, metric_name: str, metric_description: str) -> None: ...
     def _handle_climate(self, state: State) -> None: ...
     def _handle_humidifier(self, state: State) -> None: ...
+    def _handle_water_heater(self, state: State) -> None: ...
+    def _handle_switch(self, state: State) -> None: ...
+    def _handle_fan(self, state: State) -> None: ...
+    def _handle_zwave(self, state: State) -> None: ...
+    def _handle_automation(self, state: State) -> None: ...
+    def _handle_counter(self, state: State) -> None: ...
+    def _handle_update(self, state: State) -> None: ...
+    def _handle_alarm_control_panel(self, state: State) -> None: ...
     def _handle_sensor(self, state: State) -> None: ...
     def _sensor_default_metric(self, state: State, unit: str | None) -> str | None: ...
     @staticmethod
@@ -94,13 +122,6 @@ class PrometheusMetrics:
     def _sensor_fallback_metric(state: State, unit: str | None) -> str | None: ...
     @staticmethod
     def _unit_string(unit: str | None) -> str | None: ...
-    def _handle_switch(self, state: State) -> None: ...
-    def _handle_fan(self, state: State) -> None: ...
-    def _handle_zwave(self, state: State) -> None: ...
-    def _handle_automation(self, state: State) -> None: ...
-    def _handle_counter(self, state: State) -> None: ...
-    def _handle_update(self, state: State) -> None: ...
-    def _handle_alarm_control_panel(self, state: State) -> None: ...
 
 class PrometheusView(HomeAssistantView):
     url = API_ENDPOINT

homeassistant-stubs/components/proximity/__init__.pyi

@@ -9,4 +9,3 @@ _LOGGER: Incomplete
 
 async def async_setup_entry(hass: HomeAssistant, entry: ProximityConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: ProximityConfigEntry) -> bool: ...
-async def _async_update_listener(hass: HomeAssistant, entry: ProximityConfigEntry) -> None: ...

homeassistant-stubs/components/proximity/config_flow.pyi

@@ -1,6 +1,6 @@
 import voluptuous as vol
 from .const import CONF_IGNORED_ZONES as CONF_IGNORED_ZONES, CONF_TOLERANCE as CONF_TOLERANCE, CONF_TRACKED_ENTITIES as CONF_TRACKED_ENTITIES, DEFAULT_PROXIMITY_ZONE as DEFAULT_PROXIMITY_ZONE, DEFAULT_TOLERANCE as DEFAULT_TOLERANCE, DOMAIN as DOMAIN
-from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlow as OptionsFlow
+from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlowWithReload as OptionsFlowWithReload
 from homeassistant.const import CONF_ZONE as CONF_ZONE, UnitOfLength as UnitOfLength
 from homeassistant.core import State as State, callback as callback
 from homeassistant.helpers.selector import EntitySelector as EntitySelector, EntitySelectorConfig as EntitySelectorConfig, NumberSelector as NumberSelector, NumberSelectorConfig as NumberSelectorConfig
@@ -17,9 +17,9 @@ class ProximityConfigFlow(ConfigFlow, domain=DOMAIN):
     def _user_form_schema(self, user_input: dict[str, Any] | None = None) -> vol.Schema: ...
     @staticmethod
     @callback
-    def async_get_options_flow(config_entry: ConfigEntry) -> OptionsFlow: ...
+    def async_get_options_flow(config_entry: ConfigEntry) -> ProximityOptionsFlow: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
 
-class ProximityOptionsFlow(OptionsFlow):
+class ProximityOptionsFlow(OptionsFlowWithReload):
     def _user_form_schema(self, user_input: dict[str, Any]) -> vol.Schema: ...
     async def async_step_init(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/prusalink/coordinator.pyi

@@ -5,11 +5,13 @@ from abc import ABC, abstractmethod
 from datetime import timedelta
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.debounce import Debouncer as Debouncer
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
 from pyprusalink import JobInfo, LegacyPrinterStatus, PrinterInfo, PrinterStatus, PrusaLink as PrusaLink
 from typing import TypeVar
 
 _LOGGER: Incomplete
+_MINIMUM_REFRESH_INTERVAL: float
 T = TypeVar('T', PrinterStatus, LegacyPrinterStatus, JobInfo)
 
 class PrusaLinkUpdateCoordinator(DataUpdateCoordinator[T], ABC, metaclass=abc.ABCMeta):

homeassistant-stubs/components/purpleair/__init__.pyi

@@ -3,5 +3,4 @@ from .coordinator import PurpleAirConfigEntry as PurpleAirConfigEntry, PurpleAir
 from homeassistant.core import HomeAssistant as HomeAssistant
 
 async def async_setup_entry(hass: HomeAssistant, entry: PurpleAirConfigEntry) -> bool: ...
-async def async_reload_entry(hass: HomeAssistant, entry: PurpleAirConfigEntry) -> None: ...
 async def async_unload_entry(hass: HomeAssistant, entry: PurpleAirConfigEntry) -> bool: ...

homeassistant-stubs/components/purpleair/config_flow.pyi

@@ -5,7 +5,7 @@ from aiopurpleair import API
 from aiopurpleair.endpoints.sensors import NearbySensorResult as NearbySensorResult
 from collections.abc import Mapping
 from dataclasses import dataclass, field
-from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlow as OptionsFlow
+from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlowWithReload as OptionsFlowWithReload
 from homeassistant.const import CONF_API_KEY as CONF_API_KEY, CONF_LATITUDE as CONF_LATITUDE, CONF_LONGITUDE as CONF_LONGITUDE, CONF_SHOW_ON_MAP as CONF_SHOW_ON_MAP
 from homeassistant.core import Event as Event, EventStateChangedData as EventStateChangedData, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers import aiohttp_client as aiohttp_client
@@ -54,7 +54,7 @@ class PurpleAirConfigFlow(ConfigFlow, domain=DOMAIN):
     async def async_step_reauth_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
 
-class PurpleAirOptionsFlowHandler(OptionsFlow):
+class PurpleAirOptionsFlowHandler(OptionsFlowWithReload):
     _flow_data: dict[str, Any]
     def __init__(self) -> None: ...
     @property

homeassistant-stubs/components/pushbullet/sensor.pyi

@@ -3,7 +3,7 @@ from .const import DATA_UPDATED as DATA_UPDATED, DOMAIN as DOMAIN
 from _typeshed import Incomplete
 from homeassistant.components.sensor import SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.const import CONF_NAME as CONF_NAME
+from homeassistant.const import CONF_NAME as CONF_NAME, MAX_LENGTH_STATE_STATE as MAX_LENGTH_STATE_STATE
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.device_registry import DeviceEntryType as DeviceEntryType, DeviceInfo as DeviceInfo
 from homeassistant.helpers.dispatcher import async_dispatcher_connect as async_dispatcher_connect

homeassistant-stubs/components/pyload/config_flow.pyi

@@ -6,18 +6,23 @@ from homeassistant.const import CONF_NAME as CONF_NAME, CONF_PASSWORD as CONF_PA
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.aiohttp_client import async_create_clientsession as async_create_clientsession
 from homeassistant.helpers.selector import TextSelector as TextSelector, TextSelectorConfig as TextSelectorConfig, TextSelectorType as TextSelectorType
+from homeassistant.helpers.service_info.hassio import HassioServiceInfo as HassioServiceInfo
 from typing import Any
 
 _LOGGER: Incomplete
 STEP_USER_DATA_SCHEMA: Incomplete
 REAUTH_SCHEMA: Incomplete
+PLACEHOLDER: Incomplete
 
 async def validate_input(hass: HomeAssistant, user_input: dict[str, Any]) -> None: ...
 
 class PyLoadConfigFlow(ConfigFlow, domain=DOMAIN):
     VERSION: int
     MINOR_VERSION: int
+    _hassio_discovery: HassioServiceInfo | None
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
     async def async_step_reauth_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_reconfigure(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_hassio(self, discovery_info: HassioServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_hassio_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/qbus/binary_sensor.pyi

@@ -0,0 +1,43 @@
+from .const import DOMAIN as DOMAIN
+from .coordinator import QbusConfigEntry as QbusConfigEntry
+from .entity import QbusEntity as QbusEntity, create_device_identifier as create_device_identifier, create_unique_id as create_unique_id, determine_new_outputs as determine_new_outputs
+from _typeshed import Incomplete
+from dataclasses import dataclass
+from homeassistant.components.binary_sensor import BinarySensorDeviceClass as BinarySensorDeviceClass, BinarySensorEntity as BinarySensorEntity, BinarySensorEntityDescription as BinarySensorEntityDescription
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
+from homeassistant.helpers.dispatcher import async_dispatcher_connect as async_dispatcher_connect
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from qbusmqttapi.discovery import QbusMqttDevice as QbusMqttDevice, QbusMqttOutput as QbusMqttOutput
+from qbusmqttapi.state import QbusMqttDeviceState as QbusMqttDeviceState, QbusMqttWeatherState
+
+PARALLEL_UPDATES: int
+
+@dataclass(frozen=True, kw_only=True)
+class QbusWeatherDescription(BinarySensorEntityDescription):
+    property: str
+
+_WEATHER_DESCRIPTIONS: Incomplete
+
+async def async_setup_entry(hass: HomeAssistant, entry: QbusConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class QbusWeatherBinarySensor(QbusEntity, BinarySensorEntity):
+    _state_cls = QbusMqttWeatherState
+    entity_description: QbusWeatherDescription
+    def __init__(self, mqtt_output: QbusMqttOutput, description: QbusWeatherDescription) -> None: ...
+    _attr_is_on: Incomplete
+    async def _handle_state_received(self, state: QbusMqttWeatherState) -> None: ...
+
+class QbusControllerConnectedBinarySensor(BinarySensorEntity):
+    _attr_has_entity_name: bool
+    _attr_name: Incomplete
+    _attr_should_poll: bool
+    _attr_device_class: Incomplete
+    _controller: Incomplete
+    _attr_unique_id: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, controller: QbusMqttDevice) -> None: ...
+    async def async_added_to_hass(self) -> None: ...
+    _attr_is_on: Incomplete
+    @callback
+    def _state_received(self, state: QbusMqttDeviceState) -> None: ...

homeassistant-stubs/components/qbus/climate.pyi

@@ -1,15 +1,15 @@
 from .const import DOMAIN as DOMAIN
 from .coordinator import QbusConfigEntry as QbusConfigEntry
-from .entity import QbusEntity as QbusEntity, add_new_outputs as add_new_outputs
+from .entity import QbusEntity as QbusEntity, create_new_entities as create_new_entities
 from _typeshed import Incomplete
 from homeassistant.components.climate import ClimateEntity as ClimateEntity, ClimateEntityFeature as ClimateEntityFeature, HVACAction as HVACAction, HVACMode as HVACMode
-from homeassistant.components.mqtt import ReceiveMessage as ReceiveMessage
 from homeassistant.const import ATTR_TEMPERATURE as ATTR_TEMPERATURE, UnitOfTemperature as UnitOfTemperature
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import ServiceValidationError as ServiceValidationError
 from homeassistant.helpers.debounce import Debouncer as Debouncer
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 from qbusmqttapi.discovery import QbusMqttOutput as QbusMqttOutput
+from qbusmqttapi.state import QbusMqttThermoState
 from typing import Any
 
 PARALLEL_UPDATES: int
@@ -19,6 +19,8 @@ _LOGGER: Incomplete
 async def async_setup_entry(hass: HomeAssistant, entry: QbusConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
 class QbusClimate(QbusEntity, ClimateEntity):
+    _state_cls = QbusMqttThermoState
+    _attr_name: Incomplete
     _attr_hvac_modes: Incomplete
     _attr_supported_features: Incomplete
     _attr_temperature_unit: Incomplete
@@ -36,6 +38,6 @@ class QbusClimate(QbusEntity, ClimateEntity):
     async def async_set_temperature(self, **kwargs: Any) -> None: ...
     _attr_current_temperature: Incomplete
     _attr_target_temperature: Incomplete
-    async def _state_received(self, msg: ReceiveMessage) -> None: ...
+    async def _handle_state_received(self, state: QbusMqttThermoState) -> None: ...
     def _set_hvac_action(self) -> None: ...
     async def _async_request_state(self) -> None: ...

homeassistant-stubs/components/qbus/coordinator.pyi

@@ -5,16 +5,17 @@ from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, HomeAssistant as HomeAssistant
 from homeassistant.helpers.device_registry import format_mac as format_mac
+from homeassistant.helpers.dispatcher import async_dispatcher_send as async_dispatcher_send
 from homeassistant.helpers.event import async_call_later as async_call_later
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator
 from homeassistant.util.hass_dict import HassKey as HassKey
-from qbusmqttapi.discovery import QbusDiscovery as QbusDiscovery, QbusMqttDevice as QbusMqttDevice, QbusMqttOutput
+from qbusmqttapi.discovery import QbusDiscovery as QbusDiscovery, QbusMqttDevice
 
 _LOGGER: Incomplete
 type QbusConfigEntry = ConfigEntry[QbusControllerCoordinator]
 QBUS_KEY: HassKey[QbusConfigCoordinator]
 
-class QbusControllerCoordinator(DataUpdateCoordinator[list[QbusMqttOutput]]):
+class QbusControllerCoordinator(DataUpdateCoordinator[QbusMqttDevice | None]):
     _STATE_REQUEST_DELAY: int
     config_entry: QbusConfigEntry
     _message_factory: Incomplete
@@ -23,7 +24,7 @@ class QbusControllerCoordinator(DataUpdateCoordinator[list[QbusMqttOutput]]):
     _subscribed_to_controller_state: bool
     _controller: QbusMqttDevice | None
     def __init__(self, hass: HomeAssistant, entry: QbusConfigEntry) -> None: ...
-    async def _async_update_data(self) -> list[QbusMqttOutput]: ...
+    async def _async_update_data(self) -> QbusMqttDevice | None: ...
     def shutdown(self, event: Event | None = None) -> None: ...
     async def async_update_controller_config(self, config: QbusDiscovery) -> None: ...
     def _update_device_info(self) -> None: ...

homeassistant-stubs/components/qbus/cover.pyi

@@ -0,0 +1,39 @@
+from .coordinator import QbusConfigEntry as QbusConfigEntry
+from .entity import QbusEntity as QbusEntity, create_new_entities as create_new_entities
+from _typeshed import Incomplete
+from homeassistant.components.cover import ATTR_POSITION as ATTR_POSITION, ATTR_TILT_POSITION as ATTR_TILT_POSITION, CoverDeviceClass as CoverDeviceClass, CoverEntity as CoverEntity, CoverEntityFeature as CoverEntityFeature
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from qbusmqttapi.discovery import QbusMqttOutput as QbusMqttOutput
+from qbusmqttapi.state import QbusMqttShutterState
+from typing import Any
+
+PARALLEL_UPDATES: int
+
+async def async_setup_entry(hass: HomeAssistant, entry: QbusConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class QbusCover(QbusEntity, CoverEntity):
+    _state_cls = QbusMqttShutterState
+    _attr_name: Incomplete
+    _attr_supported_features: CoverEntityFeature
+    _attr_device_class: Incomplete
+    _attr_assumed_state: bool
+    _attr_current_cover_position: int
+    _attr_current_cover_tilt_position: int
+    _attr_is_closed: bool
+    _target_shutter_position: int | None
+    _target_slat_position: int | None
+    _target_state: str | None
+    _previous_state: str | None
+    def __init__(self, mqtt_output: QbusMqttOutput) -> None: ...
+    async def async_open_cover(self, **kwargs: Any) -> None: ...
+    async def async_close_cover(self, **kwargs: Any) -> None: ...
+    async def async_stop_cover(self, **kwargs: Any) -> None: ...
+    async def async_set_cover_position(self, **kwargs: Any) -> None: ...
+    async def async_open_cover_tilt(self, **kwargs: Any) -> None: ...
+    async def async_close_cover_tilt(self, **kwargs: Any) -> None: ...
+    async def async_set_cover_tilt_position(self, **kwargs: Any) -> None: ...
+    async def _handle_state_received(self, state: QbusMqttShutterState) -> None: ...
+    def _update_is_closed(self) -> None: ...
+    def _update_cover_position(self) -> None: ...
+    def _update_tilt_position(self) -> None: ...

homeassistant-stubs/components/qbus/entity.pyi

@@ -7,27 +7,30 @@ from collections.abc import Callable as Callable
 from homeassistant.components.mqtt import ReceiveMessage as ReceiveMessage
 from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo, format_mac as format_mac
 from homeassistant.helpers.entity import Entity as Entity
-from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
-from qbusmqttapi.discovery import QbusMqttOutput as QbusMqttOutput
-from qbusmqttapi.state import QbusMqttState as QbusMqttState
+from qbusmqttapi.discovery import QbusMqttDevice as QbusMqttDevice, QbusMqttOutput as QbusMqttOutput
+from qbusmqttapi.state import QbusMqttState
 
 _REFID_REGEX: Incomplete
 
-def add_new_outputs(coordinator: QbusControllerCoordinator, added_outputs: list[QbusMqttOutput], filter_fn: Callable[[QbusMqttOutput], bool], entity_type: type[QbusEntity], async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+def create_new_entities(coordinator: QbusControllerCoordinator, added_outputs: list[QbusMqttOutput], filter_fn: Callable[[QbusMqttOutput], bool], entity_type: type[QbusEntity]) -> list[QbusEntity]: ...
+def determine_new_outputs(coordinator: QbusControllerCoordinator, added_outputs: list[QbusMqttOutput], filter_fn: Callable[[QbusMqttOutput], bool]) -> list[QbusMqttOutput]: ...
 def format_ref_id(ref_id: str) -> str | None: ...
+def create_device_identifier(mqtt_device: QbusMqttDevice) -> tuple[str, str]: ...
+def create_unique_id(serial_number: str, suffix: str) -> str: ...
 
-class QbusEntity(Entity, ABC, metaclass=abc.ABCMeta):
+class QbusEntity[StateT: QbusMqttState](Entity, ABC, metaclass=abc.ABCMeta):
+    _state_cls: type[StateT]
     _attr_has_entity_name: bool
-    _attr_name: Incomplete
     _attr_should_poll: bool
+    _mqtt_output: Incomplete
     _topic_factory: Incomplete
     _message_factory: Incomplete
+    _state_topic: Incomplete
     _attr_unique_id: Incomplete
     _attr_device_info: Incomplete
-    _mqtt_output: Incomplete
-    _state_topic: Incomplete
-    def __init__(self, mqtt_output: QbusMqttOutput) -> None: ...
+    def __init__(self, mqtt_output: QbusMqttOutput, *, id_suffix: str = '', link_to_main_device: bool = False) -> None: ...
     async def async_added_to_hass(self) -> None: ...
-    @abstractmethod
     async def _state_received(self, msg: ReceiveMessage) -> None: ...
+    @abstractmethod
+    async def _handle_state_received(self, state: StateT) -> None: ...
     async def _async_publish_output_state(self, state: QbusMqttState) -> None: ...

homeassistant-stubs/components/qbus/light.pyi

@@ -1,12 +1,12 @@
 from .coordinator import QbusConfigEntry as QbusConfigEntry
-from .entity import QbusEntity as QbusEntity, add_new_outputs as add_new_outputs
+from .entity import QbusEntity as QbusEntity, create_new_entities as create_new_entities
 from _typeshed import Incomplete
 from homeassistant.components.light import ATTR_BRIGHTNESS as ATTR_BRIGHTNESS, ColorMode as ColorMode, LightEntity as LightEntity
-from homeassistant.components.mqtt import ReceiveMessage as ReceiveMessage
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 from homeassistant.util.color import brightness_to_value as brightness_to_value, value_to_brightness as value_to_brightness
 from qbusmqttapi.discovery import QbusMqttOutput as QbusMqttOutput
+from qbusmqttapi.state import QbusMqttAnalogState
 from typing import Any
 
 PARALLEL_UPDATES: int
@@ -14,12 +14,14 @@ PARALLEL_UPDATES: int
 async def async_setup_entry(hass: HomeAssistant, entry: QbusConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
 class QbusLight(QbusEntity, LightEntity):
+    _state_cls = QbusMqttAnalogState
+    _attr_name: Incomplete
     _attr_supported_color_modes: Incomplete
     _attr_color_mode: Incomplete
     def __init__(self, mqtt_output: QbusMqttOutput) -> None: ...
     async def async_turn_on(self, **kwargs: Any) -> None: ...
     async def async_turn_off(self, **kwargs: Any) -> None: ...
-    async def _state_received(self, msg: ReceiveMessage) -> None: ...
+    async def _handle_state_received(self, state: QbusMqttAnalogState) -> None: ...
     _attr_is_on: Incomplete
     _attr_brightness: Incomplete
-    def _set_state(self, percentage: int = 0) -> None: ...
+    def _set_state(self, percentage: int) -> None: ...