homeassistant-stubs 2025.7.4__py3-none-any.whl → 2025.8.0b1__py3-none-any.whl

homeassistant-stubs/components/uptime_kuma/__init__.pyi

@@ -0,0 +1,14 @@
+from .const import DOMAIN as DOMAIN
+from .coordinator import UptimeKumaConfigEntry as UptimeKumaConfigEntry, UptimeKumaDataUpdateCoordinator as UptimeKumaDataUpdateCoordinator, UptimeKumaSoftwareUpdateCoordinator as UptimeKumaSoftwareUpdateCoordinator
+from homeassistant.const import Platform as Platform
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers import device_registry as dr
+from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from homeassistant.util.hass_dict import HassKey as HassKey
+
+_PLATFORMS: list[Platform]
+UPTIME_KUMA_KEY: HassKey[UptimeKumaSoftwareUpdateCoordinator]
+
+async def async_setup_entry(hass: HomeAssistant, entry: UptimeKumaConfigEntry) -> bool: ...
+async def async_remove_config_entry_device(hass: HomeAssistant, config_entry: UptimeKumaConfigEntry, device_entry: dr.DeviceEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: UptimeKumaConfigEntry) -> bool: ...

homeassistant-stubs/components/uptime_kuma/config_flow.pyi

@@ -0,0 +1,26 @@
+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_KEY as CONF_API_KEY, CONF_URL as CONF_URL, CONF_VERIFY_SSL as CONF_VERIFY_SSL
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_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
+from yarl import URL
+
+_LOGGER: Incomplete
+STEP_USER_DATA_SCHEMA: Incomplete
+STEP_REAUTH_DATA_SCHEMA: Incomplete
+
+async def validate_connection(hass: HomeAssistant, url: URL | str, verify_ssl: bool, api_key: str | None) -> dict[str, str]: ...
+
+class UptimeKumaConfigFlow(ConfigFlow, domain=DOMAIN):
+    _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/uptime_kuma/const.pyi

@@ -0,0 +1,7 @@
+from _typeshed import Incomplete
+
+DOMAIN: str
+HAS_CERT: Incomplete
+HAS_URL: Incomplete
+HAS_PORT: Incomplete
+HAS_HOST: Incomplete

homeassistant-stubs/components/uptime_kuma/coordinator.pyi

@@ -0,0 +1,30 @@
+from .const import DOMAIN as DOMAIN
+from _typeshed import Incomplete
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import CONF_API_KEY as CONF_API_KEY, CONF_URL as CONF_URL, CONF_VERIFY_SSL as CONF_VERIFY_SSL
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed
+from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from pythonkuma import UptimeKumaMonitor, UptimeKumaVersion as UptimeKumaVersion
+from pythonkuma.update import LatestRelease, UpdateChecker as UpdateChecker
+
+_LOGGER: Incomplete
+SCAN_INTERVAL: Incomplete
+SCAN_INTERVAL_UPDATES: Incomplete
+type UptimeKumaConfigEntry = ConfigEntry[UptimeKumaDataUpdateCoordinator]
+
+class UptimeKumaDataUpdateCoordinator(DataUpdateCoordinator[dict[str | int, UptimeKumaMonitor]]):
+    config_entry: UptimeKumaConfigEntry
+    api: Incomplete
+    version: UptimeKumaVersion | None
+    def __init__(self, hass: HomeAssistant, config_entry: UptimeKumaConfigEntry) -> None: ...
+    async def _async_update_data(self) -> dict[str | int, UptimeKumaMonitor]: ...
+
+@callback
+def async_migrate_entities_unique_ids(hass: HomeAssistant, coordinator: UptimeKumaDataUpdateCoordinator, metrics: dict[str | int, UptimeKumaMonitor]) -> None: ...
+
+class UptimeKumaSoftwareUpdateCoordinator(DataUpdateCoordinator[LatestRelease]):
+    update_checker: Incomplete
+    def __init__(self, hass: HomeAssistant, update_checker: UpdateChecker) -> None: ...
+    async def _async_update_data(self) -> LatestRelease: ...

homeassistant-stubs/components/uptime_kuma/diagnostics.pyi

