Generate v2025.1.3

homeassistant-stubs/auth/__init__.pyi

@@ -59,6 +59,7 @@ class AuthManager:
     async def async_link_user(self, user: models.User, credentials: models.Credentials) -> None: ...
     async def async_remove_user(self, user: models.User) -> None: ...
     async def async_update_user(self, user: models.User, name: str | None = None, is_active: bool | None = None, group_ids: list[str] | None = None, local_only: bool | None = None) -> None: ...
+    @callback
     def async_update_user_credentials_data(self, credentials: models.Credentials, data: dict[str, Any]) -> None: ...
     async def async_activate_user(self, user: models.User) -> None: ...
     async def async_deactivate_user(self, user: models.User) -> None: ...
@@ -67,18 +68,32 @@ class AuthManager:
     async def async_disable_user_mfa(self, user: models.User, mfa_module_id: str) -> None: ...
     async def async_get_enabled_mfa(self, user: models.User) -> dict[str, str]: ...
     async def async_create_refresh_token(self, user: models.User, client_id: str | None = None, client_name: str | None = None, client_icon: str | None = None, token_type: str | None = None, access_token_expiration: timedelta = ..., credential: models.Credentials | None = None) -> models.RefreshToken: ...
+    @callback
     def async_get_refresh_token(self, token_id: str) -> models.RefreshToken | None: ...
+    @callback
     def async_get_refresh_token_by_token(self, token: str) -> models.RefreshToken | None: ...
+    @callback
     def async_remove_refresh_token(self, refresh_token: models.RefreshToken) -> None: ...
+    @callback
     def async_set_expiry(self, refresh_token: models.RefreshToken, *, enable_expiry: bool) -> None: ...
+    @callback
     def _async_remove_expired_refresh_tokens(self, _: datetime | None = None) -> None: ...
+    @callback
     def _async_track_next_refresh_token_expiration(self) -> None: ...
+    @callback
     def _async_cancel_expiration_schedule(self) -> None: ...
+    @callback
     def _async_unregister(self, callbacks: set[CALLBACK_TYPE], callback_: CALLBACK_TYPE) -> None: ...
+    @callback
     def async_register_revoke_token_callback(self, refresh_token_id: str, revoke_callback: CALLBACK_TYPE) -> CALLBACK_TYPE: ...
+    @callback
     def async_create_access_token(self, refresh_token: models.RefreshToken, remote_ip: str | None = None) -> str: ...
+    @callback
     def _async_resolve_provider(self, refresh_token: models.RefreshToken) -> AuthProvider | None: ...
+    @callback
     def async_validate_refresh_token(self, refresh_token: models.RefreshToken, remote_ip: str | None = None) -> None: ...
+    @callback
     def async_validate_access_token(self, token: str) -> models.RefreshToken | None: ...
+    @callback
     def _async_get_auth_provider(self, credentials: models.Credentials) -> AuthProvider | None: ...
     async def _user_should_be_owner(self) -> bool: ...

homeassistant-stubs/auth/auth_store.pyi

@@ -38,16 +38,26 @@ class AuthStore:
     async def async_deactivate_user(self, user: models.User) -> None: ...
     async def async_remove_credentials(self, credentials: models.Credentials) -> None: ...
     async def async_create_refresh_token(self, user: models.User, client_id: str | None = None, client_name: str | None = None, client_icon: str | None = None, token_type: str = ..., access_token_expiration: timedelta = ..., expire_at: float | None = None, credential: models.Credentials | None = None) -> models.RefreshToken: ...
+    @callback
     def async_remove_refresh_token(self, refresh_token: models.RefreshToken) -> None: ...
+    @callback
     def async_get_refresh_token(self, token_id: str) -> models.RefreshToken | None: ...
+    @callback
     def async_get_refresh_token_by_token(self, token: str) -> models.RefreshToken | None: ...
+    @callback
     def async_get_refresh_tokens(self) -> list[models.RefreshToken]: ...
+    @callback
     def async_log_refresh_token_usage(self, refresh_token: models.RefreshToken, remote_ip: str | None = None) -> None: ...
+    @callback
     def async_set_expiry(self, refresh_token: models.RefreshToken, *, enable_expiry: bool) -> None: ...
+    @callback
     def async_update_user_credentials_data(self, credentials: models.Credentials, data: dict[str, Any]) -> None: ...
     async def async_load(self) -> None: ...
+    @callback
     def _build_token_id_to_user_id(self) -> None: ...
+    @callback
     def _async_schedule_save(self, delay: float = ...) -> None: ...
+    @callback
     def _data_to_save(self) -> dict[str, list[dict[str, Any]]]: ...
     def _set_defaults(self) -> None: ...
 

