homeassistant-stubs 2025.1.1__py3-none-any.whl → 2025.1.3__py3-none-any.whl

homeassistant-stubs/helpers/start.pyi

@@ -5,6 +5,9 @@ from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, CoreState as Core
 from homeassistant.util.event_type import EventType as EventType
 from typing import Any
 
+@callback
 def _async_at_core_state(hass: HomeAssistant, at_start_cb: Callable[[HomeAssistant], Coroutine[Any, Any, None] | None], event_type: EventType[NoEventData], check_state: Callable[[HomeAssistant], bool]) -> CALLBACK_TYPE: ...
+@callback
 def async_at_start(hass: HomeAssistant, at_start_cb: Callable[[HomeAssistant], Coroutine[Any, Any, None] | None]) -> CALLBACK_TYPE: ...
+@callback
 def async_at_started(hass: HomeAssistant, at_start_cb: Callable[[HomeAssistant], Coroutine[Any, Any, None] | None]) -> CALLBACK_TYPE: ...

homeassistant-stubs/helpers/state.pyi

@@ -9,5 +9,6 @@ from typing import Any
 
 _LOGGER: Incomplete
 
+@bind_hass
 async def async_reproduce_state(hass: HomeAssistant, states: State | Iterable[State], *, context: Context | None = None, reproduce_options: dict[str, Any] | None = None) -> None: ...
 def state_as_number(state: State) -> float: ...

homeassistant-stubs/helpers/storage.pyi

@@ -20,6 +20,7 @@ STORAGE_SEMAPHORE: HassKey[asyncio.Semaphore]
 STORAGE_MANAGER: HassKey[_StoreManager]
 MANAGER_CLEANUP_DELAY: int
 
+@bind_hass
 async def async_migrator[_T: Mapping[str, Any] | Sequence[Any]](hass: HomeAssistant, old_path: str, store: Store[_T], *, old_conf_load_func: Callable | None = None, old_conf_migrate_func: Callable | None = None) -> _T | None: ...
 def get_internal_store_manager(hass: HomeAssistant) -> _StoreManager: ...
 
@@ -32,10 +33,15 @@ class _StoreManager:
     _cancel_cleanup: asyncio.TimerHandle | None
     def __init__(self, hass: HomeAssistant) -> None: ...
     async def async_initialize(self) -> None: ...
+    @callback
     def async_invalidate(self, key: str) -> None: ...
+    @callback
     def async_fetch(self, key: str) -> tuple[bool, json_util.JsonValueType | None] | None: ...
+    @callback
     def _async_schedule_cleanup(self, _event: Event) -> None: ...
+    @callback
     def _async_cancel_and_cleanup(self, _event: Event) -> None: ...
+    @callback
     def _async_cleanup(self) -> None: ...
     async def async_preload(self, keys: Iterable[str]) -> None: ...
     def _preload(self, keys: Iterable[str]) -> None: ...
@@ -65,11 +71,17 @@ class Store[_T: Mapping[str, Any] | Sequence[Any]]:
     async def _async_load(self) -> _T | None: ...
     async def _async_load_data(self): ...
     async def async_save(self, data: _T) -> None: ...
+    @callback
     def async_delay_save(self, data_func: Callable[[], _T], delay: float = 0) -> None: ...
+    @callback
     def _async_reschedule_delayed_write(self, when: float) -> None: ...
+    @callback
     def _async_schedule_callback_delayed_write(self) -> None: ...
+    @callback
     def _async_ensure_final_write_listener(self) -> None: ...
+    @callback
     def _async_cleanup_final_write_listener(self) -> None: ...
+    @callback
     def _async_cleanup_delay_listener(self) -> None: ...
     async def _async_callback_delayed_write(self) -> None: ...
     async def _async_callback_final_write(self, _event: Event) -> None: ...

homeassistant-stubs/helpers/sun.pyi

