homeassistant-stubs 2024.2.5__py3-none-any.whl → 2024.3.0b0__py3-none-any.whl

homeassistant-stubs/helpers/event.pyi

@@ -15,7 +15,7 @@ from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, HassJob as HassJo
 from homeassistant.exceptions import TemplateError as TemplateError
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.async_ import run_callback_threadsafe as run_callback_threadsafe
-from typing import Any, Concatenate, ParamSpec, TypeVar, TypedDict
+from typing import Any, Concatenate, Generic, ParamSpec, TypeVar, TypedDict
 
 TRACK_STATE_CHANGE_CALLBACKS: str
 TRACK_STATE_CHANGE_LISTENER: str
@@ -36,6 +36,16 @@ RANDOM_MICROSECOND_MAX: int
 _TypedDictT = TypeVar('_TypedDictT', bound=Mapping[str, Any])
 _P = ParamSpec('_P')
 
+@dataclass(slots=True, frozen=True)
+class _KeyedEventTracker(Generic[_TypedDictT]):
+    listeners_key: str
+    callbacks_key: str
+    event_type: str
+    dispatcher_callable: Callable[[HomeAssistant, dict[str, list[HassJob[[EventType[_TypedDictT]], Any]]], EventType[_TypedDictT]], None]
+    filter_callable: Callable[[HomeAssistant, dict[str, list[HassJob[[EventType[_TypedDictT]], Any]]], EventType[_TypedDictT]], bool]
+    run_immediately: bool
+    def __init__(self, listeners_key, callbacks_key, event_type, dispatcher_callable, filter_callable, run_immediately) -> None: ...
+
 @dataclass(slots=True)
 class TrackStates:
     all_states: bool
@@ -70,21 +80,36 @@ track_state_change: Incomplete
 def async_track_state_change_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[EventType[EventStateChangedData]], Any]) -> CALLBACK_TYPE: ...
 def _async_dispatch_entity_id_event(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[EventType[EventStateChangedData]], Any]]], event: EventType[EventStateChangedData]) -> None: ...
 def _async_state_change_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[EventType[EventStateChangedData]], Any]]], event: EventType[EventStateChangedData]) -> bool: ...
+
+_KEYED_TRACK_STATE_CHANGE: Incomplete
+
 def _async_track_state_change_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[EventType[EventStateChangedData]], Any]) -> CALLBACK_TYPE: ...
 def _remove_empty_listener() -> None: ...
 def _remove_listener(hass: HomeAssistant, listeners_key: str, keys: Iterable[str], job: HassJob[[EventType[_TypedDictT]], Any], callbacks: dict[str, list[HassJob[[EventType[_TypedDictT]], Any]]]) -> None: ...
-def _async_track_event(hass: HomeAssistant, keys: str | Iterable[str], callbacks_key: str, listeners_key: str, event_type: str, dispatcher_callable: Callable[[HomeAssistant, dict[str, list[HassJob[[EventType[_TypedDictT]], Any]]], EventType[_TypedDictT]], None], filter_callable: Callable[[HomeAssistant, dict[str, list[HassJob[[EventType[_TypedDictT]], Any]]], EventType[_TypedDictT]], bool], action: Callable[[EventType[_TypedDictT]], None]) -> CALLBACK_TYPE: ...
+def _async_track_event(tracker: _KeyedEventTracker[_TypedDictT], hass: HomeAssistant, keys: str | Iterable[str], action: Callable[[EventType[_TypedDictT]], None]) -> CALLBACK_TYPE: ...
 def _async_dispatch_old_entity_id_or_entity_id_event(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[EventType[EventEntityRegistryUpdatedData]], Any]]], event: EventType[EventEntityRegistryUpdatedData]) -> None: ...
 def _async_entity_registry_updated_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[EventType[EventEntityRegistryUpdatedData]], Any]]], event: EventType[EventEntityRegistryUpdatedData]) -> bool: ...
+
+_KEYED_TRACK_ENTITY_REGISTRY_UPDATED: Incomplete
+
 def async_track_entity_registry_updated_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[EventType[EventEntityRegistryUpdatedData]], Any]) -> CALLBACK_TYPE: ...
 def _async_device_registry_updated_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[EventType[EventDeviceRegistryUpdatedData]], Any]]], event: EventType[EventDeviceRegistryUpdatedData]) -> bool: ...
 def _async_dispatch_device_id_event(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[EventType[EventDeviceRegistryUpdatedData]], Any]]], event: EventType[EventDeviceRegistryUpdatedData]) -> None: ...
