PyPI - homeassistant-stubs - Versions diffs - 2025.1.2__py3-none-any.whl → 2025.1.4__py3-none-any.whl - Mend

homeassistant-stubs 2025.1.2py3-none-any.whl → 2025.1.4py3-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 (1171) hide show

homeassistant-stubs/helpers/event.pyi CHANGED Viewed

@@ -66,49 +66,72 @@ class TrackTemplateResult:
     result: Any
 def threaded_listener_factory[**_P](async_factory: Callable[Concatenate[HomeAssistant, _P], Any]) -> Callable[Concatenate[HomeAssistant, _P], CALLBACK_TYPE]: ...
+@callback
+@bind_hass
 def async_track_state_change(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[str, State | None, State | None], Coroutine[Any, Any, None] | None], from_state: str | Iterable[str] | None = None, to_state: str | Iterable[str] | None = None) -> CALLBACK_TYPE: ...
 track_state_change: Incomplete
+@bind_hass
 def async_track_state_change_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[Event[EventStateChangedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+@callback
 def _async_dispatch_entity_id_event_soon[_StateEventDataT: EventStateEventData](hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[_StateEventDataT]], Any]]], event: Event[_StateEventDataT]) -> None: ...
+@callback
 def _async_dispatch_entity_id_event[_StateEventDataT: EventStateEventData](hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[_StateEventDataT]], Any]]], event: Event[_StateEventDataT]) -> None: ...
+@callback
 def _async_state_filter[_StateEventDataT: EventStateEventData](hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[_StateEventDataT]], Any]]], event_data: _StateEventDataT) -> bool: ...
 _KEYED_TRACK_STATE_CHANGE: Incomplete
+@bind_hass
 def _async_track_state_change_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[Event[EventStateChangedData]], Any], job_type: HassJobType | None) -> CALLBACK_TYPE: ...
 _KEYED_TRACK_STATE_REPORT: Incomplete
 def async_track_state_report_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[Event[EventStateReportedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+@callback
 def _remove_empty_listener() -> None: ...
+@callback
 def _remove_listener(hass: HomeAssistant, tracker: _KeyedEventTracker[_TypedDictT], keys: Iterable[str], job: HassJob[[Event[_TypedDictT]], Any], callbacks: dict[str, list[HassJob[[Event[_TypedDictT]], Any]]]) -> None: ...
 def _async_track_event(tracker: _KeyedEventTracker[_TypedDictT], hass: HomeAssistant, keys: str | Iterable[str], action: Callable[[Event[_TypedDictT]], None], job_type: HassJobType | None) -> CALLBACK_TYPE: ...
+@callback
 def _async_dispatch_old_entity_id_or_entity_id_event(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventEntityRegistryUpdatedData]], Any]]], event: Event[EventEntityRegistryUpdatedData]) -> None: ...
+@callback
 def _async_entity_registry_updated_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventEntityRegistryUpdatedData]], Any]]], event_data: EventEntityRegistryUpdatedData) -> bool: ...
 _KEYED_TRACK_ENTITY_REGISTRY_UPDATED: Incomplete
+@bind_hass
+@callback
 def async_track_entity_registry_updated_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[Event[EventEntityRegistryUpdatedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+@callback
 def _async_device_registry_updated_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventDeviceRegistryUpdatedData]], Any]]], event_data: EventDeviceRegistryUpdatedData) -> bool: ...
+@callback
 def _async_dispatch_device_id_event(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventDeviceRegistryUpdatedData]], Any]]], event: Event[EventDeviceRegistryUpdatedData]) -> None: ...
 _KEYED_TRACK_DEVICE_REGISTRY_UPDATED: Incomplete
+@callback
 def async_track_device_registry_updated_event(hass: HomeAssistant, device_ids: str | Iterable[str], action: Callable[[Event[EventDeviceRegistryUpdatedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+@callback
 def _async_dispatch_domain_event(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventStateChangedData]], Any]]], event: Event[EventStateChangedData]) -> None: ...
+@callback
 def _async_domain_added_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventStateChangedData]], Any]]], event_data: EventStateChangedData) -> bool: ...
+@bind_hass
 def async_track_state_added_domain(hass: HomeAssistant, domains: str | Iterable[str], action: Callable[[Event[EventStateChangedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
 _KEYED_TRACK_STATE_ADDED_DOMAIN: Incomplete
+@bind_hass
 def _async_track_state_added_domain(hass: HomeAssistant, domains: str | Iterable[str], action: Callable[[Event[EventStateChangedData]], Any], job_type: HassJobType | None) -> CALLBACK_TYPE: ...
+@callback
 def _async_domain_removed_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventStateChangedData]], Any]]], event_data: EventStateChangedData) -> bool: ...
 _KEYED_TRACK_STATE_REMOVED_DOMAIN: Incomplete
