PyPI - homeassistant-stubs - Versions diffs - 2025.2.5__py3-none-any.whl → 2025.3.0b0__py3-none-any.whl - Mend

homeassistant-stubs 2025.2.5py3-none-any.whl → 2025.3.0b0py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1568) hide show

homeassistant-stubs/helpers/chat_session.pyi ADDED Viewed

@@ -0,0 +1,45 @@
+from .event import async_call_later as async_call_later
+from _typeshed import Incomplete
+from collections.abc import Generator
+from contextlib import contextmanager
+from contextvars import ContextVar
+from dataclasses import dataclass, field
+from datetime import datetime
+from homeassistant.const import EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP
+from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, HassJob as HassJob, HassJobType as HassJobType, HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.util import dt as dt_util
+from homeassistant.util.hass_dict import HassKey as HassKey
+from homeassistant.util.ulid import ulid_now as ulid_now, ulid_to_bytes as ulid_to_bytes
+DATA_CHAT_SESSION: HassKey[dict[str, ChatSession]]
+DATA_CHAT_SESSION_CLEANUP: HassKey[SessionCleanup]
+CONVERSATION_TIMEOUT: Incomplete
+LOGGER: Incomplete
+current_session: ContextVar[ChatSession | None]
+@dataclass
+class ChatSession:
+    conversation_id: str
+    last_updated: datetime = field(default_factory=dt_util.utcnow)
+    _cleanup_callbacks: list[CALLBACK_TYPE] = field(default_factory=list)
+    @callback
+    def async_updated(self) -> None: ...
+    @callback
+    def async_on_cleanup(self, cb: CALLBACK_TYPE) -> None: ...
+    @callback
+    def async_cleanup(self) -> None: ...
+class SessionCleanup:
+    unsub: CALLBACK_TYPE | None
+    hass: Incomplete
+    cleanup_job: Incomplete
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
+    def schedule(self) -> None: ...
+    @callback
+    def _on_hass_stop(self, event: Event) -> None: ...
+    @callback
+    def _cleanup(self, now: datetime) -> None: ...
+@contextmanager
+def async_get_chat_session(hass: HomeAssistant, conversation_id: str | None = None) -> Generator[ChatSession]: ...

homeassistant-stubs/helpers/data_entry_flow.pyi CHANGED Viewed

@@ -5,7 +5,7 @@ from homeassistant.components.http import HomeAssistantView as HomeAssistantView
 from homeassistant.components.http.data_validator import RequestDataValidator as RequestDataValidator
 from typing import Any, Generic, TypeVar
-_FlowManagerT = TypeVar('_FlowManagerT', bound=data_entry_flow.FlowManager[Any, Any], default=data_entry_flow.FlowManager)
+_FlowManagerT = TypeVar('_FlowManagerT', bound=data_entry_flow.FlowManager[Any, Any, Any], default=data_entry_flow.FlowManager)
 class _BaseFlowManagerView(HomeAssistantView, Generic[_FlowManagerT]):
     _flow_mgr: Incomplete

homeassistant-stubs/helpers/deprecation.pyi CHANGED Viewed

@@ -1,7 +1,7 @@
 import functools
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
-from enum import EnumType, IntEnum, IntFlag, StrEnum, _EnumDict
+from enum import EnumType, IntEnum as IntEnum, IntFlag as IntFlag, StrEnum as StrEnum, _EnumDict
 from typing import Any, NamedTuple
 def deprecated_substitute[_ObjectT: object](substitute_name: str) -> Callable[[Callable[[_ObjectT], Any]], Callable[[_ObjectT], Any]]: ...
@@ -12,27 +12,27 @@ def _print_deprecation_warning(obj: Any, replacement: str, description: str, ver
 def _print_deprecation_warning_internal(obj_name: str, module_name: str, replacement: str, description: str, verb: str, breaks_in_ha_version: str | None, *, log_when_no_integration_is_found: bool) -> None: ...
 def _print_deprecation_warning_internal_impl(obj_name: str, module_name: str, replacement: str, description: str, verb: str, breaks_in_ha_version: str | None, *, log_when_no_integration_is_found: bool) -> None: ...
-class DeprecatedConstant(NamedTuple):
-    value: Any
+class DeprecatedConstant[T](NamedTuple):
+    value: T
     replacement: str
     breaks_in_ha_version: str | None
-class DeprecatedConstantEnum(NamedTuple):
-    enum: StrEnum | IntEnum | IntFlag
+class DeprecatedConstantEnum[T: StrEnum | IntEnum | IntFlag](NamedTuple):
+    enum: T
     breaks_in_ha_version: str | None
-class DeprecatedAlias(NamedTuple):
-    value: Any
+class DeprecatedAlias[T](NamedTuple):
+    value: T
     replacement: str
     breaks_in_ha_version: str | None
-class DeferredDeprecatedAlias:
+class DeferredDeprecatedAlias[T]:
     breaks_in_ha_version: Incomplete
     replacement: Incomplete
     _value_fn: Incomplete
-    def __init__(self, value_fn: Callable[[], Any], replacement: str, breaks_in_ha_version: str | None) -> None: ...
+    def __init__(self, value_fn: Callable[[], T], replacement: str, breaks_in_ha_version: str | None) -> None: ...
     @functools.cached_property
-    def value(self) -> Any: ...
+    def value(self) -> T: ...
 _PREFIX_DEPRECATED: str

homeassistant-stubs/helpers/device_registry.pyi CHANGED Viewed

@@ -6,7 +6,7 @@ from .registry import BaseRegistry as BaseRegistry, BaseRegistryItems as BaseReg
 from .singleton import singleton as singleton
 from .typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from _typeshed import Incomplete
-from collections.abc import Mapping
+from collections.abc import Iterable, Mapping
 from datetime import datetime
 from enum import StrEnum
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -103,6 +103,7 @@ def _validate_configuration_url(value: Any) -> str | None: ...
 class DeviceEntry:
     area_id: str | None
     config_entries: set[str]
+    config_entries_subentries: dict[str, set[str | None]]
     configuration_url: str | None
     connections: set[tuple[str, str]]
     created_at: datetime
@@ -133,7 +134,7 @@ class DeviceEntry:
     def json_repr(self) -> bytes | None: ...
     @under_cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, area_id, config_entries, configuration_url, connections, created_at, disabled_by, entry_type, hw_version, id, identifiers, labels, manufacturer, model, model_id, modified_at, name_by_user, name, primary_config_entry, serial_number, suggested_area, sw_version, via_device_id, is_new, cache) -> None: ...