+
+_KEYED_TRACK_DEVICE_REGISTRY_UPDATED: Incomplete
+
 def async_track_device_registry_updated_event(hass: HomeAssistant, device_ids: str | Iterable[str], action: Callable[[EventType[EventDeviceRegistryUpdatedData]], Any]) -> CALLBACK_TYPE: ...
 def _async_dispatch_domain_event(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[EventType[EventStateChangedData]], Any]]], event: EventType[EventStateChangedData]) -> None: ...
 def _async_domain_added_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[EventType[EventStateChangedData]], Any]]], event: EventType[EventStateChangedData]) -> bool: ...
 def async_track_state_added_domain(hass: HomeAssistant, domains: str | Iterable[str], action: Callable[[EventType[EventStateChangedData]], Any]) -> CALLBACK_TYPE: ...
+
+_KEYED_TRACK_STATE_ADDED_DOMAIN: Incomplete
+
 def _async_track_state_added_domain(hass: HomeAssistant, domains: str | Iterable[str], action: Callable[[EventType[EventStateChangedData]], Any]) -> CALLBACK_TYPE: ...
 def _async_domain_removed_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[EventType[EventStateChangedData]], Any]]], event: EventType[EventStateChangedData]) -> bool: ...
+
+_KEYED_TRACK_STATE_REMOVED_DOMAIN: Incomplete
+
 def async_track_state_removed_domain(hass: HomeAssistant, domains: str | Iterable[str], action: Callable[[EventType[EventStateChangedData]], Any]) -> CALLBACK_TYPE: ...
 def _async_string_to_lower_list(instr: str | Iterable[str]) -> list[str]: ...
 
@@ -133,6 +158,7 @@ class TrackTemplateResultInfo:
     def _render_template_if_ready(self, track_template_: TrackTemplate, now: datetime, event: EventType[EventStateChangedData] | None) -> bool | TrackTemplateResult: ...
     @staticmethod
     def _super_template_as_boolean(result: bool | str | TemplateError) -> bool: ...
+    def _apply_update(self, updates: list[TrackTemplateResult], update: bool | TrackTemplateResult, template: Template) -> bool: ...
     def _refresh(self, event: EventType[EventStateChangedData] | None, track_templates: Iterable[TrackTemplate] | None = None, replayed: bool | None = False) -> None: ...
 
 TrackTemplateResultListener: Incomplete

homeassistant-stubs/helpers/floor_registry.pyi

@@ -0,0 +1,59 @@
+from .storage import Store as Store
+from .typing import EventType as EventType, UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
+from _typeshed import Incomplete
+from collections import UserDict
+from collections.abc import Iterable, ValuesView
+from dataclasses import dataclass
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.util import slugify as slugify
+from typing import Literal, TypedDict
+
+DATA_REGISTRY: str
+EVENT_FLOOR_REGISTRY_UPDATED: str
+STORAGE_KEY: str
+STORAGE_VERSION_MAJOR: int
+SAVE_DELAY: int
+
+class EventFloorRegistryUpdatedData(TypedDict):
+    action: Literal['create', 'remove', 'update']
+    floor_id: str
+EventFloorRegistryUpdated = EventType[EventFloorRegistryUpdatedData]
+
+@dataclass(slots=True, kw_only=True, frozen=True)
+class FloorEntry:
+    aliases: set[str]
+    floor_id: str
+    icon: str | None = ...
+    level: int = ...
+    name: str
+    normalized_name: str
+    def __init__(self, *, aliases, floor_id, icon, level, name, normalized_name) -> None: ...
+
+class FloorRegistryItems(UserDict[str, FloorEntry]):
+    _normalized_names: Incomplete
+    def __init__(self) -> None: ...
+    def values(self) -> ValuesView[FloorEntry]: ...
+    def __setitem__(self, key: str, entry: FloorEntry) -> None: ...
+    def __delitem__(self, key: str) -> None: ...
+    def get_floor_by_name(self, name: str) -> FloorEntry | None: ...
+
+class FloorRegistry:
+    floors: FloorRegistryItems
+    _floor_data: dict[str, FloorEntry]
+    hass: Incomplete
+    _store: Incomplete
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    def async_get_floor(self, floor_id: str) -> FloorEntry | None: ...
+    def async_get_floor_by_name(self, name: str) -> FloorEntry | None: ...
+    def async_list_floors(self) -> Iterable[FloorEntry]: ...
+    def _generate_id(self, name: str) -> str: ...
+    def async_create(self, name: str, *, aliases: set[str] | None = None, icon: str | None = None, level: int = 0) -> FloorEntry: ...
+    def async_delete(self, floor_id: str) -> None: ...
+    def async_update(self, floor_id: str, *, aliases: set[str] | UndefinedType = ..., icon: str | None | UndefinedType = ..., level: int | UndefinedType = ..., name: str | UndefinedType = ...) -> FloorEntry: ...
+    async def async_load(self) -> None: ...
+    def async_schedule_save(self) -> None: ...
+    def _data_to_save(self) -> dict[str, list[dict[str, str | int | list[str] | None]]]: ...
+
+def async_get(hass: HomeAssistant) -> FloorRegistry: ...
+async def async_load(hass: HomeAssistant) -> None: ...
+def _normalize_floor_name(floor_name: str) -> str: ...