+@bind_hass
 def async_track_state_removed_domain(hass: HomeAssistant, domains: str | Iterable[str], action: Callable[[Event[EventStateChangedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+@callback
 def _async_string_to_lower_list(instr: str | Iterable[str]) -> list[str]: ...
 class _TrackStateChangeFiltered:
@@ -118,18 +141,30 @@ class _TrackStateChangeFiltered:
     _listeners: dict[str, Callable[[], None]]
     _last_track_states: TrackStates
     def __init__(self, hass: HomeAssistant, track_states: TrackStates, action: Callable[[Event[EventStateChangedData]], Any]) -> None: ...
+    @callback
     def async_setup(self) -> None: ...
     @property
     def listeners(self) -> dict[str, bool | set[str]]: ...
+    @callback
     def async_update_listeners(self, new_track_states: TrackStates) -> None: ...
+    @callback
     def async_remove(self) -> None: ...
+    @callback
     def _cancel_listener(self, listener_name: str) -> None: ...
+    @callback
     def _setup_entities_listener(self, domains: set[str], entities: set[str]) -> None: ...
+    @callback
     def _state_added(self, event: Event[EventStateChangedData]) -> None: ...
+    @callback
     def _setup_domains_listener(self, domains: set[str]) -> None: ...
+    @callback
     def _setup_all_listener(self) -> None: ...
+@callback
+@bind_hass
 def async_track_state_change_filtered(hass: HomeAssistant, track_states: TrackStates, action: Callable[[Event[EventStateChangedData]], Any]) -> _TrackStateChangeFiltered: ...
+@callback
+@bind_hass
 def async_track_template(hass: HomeAssistant, template: Template, action: Callable[[str, State | None, State | None], Coroutine[Any, Any, None] | None], variables: TemplateVarsType | None = None) -> CALLBACK_TYPE: ...
 track_template: Incomplete
@@ -149,22 +184,34 @@ class TrackTemplateResultInfo:
     def async_setup(self, strict: bool = False, log_fn: Callable[[int, str], None] | None = None) -> None: ...
     @property
     def listeners(self) -> dict[str, bool | set[str]]: ...
+    @callback
     def _setup_time_listener(self, template: Template, has_time: bool) -> None: ...
+    @callback
     def _update_time_listeners(self) -> None: ...
+    @callback
     def async_remove(self) -> None: ...
+    @callback
     def async_refresh(self) -> None: ...
     def _render_template_if_ready(self, track_template_: TrackTemplate, now: float, event: Event[EventStateChangedData] | None) -> bool | TrackTemplateResult: ...
     @staticmethod
     def _super_template_as_boolean(result: bool | str | TemplateError) -> bool: ...
+    @callback
     def _apply_update(self, updates: list[TrackTemplateResult], update: bool | TrackTemplateResult, template: Template) -> bool: ...
+    @callback
     def _refresh(self, event: Event[EventStateChangedData] | None, track_templates: Iterable[TrackTemplate] | None = None, replayed: bool | None = False) -> None: ...
 type TrackTemplateResultListener = Callable[[Event[EventStateChangedData] | None, list[TrackTemplateResult]], Coroutine[Any, Any, None] | None]
+@callback
+@bind_hass
 def async_track_template_result(hass: HomeAssistant, track_templates: Sequence[TrackTemplate], action: TrackTemplateResultListener, strict: bool = False, log_fn: Callable[[int, str], None] | None = None, has_super_template: bool = False) -> TrackTemplateResultInfo: ...
+@callback
+@bind_hass
 def async_track_same_state(hass: HomeAssistant, period: timedelta, action: Callable[[], Coroutine[Any, Any, None] | None], async_check_same_func: Callable[[str, State | None, State | None], bool], entity_ids: str | Iterable[str] = ...) -> CALLBACK_TYPE: ...
 track_same_state: Incomplete
+@callback
+@bind_hass
 def async_track_point_in_time(hass: HomeAssistant, action: HassJob[[datetime], Coroutine[Any, Any, None] | None] | Callable[[datetime], Coroutine[Any, Any, None] | None], point_in_time: datetime) -> CALLBACK_TYPE: ...
 track_point_in_time: Incomplete
@@ -177,15 +224,23 @@ class _TrackPointUTCTime:
     expected_fire_timestamp: float
     _cancel_callback: asyncio.TimerHandle | None = ...
     def async_attach(self) -> None: ...
+    @callback
     def __call__(self) -> None: ...
+    @callback
     def async_cancel(self) -> None: ...
+@callback
+@bind_hass
 def async_track_point_in_utc_time(hass: HomeAssistant, action: HassJob[[datetime], Coroutine[Any, Any, None] | None] | Callable[[datetime], Coroutine[Any, Any, None] | None], point_in_time: datetime) -> CALLBACK_TYPE: ...
 track_point_in_utc_time: Incomplete
 def _run_async_call_action(hass: HomeAssistant, job: HassJob[[datetime], Coroutine[Any, Any, None] | None]) -> None: ...
+@callback
+@bind_hass
 def async_call_at(hass: HomeAssistant, action: HassJob[[datetime], Coroutine[Any, Any, None] | None] | Callable[[datetime], Coroutine[Any, Any, None] | None], loop_time: float) -> CALLBACK_TYPE: ...
+@callback
+@bind_hass
 def async_call_later(hass: HomeAssistant, delay: float | timedelta, action: HassJob[[datetime], Coroutine[Any, Any, None] | None] | Callable[[datetime], Coroutine[Any, Any, None] | None]) -> CALLBACK_TYPE: ...
 call_later: Incomplete
@@ -202,9 +257,13 @@ class _TrackTimeInterval:
     _timer_handle: asyncio.TimerHandle | None = ...
     def async_attach(self) -> None: ...
     def _schedule_timer(self) -> None: ...
+    @callback
     def _interval_listener(self, _: Any) -> None: ...
+    @callback
     def async_cancel(self) -> None: ...
+@callback
+@bind_hass
 def async_track_time_interval(hass: HomeAssistant, action: Callable[[datetime], Coroutine[Any, Any, None] | None], interval: timedelta, *, name: str | None = None, cancel_on_shutdown: bool | None = None) -> CALLBACK_TYPE: ...
 track_time_interval: Incomplete
@@ -217,16 +276,25 @@ class SunListener:
     offset: timedelta | None
     _unsub_sun: CALLBACK_TYPE | None = ...
     _unsub_config: CALLBACK_TYPE | None = ...
+    @callback
     def async_attach(self) -> None: ...
+    @callback
     def async_detach(self) -> None: ...
+    @callback
     def _listen_next_sun_event(self) -> None: ...
+    @callback
     def _handle_sun_event(self, _now: Any) -> None: ...
+    @callback
     def _handle_config_event(self, _event: Any) -> None: ...
+@callback
+@bind_hass
 def async_track_sunrise(hass: HomeAssistant, action: Callable[[], None], offset: timedelta | None = None) -> CALLBACK_TYPE: ...
 track_sunrise: Incomplete
+@callback
+@bind_hass
 def async_track_sunset(hass: HomeAssistant, action: Callable[[], None], offset: timedelta | None = None) -> CALLBACK_TYPE: ...
 track_sunset: Incomplete
@@ -245,21 +313,32 @@ class _TrackUTCTimeChange:
     _cancel_callback: CALLBACK_TYPE | None = ...
     def async_attach(self) -> None: ...
     def _calculate_next(self, utc_now: datetime) -> datetime: ...
+    @callback
     def _pattern_time_change_listener(self, _: datetime) -> None: ...
+    @callback
     def async_cancel(self) -> None: ...
+@callback
+@bind_hass
 def async_track_utc_time_change(hass: HomeAssistant, action: Callable[[datetime], Coroutine[Any, Any, None] | None], hour: Any | None = None, minute: Any | None = None, second: Any | None = None, local: bool = False) -> CALLBACK_TYPE: ...
 track_utc_time_change: Incomplete
+@callback
+@bind_hass
 def async_track_time_change(hass: HomeAssistant, action: Callable[[datetime], Coroutine[Any, Any, None] | None], hour: Any | None = None, minute: Any | None = None, second: Any | None = None) -> CALLBACK_TYPE: ...
 track_time_change: Incomplete
 def process_state_match(parameter: str | Iterable[str] | None, invert: bool = False) -> Callable[[str | None], bool]: ...
+@callback
 def _entities_domains_from_render_infos(render_infos: Iterable[RenderInfo]) -> tuple[set[str], set[str]]: ...
+@callback
 def _render_infos_needs_all_listener(render_infos: Iterable[RenderInfo]) -> bool: ...
+@callback
 def _render_infos_to_track_states(render_infos: Iterable[RenderInfo]) -> TrackStates: ...
+@callback
 def _event_triggers_rerender(event: Event[EventStateChangedData], info: RenderInfo) -> bool: ...
+@callback
 def _rate_limit_for_event(event: Event[EventStateChangedData], info: RenderInfo, track_template_: TrackTemplate) -> float | None: ...
 def _suppress_domain_all_in_render_info(render_info: RenderInfo) -> RenderInfo: ...

homeassistant-stubs/helpers/floor_registry.pyi CHANGED Viewed

@@ -51,15 +51,23 @@ class FloorRegistry(BaseRegistry[FloorRegistryStoreData]):
     hass: Incomplete
     _store: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_get_floor(self, floor_id: str) -> FloorEntry | None: ...
+    @callback
     def async_get_floor_by_name(self, name: str) -> FloorEntry | None: ...
+    @callback
     def async_list_floors(self) -> Iterable[FloorEntry]: ...
     def _generate_id(self, name: str) -> str: ...
+    @callback
     def async_create(self, name: str, *, aliases: set[str] | None = None, icon: str | None = None, level: int | None = None) -> FloorEntry: ...
+    @callback
     def async_delete(self, floor_id: str) -> None: ...
+    @callback
     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: ...
+    @callback
     def _data_to_save(self) -> FloorRegistryStoreData: ...
+@callback
 def async_get(hass: HomeAssistant) -> FloorRegistry: ...
 async def async_load(hass: HomeAssistant) -> None: ...

homeassistant-stubs/helpers/hassio.pyi CHANGED Viewed

@@ -1,4 +1,6 @@
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+@callback
 def is_hassio(hass: HomeAssistant) -> bool: ...
+@callback
 def get_supervisor_ip() -> str | None: ...

homeassistant-stubs/helpers/httpx_client.pyi CHANGED Viewed

@@ -17,11 +17,15 @@ limits: Incomplete
 SERVER_SOFTWARE: Incomplete
 USER_AGENT: str
+@callback
+@bind_hass
 def get_async_client(hass: HomeAssistant, verify_ssl: bool = True) -> httpx.AsyncClient: ...
 class HassHttpXAsyncClient(httpx.AsyncClient):
     async def __aenter__(self) -> Self: ...
     async def __aexit__(self, *args: object) -> None: ...
+@callback
 def create_async_httpx_client(hass: HomeAssistant, verify_ssl: bool = True, auto_cleanup: bool = True, ssl_cipher_list: SSLCipherList = ..., **kwargs: Any) -> httpx.AsyncClient: ...
+@callback
 def _async_register_async_client_shutdown(hass: HomeAssistant, client: httpx.AsyncClient, original_aclose: Callable[[], Coroutine[Any, Any, None]]) -> None: ...

homeassistant-stubs/helpers/icon.pyi CHANGED Viewed

@@ -2,6 +2,7 @@ import pathlib
 from .translation import build_resources as build_resources
 from _typeshed import Incomplete
 from collections.abc import Iterable
+from functools import lru_cache
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.loader import Integration as Integration, async_get_integrations as async_get_integrations
 from homeassistant.util.hass_dict import HassKey as HassKey
@@ -25,8 +26,10 @@ class _IconsCache:
     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: ...
+    @callback
     def _build_category_cache(self, components: set[str], icons: dict[str, dict[str, Any]]) -> None: ...
 async def async_get_icons(hass: HomeAssistant, category: str, integrations: Iterable[str] | None = None) -> dict[str, Any]: ...
+@lru_cache
 def icon_for_battery_level(battery_level: int | None = None, charging: bool = False) -> str: ...
 def icon_for_signal_level(signal_level: int | None = None) -> str: ...

homeassistant-stubs/helpers/integration_platform.pyi CHANGED Viewed

@@ -20,9 +20,12 @@ class IntegrationPlatform:
     process_job: HassJob[[HomeAssistant, str, Any], Awaitable[None] | None]
     seen_components: set[str]
+@callback
 def _async_integration_platform_component_loaded(hass: HomeAssistant, integration_platforms: list[IntegrationPlatform], event: Event[EventComponentLoaded]) -> None: ...
 async def _async_process_integration_platforms_for_component(hass: HomeAssistant, integration: Integration, platforms_that_exist: list[str], integration_platforms_by_name: dict[str, IntegrationPlatform]) -> None: ...
+@callback
 def _process_integration_platforms(hass: HomeAssistant, integration: Integration, platforms: dict[str, ModuleType], integration_platforms_by_name: dict[str, IntegrationPlatform]) -> list[asyncio.Future[Awaitable[None] | None]]: ...
 def _format_err(name: str, platform_name: str, *args: Any) -> str: ...
+@bind_hass
 async def async_process_integration_platforms(hass: HomeAssistant, platform_name: str, process_platform: Callable[[HomeAssistant, str, Any], Awaitable[None] | None], wait_for_platforms: bool = False) -> None: ...
 async def _async_process_integration_platforms(hass: HomeAssistant, platform_name: str, top_level_components: set[str], process_job: HassJob) -> None: ...

homeassistant-stubs/helpers/intent.pyi CHANGED Viewed

@@ -42,9 +42,15 @@ DATA_KEY: HassKey[dict[str, IntentHandler]]
 SPEECH_TYPE_PLAIN: str
 SPEECH_TYPE_SSML: str
+@callback
+@bind_hass
 def async_register(hass: HomeAssistant, handler: IntentHandler) -> None: ...
+@callback
+@bind_hass
 def async_remove(hass: HomeAssistant, intent_type: str) -> None: ...
+@callback
 def async_get(hass: HomeAssistant) -> Iterable[IntentHandler]: ...
+@bind_hass
 async def async_handle(hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType | None = None, text_input: str | None = None, context: Context | None = None, language: str | None = None, assistant: str | None = None, device_id: str | None = None, conversation_agent_id: str | None = None) -> IntentResponse: ...
 class IntentError(HomeAssistantError): ...
@@ -126,8 +132,12 @@ def _filter_by_name(name: str, candidates: Iterable[MatchTargetsCandidate]) -> I
 def _filter_by_features(features: int, candidates: Iterable[MatchTargetsCandidate]) -> Iterable[MatchTargetsCandidate]: ...
 def _filter_by_device_classes(device_classes: Iterable[str], candidates: Iterable[MatchTargetsCandidate]) -> Iterable[MatchTargetsCandidate]: ...
 def _add_areas(areas: area_registry.AreaRegistry, devices: device_registry.DeviceRegistry, candidates: Iterable[MatchTargetsCandidate]) -> None: ...
+@callback
 def async_match_targets(hass: HomeAssistant, constraints: MatchTargetsConstraints, preferences: MatchTargetsPreferences | None = None, states: list[State] | None = None) -> MatchTargetsResult: ...
+@callback
+@bind_hass
 def async_match_states(hass: HomeAssistant, name: str | None = None, area_name: str | None = None, floor_name: str | None = None, domains: Collection[str] | None = None, device_classes: Collection[str] | None = None, states: list[State] | None = None, assistant: str | None = None) -> Iterable[State]: ...
+@callback
 def async_test_feature(state: State, feature: int, feature_name: str) -> None: ...
 class IntentHandler:
@@ -136,7 +146,9 @@ class IntentHandler:
     description: str | None
     @property
     def slot_schema(self) -> dict | None: ...
+    @callback
     def async_can_handle(self, intent_obj: Intent) -> bool: ...
+    @callback
     def async_validate_slots(self, slots: _SlotsType) -> _SlotsType: ...
     @cached_property
     def _slot_schema(self) -> vol.Schema: ...
@@ -191,6 +203,7 @@ class Intent:
     device_id: Incomplete
     conversation_agent_id: Incomplete
     def __init__(self, hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType, text_input: str | None, context: Context, language: str, category: IntentCategory | None = None, assistant: str | None = None, device_id: str | None = None, conversation_agent_id: str | None = None) -> None: ...
+    @callback
     def create_response(self) -> IntentResponse: ...
 class IntentResponseType(Enum):
@@ -235,12 +248,21 @@ class IntentResponse:
     speech_slots: dict[str, Any]
     response_type: Incomplete
     def __init__(self, language: str, intent: Intent | None = None) -> None: ...
+    @callback
     def async_set_speech(self, speech: str, speech_type: str = 'plain', extra_data: Any | None = None) -> None: ...
+    @callback
     def async_set_reprompt(self, speech: str, speech_type: str = 'plain', extra_data: Any | None = None) -> None: ...
+    @callback
     def async_set_card(self, title: str, content: str, card_type: str = 'simple') -> None: ...
+    @callback
     def async_set_error(self, code: IntentResponseErrorCode, message: str) -> None: ...
+    @callback
     def async_set_targets(self, intent_targets: list[IntentResponseTarget]) -> None: ...
+    @callback
     def async_set_results(self, success_results: list[IntentResponseTarget], failed_results: list[IntentResponseTarget] | None = None) -> None: ...
+    @callback
     def async_set_states(self, matched_states: list[State], unmatched_states: list[State] | None = None) -> None: ...
+    @callback
     def async_set_speech_slots(self, speech_slots: dict[str, Any]) -> None: ...
+    @callback
     def as_dict(self) -> dict[str, Any]: ...

homeassistant-stubs/helpers/issue_registry.pyi CHANGED Viewed

@@ -53,18 +53,28 @@ class IssueRegistry(BaseRegistry):
     issues: dict[tuple[str, str], IssueEntry]
     _store: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_get_issue(self, domain: str, issue_id: str) -> IssueEntry | None: ...
+    @callback
     def async_get_or_create(self, domain: str, issue_id: str, *, breaks_in_ha_version: str | None = None, data: dict[str, str | int | float | None] | None = None, is_fixable: bool, is_persistent: bool, issue_domain: str | None = None, learn_more_url: str | None = None, severity: IssueSeverity, translation_key: str, translation_placeholders: dict[str, str] | None = None) -> IssueEntry: ...
+    @callback
     def async_delete(self, domain: str, issue_id: str) -> None: ...
+    @callback
     def async_ignore(self, domain: str, issue_id: str, ignore: bool) -> IssueEntry: ...
+    @callback
     def make_read_only(self) -> None: ...
     async def async_load(self) -> None: ...
+    @callback
     def _data_to_save(self) -> dict[str, list[dict[str, str | None]]]: ...
+@callback
 def async_get(hass: HomeAssistant) -> IssueRegistry: ...
 async def async_load(hass: HomeAssistant, *, read_only: bool = False) -> None: ...
+@callback
 def async_create_issue(hass: HomeAssistant, domain: str, issue_id: str, *, breaks_in_ha_version: str | None = None, data: dict[str, str | int | float | None] | None = None, is_fixable: bool, is_persistent: bool = False, issue_domain: str | None = None, learn_more_url: str | None = None, severity: IssueSeverity, translation_key: str, translation_placeholders: dict[str, str] | None = None) -> None: ...
 def create_issue(hass: HomeAssistant, domain: str, issue_id: str, *, breaks_in_ha_version: str | None = None, data: dict[str, str | int | float | None] | None = None, is_fixable: bool, is_persistent: bool = False, issue_domain: str | None = None, learn_more_url: str | None = None, severity: IssueSeverity, translation_key: str, translation_placeholders: dict[str, str] | None = None) -> None: ...
+@callback
 def async_delete_issue(hass: HomeAssistant, domain: str, issue_id: str) -> None: ...
 def delete_issue(hass: HomeAssistant, domain: str, issue_id: str) -> None: ...
+@callback
 def async_ignore_issue(hass: HomeAssistant, domain: str, issue_id: str, ignore: bool) -> None: ...

homeassistant-stubs/helpers/label_registry.pyi CHANGED Viewed

@@ -51,15 +51,23 @@ class LabelRegistry(BaseRegistry[LabelRegistryStoreData]):
     hass: Incomplete
     _store: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_get_label(self, label_id: str) -> LabelEntry | None: ...
+    @callback
     def async_get_label_by_name(self, name: str) -> LabelEntry | None: ...
+    @callback
     def async_list_labels(self) -> Iterable[LabelEntry]: ...
     def _generate_id(self, name: str) -> str: ...
+    @callback
     def async_create(self, name: str, *, color: str | None = None, icon: str | None = None, description: str | None = None) -> LabelEntry: ...
+    @callback
     def async_delete(self, label_id: str) -> None: ...
+    @callback
     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: ...
+    @callback
     def _data_to_save(self) -> LabelRegistryStoreData: ...
+@callback
 def async_get(hass: HomeAssistant) -> LabelRegistry: ...
 async def async_load(hass: HomeAssistant) -> None: ...

homeassistant-stubs/helpers/llm.pyi CHANGED Viewed

@@ -25,10 +25,14 @@ LLM_API_ASSIST: str
 BASE_PROMPT: str
 DEFAULT_INSTRUCTIONS_PROMPT: str
+@callback
 def async_render_no_api_prompt(hass: HomeAssistant) -> str: ...
+@callback
 def _async_get_apis(hass: HomeAssistant) -> dict[str, API]: ...
+@callback
 def async_register_api(hass: HomeAssistant, api: API) -> None: ...
 async def async_get_api(hass: HomeAssistant, api_id: str, llm_context: LLMContext) -> APIInstance: ...
+@callback
 def async_get_apis(hass: HomeAssistant) -> list[API]: ...
 @dataclass(slots=True)
@@ -83,7 +87,9 @@ class AssistAPI(API):
     cached_slugify: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
     async def async_get_api_instance(self, llm_context: LLMContext) -> APIInstance: ...
+    @callback
     def _async_get_api_prompt(self, llm_context: LLMContext, exposed_entities: dict | None) -> str: ...
+    @callback
     def _async_get_tools(self, llm_context: LLMContext, exposed_entities: dict | None) -> list[Tool]: ...
 def _get_exposed_entities(hass: HomeAssistant, assistant: str) -> dict[str, dict[str, Any]]: ...

homeassistant-stubs/helpers/network.pyi CHANGED Viewed

@@ -12,12 +12,18 @@ SUPERVISOR_NETWORK_HOST: str
 class NoURLAvailableError(HomeAssistantError): ...
+@bind_hass
 def is_internal_request(hass: HomeAssistant) -> bool: ...
+@bind_hass
 def get_supervisor_network_url(hass: HomeAssistant, *, allow_ssl: bool = False) -> str | None: ...
 def is_hass_url(hass: HomeAssistant, url: str) -> bool: ...
+@bind_hass
 def get_url(hass: HomeAssistant, *, require_current_request: bool = False, require_ssl: bool = False, require_standard_port: bool = False, require_cloud: bool = False, allow_internal: bool = True, allow_external: bool = True, allow_cloud: bool = True, allow_ip: bool | None = None, prefer_external: bool | None = None, prefer_cloud: bool = False) -> str: ...
 def _get_request_host() -> str | None: ...
+@bind_hass
 def _get_internal_url(hass: HomeAssistant, *, allow_ip: bool = True, require_current_request: bool = False, require_ssl: bool = False, require_standard_port: bool = False) -> str: ...
+@bind_hass
 def _get_external_url(hass: HomeAssistant, *, allow_cloud: bool = True, allow_ip: bool = True, prefer_cloud: bool = False, require_current_request: bool = False, require_ssl: bool = False, require_standard_port: bool = False, require_cloud: bool = False) -> str: ...
+@bind_hass
 def _get_cloud_url(hass: HomeAssistant, require_current_request: bool = False) -> str: ...
 def is_cloud_connection(hass: HomeAssistant) -> bool: ...

homeassistant-stubs/helpers/ratelimit.pyi CHANGED Viewed

@@ -10,8 +10,13 @@ class KeyedRateLimit:
     _last_triggered: dict[Hashable, float]
     _rate_limit_timers: dict[Hashable, asyncio.TimerHandle]
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_has_timer(self, key: Hashable) -> bool: ...
+    @callback
     def async_triggered(self, key: Hashable, now: float | None = None) -> None: ...
+    @callback
     def async_cancel_timer(self, key: Hashable) -> None: ...
+    @callback
     def async_remove(self) -> None: ...
+    @callback
     def async_schedule_action[*_Ts](self, key: Hashable, rate_limit: float | None, now: float, action: Callable[[*_Ts], None], *args: *_Ts) -> float | None: ...

homeassistant-stubs/helpers/recorder.pyi CHANGED Viewed

@@ -1,6 +1,7 @@
 import asyncio
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Generator
+from contextlib import contextmanager
 from dataclasses import dataclass, field
 from homeassistant.components.recorder import Recorder as Recorder
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
@@ -17,9 +18,13 @@ class RecorderData:
     recorder_platforms: dict[str, Any] = field(default_factory=dict)
     db_connected: asyncio.Future[bool] = field(default_factory=asyncio.Future)
+@callback
 def async_migration_in_progress(hass: HomeAssistant) -> bool: ...
+@callback
 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/registry.pyi CHANGED Viewed

@@ -24,6 +24,8 @@ class BaseRegistryItems[_DataT](UserDict[str, _DataT], ABC, metaclass=abc.ABCMet
 class BaseRegistry[_StoreDataT: Mapping[str, Any] | Sequence[Any]](ABC, metaclass=abc.ABCMeta):
     hass: HomeAssistant
     _store: Store[_StoreDataT]
+    @callback
     def async_schedule_save(self) -> None: ...
+    @callback
     @abstractmethod
     def _data_to_save(self) -> _StoreDataT: ...

homeassistant-stubs/helpers/reload.pyi CHANGED Viewed

@@ -25,6 +25,7 @@ async def async_integration_yaml_config(hass: HomeAssistant, integration_name: s
 async def async_integration_yaml_config(hass: HomeAssistant, integration_name: str, *, raise_on_failure: Literal[True]) -> ConfigType: ...
 @overload
 async def async_integration_yaml_config(hass: HomeAssistant, integration_name: str, *, raise_on_failure: Literal[False]) -> ConfigType | None: ...
+@callback
 def async_get_platform_without_config_entry(hass: HomeAssistant, integration_name: str, integration_platform_name: str) -> EntityPlatform | None: ...
 async def async_setup_reload_service(hass: HomeAssistant, domain: str, platforms: Iterable[str]) -> None: ...
 def setup_reload_service(hass: HomeAssistant, domain: str, platforms: Iterable[str]) -> None: ...

homeassistant-stubs/helpers/restore_state.pyi CHANGED Viewed

@@ -41,6 +41,7 @@ class StoredState:
     def from_dict(cls, json_dict: dict) -> Self: ...
 async def async_load(hass: HomeAssistant) -> None: ...
+@callback
 def async_get(hass: HomeAssistant) -> RestoreStateData: ...
 class RestoreStateData:
@@ -53,15 +54,20 @@ class RestoreStateData:
     def __init__(self, hass: HomeAssistant) -> None: ...
     async def async_setup(self) -> None: ...
     async def async_load(self) -> None: ...
+    @callback
     def async_get_stored_states(self) -> list[StoredState]: ...
     async def async_dump_states(self) -> None: ...
+    @callback
     def async_setup_dump(self, *args: Any) -> None: ...
+    @callback
     def async_restore_entity_added(self, entity: RestoreEntity) -> None: ...
+    @callback
     def async_restore_entity_removed(self, entity_id: str, extra_data: ExtraStoredData | None) -> None: ...
 class RestoreEntity(Entity):
     async def async_internal_added_to_hass(self) -> None: ...
     async def async_internal_will_remove_from_hass(self) -> None: ...
+    @callback
     def _async_get_restored_data(self) -> StoredState | None: ...
     async def async_get_last_state(self) -> State | None: ...
     async def async_get_last_extra_data(self) -> ExtraStoredData | None: ...

homeassistant-stubs/helpers/schema_config_entry_flow.pyi CHANGED Viewed

@@ -57,14 +57,19 @@ class SchemaConfigFlowHandler(ConfigFlow, ABC, metaclass=abc.ABCMeta):
     @staticmethod
     async def async_setup_preview(hass: HomeAssistant) -> None: ...
     @classmethod
+    @callback
     def async_supports_options_flow(cls, config_entry: ConfigEntry) -> bool: ...
     @staticmethod
     def _async_step(step_id: str) -> Callable[[SchemaConfigFlowHandler, dict[str, Any] | None], Coroutine[Any, Any, ConfigFlowResult]]: ...
     @abstractmethod
+    @callback
     def async_config_entry_title(self, options: Mapping[str, Any]) -> str: ...
+    @callback
     def async_config_flow_finished(self, options: Mapping[str, Any]) -> None: ...
+    @callback
     @staticmethod
     def async_options_flow_finished(hass: HomeAssistant, options: Mapping[str, Any]) -> None: ...
+    @callback
     def async_create_entry(self, data: Mapping[str, Any], **kwargs: Any) -> ConfigFlowResult: ...
 class SchemaOptionsFlowHandler(OptionsFlow):
@@ -76,7 +81,10 @@ class SchemaOptionsFlowHandler(OptionsFlow):
     def options(self) -> dict[str, Any]: ...
     @staticmethod
     def _async_step(step_id: str) -> Callable[[SchemaConfigFlowHandler, dict[str, Any] | None], Coroutine[Any, Any, ConfigFlowResult]]: ...
+    @callback
     def async_create_entry(self, data: Mapping[str, Any], **kwargs: Any) -> ConfigFlowResult: ...
+@callback
 def wrapped_entity_config_entry_title(hass: HomeAssistant, entity_id_or_uuid: str) -> str: ...
+@callback
 def entity_selector_without_own_entities(handler: SchemaOptionsFlowHandler, entity_selector_config: selector.EntitySelectorConfig) -> selector.EntitySelector: ...

homeassistant-stubs 2025.1.2__py3-none-any.whl → 2025.1.4__py3-none-any.whl

homeassistant-stubs 2025.1.2py3-none-any.whl → 2025.1.4py3-none-any.whl