+    def __init__(self, area_id, config_entries, config_entries_subentries, configuration_url, connections, created_at, disabled_by, entry_type, hw_version, id, identifiers, labels, manufacturer, model, model_id, modified_at, name_by_user, name, primary_config_entry, serial_number, suggested_area, sw_version, via_device_id, is_new, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -141,6 +142,7 @@ class DeviceEntry:
 class DeletedDeviceEntry:
     config_entries: set[str]
+    config_entries_subentries: dict[str, set[str | None]]
     connections: set[tuple[str, str]]
     identifiers: set[tuple[str, str]]
     id: str
@@ -148,10 +150,10 @@ class DeletedDeviceEntry:
     created_at: datetime
     modified_at: datetime
     _cache: dict[str, Any]
-    def to_device_entry(self, config_entry_id: str, connections: set[tuple[str, str]], identifiers: set[tuple[str, str]]) -> DeviceEntry: ...
+    def to_device_entry(self, config_entry_id: str, config_subentry_id: str | None, connections: set[tuple[str, str]], identifiers: set[tuple[str, str]]) -> DeviceEntry: ...
     @under_cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, config_entries, connections, identifiers, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
+    def __init__(self, config_entries, config_entries_subentries, connections, identifiers, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -169,6 +171,7 @@ class DeviceRegistryItems[_EntryTypeT: (DeviceEntry, DeletedDeviceEntry)](BaseRe
     def _index_entry(self, key: str, entry: _EntryTypeT) -> None: ...
     def _unindex_entry(self, key: str, replacement_entry: _EntryTypeT | None = None) -> None: ...
     def get_entry(self, identifiers: set[tuple[str, str]] | None, connections: set[tuple[str, str]] | None) -> _EntryTypeT | None: ...
+    def get_entries(self, identifiers: set[tuple[str, str]] | None, connections: set[tuple[str, str]] | None) -> Iterable[_EntryTypeT]: ...
 class ActiveDeviceRegistryItems(DeviceRegistryItems[DeviceEntry]):
     _area_id_index: RegistryIndexType
@@ -193,11 +196,12 @@ class DeviceRegistry(BaseRegistry[dict[str, list[dict[str, Any]]]]):
     @callback
     def async_get_device(self, identifiers: set[tuple[str, str]] | None = None, connections: set[tuple[str, str]] | None = None) -> DeviceEntry | None: ...
     def _async_get_deleted_device(self, identifiers: set[tuple[str, str]], connections: set[tuple[str, str]]) -> DeletedDeviceEntry | None: ...
+    def _async_get_deleted_devices(self, identifiers: set[tuple[str, str]] | None = None, connections: set[tuple[str, str]] | None = None) -> Iterable[DeletedDeviceEntry]: ...
     def _substitute_name_placeholders(self, domain: str, name: str, translation_placeholders: Mapping[str, str]) -> str: ...
     @callback
-    def async_get_or_create(self, *, config_entry_id: str, configuration_url: str | URL | None | UndefinedType = ..., connections: set[tuple[str, str]] | None | UndefinedType = ..., created_at: str | datetime | UndefinedType = ..., default_manufacturer: str | None | UndefinedType = ..., default_model: str | None | UndefinedType = ..., default_name: str | None | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., identifiers: set[tuple[str, str]] | None | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., modified_at: str | datetime | UndefinedType = ..., name: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., translation_key: str | None = None, translation_placeholders: Mapping[str, str] | None = None, via_device: tuple[str, str] | None | UndefinedType = ...) -> DeviceEntry: ...
+    def async_get_or_create(self, *, config_entry_id: str, config_subentry_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., connections: set[tuple[str, str]] | None | UndefinedType = ..., created_at: str | datetime | UndefinedType = ..., default_manufacturer: str | None | UndefinedType = ..., default_model: str | None | UndefinedType = ..., default_name: str | None | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., identifiers: set[tuple[str, str]] | None | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., modified_at: str | datetime | UndefinedType = ..., name: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., translation_key: str | None = None, translation_placeholders: Mapping[str, str] | None = None, via_device: tuple[str, str] | None | UndefinedType = ...) -> DeviceEntry: ...
     @callback
-    def async_update_device(self, device_id: str, *, add_config_entry_id: str | UndefinedType = ..., allow_collisions: bool = False, area_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., device_info_type: str | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., merge_connections: set[tuple[str, str]] | UndefinedType = ..., merge_identifiers: set[tuple[str, str]] | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., name_by_user: str | None | UndefinedType = ..., name: str | None | UndefinedType = ..., new_connections: set[tuple[str, str]] | UndefinedType = ..., new_identifiers: set[tuple[str, str]] | UndefinedType = ..., remove_config_entry_id: str | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
+    def async_update_device(self, device_id: str, *, add_config_entry_id: str | UndefinedType = ..., add_config_subentry_id: str | None | UndefinedType = ..., allow_collisions: bool = False, area_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., device_info_type: str | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., merge_connections: set[tuple[str, str]] | UndefinedType = ..., merge_identifiers: set[tuple[str, str]] | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., name_by_user: str | None | UndefinedType = ..., name: str | None | UndefinedType = ..., new_connections: set[tuple[str, str]] | UndefinedType = ..., new_identifiers: set[tuple[str, str]] | UndefinedType = ..., remove_config_entry_id: str | UndefinedType = ..., remove_config_subentry_id: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
     @callback
     def _validate_connections(self, device_id: str, connections: set[tuple[str, str]], allow_collisions: bool) -> set[tuple[str, str]]: ...
     @callback
@@ -210,6 +214,8 @@ class DeviceRegistry(BaseRegistry[dict[str, list[dict[str, Any]]]]):
     @callback
     def async_clear_config_entry(self, config_entry_id: str) -> None: ...
     @callback
+    def async_clear_config_subentry(self, config_entry_id: str, config_subentry_id: str) -> None: ...
+    @callback
     def async_purge_expired_orphaned_devices(self) -> None: ...
     @callback
     def async_clear_area_id(self, area_id: str) -> None: ...

homeassistant-stubs/helpers/entity_platform.pyi CHANGED Viewed

@@ -34,10 +34,13 @@ _LOGGER: Incomplete
 class AddEntitiesCallback(Protocol):
     def __call__(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
+class AddConfigEntryEntitiesCallback(Protocol):
+    def __call__(self, new_entities: Iterable[Entity], update_before_add: bool = False, *, config_subentry_id: str | None = None) -> None: ...
 class EntityPlatformModule(Protocol):
     async def async_setup_platform(self, hass: HomeAssistant, config: ConfigType, async_add_entities: AddEntitiesCallback, discovery_info: DiscoveryInfoType | None = None) -> None: ...
     def setup_platform(self, hass: HomeAssistant, config: ConfigType, add_entities: AddEntitiesCallback, discovery_info: DiscoveryInfoType | None = None) -> None: ...
-    async def async_setup_entry(self, hass: HomeAssistant, entry: config_entries.ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+    async def async_setup_entry(self, hass: HomeAssistant, entry: config_entries.ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 class EntityPlatform:
     hass: Incomplete
@@ -82,15 +85,15 @@ class EntityPlatform:
     @callback
     def _async_schedule_add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
     @callback
-    def _async_schedule_add_entities_for_entry(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
+    def _async_schedule_add_entities_for_entry(self, new_entities: Iterable[Entity], update_before_add: bool = False, *, config_subentry_id: str | None = None) -> None: ...
     def add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
     async def _async_add_and_update_entities(self, coros: list[Coroutine[Any, Any, None]], entities: list[Entity], timeout: float) -> None: ...
     async def _async_add_entities(self, coros: list[Coroutine[Any, Any, None]], entities: list[Entity], timeout: float) -> None: ...
-    async def async_add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
+    async def async_add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False, *, config_subentry_id: str | None = None) -> None: ...
     @callback
     def _async_handle_interval_callback(self) -> None: ...
     def _entity_id_already_exists(self, entity_id: str) -> tuple[bool, bool]: ...
-    async def _async_add_entity(self, entity: Entity, update_before_add: bool, entity_registry: EntityRegistry) -> None: ...
+    async def _async_add_entity(self, entity: Entity, update_before_add: bool, entity_registry: EntityRegistry, config_subentry_id: str | None) -> None: ...
     async def async_reset(self) -> None: ...
     @callback
     def async_unsub_polling(self) -> None: ...

homeassistant-stubs/helpers/entity_registry.pyi CHANGED Viewed

@@ -72,6 +72,7 @@ class RegistryEntry:
     categories: dict[str, str]
     capabilities: Mapping[str, Any] | None
     config_entry_id: str | None
+    config_subentry_id: str | None
     created_at: datetime
     device_class: str | None
     device_id: str | None
@@ -113,7 +114,7 @@ class RegistryEntry:
     def as_storage_fragment(self) -> json_fragment: ...
     @callback
     def write_unavailable_state(self, hass: HomeAssistant) -> None: ...
-    def __init__(self, entity_id, unique_id, platform, previous_unique_id, aliases, area_id, categories, capabilities, config_entry_id, created_at, device_class, device_id, domain, disabled_by, entity_category, hidden_by, icon, id, has_entity_name, labels, modified_at, name, options, original_device_class, original_icon, original_name, supported_features, translation_key, unit_of_measurement, cache) -> None: ...
+    def __init__(self, entity_id, unique_id, platform, previous_unique_id, aliases, area_id, categories, capabilities, config_entry_id, config_subentry_id, created_at, device_class, device_id, domain, disabled_by, entity_category, hidden_by, icon, id, has_entity_name, labels, modified_at, name, options, original_device_class, original_icon, original_name, supported_features, translation_key, unit_of_measurement, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -124,6 +125,7 @@ class DeletedRegistryEntry:
     unique_id: str
     platform: str
     config_entry_id: str | None
+    config_subentry_id: str | None
     domain: str
     id: str
     orphaned_timestamp: float | None
@@ -134,7 +136,7 @@ class DeletedRegistryEntry:
     def _domain_default(self) -> str: ...
     @under_cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, entity_id, unique_id, platform, config_entry_id, domain, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
+    def __init__(self, entity_id, unique_id, platform, config_entry_id, config_subentry_id, domain, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -161,7 +163,7 @@ class EntityRegistryItems(BaseRegistryItems[RegistryEntry]):
     def get_entries_for_area_id(self, area_id: str) -> list[RegistryEntry]: ...
     def get_entries_for_label(self, label: str) -> list[RegistryEntry]: ...
-def _validate_item(hass: HomeAssistant, domain: str, platform: str, *, config_entry_id: str | None | UndefinedType = None, device_id: str | None | UndefinedType = None, disabled_by: RegistryEntryDisabler | None | UndefinedType = None, entity_category: EntityCategory | None | UndefinedType = None, hidden_by: RegistryEntryHider | None | UndefinedType = None, report_non_string_unique_id: bool = True, unique_id: str | Hashable | UndefinedType | Any) -> None: ...
+def _validate_item(hass: HomeAssistant, domain: str, platform: str, *, config_entry_id: str | None | UndefinedType = None, config_subentry_id: str | None | UndefinedType = None, device_id: str | None | UndefinedType = None, disabled_by: RegistryEntryDisabler | None | UndefinedType = None, entity_category: EntityCategory | None | UndefinedType = None, hidden_by: RegistryEntryHider | None | UndefinedType = None, old_config_subentry_id: str | None = None, report_non_string_unique_id: bool = True, unique_id: str | Hashable | UndefinedType | Any) -> None: ...
 class EntityRegistry(BaseRegistry):
     deleted_entities: dict[tuple[str, str, str], DeletedRegistryEntry]
@@ -182,17 +184,17 @@ class EntityRegistry(BaseRegistry):
     @callback
     def async_generate_entity_id(self, domain: str, suggested_object_id: str, known_object_ids: Container[str] | None = None) -> str: ...
     @callback
-    def async_get_or_create(self, domain: str, platform: str, unique_id: str, *, known_object_ids: Container[str] | None = None, suggested_object_id: str | None = None, disabled_by: RegistryEntryDisabler | None = None, hidden_by: RegistryEntryHider | None = None, get_initial_options: Callable[[], EntityOptionsType | None] | None = None, capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry: ConfigEntry | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., entity_category: EntityCategory | UndefinedType | None = ..., has_entity_name: bool | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., supported_features: int | None | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    def async_get_or_create(self, domain: str, platform: str, unique_id: str, *, known_object_ids: Container[str] | None = None, suggested_object_id: str | None = None, disabled_by: RegistryEntryDisabler | None = None, hidden_by: RegistryEntryHider | None = None, get_initial_options: Callable[[], EntityOptionsType | None] | None = None, capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry: ConfigEntry | None | UndefinedType = ..., config_subentry_id: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., entity_category: EntityCategory | UndefinedType | None = ..., has_entity_name: bool | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., supported_features: int | None | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
     @callback
     def async_remove(self, entity_id: str) -> None: ...
     @callback
     def async_device_modified(self, event: Event[EventDeviceRegistryUpdatedData]) -> None: ...
     @callback
-    def _async_update_entity(self, entity_id: str, *, aliases: set[str] | UndefinedType = ..., area_id: str | None | UndefinedType = ..., categories: dict[str, str] | UndefinedType = ..., capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry_id: str | None | UndefinedType = ..., device_class: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., disabled_by: RegistryEntryDisabler | None | UndefinedType = ..., entity_category: EntityCategory | None | UndefinedType = ..., hidden_by: RegistryEntryHider | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., has_entity_name: bool | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | None | UndefinedType = ..., new_entity_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., options: EntityOptionsType | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., platform: str | None | UndefinedType = ..., supported_features: int | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    def _async_update_entity(self, entity_id: str, *, aliases: set[str] | UndefinedType = ..., area_id: str | None | UndefinedType = ..., categories: dict[str, str] | UndefinedType = ..., capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry_id: str | None | UndefinedType = ..., config_subentry_id: str | None | UndefinedType = ..., device_class: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., disabled_by: RegistryEntryDisabler | None | UndefinedType = ..., entity_category: EntityCategory | None | UndefinedType = ..., hidden_by: RegistryEntryHider | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., has_entity_name: bool | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | None | UndefinedType = ..., new_entity_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., options: EntityOptionsType | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., platform: str | None | UndefinedType = ..., supported_features: int | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
     @callback
-    def async_update_entity(self, entity_id: str, *, aliases: set[str] | UndefinedType = ..., area_id: str | None | UndefinedType = ..., categories: dict[str, str] | UndefinedType = ..., capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry_id: str | None | UndefinedType = ..., device_class: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., disabled_by: RegistryEntryDisabler | None | UndefinedType = ..., entity_category: EntityCategory | None | UndefinedType = ..., hidden_by: RegistryEntryHider | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., has_entity_name: bool | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | None | UndefinedType = ..., new_entity_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., supported_features: int | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    def async_update_entity(self, entity_id: str, *, aliases: set[str] | UndefinedType = ..., area_id: str | None | UndefinedType = ..., categories: dict[str, str] | UndefinedType = ..., capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry_id: str | None | UndefinedType = ..., config_subentry_id: str | None | UndefinedType = ..., device_class: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., disabled_by: RegistryEntryDisabler | None | UndefinedType = ..., entity_category: EntityCategory | None | UndefinedType = ..., hidden_by: RegistryEntryHider | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., has_entity_name: bool | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | None | UndefinedType = ..., new_entity_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., supported_features: int | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
     @callback
-    def async_update_entity_platform(self, entity_id: str, new_platform: str, *, new_config_entry_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., new_device_id: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    def async_update_entity_platform(self, entity_id: str, new_platform: str, *, new_config_entry_id: str | UndefinedType = ..., new_config_subentry_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., new_device_id: str | None | UndefinedType = ...) -> RegistryEntry: ...
     @callback
     def async_update_entity_options(self, entity_id: str, domain: str, options: Mapping[str, Any] | None) -> RegistryEntry: ...
     async def async_load(self) -> None: ...
@@ -205,6 +207,8 @@ class EntityRegistry(BaseRegistry):
     @callback
     def async_clear_config_entry(self, config_entry_id: str) -> None: ...
     @callback
+    def async_clear_config_subentry(self, config_entry_id: str, config_subentry_id: str) -> None: ...
+    @callback
     def async_purge_expired_orphaned_entities(self) -> None: ...
     @callback
     def async_clear_area_id(self, area_id: str) -> None: ...

homeassistant-stubs/helpers/llm.pyi CHANGED Viewed

@@ -5,7 +5,7 @@ from .singleton import singleton as singleton
 from _typeshed import Incomplete
 from abc import ABC, abstractmethod
 from collections.abc import Callable as Callable
-from dataclasses import dataclass
+from dataclasses import dataclass, field as dc_field
 from homeassistant.components.calendar import SERVICE_GET_EVENTS as SERVICE_GET_EVENTS
 from homeassistant.components.climate import INTENT_GET_TEMPERATURE as INTENT_GET_TEMPERATURE
 from homeassistant.components.cover import INTENT_CLOSE_COVER as INTENT_CLOSE_COVER, INTENT_OPEN_COVER as INTENT_OPEN_COVER
@@ -17,6 +17,7 @@ from homeassistant.core import Context as Context, Event as Event, HomeAssistant
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.json import JsonObjectType as JsonObjectType
+from homeassistant.util.ulid import ulid_now as ulid_now
 from typing import Any
 ACTION_PARAMETERS_CACHE: HassKey[dict[str, dict[str, tuple[str | None, vol.Schema]]]]
@@ -47,6 +48,7 @@ class LLMContext:
 class ToolInput:
     tool_name: str
     tool_args: dict[str, Any]
+    id: str = dc_field(default_factory=Incomplete)
 class Tool(metaclass=abc.ABCMeta):
     name: str

homeassistant-stubs/helpers/recorder.pyi CHANGED Viewed

@@ -10,7 +10,7 @@ from sqlalchemy.orm.session import Session as Session
 from typing import Any
 _LOGGER: Incomplete
-DOMAIN: HassKey[RecorderData]
+DATA_RECORDER: HassKey[RecorderData]
 DATA_INSTANCE: HassKey[Recorder]
 @dataclass(slots=True)
@@ -24,7 +24,6 @@ def async_migration_in_progress(hass: HomeAssistant) -> bool: ...
 def async_migration_is_live(hass: HomeAssistant) -> bool: ...
 @callback
 def async_initialize_recorder(hass: HomeAssistant) -> None: ...
-async def async_wait_recorder(hass: HomeAssistant) -> bool: ...
 def get_instance(hass: HomeAssistant) -> Recorder: ...
 @contextmanager
 def session_scope(*, hass: HomeAssistant | None = None, session: Session | None = None, exception_filter: Callable[[Exception], bool] | None = None, read_only: bool = False) -> Generator[Session]: ...

homeassistant-stubs/helpers/script.pyi CHANGED Viewed

@@ -5,7 +5,7 @@ from . import condition as condition, service as service, template as template
 from .condition import ConditionCheckerType as ConditionCheckerType, trace_condition_function as trace_condition_function
 from .dispatcher import async_dispatcher_connect as async_dispatcher_connect, async_dispatcher_send_internal as async_dispatcher_send_internal
 from .event import async_call_later as async_call_later, async_track_template as async_track_template
-from .script_variables import ScriptVariables as ScriptVariables
+from .script_variables import ScriptRunVariables as ScriptRunVariables, ScriptVariables as ScriptVariables
 from .template import Template as Template
 from .trace import TraceElement as TraceElement, async_trace_path as async_trace_path, script_execution_set as script_execution_set, trace_append_element as trace_append_element, trace_id_get as trace_id_get, trace_path as trace_path, trace_path_get as trace_path_get, trace_path_stack_cv as trace_path_stack_cv, trace_set_result as trace_set_result, trace_stack_cv as trace_stack_cv, trace_stack_pop as trace_stack_pop, trace_stack_push as trace_stack_push, trace_stack_top as trace_stack_top, trace_update_result as trace_update_result
 from .trigger import async_initialize_triggers as async_initialize_triggers, async_validate_trigger_config as async_validate_trigger_config
@@ -27,7 +27,6 @@ from homeassistant.util.dt import utcnow as utcnow
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.signal_type import SignalType as SignalType, SignalTypeFormat as SignalTypeFormat
 from propcache.api import cached_property
-from types import MappingProxyType
 from typing import Any, Literal, TypedDict, overload
 SCRIPT_MODE_PARALLEL: str
@@ -65,9 +64,9 @@ class ScriptData(TypedDict):
 class ScriptStoppedError(Exception): ...
 def _set_result_unless_done(future: asyncio.Future[None]) -> None: ...
-def action_trace_append(variables: dict[str, Any], path: str) -> TraceElement: ...
+def action_trace_append(variables: TemplateVarsType, path: str) -> TraceElement: ...
 @asynccontextmanager
-async def trace_action(hass: HomeAssistant, script_run: _ScriptRun, stop: asyncio.Future[None], variables: dict[str, Any]) -> AsyncGenerator[TraceElement]: ...
+async def trace_action(hass: HomeAssistant, script_run: _ScriptRun, stop: asyncio.Future[None], variables: TemplateVarsType) -> AsyncGenerator[TraceElement]: ...
 def make_script_schema(schema: Mapping[Any, Any], default_script_mode: str, extra: int = ...) -> vol.Schema: ...
 STATIC_VALIDATION_ACTION_TYPES: Incomplete
@@ -97,9 +96,8 @@ class _ScriptRun:
     _stop: Incomplete
     _stopped: Incomplete
     _conversation_response: str | None | UndefinedType
-    def __init__(self, hass: HomeAssistant, script: Script, variables: dict[str, Any], context: Context | None, log_exceptions: bool) -> None: ...
+    def __init__(self, hass: HomeAssistant, script: Script, variables: ScriptRunVariables, context: Context | None, log_exceptions: bool) -> None: ...
     def _changed(self) -> None: ...
-    async def _async_get_condition(self, config: ConfigType) -> ConditionCheckerType: ...
     def _log(self, msg: str, *args: Any, level: int = ..., **kwargs: Any) -> None: ...
     def _step_log(self, default_message: str, timeout: float | None = None) -> None: ...
     async def async_run(self) -> ScriptRunResult | None: ...
@@ -108,34 +106,36 @@ class _ScriptRun:
     async def async_stop(self) -> None: ...
     def _handle_exception(self, exception: Exception, continue_on_error: bool, log_exceptions: bool) -> None: ...
     def _log_exception(self, exception: Exception) -> None: ...
-    def _get_pos_time_period_template(self, key: str) -> timedelta: ...
-    async def _async_delay_step(self) -> None: ...
-    def _get_timeout_seconds_from_action(self) -> float | None: ...
-    async def _async_wait_template_step(self) -> None: ...
-    def _async_set_remaining_time_var(self, timeout_handle: asyncio.TimerHandle | None) -> None: ...
     async def _async_run_long_action[_T](self, long_task: asyncio.Task[_T]) -> _T | None: ...
-    async def _async_call_service_step(self) -> None: ...
-    async def _async_device_step(self) -> None: ...
-    async def _async_scene_step(self) -> None: ...
-    async def _async_event_step(self) -> None: ...
-    async def _async_condition_step(self) -> None: ...
+    async def _async_run_script(self, script: Script, *, parallel: bool = False) -> None: ...
+    async def _async_step_parallel(self) -> None: ...
+    async def _async_step_sequence(self) -> None: ...
+    async def _async_get_condition(self, config: ConfigType) -> ConditionCheckerType: ...
     def _test_conditions(self, conditions: list[ConditionCheckerType], name: str, condition_path: str | None = None) -> bool | None: ...
-    async def _async_repeat_step(self) -> None: ...
-    async def _async_choose_step(self) -> None: ...
-    async def _async_if_step(self) -> None: ...
+    async def _async_step_choose(self) -> None: ...
+    async def _async_step_condition(self) -> None: ...
+    async def _async_step_if(self) -> None: ...
+    async def _async_do_step_repeat(self) -> None: ...
+    async def _async_step_repeat(self) -> None: ...
+    async def _async_step_stop(self) -> None: ...
+    async def _async_step_variables(self) -> None: ...
+    async def _async_step_call_service(self) -> None: ...
+    async def _async_step_device(self) -> None: ...
+    async def _async_step_event(self) -> None: ...
+    async def _async_step_scene(self) -> None: ...
     @overload
     def _async_futures_with_timeout(self, timeout: float) -> tuple[list[asyncio.Future[None]], asyncio.TimerHandle, asyncio.Future[None]]: ...
     @overload
     def _async_futures_with_timeout(self, timeout: None) -> tuple[list[asyncio.Future[None]], None, None]: ...
-    async def _async_wait_for_trigger_step(self) -> None: ...
+    def _get_pos_time_period_template(self, key: str) -> timedelta: ...
+    async def _async_step_delay(self) -> None: ...
+    def _get_timeout_seconds_from_action(self) -> float | None: ...
     def _async_handle_timeout(self) -> None: ...
     async def _async_wait_with_optional_timeout(self, futures: list[asyncio.Future[None]], timeout_handle: asyncio.TimerHandle | None, timeout_future: asyncio.Future[None] | None, unsub: Callable[[], None]) -> None: ...
-    async def _async_variables_step(self) -> None: ...
-    async def _async_set_conversation_response_step(self) -> None: ...
-    async def _async_stop_step(self) -> None: ...
-    async def _async_sequence_step(self) -> None: ...
-    async def _async_parallel_step(self) -> None: ...
-    async def _async_run_script(self, script: Script) -> None: ...
+    def _async_set_remaining_time_var(self, timeout_handle: asyncio.TimerHandle | None) -> None: ...
+    async def _async_step_wait_for_trigger(self) -> None: ...
+    async def _async_step_wait_template(self) -> None: ...
+    async def _async_step_set_conversation_response(self) -> None: ...
 class _QueuedScriptRun(_ScriptRun):
     lock_acquired: bool
@@ -146,7 +146,7 @@ class _QueuedScriptRun(_ScriptRun):
 def _schedule_stop_scripts_after_shutdown(hass: HomeAssistant) -> None: ...
 async def _async_stop_scripts_after_shutdown(hass: HomeAssistant, point_in_time: datetime) -> None: ...
 async def _async_stop_scripts_at_shutdown(hass: HomeAssistant, event: Event) -> None: ...
-type _VarsType = dict[str, Any] | Mapping[str, Any] | MappingProxyType[str, Any]
+type _VarsType = dict[str, Any] | Mapping[str, Any] | ScriptRunVariables
 def _referenced_extract_ids(data: Any, key: str, found: set[str]) -> None: ...
 class _ChooseData(TypedDict):
@@ -162,7 +162,7 @@ class _IfData(TypedDict):
 class ScriptRunResult:
     conversation_response: str | None | UndefinedType
     service_response: ServiceResponse
-    variables: dict[str, Any]
+    variables: Mapping[str, Any]
 class Script:
     top_level: Incomplete
@@ -189,9 +189,7 @@ class Script:
     _parallel_scripts: dict[int, list[Script]]
     _sequence_scripts: dict[int, Script]
     variables: Incomplete
-    _variables_dynamic: Incomplete
-    _copy_variables_on_run: Incomplete
-    def __init__(self, hass: HomeAssistant, sequence: Sequence[dict[str, Any]], name: str, domain: str, *, change_listener: Callable[[], Any] | None = None, copy_variables: bool = False, log_exceptions: bool = True, logger: logging.Logger | None = None, max_exceeded: str = ..., max_runs: int = ..., running_description: str | None = None, script_mode: str = ..., top_level: bool = True, variables: ScriptVariables | None = None) -> None: ...
+    def __init__(self, hass: HomeAssistant, sequence: Sequence[dict[str, Any]], name: str, domain: str, *, change_listener: Callable[[], Any] | None = None, log_exceptions: bool = True, logger: logging.Logger | None = None, max_exceeded: str = ..., max_runs: int = ..., running_description: str | None = None, script_mode: str = ..., top_level: bool = True, variables: ScriptVariables | None = None) -> None: ...
     @property
     def change_listener(self) -> Callable[..., Any] | None: ...
     @change_listener.setter

homeassistant-stubs/helpers/script_variables.pyi CHANGED Viewed

@@ -1,6 +1,8 @@
 from . import template as template
 from _typeshed import Incomplete
+from collections import ChainMap, UserDict
 from collections.abc import Mapping
+from dataclasses import dataclass, field
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from typing import Any
@@ -9,5 +11,36 @@ class ScriptVariables:
     _has_template: bool | None
     def __init__(self, variables: dict[str, Any]) -> None: ...
     @callback
-    def async_render(self, hass: HomeAssistant, run_variables: Mapping[str, Any] | None, *, render_as_defaults: bool = True, limited: bool = False) -> dict[str, Any]: ...
+    def async_render(self, hass: HomeAssistant, run_variables: Mapping[str, Any] | None, *, limited: bool = False) -> dict[str, Any]: ...
+    @callback
+    def async_simple_render(self, run_variables: Mapping[str, Any]) -> dict[str, Any]: ...
     def as_dict(self) -> dict[str, Any]: ...
+@dataclass
+class _ParallelData:
+    protected: dict[str, Any] = field(default_factory=dict)
+    outer_scope_writes: dict[str, Any] = field(default_factory=dict)
+@dataclass(kw_only=True)
+class ScriptRunVariables(UserDict[str, Any]):
+    _previous: ScriptRunVariables | None = ...
+    _parent: ScriptRunVariables | None = ...
+    _local_data: dict[str, Any] | None = ...
+    _parallel_data: _ParallelData | None = ...
+    _non_parallel_scope: ChainMap[str, Any]
+    _full_scope: ChainMap[str, Any]
+    @classmethod
+    def create_top_level(cls, initial_data: Mapping[str, Any] | None = None) -> ScriptRunVariables: ...
+    def enter_scope(self, *, parallel: bool = False) -> ScriptRunVariables: ...
+    def exit_scope(self) -> ScriptRunVariables: ...
+    def __delitem__(self, key: str) -> None: ...
+    def __setitem__(self, key: str, value: Any) -> None: ...
+    def assign_parallel_protected(self, key: str, value: Any) -> None: ...
+    def _assign(self, key: str, value: Any, *, parallel_protected: bool) -> None: ...
+    def define_local(self, key: str, value: Any) -> None: ...
+    @property
+    def data(self) -> Mapping[str, Any]: ...
+    @property
+    def non_parallel_scope(self) -> Mapping[str, Any]: ...
+    @property
+    def local_scope(self) -> Mapping[str, Any]: ...

homeassistant-stubs/loader.pyi CHANGED Viewed

@@ -15,7 +15,7 @@ from .generated.usb import USB as USB
 from .generated.zeroconf import HOMEKIT as HOMEKIT, ZEROCONF as ZEROCONF
 from .helpers import device_registry as dr
 from .helpers.json import json_bytes as json_bytes, json_fragment as json_fragment
-from .helpers.typing import ConfigType as ConfigType, UNDEFINED as UNDEFINED
+from .helpers.typing import ConfigType as ConfigType
 from .util.hass_dict import HassKey as HassKey
 from .util.json import JSON_DECODE_EXCEPTIONS as JSON_DECODE_EXCEPTIONS, json_loads as json_loads
 from _typeshed import Incomplete
@@ -36,7 +36,7 @@ class BlockedIntegration:
 BLOCKED_CUSTOM_INTEGRATIONS: dict[str, BlockedIntegration]
 DATA_COMPONENTS: HassKey[dict[str, ModuleType | ComponentProtocol]]
-DATA_INTEGRATIONS: HassKey[dict[str, Integration | asyncio.Future[None]]]
+DATA_INTEGRATIONS: HassKey[dict[str, Integration | asyncio.Future[Integration | IntegrationNotFound]]]
 DATA_MISSING_PLATFORMS: HassKey[dict[str, bool]]
 DATA_CUSTOM_COMPONENTS: HassKey[dict[str, Integration] | asyncio.Future[dict[str, Integration]]]
 DATA_PRELOAD_PLATFORMS: HassKey[list[str]]

homeassistant-stubs/util/unit_conversion.pyi CHANGED Viewed

@@ -1,7 +1,7 @@
 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.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, UnitOfEnergyDistance as UnitOfEnergyDistance, 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
 _MM_TO_M: float
@@ -42,6 +42,7 @@ class BaseUnitConverter:
     UNIT_CLASS: str
     VALID_UNITS: set[str | None]
     _UNIT_CONVERSION: dict[str | None, float]
+    _UNIT_INVERSES: set[str]
     @classmethod
     def convert(cls, value: float, from_unit: str | None, to_unit: str | None) -> float: ...
     @classmethod
@@ -55,6 +56,9 @@ class BaseUnitConverter:
     @classmethod
     @lru_cache
     def get_unit_ratio(cls, from_unit: str | None, to_unit: str | None) -> float: ...
+    @classmethod
+    @lru_cache
+    def _are_unit_inverses(cls, from_unit: str | None, to_unit: str | None) -> bool: ...
 class DataRateConverter(BaseUnitConverter):
     UNIT_CLASS: str
@@ -96,6 +100,12 @@ class EnergyConverter(BaseUnitConverter):
     _UNIT_CONVERSION: dict[str | None, float]
     VALID_UNITS: Incomplete
+class EnergyDistanceConverter(BaseUnitConverter):
+    UNIT_CLASS: str
+    _UNIT_CONVERSION: dict[str | None, float]
+    _UNIT_INVERSES: set[str]
+    VALID_UNITS: Incomplete
 class InformationConverter(BaseUnitConverter):
     UNIT_CLASS: str
     _UNIT_CONVERSION: dict[str | None, float]

{homeassistant_stubs-2025.2.5.dist-info → homeassistant_stubs-2025.3.0b0.dist-info}/METADATA RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homeassistant-stubs
-Version: 2025.2.5
+Version: 2025.3.0b0
 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.13
-Requires-Dist: homeassistant==2025.2.5
+Requires-Dist: homeassistant==2025.3.0b0
 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)

homeassistant-stubs 2025.2.5__py3-none-any.whl → 2025.3.0b0__py3-none-any.whl

homeassistant-stubs 2025.2.5py3-none-any.whl → 2025.3.0b0py3-none-any.whl