homeassistant-stubs/helpers/icon.pyi

@@ -6,7 +6,6 @@ from homeassistant.loader import Integration as Integration, async_get_integrati
 from homeassistant.util.json import load_json_object as load_json_object
 from typing import Any
 
-ICON_LOAD_LOCK: str
 ICON_CACHE: str
 _LOGGER: Incomplete
 
@@ -19,6 +18,7 @@ class _IconsCache:
     _hass: Incomplete
     _loaded: Incomplete
     _cache: Incomplete
+    _lock: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
     async def async_fetch(self, category: str, components: set[str]) -> dict[str, dict[str, Any]]: ...
     async def _async_load(self, components: set[str]) -> None: ...

homeassistant-stubs/helpers/integration_platform.pyi

@@ -1,10 +1,13 @@
+from .typing import EventType as EventType
 from _typeshed import Incomplete
 from collections.abc import Awaitable, Callable as Callable
 from dataclasses import dataclass
 from homeassistant.const import EVENT_COMPONENT_LOADED as EVENT_COMPONENT_LOADED
-from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback
-from homeassistant.loader import Integration as Integration, async_get_integrations as async_get_integrations, bind_hass as bind_hass
-from homeassistant.setup import ATTR_COMPONENT as ATTR_COMPONENT
+from homeassistant.core import HassJob as HassJob, HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.loader import Integration as Integration, async_get_integrations as async_get_integrations, async_get_loaded_integration as async_get_loaded_integration, bind_hass as bind_hass
+from homeassistant.setup import ATTR_COMPONENT as ATTR_COMPONENT, EventComponentLoaded as EventComponentLoaded
+from homeassistant.util.logging import catch_log_exception as catch_log_exception
+from types import ModuleType
 from typing import Any
 
 _LOGGER: Incomplete
@@ -13,10 +16,11 @@ DATA_INTEGRATION_PLATFORMS: str
 @dataclass(slots=True, frozen=True)
 class IntegrationPlatform:
     platform_name: str
-    process_platform: Callable[[HomeAssistant, str, Any], Awaitable[None]]
+    process_job: HassJob[[HomeAssistant, str, Any], Awaitable[None] | None]
     seen_components: set[str]
-    def __init__(self, platform_name, process_platform, seen_components) -> None: ...
+    def __init__(self, platform_name, process_job, seen_components) -> None: ...
 
-async def _async_process_single_integration_platform_component(hass: HomeAssistant, component_name: str, integration: Integration | Exception, integration_platform: IntegrationPlatform) -> None: ...
-async def _async_process_integration_platform_for_component(hass: HomeAssistant, component_name: str) -> None: ...
-async def async_process_integration_platforms(hass: HomeAssistant, platform_name: str, process_platform: Callable[[HomeAssistant, str, Any], Awaitable[None]]) -> None: ...
+def _get_platform(integration: Integration | Exception, component_name: str, platform_name: str) -> ModuleType | None: ...
+def _async_process_integration_platforms_for_component(hass: HomeAssistant, integration_platforms: list[IntegrationPlatform], event: EventType[EventComponentLoaded]) -> None: ...
+def _format_err(name: str, platform_name: str, *args: Any) -> str: ...
+async def async_process_integration_platforms(hass: HomeAssistant, platform_name: str, process_platform: Callable[[HomeAssistant, str, Any], Awaitable[None] | None]) -> None: ...

homeassistant-stubs/helpers/intent.pyi

@@ -5,6 +5,7 @@ from _typeshed import Incomplete
 from collections.abc import Collection, Iterable
 from dataclasses import dataclass
 from enum import Enum