@@ -0,0 +1,9 @@
+from .coordinator import UptimeKumaConfigEntry as UptimeKumaConfigEntry
+from _typeshed import Incomplete
+from homeassistant.components.diagnostics import async_redact_data as async_redact_data
+from homeassistant.core import HomeAssistant as HomeAssistant
+from typing import Any
+
+TO_REDACT: Incomplete
+
+async def async_get_config_entry_diagnostics(hass: HomeAssistant, entry: UptimeKumaConfigEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/uptime_kuma/sensor.pyi

@@ -0,0 +1,46 @@
+from .const import DOMAIN as DOMAIN, HAS_CERT as HAS_CERT, HAS_HOST as HAS_HOST, HAS_PORT as HAS_PORT, HAS_URL as HAS_URL
+from .coordinator import UptimeKumaConfigEntry as UptimeKumaConfigEntry, UptimeKumaDataUpdateCoordinator as UptimeKumaDataUpdateCoordinator
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from enum import StrEnum
+from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription
+from homeassistant.const import CONF_URL as CONF_URL, EntityCategory as EntityCategory, UnitOfTime as UnitOfTime
+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.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.typing import StateType as StateType
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+from pythonkuma import MonitorType, UptimeKumaMonitor as UptimeKumaMonitor
+
+PARALLEL_UPDATES: int
+
+class UptimeKumaSensor(StrEnum):
+    CERT_DAYS_REMAINING = 'cert_days_remaining'
+    RESPONSE_TIME = 'response_time'
+    STATUS = 'status'
+    TYPE = 'type'
+    URL = 'url'
+    HOSTNAME = 'hostname'
+    PORT = 'port'
+
+@dataclass(kw_only=True, frozen=True)
+class UptimeKumaSensorEntityDescription(SensorEntityDescription):
+    value_fn: Callable[[UptimeKumaMonitor], StateType]
+    create_entity: Callable[[MonitorType], bool]
+
+SENSOR_DESCRIPTIONS: tuple[UptimeKumaSensorEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, config_entry: UptimeKumaConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class UptimeKumaSensorEntity(CoordinatorEntity[UptimeKumaDataUpdateCoordinator], SensorEntity):
+    entity_description: UptimeKumaSensorEntityDescription
+    _attr_has_entity_name: bool
+    monitor: Incomplete
+    _attr_unique_id: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, coordinator: UptimeKumaDataUpdateCoordinator, monitor: str | int, entity_description: UptimeKumaSensorEntityDescription) -> None: ...
+    @property
+    def native_value(self) -> StateType: ...
+    @property
+    def available(self) -> bool: ...

homeassistant-stubs/components/uptime_kuma/update.pyi

@@ -0,0 +1,39 @@
+from . import UPTIME_KUMA_KEY as UPTIME_KUMA_KEY
+from .const import DOMAIN as DOMAIN
+from .coordinator import UptimeKumaConfigEntry as UptimeKumaConfigEntry, UptimeKumaDataUpdateCoordinator as UptimeKumaDataUpdateCoordinator, UptimeKumaSoftwareUpdateCoordinator as UptimeKumaSoftwareUpdateCoordinator
+from _typeshed import Incomplete
+from enum import StrEnum
+from homeassistant.components.update import UpdateEntity as UpdateEntity, UpdateEntityDescription as UpdateEntityDescription, UpdateEntityFeature as UpdateEntityFeature
+from homeassistant.const import CONF_URL as CONF_URL
+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 AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+
+PARALLEL_UPDATES: int
+
+class UptimeKumaUpdate(StrEnum):
+    UPDATE = 'update'
+
+async def async_setup_entry(hass: HomeAssistant, entry: UptimeKumaConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class UptimeKumaUpdateEntity(CoordinatorEntity[UptimeKumaDataUpdateCoordinator], UpdateEntity):
+    entity_description: Incomplete
+    _attr_supported_features: Incomplete
+    _attr_has_entity_name: bool
+    update_checker: Incomplete
+    _attr_device_info: Incomplete
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: UptimeKumaDataUpdateCoordinator, update_coordinator: UptimeKumaSoftwareUpdateCoordinator) -> None: ...
+    @property
+    def installed_version(self) -> str | None: ...
+    @property
+    def title(self) -> str | None: ...
+    @property
+    def release_url(self) -> str | None: ...
+    @property
+    def latest_version(self) -> str | None: ...
+    async def async_release_notes(self) -> str | None: ...
+    async def async_added_to_hass(self) -> None: ...
+    @property
+    def available(self) -> bool: ...

homeassistant-stubs/components/vacuum/__init__.pyi

@@ -93,12 +93,19 @@ class StateVacuumEntity(Entity, cached_properties=STATE_VACUUM_CACHED_PROPERTIES
     _attr_activity: VacuumActivity | None
     _attr_supported_features: VacuumEntityFeature
     __vacuum_legacy_state: bool
+    __vacuum_legacy_battery_level: bool
+    __vacuum_legacy_battery_icon: bool
+    __vacuum_legacy_battery_feature: bool
     def __init_subclass__(cls, **kwargs: Any) -> None: ...
     def __setattr__(self, name: str, value: Any) -> None: ...
     @callback
     def add_to_platform_start(self, hass: HomeAssistant, platform: EntityPlatform, parallel_updates: asyncio.Semaphore | None) -> None: ...
     @callback
     def _report_deprecated_activity_handling(self) -> None: ...
+    @callback
+    def _report_deprecated_battery_properties(self, property: str) -> None: ...
+    @callback
+    def _report_deprecated_battery_feature(self) -> None: ...
     @cached_property
     def battery_level(self) -> int | None: ...
     @property

homeassistant-stubs/components/velbus/__init__.pyi

@@ -1,6 +1,6 @@
 import asyncio
 from .const import DOMAIN as DOMAIN
-from .services import setup_services as setup_services
+from .services import async_setup_services as async_setup_services
 from _typeshed import Incomplete
 from dataclasses import dataclass
 from homeassistant.config_entries import ConfigEntry as ConfigEntry

homeassistant-stubs/components/velbus/const.pyi

@@ -4,7 +4,6 @@ from typing import Final
 
 DOMAIN: Final[str]
 CONF_CONFIG_ENTRY: Final[str]
-CONF_INTERFACE: Final[str]
 CONF_MEMO_TEXT: Final[str]
 CONF_TLS: Final[str]
 SERVICE_SCAN: Final[str]

homeassistant-stubs/components/velbus/services.pyi

@@ -1,11 +1,11 @@
 from . import VelbusConfigEntry as VelbusConfigEntry
-from .const import CONF_CONFIG_ENTRY as CONF_CONFIG_ENTRY, CONF_INTERFACE as CONF_INTERFACE, CONF_MEMO_TEXT as CONF_MEMO_TEXT, DOMAIN as DOMAIN, SERVICE_CLEAR_CACHE as SERVICE_CLEAR_CACHE, SERVICE_SCAN as SERVICE_SCAN, SERVICE_SET_MEMO_TEXT as SERVICE_SET_MEMO_TEXT, SERVICE_SYNC as SERVICE_SYNC
+from .const import CONF_CONFIG_ENTRY as CONF_CONFIG_ENTRY, CONF_MEMO_TEXT as CONF_MEMO_TEXT, DOMAIN as DOMAIN, SERVICE_CLEAR_CACHE as SERVICE_CLEAR_CACHE, SERVICE_SCAN as SERVICE_SCAN, SERVICE_SET_MEMO_TEXT as SERVICE_SET_MEMO_TEXT, SERVICE_SYNC as SERVICE_SYNC
 from homeassistant.config_entries import ConfigEntryState as ConfigEntryState
 from homeassistant.const import CONF_ADDRESS as CONF_ADDRESS
-from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall
+from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, callback as callback
 from homeassistant.exceptions import ServiceValidationError as ServiceValidationError
 from homeassistant.helpers import selector as selector
-from homeassistant.helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue
 from homeassistant.helpers.storage import STORAGE_DIR as STORAGE_DIR
 
-def setup_services(hass: HomeAssistant) -> None: ...
+@callback
+def async_setup_services(hass: HomeAssistant) -> None: ...

homeassistant-stubs/components/vodafone_station/__init__.pyi

@@ -8,4 +8,3 @@ PLATFORMS: Incomplete
 
 async def async_setup_entry(hass: HomeAssistant, entry: VodafoneConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: VodafoneConfigEntry) -> bool: ...
-async def update_listener(hass: HomeAssistant, entry: VodafoneConfigEntry) -> None: ...

homeassistant-stubs/components/vodafone_station/config_flow.pyi

@@ -5,7 +5,7 @@ from .utils import async_client_session as async_client_session
 from _typeshed import Incomplete
 from collections.abc import Mapping
 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 ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlow as OptionsFlow
+from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlowWithReload as OptionsFlowWithReload
 from homeassistant.const import CONF_HOST as CONF_HOST, CONF_PASSWORD as CONF_PASSWORD, CONF_USERNAME as CONF_USERNAME
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from typing import Any
@@ -26,5 +26,5 @@ class VodafoneStationConfigFlow(ConfigFlow, domain=DOMAIN):
     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 VodafoneStationOptionsFlowHandler(OptionsFlow):
+class VodafoneStationOptionsFlowHandler(OptionsFlowWithReload):
     async def async_step_init(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/volvo/__init__.pyi

@@ -0,0 +1,15 @@
+from .api import VolvoAuth as VolvoAuth
+from .const import CONF_VIN as CONF_VIN, DOMAIN as DOMAIN, PLATFORMS as PLATFORMS
+from .coordinator import VolvoConfigEntry as VolvoConfigEntry, VolvoMediumIntervalCoordinator as VolvoMediumIntervalCoordinator, VolvoSlowIntervalCoordinator as VolvoSlowIntervalCoordinator, VolvoVerySlowIntervalCoordinator as VolvoVerySlowIntervalCoordinator
+from homeassistant.const import CONF_API_KEY as CONF_API_KEY
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, ConfigEntryError as ConfigEntryError, ConfigEntryNotReady as ConfigEntryNotReady
+from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from homeassistant.helpers.config_entry_oauth2_flow import OAuth2Session as OAuth2Session, async_get_config_entry_implementation as async_get_config_entry_implementation
+from volvocarsapi.api import VolvoCarsApi
+from volvocarsapi.models import VolvoCarsVehicle as VolvoCarsVehicle
+
+async def async_setup_entry(hass: HomeAssistant, entry: VolvoConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: VolvoConfigEntry) -> bool: ...
+async def _async_auth_and_create_api(hass: HomeAssistant, entry: VolvoConfigEntry) -> VolvoCarsApi: ...
+async def _async_load_vehicle(api: VolvoCarsApi) -> VolvoCarsVehicle: ...

homeassistant-stubs/components/volvo/api.pyi

@@ -0,0 +1,14 @@
+from _typeshed import Incomplete
+from aiohttp import ClientSession as ClientSession
+from homeassistant.helpers.config_entry_oauth2_flow import OAuth2Session as OAuth2Session
+from volvocarsapi.auth import AccessTokenManager
+
+class VolvoAuth(AccessTokenManager):
+    _oauth_session: Incomplete
+    def __init__(self, websession: ClientSession, oauth_session: OAuth2Session) -> None: ...
+    async def async_get_access_token(self) -> str: ...
+
+class ConfigFlowVolvoAuth(AccessTokenManager):
+    _token: Incomplete
+    def __init__(self, websession: ClientSession, token: str) -> None: ...
+    async def async_get_access_token(self) -> str: ...

homeassistant-stubs/components/volvo/application_credentials.pyi

@@ -0,0 +1,9 @@
+from homeassistant.components.application_credentials import ClientCredential as ClientCredential
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.config_entry_oauth2_flow import LocalOAuth2ImplementationWithPkce as LocalOAuth2ImplementationWithPkce
+
+async def async_get_auth_implementation(hass: HomeAssistant, auth_domain: str, credential: ClientCredential) -> VolvoOAuth2Implementation: ...
+
+class VolvoOAuth2Implementation(LocalOAuth2ImplementationWithPkce):
+    @property
+    def extra_authorize_data(self) -> dict: ...

homeassistant-stubs/components/volvo/config_flow.pyi

@@ -0,0 +1,34 @@
+import logging
+from .api import ConfigFlowVolvoAuth as ConfigFlowVolvoAuth
+from .const import CONF_VIN as CONF_VIN, DOMAIN as DOMAIN, MANUFACTURER as MANUFACTURER
+from _typeshed import Incomplete
+from collections.abc import Mapping
+from homeassistant.config_entries import ConfigFlowResult as ConfigFlowResult, SOURCE_REAUTH as SOURCE_REAUTH, SOURCE_RECONFIGURE as SOURCE_RECONFIGURE
+from homeassistant.const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN, CONF_API_KEY as CONF_API_KEY, CONF_NAME as CONF_NAME, CONF_TOKEN as CONF_TOKEN
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers import aiohttp_client as aiohttp_client
+from homeassistant.helpers.config_entry_oauth2_flow import AbstractOAuth2FlowHandler as AbstractOAuth2FlowHandler
+from homeassistant.helpers.selector import SelectOptionDict as SelectOptionDict, SelectSelector as SelectSelector, SelectSelectorConfig as SelectSelectorConfig, TextSelector as TextSelector, TextSelectorConfig as TextSelectorConfig, TextSelectorType as TextSelectorType
+from typing import Any
+from volvocarsapi.api import VolvoCarsApi
+from volvocarsapi.models import VolvoCarsVehicle as VolvoCarsVehicle
+
+_LOGGER: Incomplete
+
+def _create_volvo_cars_api(hass: HomeAssistant, access_token: str, api_key: str) -> VolvoCarsApi: ...
+
+class VolvoOAuth2FlowHandler(AbstractOAuth2FlowHandler, domain=DOMAIN):
+    DOMAIN = DOMAIN
+    _vehicles: list[VolvoCarsVehicle]
+    _config_data: dict
+    def __init__(self) -> None: ...
+    @property
+    def logger(self) -> logging.Logger: ...
+    async def async_oauth_create_entry(self, data: dict) -> ConfigFlowResult: ...
+    async def async_step_reauth(self, _: Mapping[str, Any]) -> ConfigFlowResult: ...
+    async def async_step_reconfigure(self, _: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_reauth_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_api_key(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_vin(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def _async_create_or_update(self) -> ConfigFlowResult: ...
+    async def _async_load_vehicles(self, api: VolvoCarsApi) -> None: ...

homeassistant-stubs/components/volvo/const.pyi

@@ -0,0 +1,8 @@
+from homeassistant.const import Platform as Platform
+
+DOMAIN: str
+PLATFORMS: list[Platform]
+ATTR_API_TIMESTAMP: str
+CONF_VIN: str
+DATA_BATTERY_CAPACITY: str
+MANUFACTURER: str

homeassistant-stubs/components/volvo/coordinator.pyi

@@ -0,0 +1,46 @@
+import abc
+from .const import DATA_BATTERY_CAPACITY as DATA_BATTERY_CAPACITY, DOMAIN as DOMAIN
+from _typeshed import Incomplete
+from abc import abstractmethod
+from collections.abc import Callable as Callable, Coroutine
+from datetime import timedelta
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from typing import Any
+from volvocarsapi.api import VolvoCarsApi as VolvoCarsApi
+from volvocarsapi.models import VolvoCarsApiBaseModel, VolvoCarsVehicle as VolvoCarsVehicle
+
+VERY_SLOW_INTERVAL: int
+SLOW_INTERVAL: int
+MEDIUM_INTERVAL: int
+_LOGGER: Incomplete
+type VolvoConfigEntry = ConfigEntry[tuple[VolvoBaseCoordinator, ...]]
+type CoordinatorData = dict[str, VolvoCarsApiBaseModel | None]
+
+class VolvoBaseCoordinator(DataUpdateCoordinator[CoordinatorData], metaclass=abc.ABCMeta):
+    config_entry: VolvoConfigEntry
+    api: Incomplete
+    vehicle: Incomplete
+    _api_calls: list[Callable[[], Coroutine[Any, Any, Any]]]
+    def __init__(self, hass: HomeAssistant, entry: VolvoConfigEntry, api: VolvoCarsApi, vehicle: VolvoCarsVehicle, update_interval: timedelta, name: str) -> None: ...
+    update_interval: Incomplete
+    async def _async_setup(self) -> None: ...
+    async def _async_update_data(self) -> CoordinatorData: ...
+    def get_api_field(self, api_field: str | None) -> VolvoCarsApiBaseModel | None: ...
+    @abstractmethod
+    async def _async_determine_api_calls(self) -> list[Callable[[], Coroutine[Any, Any, Any]]]: ...
+
+class VolvoVerySlowIntervalCoordinator(VolvoBaseCoordinator):
+    def __init__(self, hass: HomeAssistant, entry: VolvoConfigEntry, api: VolvoCarsApi, vehicle: VolvoCarsVehicle) -> None: ...
+    async def _async_determine_api_calls(self) -> list[Callable[[], Coroutine[Any, Any, Any]]]: ...
+    async def _async_update_data(self) -> CoordinatorData: ...
+
+class VolvoSlowIntervalCoordinator(VolvoBaseCoordinator):
+    def __init__(self, hass: HomeAssistant, entry: VolvoConfigEntry, api: VolvoCarsApi, vehicle: VolvoCarsVehicle) -> None: ...
+    async def _async_determine_api_calls(self) -> list[Callable[[], Coroutine[Any, Any, Any]]]: ...
+
+class VolvoMediumIntervalCoordinator(VolvoBaseCoordinator):
+    def __init__(self, hass: HomeAssistant, entry: VolvoConfigEntry, api: VolvoCarsApi, vehicle: VolvoCarsVehicle) -> None: ...
+    async def _async_determine_api_calls(self) -> list[Callable[[], Coroutine[Any, Any, Any]]]: ...

homeassistant-stubs/components/volvo/entity.pyi

@@ -0,0 +1,33 @@
+import abc
+from .const import CONF_VIN as CONF_VIN, DOMAIN as DOMAIN, MANUFACTURER as MANUFACTURER
+from .coordinator import VolvoBaseCoordinator as VolvoBaseCoordinator
+from _typeshed import Incomplete
+from abc import abstractmethod
+from dataclasses import dataclass
+from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass
+from homeassistant.core import callback as callback
+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 volvocarsapi.models import VolvoCarsApiBaseModel as VolvoCarsApiBaseModel
+
+def get_unique_id(vin: str, key: str) -> str: ...
+def value_to_translation_key(value: str) -> str: ...
+
+@dataclass(frozen=True, kw_only=True)
+class VolvoEntityDescription(EntityDescription):
+    api_field: str
+
+class VolvoEntity(CoordinatorEntity[VolvoBaseCoordinator], metaclass=abc.ABCMeta):
+    _attr_has_entity_name: bool
+    entity_description: VolvoEntityDescription
+    _attr_translation_key: Incomplete
+    _attr_unique_id: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, coordinator: VolvoBaseCoordinator, description: VolvoEntityDescription) -> None: ...
+    @callback
+    def _handle_coordinator_update(self) -> None: ...
+    @property
+    def available(self) -> bool: ...
+    @abstractmethod
+    def _update_state(self, api_field: VolvoCarsApiBaseModel | None) -> None: ...

homeassistant-stubs/components/volvo/sensor.pyi

@@ -0,0 +1,35 @@
+from .const import DATA_BATTERY_CAPACITY as DATA_BATTERY_CAPACITY
+from .coordinator import VolvoBaseCoordinator as VolvoBaseCoordinator, VolvoConfigEntry as VolvoConfigEntry
+from .entity import VolvoEntity as VolvoEntity, VolvoEntityDescription as VolvoEntityDescription, value_to_translation_key as value_to_translation_key
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass
+from homeassistant.const import EntityCategory as EntityCategory, PERCENTAGE as PERCENTAGE, UnitOfElectricCurrent as UnitOfElectricCurrent, UnitOfEnergy as UnitOfEnergy, UnitOfEnergyDistance as UnitOfEnergyDistance, UnitOfLength as UnitOfLength, UnitOfPower as UnitOfPower, UnitOfSpeed as UnitOfSpeed, UnitOfTime as UnitOfTime, UnitOfVolume as UnitOfVolume
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from typing import Any
+from volvocarsapi.models import VolvoCarsApiBaseModel as VolvoCarsApiBaseModel, VolvoCarsValue
+
+PARALLEL_UPDATES: int
+_LOGGER: Incomplete
+
+@dataclass(frozen=True, kw_only=True)
+class VolvoSensorDescription(VolvoEntityDescription, SensorEntityDescription):
+    source_fields: list[str] | None = ...
+    value_fn: Callable[[VolvoCarsValue], Any] | None = ...
+
+def _availability_status(field: VolvoCarsValue) -> str: ...
+def _calculate_time_to_service(field: VolvoCarsValue) -> int: ...
+def _charging_power_value(field: VolvoCarsValue) -> int: ...
+def _charging_power_status_value(field: VolvoCarsValue) -> str | None: ...
+
+_CHARGING_POWER_STATUS_OPTIONS: Incomplete
+_DESCRIPTIONS: tuple[VolvoSensorDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: VolvoConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class VolvoSensor(VolvoEntity, SensorEntity):
+    entity_description: VolvoSensorDescription
+    _attr_native_value: Incomplete
+    def _update_state(self, api_field: VolvoCarsApiBaseModel | None) -> None: ...

homeassistant-stubs/components/wallbox/__init__.pyi

@@ -1,12 +1,11 @@
-from .const import DOMAIN as DOMAIN, UPDATE_INTERVAL as UPDATE_INTERVAL
-from .coordinator import InvalidAuth as InvalidAuth, WallboxCoordinator as WallboxCoordinator, async_validate_input as async_validate_input
+from .const import UPDATE_INTERVAL as UPDATE_INTERVAL
+from .coordinator import InvalidAuth as InvalidAuth, WallboxConfigEntry as WallboxConfigEntry, WallboxCoordinator as WallboxCoordinator, async_validate_input as async_validate_input
 from _typeshed import Incomplete
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_PASSWORD as CONF_PASSWORD, CONF_USERNAME as CONF_USERNAME, Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed
 
 PLATFORMS: Incomplete
 
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
-async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
+async def async_setup_entry(hass: HomeAssistant, entry: WallboxConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: WallboxConfigEntry) -> bool: ...

homeassistant-stubs/components/wallbox/coordinator.pyi

@@ -10,16 +10,17 @@ from wallbox import Wallbox as Wallbox
 
 _LOGGER: Incomplete
 CHARGER_STATUS: dict[int, ChargerStatus]
+type WallboxConfigEntry = ConfigEntry[WallboxCoordinator]
 
 def _require_authentication[_WallboxCoordinatorT: WallboxCoordinator, **_P](func: Callable[Concatenate[_WallboxCoordinatorT, _P], Any]) -> Callable[Concatenate[_WallboxCoordinatorT, _P], Any]: ...
 def _validate(wallbox: Wallbox) -> None: ...
 async def async_validate_input(hass: HomeAssistant, wallbox: Wallbox) -> None: ...
 
 class WallboxCoordinator(DataUpdateCoordinator[dict[str, Any]]):
-    config_entry: ConfigEntry
+    config_entry: WallboxConfigEntry
     _station: Incomplete
     _wallbox: Incomplete
-    def __init__(self, hass: HomeAssistant, config_entry: ConfigEntry, wallbox: Wallbox) -> None: ...
+    def __init__(self, hass: HomeAssistant, config_entry: WallboxConfigEntry, wallbox: Wallbox) -> None: ...
     def authenticate(self) -> None: ...
     @_require_authentication
     def _get_data(self) -> dict[str, Any]: ...
@@ -44,3 +45,8 @@ class WallboxCoordinator(DataUpdateCoordinator[dict[str, Any]]):
     async def async_set_eco_smart(self, option: str) -> None: ...
 
 class InvalidAuth(HomeAssistantError): ...
+
+class InsufficientRights(HomeAssistantError):
+    hass: Incomplete
+    def __init__(self, *args: object, translation_domain: str | None = None, translation_key: str | None = None, translation_placeholders: dict[str, str] | None = None, hass: HomeAssistant) -> None: ...
+    def _create_insufficient_rights_issue(self) -> None: ...

homeassistant-stubs/components/wallbox/lock.pyi

@@ -1,16 +1,17 @@
-from .const import CHARGER_DATA_KEY as CHARGER_DATA_KEY, CHARGER_LOCKED_UNLOCKED_KEY as CHARGER_LOCKED_UNLOCKED_KEY, CHARGER_SERIAL_NUMBER_KEY as CHARGER_SERIAL_NUMBER_KEY, DOMAIN as DOMAIN
-from .coordinator import WallboxCoordinator as WallboxCoordinator
+from .const import CHARGER_DATA_KEY as CHARGER_DATA_KEY, CHARGER_LOCKED_UNLOCKED_KEY as CHARGER_LOCKED_UNLOCKED_KEY, CHARGER_SERIAL_NUMBER_KEY as CHARGER_SERIAL_NUMBER_KEY
+from .coordinator import WallboxConfigEntry as WallboxConfigEntry, WallboxCoordinator as WallboxCoordinator
 from .entity import WallboxEntity as WallboxEntity
 from _typeshed import Incomplete
 from homeassistant.components.lock import LockEntity as LockEntity, LockEntityDescription as LockEntityDescription
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 from typing import Any
 
 LOCK_TYPES: dict[str, LockEntityDescription]
 
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: WallboxConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+PARALLEL_UPDATES: int
 
 class WallboxLock(WallboxEntity, LockEntity):
     entity_description: Incomplete

homeassistant-stubs/components/wallbox/number.pyi

@@ -1,11 +1,10 @@
-from .const import BIDIRECTIONAL_MODEL_PREFIXES as BIDIRECTIONAL_MODEL_PREFIXES, CHARGER_DATA_KEY as CHARGER_DATA_KEY, CHARGER_ENERGY_PRICE_KEY as CHARGER_ENERGY_PRICE_KEY, CHARGER_MAX_AVAILABLE_POWER_KEY as CHARGER_MAX_AVAILABLE_POWER_KEY, CHARGER_MAX_CHARGING_CURRENT_KEY as CHARGER_MAX_CHARGING_CURRENT_KEY, CHARGER_MAX_ICP_CURRENT_KEY as CHARGER_MAX_ICP_CURRENT_KEY, CHARGER_PART_NUMBER_KEY as CHARGER_PART_NUMBER_KEY, CHARGER_SERIAL_NUMBER_KEY as CHARGER_SERIAL_NUMBER_KEY, DOMAIN as DOMAIN
-from .coordinator import WallboxCoordinator as WallboxCoordinator
+from .const import BIDIRECTIONAL_MODEL_PREFIXES as BIDIRECTIONAL_MODEL_PREFIXES, CHARGER_DATA_KEY as CHARGER_DATA_KEY, CHARGER_ENERGY_PRICE_KEY as CHARGER_ENERGY_PRICE_KEY, CHARGER_MAX_AVAILABLE_POWER_KEY as CHARGER_MAX_AVAILABLE_POWER_KEY, CHARGER_MAX_CHARGING_CURRENT_KEY as CHARGER_MAX_CHARGING_CURRENT_KEY, CHARGER_MAX_ICP_CURRENT_KEY as CHARGER_MAX_ICP_CURRENT_KEY, CHARGER_PART_NUMBER_KEY as CHARGER_PART_NUMBER_KEY, CHARGER_SERIAL_NUMBER_KEY as CHARGER_SERIAL_NUMBER_KEY
+from .coordinator import WallboxConfigEntry as WallboxConfigEntry, WallboxCoordinator as WallboxCoordinator
 from .entity import WallboxEntity as WallboxEntity
 from _typeshed import Incomplete
 from collections.abc import Awaitable, Callable as Callable
 from dataclasses import dataclass
 from homeassistant.components.number import NumberEntity as NumberEntity, NumberEntityDescription as NumberEntityDescription
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 
@@ -19,13 +18,15 @@ class WallboxNumberEntityDescription(NumberEntityDescription):
 
 NUMBER_TYPES: dict[str, WallboxNumberEntityDescription]
 
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: WallboxConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+PARALLEL_UPDATES: int
 
 class WallboxNumber(WallboxEntity, NumberEntity):
     entity_description: WallboxNumberEntityDescription
     _coordinator: Incomplete
     _attr_unique_id: Incomplete
-    def __init__(self, coordinator: WallboxCoordinator, entry: ConfigEntry, description: WallboxNumberEntityDescription) -> None: ...
+    def __init__(self, coordinator: WallboxCoordinator, entry: WallboxConfigEntry, description: WallboxNumberEntityDescription) -> None: ...
     @property
     def native_max_value(self) -> float: ...
     @property

homeassistant-stubs/components/wallbox/select.pyi

@@ -1,11 +1,10 @@
 from .const import CHARGER_DATA_KEY as CHARGER_DATA_KEY, CHARGER_ECO_SMART_KEY as CHARGER_ECO_SMART_KEY, CHARGER_FEATURES_KEY as CHARGER_FEATURES_KEY, CHARGER_PLAN_KEY as CHARGER_PLAN_KEY, CHARGER_POWER_BOOST_KEY as CHARGER_POWER_BOOST_KEY, CHARGER_SERIAL_NUMBER_KEY as CHARGER_SERIAL_NUMBER_KEY, DOMAIN as DOMAIN, EcoSmartMode as EcoSmartMode
-from .coordinator import WallboxCoordinator as WallboxCoordinator
+from .coordinator import WallboxConfigEntry as WallboxConfigEntry, WallboxCoordinator as WallboxCoordinator
 from .entity import WallboxEntity as WallboxEntity
 from _typeshed import Incomplete
 from collections.abc import Awaitable, Callable as Callable
 from dataclasses import dataclass
 from homeassistant.components.select import SelectEntity as SelectEntity, SelectEntityDescription as SelectEntityDescription
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
@@ -18,7 +17,9 @@ class WallboxSelectEntityDescription(SelectEntityDescription):
 
 SELECT_TYPES: dict[str, WallboxSelectEntityDescription]
 
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: WallboxConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+PARALLEL_UPDATES: int
 
 class WallboxSelect(WallboxEntity, SelectEntity):
     entity_description: WallboxSelectEntityDescription

homeassistant-stubs/components/wallbox/sensor.pyi

@@ -1,10 +1,9 @@
-from .const import CHARGER_ADDED_DISCHARGED_ENERGY_KEY as CHARGER_ADDED_DISCHARGED_ENERGY_KEY, CHARGER_ADDED_ENERGY_KEY as CHARGER_ADDED_ENERGY_KEY, CHARGER_ADDED_GREEN_ENERGY_KEY as CHARGER_ADDED_GREEN_ENERGY_KEY, CHARGER_ADDED_GRID_ENERGY_KEY as CHARGER_ADDED_GRID_ENERGY_KEY, CHARGER_ADDED_RANGE_KEY as CHARGER_ADDED_RANGE_KEY, CHARGER_CHARGING_POWER_KEY as CHARGER_CHARGING_POWER_KEY, CHARGER_CHARGING_SPEED_KEY as CHARGER_CHARGING_SPEED_KEY, CHARGER_COST_KEY as CHARGER_COST_KEY, CHARGER_CURRENCY_KEY as CHARGER_CURRENCY_KEY, CHARGER_CURRENT_MODE_KEY as CHARGER_CURRENT_MODE_KEY, CHARGER_DATA_KEY as CHARGER_DATA_KEY, CHARGER_DEPOT_PRICE_KEY as CHARGER_DEPOT_PRICE_KEY, CHARGER_ENERGY_PRICE_KEY as CHARGER_ENERGY_PRICE_KEY, CHARGER_MAX_AVAILABLE_POWER_KEY as CHARGER_MAX_AVAILABLE_POWER_KEY, CHARGER_MAX_CHARGING_CURRENT_KEY as CHARGER_MAX_CHARGING_CURRENT_KEY, CHARGER_MAX_ICP_CURRENT_KEY as CHARGER_MAX_ICP_CURRENT_KEY, CHARGER_SERIAL_NUMBER_KEY as CHARGER_SERIAL_NUMBER_KEY, CHARGER_STATE_OF_CHARGE_KEY as CHARGER_STATE_OF_CHARGE_KEY, CHARGER_STATUS_DESCRIPTION_KEY as CHARGER_STATUS_DESCRIPTION_KEY, DOMAIN as DOMAIN
-from .coordinator import WallboxCoordinator as WallboxCoordinator
+from .const import CHARGER_ADDED_DISCHARGED_ENERGY_KEY as CHARGER_ADDED_DISCHARGED_ENERGY_KEY, CHARGER_ADDED_ENERGY_KEY as CHARGER_ADDED_ENERGY_KEY, CHARGER_ADDED_GREEN_ENERGY_KEY as CHARGER_ADDED_GREEN_ENERGY_KEY, CHARGER_ADDED_GRID_ENERGY_KEY as CHARGER_ADDED_GRID_ENERGY_KEY, CHARGER_ADDED_RANGE_KEY as CHARGER_ADDED_RANGE_KEY, CHARGER_CHARGING_POWER_KEY as CHARGER_CHARGING_POWER_KEY, CHARGER_CHARGING_SPEED_KEY as CHARGER_CHARGING_SPEED_KEY, CHARGER_COST_KEY as CHARGER_COST_KEY, CHARGER_CURRENCY_KEY as CHARGER_CURRENCY_KEY, CHARGER_CURRENT_MODE_KEY as CHARGER_CURRENT_MODE_KEY, CHARGER_DATA_KEY as CHARGER_DATA_KEY, CHARGER_DEPOT_PRICE_KEY as CHARGER_DEPOT_PRICE_KEY, CHARGER_ENERGY_PRICE_KEY as CHARGER_ENERGY_PRICE_KEY, CHARGER_MAX_AVAILABLE_POWER_KEY as CHARGER_MAX_AVAILABLE_POWER_KEY, CHARGER_MAX_CHARGING_CURRENT_KEY as CHARGER_MAX_CHARGING_CURRENT_KEY, CHARGER_MAX_ICP_CURRENT_KEY as CHARGER_MAX_ICP_CURRENT_KEY, CHARGER_SERIAL_NUMBER_KEY as CHARGER_SERIAL_NUMBER_KEY, CHARGER_STATE_OF_CHARGE_KEY as CHARGER_STATE_OF_CHARGE_KEY, CHARGER_STATUS_DESCRIPTION_KEY as CHARGER_STATUS_DESCRIPTION_KEY
+from .coordinator import WallboxConfigEntry as WallboxConfigEntry, WallboxCoordinator as WallboxCoordinator
 from .entity import WallboxEntity as WallboxEntity
 from _typeshed import Incomplete
 from dataclasses import dataclass
 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 PERCENTAGE as PERCENTAGE, UnitOfElectricCurrent as UnitOfElectricCurrent, UnitOfEnergy as UnitOfEnergy, UnitOfLength as UnitOfLength, UnitOfPower as UnitOfPower
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
@@ -16,7 +15,9 @@ class WallboxSensorEntityDescription(SensorEntityDescription):
 
 SENSOR_TYPES: dict[str, WallboxSensorEntityDescription]
 
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: WallboxConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+PARALLEL_UPDATES: int
 
 class WallboxSensor(WallboxEntity, SensorEntity):
     entity_description: WallboxSensorEntityDescription