homeassistant-stubs/auth/mfa_modules/notify.pyi

@@ -48,6 +48,7 @@ class NotifyAuthModule(MultiFactorAuthModule):
     def input_schema(self) -> vol.Schema: ...
     async def _async_load(self) -> None: ...
     async def _async_save(self) -> None: ...
+    @callback
     def aync_get_available_notify_services(self) -> list[str]: ...
     async def async_setup_flow(self, user_id: str) -> NotifySetupFlow: ...
     async def async_setup_user(self, user_id: str, setup_data: Any) -> Any: ...

homeassistant-stubs/auth/providers/__init__.pyi

@@ -36,11 +36,13 @@ class AuthProvider:
     @property
     def support_mfa(self) -> bool: ...
     async def async_credentials(self) -> list[Credentials]: ...
+    @callback
     def async_create_credentials(self, data: dict[str, str]) -> Credentials: ...
     async def async_login_flow(self, context: AuthFlowContext | None) -> LoginFlow[Any]: ...
     async def async_get_or_create_credentials(self, flow_result: Mapping[str, str]) -> Credentials: ...
     async def async_user_meta_for_credentials(self, credentials: Credentials) -> UserMeta: ...
     async def async_initialize(self) -> None: ...
+    @callback
     def async_validate_refresh_token(self, refresh_token: RefreshToken, remote_ip: str | None = None) -> None: ...
 
 async def auth_provider_from_config(hass: HomeAssistant, store: AuthStore, config: dict[str, Any]) -> AuthProvider: ...

homeassistant-stubs/auth/providers/homeassistant.pyi

@@ -15,6 +15,7 @@ def _disallow_id(conf: dict[str, Any]) -> dict[str, Any]: ...
 
 CONFIG_SCHEMA: Incomplete
 
+@callback
 def async_get_provider(hass: HomeAssistant) -> HassAuthProvider: ...
 
 class InvalidAuth(HomeAssistantError): ...
@@ -30,17 +31,22 @@ class Data:
     _data: dict[str, list[dict[str, str]]] | None
     is_legacy: bool
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def normalize_username(self, username: str, *, force_normalize: bool = False) -> str: ...
     async def async_load(self) -> None: ...
+    @callback
     def _async_check_for_not_normalized_usernames(self, data: dict[str, list[dict[str, str]]]) -> None: ...
     @property
     def users(self) -> list[dict[str, str]]: ...
     def validate_login(self, username: str, password: str) -> None: ...
     def hash_password(self, password: str, for_storage: bool = False) -> bytes: ...
     def add_auth(self, username: str, password: str) -> None: ...
+    @callback
     def async_remove_auth(self, username: str) -> None: ...
     def change_password(self, username: str, new_password: str) -> None: ...
+    @callback
     def _validate_new_username(self, new_username: str) -> None: ...
+    @callback
     def change_username(self, username: str, new_username: str) -> None: ...
     async def async_save(self) -> None: ...
 

homeassistant-stubs/auth/providers/insecure_example.pyi

@@ -12,6 +12,7 @@ class InvalidAuthError(HomeAssistantError): ...
 
 class ExampleAuthProvider(AuthProvider):
     async def async_login_flow(self, context: AuthFlowContext | None) -> ExampleLoginFlow: ...
+    @callback
     def async_validate_login(self, username: str, password: str) -> None: ...
     async def async_get_or_create_credentials(self, flow_result: Mapping[str, str]) -> Credentials: ...
     async def async_user_meta_for_credentials(self, credentials: Credentials) -> UserMeta: ...

homeassistant-stubs/auth/providers/trusted_networks.pyi

@@ -32,7 +32,9 @@ class TrustedNetworksAuthProvider(AuthProvider):
     async def async_login_flow(self, context: AuthFlowContext | None) -> TrustedNetworksLoginFlow: ...
     async def async_get_or_create_credentials(self, flow_result: Mapping[str, str]) -> Credentials: ...
     async def async_user_meta_for_credentials(self, credentials: Credentials) -> UserMeta: ...
+    @callback
     def async_validate_access(self, ip_addr: IPAddress) -> None: ...
+    @callback
     def async_validate_refresh_token(self, refresh_token: RefreshToken, remote_ip: str | None = None) -> None: ...
 
 class TrustedNetworksLoginFlow(LoginFlow[TrustedNetworksAuthProvider]):

homeassistant-stubs/bootstrap.pyi

@@ -58,6 +58,7 @@ class _RotatingFileHandlerWithoutShouldRollOver(RotatingFileHandler):
     def shouldRollover(self, record: logging.LogRecord) -> bool: ...
 
 async def async_mount_local_lib_path(config_dir: str) -> str: ...