+from functools import cached_property as cached_property
 from homeassistant.components.homeassistant.exposed_entities import async_should_expose as async_should_expose
 from homeassistant.const import ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, ATTR_ENTITY_ID as ATTR_ENTITY_ID, ATTR_SUPPORTED_FEATURES as ATTR_SUPPORTED_FEATURES
 from homeassistant.core import Context as Context, HomeAssistant as HomeAssistant, State as State, callback as callback
@@ -20,6 +21,7 @@ INTENT_TURN_ON: str
 INTENT_TOGGLE: str
 INTENT_GET_STATE: str
 INTENT_NEVERMIND: str
+INTENT_SET_POSITION: str
 SLOT_SCHEMA: Incomplete
 DATA_KEY: str
 SPEECH_TYPE_PLAIN: str
@@ -57,10 +59,11 @@ def async_test_feature(state: State, feature: int, feature_name: str) -> None: .
 class IntentHandler:
     intent_type: str | None
     slot_schema: vol.Schema | None
-    _slot_schema: vol.Schema | None
     platforms: Iterable[str] | None
     def async_can_handle(self, intent_obj: Intent) -> bool: ...
     def async_validate_slots(self, slots: _SlotsType) -> _SlotsType: ...
+    @cached_property
+    def _slot_schema(self) -> vol.Schema: ...
     async def async_handle(self, intent_obj: Intent) -> IntentResponse: ...
     def __repr__(self) -> str: ...
 
@@ -71,7 +74,10 @@ class ServiceIntentHandler(IntentHandler):
     domain: Incomplete
     service: Incomplete
     speech: Incomplete
-    def __init__(self, intent_type: str, domain: str, service: str, speech: str | None = None) -> None: ...
+    extra_slots: Incomplete
+    def __init__(self, intent_type: str, domain: str, service: str, speech: str | None = None, extra_slots: dict[str, vol.Schema] | None = None) -> None: ...
+    @cached_property
+    def _slot_schema(self) -> vol.Schema: ...
     async def async_handle(self, intent_obj: Intent) -> IntentResponse: ...
     async def async_handle_states(self, intent_obj: Intent, states: list[State], area: area_registry.AreaEntry | None = None) -> IntentResponse: ...
     async def async_call_service(self, intent_obj: Intent, state: State) -> None: ...

homeassistant-stubs/helpers/json.pyi

@@ -28,5 +28,6 @@ def json_dumps_sorted(data: Any) -> str: ...
 JSON_DUMP: Final[Incomplete]
 
 def _orjson_default_encoder(data: Any) -> str: ...
+def _orjson_bytes_default_encoder(data: Any) -> bytes: ...
 def save_json(filename: str, data: list | dict, private: bool = False, *, encoder: type[json.JSONEncoder] | None = None, atomic_writes: bool = False) -> None: ...
 def find_paths_unserializable_data(bad_data: Any, *, dump: Callable[[Any], str] = ...) -> dict[str, Any]: ...

homeassistant-stubs/helpers/label_registry.pyi

@@ -0,0 +1,59 @@
+from .storage import Store as Store
+from .typing import EventType as EventType, UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
+from _typeshed import Incomplete
+from collections import UserDict
+from collections.abc import Iterable, ValuesView
+from dataclasses import dataclass
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.util import slugify as slugify
+from typing import Literal, TypedDict
+
+DATA_REGISTRY: str
+EVENT_LABEL_REGISTRY_UPDATED: str
+STORAGE_KEY: str
+STORAGE_VERSION_MAJOR: int
+SAVE_DELAY: int
+
+class EventLabelRegistryUpdatedData(TypedDict):
+    action: Literal['create', 'remove', 'update']
+    label_id: str
+EventLabelRegistryUpdated = EventType[EventLabelRegistryUpdatedData]
+
+@dataclass(slots=True, frozen=True)
+class LabelEntry:
+    label_id: str
+    name: str
+    normalized_name: str
+    description: str | None = ...
+    color: str | None = ...
+    icon: str | None = ...
+    def __init__(self, label_id, name, normalized_name, description, color, icon) -> None: ...
+
+class LabelRegistryItems(UserDict[str, LabelEntry]):
+    _normalized_names: Incomplete
+    def __init__(self) -> None: ...
+    def values(self) -> ValuesView[LabelEntry]: ...
+    def __setitem__(self, key: str, entry: LabelEntry) -> None: ...
+    def __delitem__(self, key: str) -> None: ...
+    def get_label_by_name(self, name: str) -> LabelEntry | None: ...
+
+class LabelRegistry:
+    labels: LabelRegistryItems
+    _label_data: dict[str, LabelEntry]
+    hass: Incomplete
+    _store: Incomplete
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    def async_get_label(self, label_id: str) -> LabelEntry | None: ...
+    def async_get_label_by_name(self, name: str) -> LabelEntry | None: ...
+    def async_list_labels(self) -> Iterable[LabelEntry]: ...
+    def _generate_id(self, name: str) -> str: ...
+    def async_create(self, name: str, *, color: str | None = None, icon: str | None = None, description: str | None = None) -> LabelEntry: ...
+    def async_delete(self, label_id: str) -> None: ...
+    def async_update(self, label_id: str, *, color: str | None | UndefinedType = ..., description: str | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., name: str | UndefinedType = ...) -> LabelEntry: ...
+    async def async_load(self) -> None: ...
+    def async_schedule_save(self) -> None: ...
+    def _data_to_save(self) -> dict[str, list[dict[str, str | None]]]: ...
+
+def async_get(hass: HomeAssistant) -> LabelRegistry: ...
+async def async_load(hass: HomeAssistant) -> None: ...
+def _normalize_label_name(label_name: str) -> str: ...