@@ -12,8 +12,17 @@ DATA_LOCATION_CACHE: HassKey[dict[tuple[str, str, str, float, float], astral.loc
 ELEVATION_AGNOSTIC_EVENTS: Incomplete
 type _AstralSunEventCallable = Callable[..., datetime.datetime]
 
+@callback
+@bind_hass
 def get_astral_location(hass: HomeAssistant) -> tuple[astral.location.Location, astral.Elevation]: ...
+@callback
+@bind_hass
 def get_astral_event_next(hass: HomeAssistant, event: str, utc_point_in_time: datetime.datetime | None = None, offset: datetime.timedelta | None = None) -> datetime.datetime: ...
+@callback
 def get_location_astral_event_next(location: astral.location.Location, elevation: astral.Elevation, event: str, utc_point_in_time: datetime.datetime | None = None, offset: datetime.timedelta | None = None) -> datetime.datetime: ...
+@callback
+@bind_hass
 def get_astral_event_date(hass: HomeAssistant, event: str, date: datetime.date | datetime.datetime | None = None) -> datetime.datetime | None: ...
+@callback
+@bind_hass
 def is_up(hass: HomeAssistant, utc_point_in_time: datetime.datetime | None = None) -> bool: ...

homeassistant-stubs/helpers/system_info.pyi

@@ -15,4 +15,5 @@ async def async_get_mac_ver(hass: HomeAssistant) -> str: ...
 
 cached_get_user: Incomplete
 
+@bind_hass
 async def async_get_system_info(hass: HomeAssistant) -> dict[str, Any]: ...

homeassistant-stubs/helpers/template.pyi

@@ -11,6 +11,7 @@ from collections.abc import Callable as Callable, Generator, Iterable
 from contextlib import AbstractContextManager
 from contextvars import ContextVar
 from datetime import datetime, timedelta
+from functools import cache
 from homeassistant.const import ATTR_ENTITY_ID as ATTR_ENTITY_ID, ATTR_LATITUDE as ATTR_LATITUDE, ATTR_LONGITUDE as ATTR_LONGITUDE, ATTR_PERSONS as ATTR_PERSONS, ATTR_UNIT_OF_MEASUREMENT as ATTR_UNIT_OF_MEASUREMENT, EVENT_HOMEASSISTANT_START as EVENT_HOMEASSISTANT_START, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN, UnitOfLength as UnitOfLength
 from homeassistant.core import Context as Context, HomeAssistant as HomeAssistant, ServiceResponse as ServiceResponse, State as State, callback as callback, split_entity_id as split_entity_id, valid_domain as valid_domain, valid_entity_id as valid_entity_id
 from homeassistant.exceptions import TemplateError as TemplateError
@@ -21,6 +22,7 @@ from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.json import JSON_DECODE_EXCEPTIONS as JSON_DECODE_EXCEPTIONS, json_loads as json_loads
 from homeassistant.util.read_only_dict import ReadOnlyDict as ReadOnlyDict
 from homeassistant.util.thread import ThreadWithException as ThreadWithException
+from jinja2 import pass_context
 from jinja2.sandbox import ImmutableSandboxedEnvironment
 from lru import LRU
 from propcache import under_cached_property
@@ -53,6 +55,7 @@ ORJSON_PASSTHROUGH_OPTIONS: Incomplete
 def _template_state_no_collect(hass: HomeAssistant, state: State) -> TemplateState: ...
 def _template_state(hass: HomeAssistant, state: State) -> TemplateState: ...
 def async_setup(hass: HomeAssistant) -> bool: ...
+@bind_hass
 def attach(hass: HomeAssistant, obj: Any) -> None: ...
 def _attach(hass: HomeAssistant, obj: Any) -> None: ...
 def render_complex(value: Any, variables: TemplateVarsType = None, limited: bool = False, parse_result: bool = True) -> Any: ...
@@ -121,17 +124,21 @@ class Template:
     def _env(self) -> TemplateEnvironment: ...
     def ensure_valid(self) -> None: ...
     def render(self, variables: TemplateVarsType = None, parse_result: bool = True, limited: bool = False, **kwargs: Any) -> Any: ...
+    @callback
     def async_render(self, variables: TemplateVarsType = None, parse_result: bool = True, limited: bool = False, strict: bool = False, log_fn: Callable[[int, str], None] | None = None, **kwargs: Any) -> Any: ...
     def _parse_result(self, render_result: str) -> Any: ...
     async def async_render_will_timeout(self, timeout: float, variables: TemplateVarsType = None, strict: bool = False, log_fn: Callable[[int, str], None] | None = None, **kwargs: Any) -> bool: ...
+    @callback
     def async_render_to_info(self, variables: TemplateVarsType = None, strict: bool = False, log_fn: Callable[[int, str], None] | None = None, **kwargs: Any) -> RenderInfo: ...
     def render_with_possible_json_value(self, value, error_value=...): ...
+    @callback
     def async_render_with_possible_json_value(self, value: Any, error_value: Any = ..., variables: dict[str, Any] | None = None, parse_result: bool = False) -> Any: ...
     def _ensure_compiled(self, limited: bool = False, strict: bool = False, log_fn: Callable[[int, str], None] | None = None) -> jinja2.Template: ...
     def __eq__(self, other): ...
     def __hash__(self) -> int: ...
     def __repr__(self) -> str: ...
 
+@cache
 def _domain_states(hass: HomeAssistant, name: str) -> DomainStates: ...
 def _readonly(*args: Any, **kwargs: Any) -> Any: ...
 
@@ -329,6 +336,7 @@ def ordinal(value): ...
 def from_json(value): ...
 def _to_json_default(obj: Any) -> None: ...
 def to_json(value: Any, ensure_ascii: bool = False, pretty_print: bool = False, sort_keys: bool = False) -> str: ...
+@pass_context
 def random_every_time(context, values): ...
 def today_at(hass: HomeAssistant, time_str: str = '') -> datetime: ...
 def relative_time(hass: HomeAssistant, value: Any) -> Any: ...

homeassistant-stubs/helpers/trace.pyi

@@ -2,6 +2,7 @@ from .typing import TemplateVarsType as TemplateVarsType
 from _typeshed import Incomplete
 from collections import deque
 from collections.abc import Callable as Callable, Coroutine, Generator
+from contextlib import contextmanager
 from contextvars import ContextVar
 from homeassistant.core import ServiceResponse as ServiceResponse
 from typing import Any
@@ -54,5 +55,6 @@ class StopReason:
 
 def script_execution_set(reason: str, response: ServiceResponse = None) -> None: ...
 def script_execution_get() -> str | None: ...
+@contextmanager
 def trace_path(suffix: str | list[str]) -> Generator[None]: ...
 def async_trace_path[*_Ts](suffix: str | list[str]) -> Callable[[Callable[[*_Ts], Coroutine[Any, Any, None]]], Callable[[*_Ts], Coroutine[Any, Any, None]]]: ...

homeassistant-stubs/helpers/translation.pyi

@@ -22,7 +22,6 @@ async def _async_get_component_strings(hass: HomeAssistant, languages: Iterable[
 class _TranslationsCacheData:
     loaded: dict[str, set[str]]
     cache: dict[str, dict[str, dict[str, dict[str, str]]]]
-    def __init__(self, loaded, cache) -> None: ...
 
 class _TranslationCache:
     __slots__: Incomplete
@@ -30,19 +29,27 @@ class _TranslationCache:
     cache_data: Incomplete
     lock: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_is_loaded(self, language: str, components: set[str]) -> bool: ...
     async def async_load(self, language: str, components: set[str]) -> None: ...
     async def async_fetch(self, language: str, category: str, components: set[str]) -> dict[str, str]: ...
     def get_cached(self, language: str, category: str, components: set[str]) -> dict[str, str]: ...
     async def _async_load(self, language: str, components: set[str]) -> None: ...
     def _validate_placeholders(self, language: str, updated_resources: dict[str, str], cached_resources: dict[str, str] | None = None) -> dict[str, str]: ...
+    @callback
     def _build_category_cache(self, language: str, components: set[str], translation_strings: dict[str, dict[str, Any]]) -> None: ...
 
+@bind_hass
 async def async_get_translations(hass: HomeAssistant, language: str, category: str, integrations: Iterable[str] | None = None, config_flow: bool | None = None) -> dict[str, str]: ...
+@callback
 def async_get_cached_translations(hass: HomeAssistant, language: str, category: str, integration: str | None = None) -> dict[str, str]: ...
 def _async_get_translations_cache(hass: HomeAssistant) -> _TranslationCache: ...
+@callback
 def async_setup(hass: HomeAssistant) -> None: ...
 async def async_load_integrations(hass: HomeAssistant, integrations: set[str]) -> None: ...
+@callback
 def async_translations_loaded(hass: HomeAssistant, components: set[str]) -> bool: ...
+@callback
 def async_get_exception_message(translation_domain: str, translation_key: str, translation_placeholders: dict[str, str] | None = None) -> str: ...
+@callback
 def async_translate_state(hass: HomeAssistant, state: str, domain: str, platform: str | None, translation_key: str | None, device_class: str | None) -> str: ...

homeassistant-stubs/helpers/trigger.pyi

@@ -4,7 +4,7 @@ from .typing import ConfigType as ConfigType, TemplateVarsType as TemplateVarsTy
 from _typeshed import Incomplete
 from collections import defaultdict
 from collections.abc import Callable, Coroutine
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from homeassistant.const import CONF_ALIAS as CONF_ALIAS, CONF_ENABLED as CONF_ENABLED, CONF_ID as CONF_ID, CONF_PLATFORM as CONF_PLATFORM, CONF_VARIABLES as CONF_VARIABLES
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Context as Context, HassJob as HassJob, HomeAssistant as HomeAssistant, callback as callback, is_callback as is_callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, TemplateError as TemplateError
@@ -38,20 +38,23 @@ class TriggerInfo(TypedDict):
 
 @dataclass(slots=True)
 class PluggableActionsEntry:
-    plugs: set[PluggableAction] = ...
-    actions: dict[object, tuple[HassJob[[dict[str, Any], Context | None], Coroutine[Any, Any, None]], dict[str, Any]]] = ...
-    def __init__(self, plugs=..., actions=...) -> None: ...
+    plugs: set[PluggableAction] = field(default_factory=set)
+    actions: dict[object, tuple[HassJob[[dict[str, Any], Context | None], Coroutine[Any, Any, None]], dict[str, Any]]] = field(default_factory=dict)
 
 class PluggableAction:
     _entry: PluggableActionsEntry | None
     _update: Incomplete
     def __init__(self, update: CALLBACK_TYPE | None = None) -> None: ...
     def __bool__(self) -> bool: ...
+    @callback
     def async_run_update(self) -> None: ...
     @staticmethod
+    @callback
     def async_get_registry(hass: HomeAssistant) -> dict[tuple, PluggableActionsEntry]: ...
     @staticmethod
+    @callback
     def async_attach_trigger(hass: HomeAssistant, trigger: dict[str, str], action: TriggerActionType, variables: dict[str, Any]) -> CALLBACK_TYPE: ...
+    @callback
     def async_register(self, hass: HomeAssistant, trigger: dict[str, str]) -> CALLBACK_TYPE: ...
     async def async_run(self, hass: HomeAssistant, context: Context | None = None) -> None: ...
 

homeassistant-stubs/helpers/trigger_template_entity.pyi

@@ -52,6 +52,7 @@ class TriggerBaseEntity(Entity):
 
 class ManualTriggerEntity(TriggerBaseEntity):
     def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
+    @callback
     def _process_manual_data(self, value: Any | None = None) -> None: ...
 
 class ManualTriggerSensorEntity(ManualTriggerEntity, SensorEntity):

homeassistant-stubs/helpers/update_coordinator.pyi

@@ -26,6 +26,7 @@ _DataUpdateCoordinatorT = TypeVar('_DataUpdateCoordinatorT', bound='DataUpdateCo
 class UpdateFailed(HomeAssistantError): ...
 
 class BaseDataUpdateCoordinatorProtocol(Protocol):
+    @callback
     def async_add_listener(self, update_callback: CALLBACK_TYPE, context: Any = None) -> Callable[[], None]: ...
 
 class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
@@ -49,9 +50,12 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     _debounced_refresh: Incomplete
     def __init__(self, hass: HomeAssistant, logger: logging.Logger, *, config_entry: config_entries.ConfigEntry | None | UndefinedType = ..., name: str, update_interval: timedelta | None = None, update_method: Callable[[], Awaitable[_DataT]] | None = None, setup_method: Callable[[], Awaitable[None]] | None = None, request_refresh_debouncer: Debouncer[Coroutine[Any, Any, None]] | None = None, always_update: bool = True) -> None: ...
     async def async_register_shutdown(self) -> None: ...
+    @callback
     def async_add_listener(self, update_callback: CALLBACK_TYPE, context: Any = None) -> Callable[[], None]: ...
+    @callback
     def async_update_listeners(self) -> None: ...
     async def async_shutdown(self) -> None: ...
+    @callback
     def _unschedule_refresh(self) -> None: ...
     def async_contexts(self) -> Generator[Any]: ...
     def _async_unsub_refresh(self) -> None: ...
@@ -61,7 +65,9 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     _update_interval: Incomplete
     @update_interval.setter
     def update_interval(self, value: timedelta | None) -> None: ...
+    @callback
     def _schedule_refresh(self) -> None: ...
+    @callback
     def __wrap_handle_refresh_interval(self) -> None: ...
     async def _handle_refresh_interval(self, _now: datetime | None = None) -> None: ...
     async def async_request_refresh(self) -> None: ...
@@ -71,12 +77,16 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     async def _async_setup(self) -> None: ...
     async def async_refresh(self) -> None: ...
     async def _async_refresh(self, log_failures: bool = True, raise_on_auth_failed: bool = False, scheduled: bool = False, raise_on_entry_error: bool = False) -> None: ...
+    @callback
     def _async_refresh_finished(self) -> None: ...
+    @callback
     def async_set_update_error(self, err: Exception) -> None: ...
+    @callback
     def async_set_updated_data(self, data: _DataT) -> None: ...
 
 class TimestampDataUpdateCoordinator(DataUpdateCoordinator[_DataT]):
     last_update_success_time: datetime | None
+    @callback
     def _async_refresh_finished(self) -> None: ...
 
 class BaseCoordinatorEntity[_BaseDataUpdateCoordinatorT: BaseDataUpdateCoordinatorProtocol](entity.Entity, metaclass=abc.ABCMeta):
@@ -86,6 +96,7 @@ class BaseCoordinatorEntity[_BaseDataUpdateCoordinatorT: BaseDataUpdateCoordinat
     @cached_property
     def should_poll(self) -> bool: ...
     async def async_added_to_hass(self) -> None: ...
+    @callback
     def _handle_coordinator_update(self) -> None: ...
     @abstractmethod
     async def async_update(self) -> None: ...

homeassistant-stubs/loader.pyi

@@ -33,7 +33,6 @@ BASE_PRELOAD_PLATFORMS: Incomplete
 class BlockedIntegration:
     lowest_good_version: AwesomeVersion | None
     reason: str
-    def __init__(self, lowest_good_version, reason) -> None: ...
 
 BLOCKED_CUSTOM_INTEGRATIONS: dict[str, BlockedIntegration]
 DATA_COMPONENTS: HassKey[dict[str, ModuleType | ComponentProtocol]]
@@ -86,7 +85,6 @@ class USBMatcher(USBMatcherRequired, USBMatcherOptional): ...
 class HomeKitDiscoveredIntegration:
     domain: str
     always_discover: bool
-    def __init__(self, domain, always_discover) -> None: ...
 
 class ZeroconfMatcher(TypedDict, total=False):
     domain: str
@@ -150,6 +148,7 @@ def homekit_always_discover(iot_class: str | None) -> bool: ...
 async def async_get_homekit(hass: HomeAssistant) -> dict[str, HomeKitDiscoveredIntegration]: ...
 async def async_get_ssdp(hass: HomeAssistant) -> dict[str, list[dict[str, str]]]: ...
 async def async_get_mqtt(hass: HomeAssistant) -> dict[str, list[str]]: ...
+@callback
 def async_register_preload_platform(hass: HomeAssistant, platform_name: str) -> None: ...
 
 class Integration:
@@ -246,6 +245,7 @@ class Integration:
 
 def _version_blocked(integration_version: AwesomeVersion, blocked_integration: BlockedIntegration) -> bool: ...
 def _resolve_integrations_from_root(hass: HomeAssistant, root_module: ModuleType, domains: Iterable[str]) -> dict[str, Integration]: ...
+@callback
 def async_get_loaded_integration(hass: HomeAssistant, domain: str) -> Integration: ...
 async def async_get_integration(hass: HomeAssistant, domain: str) -> Integration: ...
 async def async_get_integrations(hass: HomeAssistant, domains: Iterable[str]) -> dict[str, Integration | Exception]: ...
@@ -288,6 +288,9 @@ async def _async_component_dependencies(hass: HomeAssistant, integration: Integr
 def _async_mount_config_dir(hass: HomeAssistant) -> None: ...
 def _lookup_path(hass: HomeAssistant) -> list[str]: ...
 def is_component_module_loaded(hass: HomeAssistant, module: str) -> bool: ...
+@callback
 def async_get_issue_integration(hass: HomeAssistant | None, integration_domain: str | None) -> Integration | None: ...
+@callback
 def async_get_issue_tracker(hass: HomeAssistant | None, *, integration: Integration | None = None, integration_domain: str | None = None, module: str | None = None) -> str | None: ...
+@callback
 def async_suggest_report_issue(hass: HomeAssistant | None, *, integration: Integration | None = None, integration_domain: str | None = None, module: str | None = None) -> str: ...

homeassistant-stubs/requirements.pyi

@@ -22,7 +22,9 @@ class RequirementsNotFound(HomeAssistantError):
 async def async_get_integration_with_requirements(hass: HomeAssistant, domain: str) -> Integration: ...
 async def async_process_requirements(hass: HomeAssistant, name: str, requirements: list[str]) -> None: ...
 async def async_load_installed_versions(hass: HomeAssistant, requirements: set[str]) -> None: ...
+@callback
 def _async_get_manager(hass: HomeAssistant) -> RequirementsManager: ...
+@callback
 def async_clear_install_history(hass: HomeAssistant) -> None: ...
 def pip_kwargs(config_dir: str | None) -> dict[str, Any]: ...
 def _install_with_retry(requirement: str, kwargs: dict[str, Any]) -> bool: ...

homeassistant-stubs/runner.pyi

@@ -16,7 +16,7 @@ _LOGGER: Incomplete
 class RuntimeConfig:
     config_dir: str
     skip_pip: bool = ...
-    skip_pip_packages: list[str] = ...
+    skip_pip_packages: list[str] = dataclasses.field(default_factory=list)
     recovery_mode: bool = ...
     verbose: bool = ...
     log_rotate_days: int | None = ...
@@ -25,7 +25,6 @@ class RuntimeConfig:
     debug: bool = ...
     open_ui: bool = ...
     safe_mode: bool = ...
-    def __init__(self, config_dir, skip_pip=..., skip_pip_packages=..., recovery_mode=..., verbose=..., log_rotate_days=..., log_file=..., log_no_color=..., debug=..., open_ui=..., safe_mode=...) -> None: ...
 
 class HassEventLoopPolicy(asyncio.DefaultEventLoopPolicy):
     debug: Incomplete
@@ -34,6 +33,7 @@ class HassEventLoopPolicy(asyncio.DefaultEventLoopPolicy):
     def loop_name(self) -> str: ...
     def new_event_loop(self) -> asyncio.AbstractEventLoop: ...
 
+@callback
 def _async_loop_exception_handler(_: Any, context: dict[str, Any]) -> None: ...
 async def setup_and_run_hass(runtime_config: RuntimeConfig) -> int: ...
 def _enable_posix_spawn() -> None: ...

homeassistant-stubs/scripts/benchmark/__init__.pyi

@@ -10,11 +10,19 @@ BENCHMARKS: dict[str, Callable]
 def run(args) -> None: ...
 async def run_benchmark(bench) -> None: ...
 def benchmark[_CallableT: Callable](func: _CallableT) -> _CallableT: ...
+@benchmark
 async def fire_events(hass): ...
+@benchmark
 async def fire_events_with_filter(hass): ...
+@benchmark
 async def state_changed_helper(hass): ...
+@benchmark
 async def state_changed_event_helper(hass): ...
+@benchmark
 async def state_changed_event_filter_helper(hass): ...
+@benchmark
 async def filtering_entity_id(hass): ...
+@benchmark
 async def valid_entity_id(hass): ...
+@benchmark
 async def json_serialize_states(hass): ...

homeassistant-stubs/setup.pyi

@@ -1,4 +1,5 @@
 import asyncio
+import contextlib
 import contextvars
 from . import core as core, loader as loader, requirements as requirements
 from .const import BASE_PLATFORMS as BASE_PLATFORMS, EVENT_COMPONENT_LOADED as EVENT_COMPONENT_LOADED, EVENT_HOMEASSISTANT_START as EVENT_HOMEASSISTANT_START, PLATFORM_FORMAT as PLATFORM_FORMAT
@@ -32,7 +33,9 @@ SLOW_SETUP_MAX_WAIT: int
 class EventComponentLoaded(TypedDict):
     component: str
 
+@callback
 def async_notify_setup_error(hass: HomeAssistant, component: str, display_link: str | None = None) -> None: ...
+@core.callback
 def async_set_domains_to_be_loaded(hass: core.HomeAssistant, domains: set[str]) -> None: ...
 def setup_component(hass: core.HomeAssistant, domain: str, config: ConfigType) -> bool: ...
 async def async_setup_component(hass: core.HomeAssistant, domain: str, config: ConfigType) -> bool: ...
@@ -41,9 +44,13 @@ def _log_error_setup_error(hass: HomeAssistant, domain: str, integration: loader
 async def _async_setup_component(hass: core.HomeAssistant, domain: str, config: ConfigType) -> bool: ...
 async def async_prepare_setup_platform(hass: core.HomeAssistant, hass_config: ConfigType, domain: str, platform_name: str) -> ModuleType | None: ...
 async def async_process_deps_reqs(hass: core.HomeAssistant, config: ConfigType, integration: loader.Integration) -> None: ...
+@core.callback
 def async_when_setup(hass: core.HomeAssistant, component: str, when_setup_cb: Callable[[core.HomeAssistant, str], Awaitable[None]]) -> None: ...
+@core.callback
 def async_when_setup_or_start(hass: core.HomeAssistant, component: str, when_setup_cb: Callable[[core.HomeAssistant, str], Awaitable[None]]) -> None: ...
+@core.callback
 def _async_when_setup(hass: core.HomeAssistant, component: str, when_setup_cb: Callable[[core.HomeAssistant, str], Awaitable[None]], start_event: bool) -> None: ...
+@core.callback
 def async_get_loaded_integrations(hass: core.HomeAssistant) -> set[str]: ...
 
 class SetupPhases(StrEnum):
@@ -56,8 +63,12 @@ class SetupPhases(StrEnum):
     WAIT_IMPORT_PACKAGES = 'wait_import_packages'
 
 def _setup_started(hass: core.HomeAssistant) -> dict[tuple[str, str | None], float]: ...
+@contextlib.contextmanager
 def async_pause_setup(hass: core.HomeAssistant, phase: SetupPhases) -> Generator[None]: ...
 def _setup_times(hass: core.HomeAssistant) -> defaultdict[str, defaultdict[str | None, defaultdict[SetupPhases, float]]]: ...
+@contextlib.contextmanager
 def async_start_setup(hass: core.HomeAssistant, integration: str, phase: SetupPhases, group: str | None = None) -> Generator[None]: ...
+@callback
 def async_get_setup_timings(hass: core.HomeAssistant) -> dict[str, float]: ...
+@callback
 def async_get_domain_setup_times(hass: core.HomeAssistant, domain: str) -> Mapping[str | None, dict[SetupPhases, float]]: ...

homeassistant-stubs/util/enum.pyi

@@ -3,4 +3,5 @@ from enum import Enum as Enum
 from typing import Any
 
 def lru_cache[_T: Callable[..., Any]](func: _T) -> _T: ...
+@lru_cache
 def try_parse_enum[_EnumT: Enum](cls, value: Any) -> _EnumT | None: ...

homeassistant-stubs/util/language.pyi

@@ -19,7 +19,6 @@ class Dialect:
     def score(self, dialect: Dialect, country: str | None = None) -> tuple[float, float]: ...
     @staticmethod
     def parse(tag: str) -> Dialect: ...
-    def __init__(self, language, region, code=...) -> None: ...
 
 def matches(target: str, supported: Iterable[str], country: str | None = None) -> list[str]: ...
 def intersect(languages_1: set[str], languages_2: set[str]) -> set[str]: ...

homeassistant-stubs/util/location.pyi

@@ -1,5 +1,6 @@
 import aiohttp
 from _typeshed import Incomplete
+from functools import lru_cache
 from typing import Any, NamedTuple
 
 WHOAMI_URL: str
@@ -25,6 +26,7 @@ class LocationInfo(NamedTuple):
     use_metric: bool
 
 async def async_detect_location_info(session: aiohttp.ClientSession) -> LocationInfo | None: ...
+@lru_cache
 def distance(lat1: float | None, lon1: float | None, lat2: float, lon2: float) -> float | None: ...
 def vincenty(point1: tuple[float, float], point2: tuple[float, float], miles: bool = False) -> float | None: ...
 async def _get_whoami(session: aiohttp.ClientSession) -> dict[str, Any] | None: ...

homeassistant-stubs/util/logging.pyi

@@ -9,10 +9,12 @@ class HomeAssistantQueueHandler(logging.handlers.QueueHandler):
     def handle(self, record: logging.LogRecord) -> Any: ...
     def close(self) -> None: ...
 
+@callback
 def async_activate_log_queue_handler(hass: HomeAssistant) -> None: ...
 def log_exception[*_Ts](format_err: Callable[[*_Ts], Any], *args: *_Ts) -> None: ...
 async def _async_wrapper[*_Ts](async_func: Callable[[*_Ts], Coroutine[Any, Any, None]], format_err: Callable[[*_Ts], Any], *args: *_Ts) -> None: ...
 def _sync_wrapper[*_Ts](func: Callable[[*_Ts], Any], format_err: Callable[[*_Ts], Any], *args: *_Ts) -> None: ...
+@callback
 def _callback_wrapper[*_Ts](func: Callable[[*_Ts], Any], format_err: Callable[[*_Ts], Any], *args: *_Ts) -> None: ...
 @overload
 def catch_log_exception[*_Ts](func: Callable[[*_Ts], Coroutine[Any, Any, Any]], format_err: Callable[[*_Ts], Any], job_type: HassJobType | None = None) -> Callable[[*_Ts], Coroutine[Any, Any, None]]: ...

homeassistant-stubs/util/loop.pyi

@@ -1,5 +1,6 @@
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
+from functools import cache
 from homeassistant.core import async_get_hass_or_none as async_get_hass_or_none
 from homeassistant.helpers.frame import MissingIntegrationFrame as MissingIntegrationFrame, get_current_frame as get_current_frame, get_integration_frame as get_integration_frame
 from homeassistant.loader import async_suggest_report_issue as async_suggest_report_issue
@@ -12,5 +13,6 @@ def _get_line_from_cache(filename: str, lineno: int) -> str: ...
 _PREVIOUSLY_REPORTED: set[tuple[str | None, str, int | Any]]
 
 def raise_for_blocking_call(func: Callable[..., Any], check_allowed: Callable[[dict[str, Any]], bool] | None = None, strict: bool = True, strict_core: bool = True, **mapped_args: Any) -> None: ...
+@cache
 def _dev_help_message(what: str) -> str: ...
 def protect_loop[**_P, _R](func: Callable[_P, _R], loop_thread_id: int, strict: bool = True, strict_core: bool = True, check_allowed: Callable[[dict[str, Any]], bool] | None = None) -> Callable[_P, _R]: ...

homeassistant-stubs/util/package.pyi

@@ -1,9 +1,11 @@
 from .system_info import is_official_image as is_official_image
 from _typeshed import Incomplete
+from functools import cache
 
 _LOGGER: Incomplete
 
 def is_virtual_env() -> bool: ...
+@cache
 def is_docker_env() -> bool: ...
 def get_installed_versions(specifiers: set[str]) -> set[str]: ...
 def is_installed(requirement_str: str) -> bool: ...

homeassistant-stubs/util/ssl.pyi

@@ -1,6 +1,7 @@
 import ssl
 from _typeshed import Incomplete
 from enum import StrEnum
+from functools import cache
 
 class SSLCipherList(StrEnum):
     PYTHON_DEFAULT = 'python_default'
@@ -10,7 +11,9 @@ class SSLCipherList(StrEnum):
 
 SSL_CIPHER_LISTS: Incomplete
 
+@cache
 def _client_context_no_verify(ssl_cipher_list: SSLCipherList) -> ssl.SSLContext: ...
+@cache
 def _client_context(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
 
 _DEFAULT_SSL_CONTEXT: Incomplete

homeassistant-stubs/util/system_info.pyi

@@ -1 +1,4 @@
+from functools import cache
+
+@cache
 def is_official_image() -> bool: ...

homeassistant-stubs/util/unit_conversion.pyi

@@ -1,5 +1,6 @@
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
+from functools import lru_cache
 from homeassistant.const import CONCENTRATION_PARTS_PER_BILLION as CONCENTRATION_PARTS_PER_BILLION, CONCENTRATION_PARTS_PER_MILLION as CONCENTRATION_PARTS_PER_MILLION, PERCENTAGE as PERCENTAGE, UNIT_NOT_RECOGNIZED_TEMPLATE as UNIT_NOT_RECOGNIZED_TEMPLATE, UnitOfArea as UnitOfArea, UnitOfBloodGlucoseConcentration as UnitOfBloodGlucoseConcentration, UnitOfConductivity as UnitOfConductivity, UnitOfDataRate as UnitOfDataRate, UnitOfElectricCurrent as UnitOfElectricCurrent, UnitOfElectricPotential as UnitOfElectricPotential, UnitOfEnergy as UnitOfEnergy, UnitOfInformation as UnitOfInformation, UnitOfLength as UnitOfLength, UnitOfMass as UnitOfMass, UnitOfPower as UnitOfPower, UnitOfPressure as UnitOfPressure, UnitOfSpeed as UnitOfSpeed, UnitOfTemperature as UnitOfTemperature, UnitOfTime as UnitOfTime, UnitOfVolume as UnitOfVolume, UnitOfVolumeFlowRate as UnitOfVolumeFlowRate, UnitOfVolumetricFlux as UnitOfVolumetricFlux
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 
@@ -44,12 +45,15 @@ class BaseUnitConverter:
     @classmethod
     def convert(cls, value: float, from_unit: str | None, to_unit: str | None) -> float: ...
     @classmethod
+    @lru_cache
     def converter_factory(cls, from_unit: str | None, to_unit: str | None) -> Callable[[float], float]: ...
     @classmethod
     def _get_from_to_ratio(cls, from_unit: str | None, to_unit: str | None) -> tuple[float, float]: ...
     @classmethod
+    @lru_cache
     def converter_factory_allow_none(cls, from_unit: str | None, to_unit: str | None) -> Callable[[float | None], float | None]: ...
     @classmethod
+    @lru_cache
     def get_unit_ratio(cls, from_unit: str | None, to_unit: str | None) -> float: ...
 
 class DataRateConverter(BaseUnitConverter):
@@ -117,8 +121,10 @@ class SpeedConverter(BaseUnitConverter):
     _UNIT_CONVERSION: dict[str | None, float]
     VALID_UNITS: Incomplete
     @classmethod
+    @lru_cache
     def converter_factory(cls, from_unit: str | None, to_unit: str | None) -> Callable[[float], float]: ...
     @classmethod
+    @lru_cache
     def converter_factory_allow_none(cls, from_unit: str | None, to_unit: str | None) -> Callable[[float | None], float | None]: ...
     @classmethod
     def _converter_factory(cls, from_unit: str | None, to_unit: str | None) -> Callable[[float], float]: ...
@@ -132,8 +138,10 @@ class TemperatureConverter(BaseUnitConverter):
     VALID_UNITS: Incomplete
     _UNIT_CONVERSION: Incomplete
     @classmethod
+    @lru_cache
     def converter_factory(cls, from_unit: str | None, to_unit: str | None) -> Callable[[float], float]: ...
     @classmethod
+    @lru_cache
     def converter_factory_allow_none(cls, from_unit: str | None, to_unit: str | None) -> Callable[[float | None], float | None]: ...
     @classmethod
     def _converter_factory(cls, from_unit: str | None, to_unit: str | None) -> Callable[[float], float]: ...

homeassistant-stubs/util/yaml/loader.pyi

@@ -61,12 +61,17 @@ def _add_reference_to_node_class(obj: NodeStrClass, loader: LoaderType, node: ya
 @overload
 def _add_reference_to_node_class(obj: NodeDictClass, loader: LoaderType, node: yaml.nodes.Node) -> NodeDictClass: ...
 def _raise_if_no_value[NodeT: yaml.nodes.Node, _R](func: Callable[[LoaderType, NodeT], _R]) -> Callable[[LoaderType, NodeT], _R]: ...
+@_raise_if_no_value
 def _include_yaml(loader: LoaderType, node: yaml.nodes.Node) -> JSON_TYPE: ...
 def _is_file_valid(name: str) -> bool: ...
 def _find_files(directory: str, pattern: str) -> Iterator[str]: ...
+@_raise_if_no_value
 def _include_dir_named_yaml(loader: LoaderType, node: yaml.nodes.Node) -> NodeDictClass: ...
+@_raise_if_no_value
 def _include_dir_merge_named_yaml(loader: LoaderType, node: yaml.nodes.Node) -> NodeDictClass: ...
+@_raise_if_no_value
 def _include_dir_list_yaml(loader: LoaderType, node: yaml.nodes.Node) -> list[JSON_TYPE]: ...
+@_raise_if_no_value
 def _include_dir_merge_list_yaml(loader: LoaderType, node: yaml.nodes.Node) -> JSON_TYPE: ...
 def _handle_mapping_tag(loader: LoaderType, node: yaml.nodes.MappingNode) -> NodeDictClass: ...
 def _construct_seq(loader: LoaderType, node: yaml.nodes.Node) -> JSON_TYPE: ...

homeassistant-stubs/util/yaml/objects.pyi

@@ -25,4 +25,3 @@ class Input:
     name: str
     @classmethod
     def from_node(cls, loader: yaml.Loader, node: yaml.nodes.Node) -> Input: ...
-    def __init__(self, name) -> None: ...

{homeassistant_stubs-2025.1.1.dist-info → homeassistant_stubs-2025.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homeassistant-stubs
-Version: 2025.1.1
+Version: 2025.1.3
 Summary: PEP 484 typing stubs for Home Assistant Core
 Project-URL: Homepage, https://github.com/KapJI/homeassistant-stubs
 Project-URL: Bug Tracker, https://github.com/KapJI/homeassistant-stubs/issues
@@ -18,7 +18,7 @@ Classifier: Topic :: Home Automation
 Classifier: Topic :: Software Development
 Classifier: Typing :: Typed
 Requires-Python: <3.14,>=3.12
-Requires-Dist: homeassistant==2025.1.1
+Requires-Dist: homeassistant==2025.1.3
 Description-Content-Type: text/markdown
 
 [![CI](https://github.com/KapJI/homeassistant-stubs/actions/workflows/ci.yaml/badge.svg)](https://github.com/KapJI/homeassistant-stubs/actions/workflows/ci.yaml)