+@core.callback
 def _get_domains(hass: core.HomeAssistant, config: dict[str, Any]) -> set[str]: ...
 
 class _WatchPendingSetups:

homeassistant-stubs/components/acaia/sensor.pyi

@@ -37,6 +37,7 @@ class AcaiaRestoreSensor(AcaiaEntity, RestoreSensor):
     _attr_native_value: Incomplete
     _attr_native_unit_of_measurement: Incomplete
     async def async_added_to_hass(self) -> None: ...
+    @callback
     def _handle_coordinator_update(self) -> None: ...
     @property
     def available(self) -> bool: ...

homeassistant-stubs/components/accuweather/sensor.pyi

@@ -34,6 +34,7 @@ class AccuWeatherSensor(CoordinatorEntity[AccuWeatherObservationDataUpdateCoordi
     def native_value(self) -> str | int | float | None: ...
     @property
     def extra_state_attributes(self) -> dict[str, Any]: ...
+    @callback
     def _handle_coordinator_update(self) -> None: ...
     @staticmethod
     def _get_sensor_data(sensors: dict[str, Any], kind: str) -> Any: ...
@@ -52,6 +53,7 @@ class AccuWeatherForecastSensor(CoordinatorEntity[AccuWeatherDailyForecastDataUp
     def native_value(self) -> str | int | float | None: ...
     @property
     def extra_state_attributes(self) -> dict[str, Any]: ...
+    @callback
     def _handle_coordinator_update(self) -> None: ...
     @staticmethod
     def _get_sensor_data(sensors: list[dict[str, Any]], kind: str, forecast_day: int) -> Any: ...

homeassistant-stubs/components/accuweather/system_health.pyi

@@ -4,5 +4,6 @@ from homeassistant.components import system_health as system_health
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from typing import Any
 
+@callback
 def async_register(hass: HomeAssistant, register: system_health.SystemHealthRegistration) -> None: ...
 async def system_health_info(hass: HomeAssistant) -> dict[str, Any]: ...

homeassistant-stubs/components/accuweather/weather.pyi

@@ -50,4 +50,5 @@ class AccuWeatherEntity(CoordinatorWeatherEntity[AccuWeatherObservationDataUpdat
     def native_visibility(self) -> float: ...
     @property
     def uv_index(self) -> float: ...
+    @callback
     def _async_forecast_daily(self) -> list[Forecast] | None: ...

homeassistant-stubs/components/acmeda/entity.pyi

@@ -13,6 +13,7 @@ class AcmedaEntity(entity.Entity):
     async def async_remove_and_unregister(self) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     async def async_will_remove_from_hass(self) -> None: ...
+    @callback
     def notify_update(self) -> None: ...
     @property
     def unique_id(self) -> str: ...

homeassistant-stubs/components/acmeda/helpers.pyi

@@ -5,5 +5,6 @@ from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 
+@callback
 def async_add_acmeda_entities(hass: HomeAssistant, entity_class: type, config_entry: AcmedaConfigEntry, current: set[int], async_add_entities: AddEntitiesCallback) -> None: ...
 async def update_devices(hass: HomeAssistant, config_entry: ConfigEntry, api: dict[int, Roller]) -> None: ...

homeassistant-stubs/components/air_quality/__init__.pyi

@@ -7,7 +7,7 @@ from homeassistant.helpers.entity import Entity as Entity
 from homeassistant.helpers.entity_component import EntityComponent as EntityComponent
 from homeassistant.helpers.typing import ConfigType as ConfigType, StateType as StateType
 from homeassistant.util.hass_dict import HassKey as HassKey
-from typing import Final
+from typing import Final, final
 
 _LOGGER: Final[Incomplete]
 DATA_COMPONENT: HassKey[EntityComponent[AirQualityEntity]]
@@ -55,6 +55,7 @@ class AirQualityEntity(Entity):
     def nitrogen_monoxide(self) -> StateType: ...
     @property
     def nitrogen_dioxide(self) -> StateType: ...
+    @final
     @property
     def state_attributes(self) -> dict[str, str | int | float]: ...
     @property

homeassistant-stubs/components/airly/sensor.pyi

@@ -30,4 +30,5 @@ class AirlySensor(CoordinatorEntity[AirlyDataUpdateCoordinator], SensorEntity):
     _attr_native_value: Incomplete
     _attr_extra_state_attributes: Incomplete
     def __init__(self, coordinator: AirlyDataUpdateCoordinator, name: str, description: AirlySensorEntityDescription) -> None: ...
+    @callback
     def _handle_coordinator_update(self) -> None: ...

homeassistant-stubs/components/airly/system_health.pyi

@@ -4,5 +4,6 @@ from homeassistant.components import system_health as system_health
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from typing import Any
 
+@callback
 def async_register(hass: HomeAssistant, register: system_health.SystemHealthRegistration) -> None: ...
 async def system_health_info(hass: HomeAssistant) -> dict[str, Any]: ...

homeassistant-stubs/components/airnow/config_flow.pyi

@@ -15,6 +15,7 @@ class AirNowConfigFlow(ConfigFlow, domain=DOMAIN):
     VERSION: int
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     @staticmethod
+    @callback
     def async_get_options_flow(config_entry: ConfigEntry) -> AirNowOptionsFlowHandler: ...
 
 class AirNowOptionsFlowHandler(OptionsFlow):

homeassistant-stubs/components/airq/config_flow.pyi

@@ -16,4 +16,5 @@ class AirQConfigFlow(ConfigFlow, domain=DOMAIN):
     VERSION: int
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     @staticmethod
+    @callback
     def async_get_options_flow(config_entry: ConfigEntry) -> SchemaOptionsFlowHandler: ...

homeassistant-stubs/components/airq/sensor.pyi

@@ -26,4 +26,5 @@ class AirQSensor(CoordinatorEntity, SensorEntity):
     _attr_unique_id: Incomplete
     _attr_native_value: Incomplete
     def __init__(self, coordinator: AirQCoordinator, description: AirQEntityDescription) -> None: ...
+    @callback
     def _handle_coordinator_update(self) -> None: ...

homeassistant-stubs/components/airthings_ble/sensor.pyi

@@ -15,6 +15,7 @@ from homeassistant.util.unit_system import METRIC_SYSTEM as METRIC_SYSTEM
 _LOGGER: Incomplete
 SENSORS_MAPPING_TEMPLATE: dict[str, SensorEntityDescription]
 
+@callback
 def async_migrate(hass: HomeAssistant, address: str, sensor_name: str) -> None: ...
 async def async_setup_entry(hass: HomeAssistant, entry: AirthingsBLEConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 

homeassistant-stubs/components/airtouch5/climate.pyi

@@ -44,6 +44,7 @@ class Airtouch5AC(Airtouch5ClimateEntity):
     _attr_target_temperature: Incomplete
     _attr_hvac_mode: Incomplete
     _attr_fan_mode: Incomplete
+    @callback
     def _async_update_attrs(self, data: dict[int, AcStatus]) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     async def async_will_remove_from_hass(self) -> None: ...
@@ -66,6 +67,7 @@ class Airtouch5Zone(Airtouch5ClimateEntity):
     _attr_target_temperature: Incomplete
     _attr_hvac_mode: Incomplete
     _attr_preset_mode: Incomplete
+    @callback
     def _async_update_attrs(self, data: dict[int, ZoneStatusZone]) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     async def async_will_remove_from_hass(self) -> None: ...

homeassistant-stubs/components/airtouch5/cover.pyi

@@ -25,6 +25,7 @@ class Airtouch5ZoneOpenPercentage(CoverEntity, Airtouch5Entity):
     def __init__(self, client: Airtouch5SimpleClient, zone_name: ZoneName, has_sensor: bool) -> None: ...
     _attr_current_cover_position: Incomplete
     _attr_is_closed: bool
+    @callback
     def _async_update_attrs(self, data: dict[int, ZoneStatusZone]) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     async def async_will_remove_from_hass(self) -> None: ...

homeassistant-stubs/components/airtouch5/entity.pyi

@@ -10,6 +10,7 @@ class Airtouch5Entity(Entity):
     _client: Incomplete
     _attr_available: bool
     def __init__(self, client: Airtouch5SimpleClient) -> None: ...
+    @callback
     def _receive_connection_callback(self, state: Airtouch5ConnectionStateChange) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     async def async_will_remove_from_hass(self) -> None: ...

homeassistant-stubs/components/airvisual/__init__.pyi

@@ -17,10 +17,15 @@ DOMAIN_AIRVISUAL_PRO: str
 PLATFORMS: Incomplete
 DEFAULT_ATTRIBUTION: str
 
+@callback
 def async_get_cloud_api_update_interval(hass: HomeAssistant, api_key: str, num_consumers: int) -> timedelta: ...
+@callback
 def async_get_cloud_coordinators_by_api_key(hass: HomeAssistant, api_key: str) -> list[DataUpdateCoordinator]: ...
+@callback
 def async_get_geography_id(geography_dict: Mapping[str, Any]) -> str: ...
+@callback
 def async_sync_geo_coordinator_update_intervals(hass: HomeAssistant, api_key: str) -> None: ...
+@callback
 def _standardize_geography_config_entry(hass: HomeAssistant, entry: ConfigEntry) -> None: ...
 async def async_setup_entry(hass: HomeAssistant, entry: AirVisualConfigEntry) -> bool: ...
 async def async_migrate_entry(hass: HomeAssistant, entry: AirVisualConfigEntry) -> bool: ...

homeassistant-stubs/components/airvisual/config_flow.pyi

@@ -27,6 +27,7 @@ class AirVisualFlowHandler(ConfigFlow, domain=DOMAIN):
     async def _async_init_geography(self, user_input: dict[str, str], integration_type: str) -> ConfigFlowResult: ...
     async def _async_set_unique_id(self, unique_id: str) -> None: ...
     @staticmethod
+    @callback
     def async_get_options_flow(config_entry: ConfigEntry) -> SchemaOptionsFlowHandler: ...
     async def async_step_import(self, import_data: dict[str, str]) -> ConfigFlowResult: ...
     async def async_step_geography_by_coords(self, user_input: dict[str, str] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/airvisual/entity.pyi

@@ -10,4 +10,5 @@ class AirVisualEntity(CoordinatorEntity):
     entity_description: Incomplete
     def __init__(self, coordinator: DataUpdateCoordinator, entry: ConfigEntry, description: EntityDescription) -> None: ...
     async def async_added_to_hass(self) -> None: ...
+    @callback
     def update_from_latest_data(self) -> None: ...

homeassistant-stubs/components/airvisual/sensor.pyi

@@ -44,4 +44,5 @@ class AirVisualGeographySensor(AirVisualEntity, SensorEntity):
     @property
     def available(self) -> bool: ...
     _attr_native_value: Incomplete
+    @callback
     def update_from_latest_data(self) -> None: ...

homeassistant-stubs/components/airvisual_pro/sensor.pyi

@@ -15,6 +15,7 @@ class AirVisualProMeasurementDescription(SensorEntityDescription):
 
 SENSOR_DESCRIPTIONS: Incomplete
 
+@callback
 def async_get_aqi_locale(settings: dict[str, Any]) -> str: ...
 async def async_setup_entry(hass: HomeAssistant, entry: AirVisualProConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 

homeassistant-stubs/components/airzone/binary_sensor.pyi

@@ -21,9 +21,11 @@ async def async_setup_entry(hass: HomeAssistant, entry: AirzoneConfigEntry, asyn
 
 class AirzoneBinarySensor(AirzoneEntity, BinarySensorEntity):
     entity_description: AirzoneBinarySensorEntityDescription
+    @callback
     def _handle_coordinator_update(self) -> None: ...
     _attr_is_on: Incomplete
     _attr_extra_state_attributes: Incomplete
+    @callback
     def _async_update_attrs(self) -> None: ...
 
 class AirzoneSystemBinarySensor(AirzoneSystemEntity, AirzoneBinarySensor):

homeassistant-stubs/components/airzone/climate.pyi

@@ -37,6 +37,7 @@ class AirzoneClimate(AirzoneZoneEntity, ClimateEntity):
     async def async_set_fan_mode(self, fan_mode: str) -> None: ...
     async def async_set_hvac_mode(self, hvac_mode: HVACMode) -> None: ...
     async def async_set_temperature(self, **kwargs: Any) -> None: ...
+    @callback
     def _handle_coordinator_update(self) -> None: ...
     _attr_current_temperature: Incomplete
     _attr_current_humidity: Incomplete
@@ -48,4 +49,5 @@ class AirzoneClimate(AirzoneZoneEntity, ClimateEntity):
     _attr_target_temperature_high: Incomplete
     _attr_target_temperature_low: Incomplete
     _attr_target_temperature: Incomplete
+    @callback
     def _async_update_attrs(self) -> None: ...

homeassistant-stubs/components/airzone/select.pyi

@@ -31,9 +31,11 @@ async def async_setup_entry(hass: HomeAssistant, entry: AirzoneConfigEntry, asyn
 class AirzoneBaseSelect(AirzoneEntity, SelectEntity):
     entity_description: AirzoneSelectDescription
     values_dict: dict[int, str]
+    @callback
     def _handle_coordinator_update(self) -> None: ...
     def _get_current_option(self) -> str | None: ...
     _attr_current_option: Incomplete
+    @callback
     def _async_update_attrs(self) -> None: ...
 
 class AirzoneZoneSelect(AirzoneZoneEntity, AirzoneBaseSelect):