homeassistant-stubs/helpers/redact.pyi

@@ -0,0 +1,13 @@
+from collections.abc import Callable as Callable, Iterable, Mapping
+from homeassistant.core import callback as callback
+from typing import Any, TypeVar, overload
+
+REDACTED: str
+_T = TypeVar('_T')
+_ValueT = TypeVar('_ValueT')
+
+def partial_redact(x: str | Any, unmasked_prefix: int = 4, unmasked_suffix: int = 4) -> str: ...
+@overload
+def async_redact_data(data: Mapping, to_redact: Iterable[Any] | Mapping[Any, Callable[[_ValueT], _ValueT]]) -> dict: ...
+@overload
+def async_redact_data(data: _T, to_redact: Iterable[Any] | Mapping[Any, Callable[[_ValueT], _ValueT]]) -> _T: ...

homeassistant-stubs/helpers/service.pyi

@@ -12,6 +12,7 @@ from homeassistant.const import ATTR_AREA_ID as ATTR_AREA_ID, ATTR_DEVICE_ID as
 from homeassistant.core import Context as Context, EntityServiceResponse as EntityServiceResponse, HassJob as HassJob, HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, ServiceResponse as ServiceResponse, SupportsResponse as SupportsResponse, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, TemplateError as TemplateError, Unauthorized as Unauthorized, UnknownUser as UnknownUser
 from homeassistant.loader import Integration as Integration, async_get_integrations as async_get_integrations, bind_hass as bind_hass
+from homeassistant.util.async_ import create_eager_task as create_eager_task
 from homeassistant.util.yaml import load_yaml_dict as load_yaml_dict
 from homeassistant.util.yaml.loader import JSON_TYPE as JSON_TYPE
 from types import ModuleType

homeassistant-stubs/helpers/storage.pyi

@@ -1,5 +1,6 @@
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Mapping, Sequence
+from functools import cached_property as cached_property
 from homeassistant.const import EVENT_HOMEASSISTANT_FINAL_WRITE as EVENT_HOMEASSISTANT_FINAL_WRITE
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, CoreState as CoreState, Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
@@ -22,25 +23,28 @@ class Store(Generic[_T]):
     hass: Incomplete
     _private: Incomplete
     _data: Incomplete
-    _unsub_delay_listener: Incomplete
+    _delay_handle: Incomplete
     _unsub_final_write_listener: Incomplete
     _write_lock: Incomplete
     _load_task: Incomplete
     _encoder: Incomplete
     _atomic_writes: Incomplete
     _read_only: Incomplete
+    _next_write_time: float
     def __init__(self, hass: HomeAssistant, version: int, key: str, private: bool = False, *, atomic_writes: bool = False, encoder: type[JSONEncoder] | None = None, minor_version: int = 1, read_only: bool = False) -> None: ...
-    @property
+    @cached_property
     def path(self): ...
     async def async_load(self) -> _T | None: ...
     async def _async_load(self) -> _T | None: ...
     async def _async_load_data(self): ...
     async def async_save(self, data: _T) -> None: ...
     def async_delay_save(self, data_func: Callable[[], _T], delay: float = 0) -> None: ...
+    def _async_reschedule_delayed_write(self, when: float) -> None: ...
+    def _async_schedule_callback_delayed_write(self) -> None: ...
     def _async_ensure_final_write_listener(self) -> None: ...
     def _async_cleanup_final_write_listener(self) -> None: ...
     def _async_cleanup_delay_listener(self) -> None: ...
-    async def _async_callback_delayed_write(self, _now) -> None: ...
+    async def _async_callback_delayed_write(self) -> None: ...
     async def _async_callback_final_write(self, _event: Event) -> None: ...
     async def _async_handle_write_data(self, *_args) -> None: ...
     async def _async_write_data(self, path: str, data: dict) -> None: ...

homeassistant-stubs/helpers/template.pyi

@@ -1,6 +1,7 @@
 import jinja2
 from . import area_registry as area_registry, device_registry as device_registry, entity_registry as entity_registry
 from .singleton import singleton as singleton
+from .translation import async_translate_state as async_translate_state
 from .typing import TemplateVarsType as TemplateVarsType
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Generator, Iterable
@@ -148,6 +149,12 @@ class AllStates:
     def __call__(self, entity_id: str, rounded: bool | object = ..., with_unit: bool = False) -> str: ...
     def __repr__(self) -> str: ...
 
+class StateTranslated:
+    _hass: Incomplete
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    def __call__(self, entity_id: str) -> str | None: ...
+    def __repr__(self) -> str: ...
+
 class DomainStates:
     __slots__: Incomplete
     __setitem__ = _readonly

homeassistant-stubs/helpers/translation.pyi

@@ -1,6 +1,7 @@
 from _typeshed import Incomplete
 from collections.abc import Iterable
-from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.const import EVENT_CORE_CONFIG_UPDATE as EVENT_CORE_CONFIG_UPDATE, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
+from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.loader import Integration as Integration, async_get_config_flows as async_get_config_flows, async_get_integrations as async_get_integrations, bind_hass as bind_hass
 from homeassistant.util.json import load_json as load_json
 from typing import Any
@@ -11,10 +12,10 @@ LOCALE_EN: str
 
 def recursive_flatten(prefix: Any, data: dict[str, Any]) -> dict[str, Any]: ...
 def component_translation_path(component: str, language: str, integration: Integration) -> str | None: ...
-def load_translations_files(translation_files: dict[str, str]) -> dict[str, dict[str, Any]]: ...
+def _load_translations_files_by_language(translation_files: dict[str, dict[str, str]]) -> dict[str, dict[str, Any]]: ...
 def _merge_resources(translation_strings: dict[str, dict[str, Any]], components: set[str], category: str) -> dict[str, dict[str, Any]]: ...
-def build_resources(translation_strings: dict[str, dict[str, Any]], components: set[str], category: str) -> dict[str, dict[str, Any] | str]: ...
-async def _async_get_component_strings(hass: HomeAssistant, language: str, components: set[str], integrations: dict[str, Integration]) -> dict[str, Any]: ...
+def build_resources(translation_strings: dict[str, dict[str, dict[str, Any] | str]], components: set[str], category: str) -> dict[str, dict[str, Any] | str]: ...
+async def _async_get_component_strings(hass: HomeAssistant, languages: Iterable[str], components: set[str], integrations: dict[str, Integration]) -> dict[str, dict[str, Any]]: ...
 
 class _TranslationCache:
     __slots__: Incomplete
@@ -23,9 +24,22 @@ class _TranslationCache:
     cache: Incomplete
     lock: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
+    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, Any], cached_resources: dict[str, Any] | None = None) -> dict[str, Any]: ...
     def _build_category_cache(self, language: str, components: set[str], translation_strings: dict[str, dict[str, Any]]) -> None: ...
 
 async def async_get_translations(hass: HomeAssistant, language: str, category: str, integrations: Iterable[str] | None = None, config_flow: bool | None = None) -> dict[str, str]: ...
+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: ...
+
+_DIRECT_MAPPED_CATEGORIES: Incomplete
+
+def _async_get_components(hass: HomeAssistant, category: str) -> set[str]: ...
+def async_setup(hass: HomeAssistant) -> None: ...
+async def async_load_integrations(hass: HomeAssistant, integrations: set[str]) -> None: ...
+def async_translations_loaded(hass: HomeAssistant, components: set[str]) -> bool: ...
+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/update_coordinator.pyi

@@ -58,6 +58,7 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     @update_interval.setter
     def update_interval(self, value: timedelta | None) -> None: ...
     def _schedule_refresh(self) -> None: ...
+    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: ...
     async def _async_update_data(self) -> _DataT: ...

homeassistant-stubs/loader.pyi

@@ -5,6 +5,7 @@ from .config_entries import ConfigEntry as ConfigEntry
 from .core import HomeAssistant as HomeAssistant, callback as callback
 from .generated.application_credentials import APPLICATION_CREDENTIALS as APPLICATION_CREDENTIALS
 from .generated.bluetooth import BLUETOOTH as BLUETOOTH
+from .generated.config_flows import FLOWS as FLOWS
 from .generated.dhcp import DHCP as DHCP
 from .generated.mqtt import MQTT as MQTT
 from .generated.ssdp import SSDP as SSDP
@@ -25,6 +26,7 @@ _CallableT = TypeVar('_CallableT', bound=Callable[..., Any])
 _LOGGER: Incomplete
 DATA_COMPONENTS: str
 DATA_INTEGRATIONS: str
+DATA_MISSING_PLATFORMS: str
 DATA_CUSTOM_COMPONENTS: str
 PACKAGE_CUSTOM_COMPONENTS: str
 PACKAGE_BUILTIN: str
@@ -103,6 +105,8 @@ class Manifest(TypedDict, total=False):
     version: str
     codeowners: list[str]
     loggers: list[str]
+    import_executor: bool
+    single_config_entry: bool
 
 def async_setup(hass: HomeAssistant) -> None: ...
 def manifest_from_legacy_module(domain: str, module: ModuleType) -> Manifest: ...
@@ -143,33 +147,36 @@ class Integration:
     manifest: Incomplete
     _all_dependencies_resolved: Incomplete
     _all_dependencies: Incomplete
+    _import_futures: Incomplete
     def __init__(self, hass: HomeAssistant, pkg_path: str, file_path: pathlib.Path, manifest: Manifest) -> None: ...
     @cached_property
     def name(self) -> str: ...
     @cached_property
     def disabled(self) -> str | None: ...
-    @property
+    @cached_property
     def domain(self) -> str: ...
-    @property
+    @cached_property
     def dependencies(self) -> list[str]: ...
-    @property
+    @cached_property
     def after_dependencies(self) -> list[str]: ...
-    @property
+    @cached_property
     def requirements(self) -> list[str]: ...
-    @property
+    @cached_property
     def config_flow(self) -> bool: ...
-    @property
+    @cached_property
     def documentation(self) -> str | None: ...
-    @property
+    @cached_property
     def issue_tracker(self) -> str | None: ...
-    @property
+    @cached_property
     def loggers(self) -> list[str] | None: ...
-    @property
+    @cached_property
     def quality_scale(self) -> str | None: ...
-    @property
+    @cached_property
     def iot_class(self) -> str | None: ...
     @cached_property
     def integration_type(self) -> Literal['entity', 'device', 'hardware', 'helper', 'hub', 'service', 'system']: ...
+    @cached_property
+    def import_executor(self) -> bool: ...
     @property
     def mqtt(self) -> list[str] | None: ...
     @property
@@ -188,17 +195,23 @@ class Integration:
     def is_built_in(self) -> bool: ...
     @property
     def version(self) -> AwesomeVersion | None: ...
+    @cached_property
+    def single_config_entry(self) -> bool: ...
     @property
     def all_dependencies(self) -> set[str]: ...
     @property
     def all_dependencies_resolved(self) -> bool: ...
     async def resolve_dependencies(self) -> bool: ...
+    async def async_get_component(self) -> ComponentProtocol: ...
     def get_component(self) -> ComponentProtocol: ...
+    async def async_get_platform(self, platform_name: str) -> ModuleType: ...
+    def _get_platform_cached(self, full_name: str) -> ModuleType | None: ...
     def get_platform(self, platform_name: str) -> ModuleType: ...
+    def _load_platform(self, platform_name: str) -> ModuleType: ...
     def _import_platform(self, platform_name: str) -> ModuleType: ...
     def __repr__(self) -> str: ...
 
-def _resolve_integrations_from_root(hass: HomeAssistant, root_module: ModuleType, domains: list[str]) -> dict[str, Integration]: ...
+def _resolve_integrations_from_root(hass: HomeAssistant, root_module: ModuleType, domains: Iterable[str]) -> dict[str, Integration]: ...
 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]: ...

homeassistant-stubs/setup.pyi

@@ -1,16 +1,19 @@
 from . import core as core, loader as loader, requirements as requirements
 from .const import EVENT_COMPONENT_LOADED as EVENT_COMPONENT_LOADED, EVENT_HOMEASSISTANT_START as EVENT_HOMEASSISTANT_START, PLATFORM_FORMAT as PLATFORM_FORMAT, Platform as Platform
-from .core import CALLBACK_TYPE as CALLBACK_TYPE, HomeAssistant as HomeAssistant, callback as callback
+from .core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from .exceptions import DependencyError as DependencyError, HomeAssistantError as HomeAssistantError
+from .helpers import translation as translation
 from .helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue
-from .helpers.typing import ConfigType as ConfigType
+from .helpers.typing import ConfigType as ConfigType, EventType as EventType
 from .util import ensure_unique_string as ensure_unique_string
+from .util.async_ import create_eager_task as create_eager_task
 from _typeshed import Incomplete
 from collections.abc import Awaitable, Callable as Callable, Generator, Iterable
 from types import ModuleType
+from typing import Final, TypedDict
 
 _LOGGER: Incomplete
-ATTR_COMPONENT: str
+ATTR_COMPONENT: Final[str]
 BASE_PLATFORMS: Incomplete
 DATA_SETUP: str
 DATA_SETUP_DONE: str
@@ -22,6 +25,9 @@ NOTIFY_FOR_TRANSLATION_KEYS: Incomplete
 SLOW_SETUP_WARNING: int
 SLOW_SETUP_MAX_WAIT: int
 
+class EventComponentLoaded(TypedDict):
+    component: str
+
 def async_notify_setup_error(hass: HomeAssistant, component: str, display_link: str | None = None) -> None: ...
 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: ...

homeassistant-stubs/util/async_.pyi

@@ -1,8 +1,7 @@
 import concurrent.futures
 from _typeshed import Incomplete
-from asyncio import Future
-from asyncio.events import AbstractEventLoop
-from collections.abc import Callable as Callable
+from asyncio import AbstractEventLoop, Future, Task
+from collections.abc import Awaitable, Callable as Callable
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from typing import Any, ParamSpec, TypeVar, TypeVarTuple
 
@@ -13,6 +12,7 @@ _R = TypeVar('_R')
 _P = ParamSpec('_P')
 _Ts = TypeVarTuple('_Ts')
 
+def create_eager_task(coro: Awaitable[_T], *, name: str | None = None, loop: AbstractEventLoop | None = None) -> Task[_T]: ...
 def cancelling(task: Future[Any]) -> bool: ...
 def run_callback_threadsafe(loop: AbstractEventLoop, callback: Callable[[Unpack[_Ts]], _T], *args: Unpack[_Ts]) -> concurrent.futures.Future[_T]: ...
 def check_loop(func: Callable[..., Any], strict: bool = True, advise_msg: str | None = None) -> None: ...

homeassistant-stubs/util/file.pyi

@@ -5,5 +5,5 @@ _LOGGER: Incomplete
 
 class WriteError(HomeAssistantError): ...
 
-def write_utf8_file_atomic(filename: str, utf8_data: str, private: bool = False) -> None: ...
-def write_utf8_file(filename: str, utf8_data: str, private: bool = False) -> None: ...
+def write_utf8_file_atomic(filename: str, utf8_data: bytes | str, private: bool = False, mode: str = 'w') -> None: ...
+def write_utf8_file(filename: str, utf8_data: bytes | str, private: bool = False, mode: str = 'w') -> None: ...

homeassistant-stubs/util/yaml/loader.pyi

@@ -4,6 +4,7 @@ from .const import SECRET_YAML as SECRET_YAML
 from .objects import Input as Input, NodeDictClass as NodeDictClass, NodeListClass as NodeListClass, NodeStrClass as NodeStrClass
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Iterator
+from functools import cached_property as cached_property
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.frame import report as report
 from io import StringIO
@@ -28,7 +29,9 @@ class Secrets:
 class _LoaderMixin:
     name: str
     stream: Any
+    @cached_property
     def get_name(self) -> str: ...
+    @cached_property
     def get_stream_name(self) -> str: ...
 
 class FastSafeLoader(FastestAvailableSafeLoader, _LoaderMixin):

{homeassistant_stubs-2024.2.5.dist-info → homeassistant_stubs-2024.3.0b0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: homeassistant-stubs
-Version: 2024.2.5
+Version: 2024.3.0b0
 Summary: PEP 484 typing stubs for Home Assistant Core
 Home-page: https://github.com/KapJI/homeassistant-stubs
 License: MIT
@@ -17,7 +17,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Topic :: Software Development
 Classifier: Typing :: Typed
-Requires-Dist: homeassistant (==2024.2.5)
+Requires-Dist: homeassistant (==2024.3.0b0)
 Project-URL: Bug Tracker, https://github.com/KapJI/homeassistant-stubs/issues
 Project-URL: Repository, https://github.com/KapJI/homeassistant-stubs
 Project-URL: Release Notes, https://github.com/KapJI/homeassistant-stubs/releases