homeassistant-stubs 2025.1.0b9__py3-none-any.whl → 2025.1.2__py3-none-any.whl

homeassistant-stubs/helpers/trigger_template_entity.pyi

@@ -28,8 +28,8 @@ class TriggerBaseEntity(Entity):
     hass: Incomplete
     _config: Incomplete
     _static_rendered: Incomplete
-    _to_render_simple: Incomplete
-    _to_render_complex: Incomplete
+    _to_render_simple: list[str]
+    _to_render_complex: list[str]
     _rendered: Incomplete
     _parse_result: Incomplete
     _attr_device_class: Incomplete

homeassistant-stubs/helpers/update_coordinator.pyi

@@ -1,4 +1,5 @@
 import abc
+import asyncio
 import logging
 from . import entity as entity, event as event
 from .debounce import Debouncer as Debouncer
@@ -13,6 +14,7 @@ from homeassistant.const import EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, ConfigEntryError as ConfigEntryError, ConfigEntryNotReady as ConfigEntryNotReady, HomeAssistantError as HomeAssistantError
 from homeassistant.util.dt import utcnow as utcnow
+from propcache import cached_property
 from typing import Any, Generic, Protocol
 from typing_extensions import TypeVar
 
@@ -32,18 +34,18 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     name: Incomplete
     update_method: Incomplete
     setup_method: Incomplete
-    _update_interval_seconds: Incomplete
+    _update_interval_seconds: float | None
     _shutdown_requested: bool
     config_entry: Incomplete
     always_update: Incomplete
-    data: Incomplete
+    data: _DataT
     _microsecond: Incomplete
-    _listeners: Incomplete
-    _unsub_refresh: Incomplete
-    _unsub_shutdown: Incomplete
-    _request_refresh_task: Incomplete
+    _listeners: dict[CALLBACK_TYPE, tuple[CALLBACK_TYPE, object | None]]
+    _unsub_refresh: CALLBACK_TYPE | None
+    _unsub_shutdown: CALLBACK_TYPE | None
+    _request_refresh_task: asyncio.TimerHandle | None
     last_update_success: bool
-    last_exception: Incomplete
+    last_exception: Exception | None
     _debounced_refresh: Incomplete
     def __init__(self, hass: HomeAssistant, logger: logging.Logger, *, config_entry: config_entries.ConfigEntry | None | UndefinedType = ..., name: str, update_interval: timedelta | None = None, update_method: Callable[[], Awaitable[_DataT]] | None = None, setup_method: Callable[[], Awaitable[None]] | None = None, request_refresh_debouncer: Debouncer[Coroutine[Any, Any, None]] | None = None, always_update: bool = True) -> None: ...
     async def async_register_shutdown(self) -> None: ...
@@ -81,6 +83,7 @@ class BaseCoordinatorEntity[_BaseDataUpdateCoordinatorT: BaseDataUpdateCoordinat
     coordinator: Incomplete
     coordinator_context: Incomplete
     def __init__(self, coordinator: _BaseDataUpdateCoordinatorT, context: Any = None) -> None: ...
+    @cached_property
     def should_poll(self) -> bool: ...
     async def async_added_to_hass(self) -> None: ...
     def _handle_coordinator_update(self) -> None: ...

homeassistant-stubs/loader.pyi

@@ -22,6 +22,7 @@ from _typeshed import Incomplete
 from awesomeversion import AwesomeVersion
 from collections.abc import Callable as Callable, Iterable
 from dataclasses import dataclass
+from propcache import cached_property
 from types import ModuleType
 from typing import Any, Literal, Protocol, TypedDict
 
@@ -32,7 +33,6 @@ BASE_PRELOAD_PLATFORMS: Incomplete
 class BlockedIntegration:
     lowest_good_version: AwesomeVersion | None
     reason: str
-    def __init__(self, lowest_good_version, reason) -> None: ...
 
 BLOCKED_CUSTOM_INTEGRATIONS: dict[str, BlockedIntegration]
 DATA_COMPONENTS: HassKey[dict[str, ModuleType | ComponentProtocol]]
@@ -85,7 +85,6 @@ class USBMatcher(USBMatcherRequired, USBMatcherOptional): ...
 class HomeKitDiscoveredIntegration:
     domain: str
     always_discover: bool
-    def __init__(self, domain, always_discover) -> None: ...
 
 class ZeroconfMatcher(TypedDict, total=False):
     domain: str
@@ -158,31 +157,48 @@ class Integration:
     pkg_path: Incomplete
     file_path: Incomplete
     manifest: Incomplete
-    _all_dependencies_resolved: Incomplete
-    _all_dependencies: Incomplete
+    _all_dependencies_resolved: bool | None
+    _all_dependencies: set[str] | None
     _platforms_to_preload: Incomplete
-    _component_future: Incomplete
-    _import_futures: Incomplete
+    _component_future: asyncio.Future[ComponentProtocol] | None
+    _import_futures: dict[str, asyncio.Future[ModuleType]]
     _cache: Incomplete
     _missing_platforms_cache: Incomplete
     _top_level_files: Incomplete
     def __init__(self, hass: HomeAssistant, pkg_path: str, file_path: pathlib.Path, manifest: Manifest, top_level_files: set[str] | None = None) -> None: ...
+    @cached_property
     def manifest_json_fragment(self) -> json_fragment: ...
+    @cached_property
     def name(self) -> str: ...
+    @cached_property
     def disabled(self) -> str | None: ...
+    @cached_property
     def domain(self) -> str: ...
+    @cached_property
     def dependencies(self) -> list[str]: ...
+    @cached_property
     def after_dependencies(self) -> list[str]: ...
+    @cached_property
     def requirements(self) -> list[str]: ...
+    @cached_property
     def config_flow(self) -> bool: ...
+    @cached_property
     def documentation(self) -> str | None: ...
+    @cached_property
     def issue_tracker(self) -> str | None: ...
+    @cached_property
     def loggers(self) -> list[str] | None: ...
+    @cached_property
     def quality_scale(self) -> str | None: ...
+    @cached_property
     def iot_class(self) -> str | None: ...
+    @cached_property
     def integration_type(self) -> Literal['entity', 'device', 'hardware', 'helper', 'hub', 'service', 'system', 'virtual']: ...
+    @cached_property
     def import_executor(self) -> bool: ...
+    @cached_property
     def has_translations(self) -> bool: ...
+    @cached_property
     def has_services(self) -> bool: ...
     @property
     def mqtt(self) -> list[str] | None: ...
@@ -204,6 +220,7 @@ class Integration:
     def overwrites_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]: ...

homeassistant-stubs/requirements.pyi

@@ -1,3 +1,4 @@
+import asyncio
 from .core import HomeAssistant as HomeAssistant, callback as callback
 from .exceptions import HomeAssistantError as HomeAssistantError
 from .helpers import singleton as singleton
@@ -30,9 +31,9 @@ def _install_requirements_if_missing(requirements: list[str], kwargs: dict[str,
 class RequirementsManager:
     hass: Incomplete
     pip_lock: Incomplete
-    integrations_with_reqs: Incomplete
-    install_failure_history: Incomplete
-    is_installed_cache: Incomplete
+    integrations_with_reqs: dict[str, Integration | asyncio.Future[Integration]]
+    install_failure_history: set[str]
+    is_installed_cache: set[str]
     def __init__(self, hass: HomeAssistant) -> None: ...
     async def async_get_integration_with_requirements(self, domain: str, done: set[str] | None = None) -> Integration: ...
     async def _async_process_integration(self, integration: Integration, done: set[str]) -> None: ...

homeassistant-stubs/runner.pyi

@@ -16,7 +16,7 @@ _LOGGER: Incomplete
 class RuntimeConfig:
     config_dir: str
     skip_pip: bool = ...
-    skip_pip_packages: list[str] = ...
+    skip_pip_packages: list[str] = dataclasses.field(default_factory=list)
     recovery_mode: bool = ...
     verbose: bool = ...
     log_rotate_days: int | None = ...
@@ -25,7 +25,6 @@ class RuntimeConfig:
     debug: bool = ...
     open_ui: bool = ...
     safe_mode: bool = ...
-    def __init__(self, config_dir, skip_pip=..., skip_pip_packages=..., recovery_mode=..., verbose=..., log_rotate_days=..., log_file=..., log_no_color=..., debug=..., open_ui=..., safe_mode=...) -> None: ...
 
 class HassEventLoopPolicy(asyncio.DefaultEventLoopPolicy):
     debug: Incomplete

homeassistant-stubs/util/aiohttp.pyi

@@ -2,7 +2,7 @@ from .json import json_loads as json_loads
 from _typeshed import Incomplete
 from aiohttp import web as web
 from aiohttp.typedefs import JSONDecoder as JSONDecoder
-from multidict import MultiDict
+from multidict import CIMultiDict, MultiDict
 from typing import Any
 
 class MockStreamReader:
@@ -21,7 +21,7 @@ class MockRequest:
     method: Incomplete
     url: Incomplete
     status: Incomplete
-    headers: Incomplete
+    headers: CIMultiDict[str]
     query_string: Incomplete
     keep_alive: bool
     version: Incomplete

homeassistant-stubs/util/async_.pyi

@@ -9,7 +9,7 @@ _SHUTDOWN_RUN_CALLBACK_THREADSAFE: str
 
 def create_eager_task[_T](coro: Coroutine[Any, Any, _T], *, name: str | None = None, loop: AbstractEventLoop | None = None) -> Task[_T]: ...
 def cancelling(task: Future[Any]) -> bool: ...
-def run_callback_threadsafe[_T, *_Ts](loop: AbstractEventLoop, callback: Callable[[Unpack[_Ts]], _T], *args: Unpack[_Ts]) -> concurrent.futures.Future[_T]: ...
+def run_callback_threadsafe[_T, *_Ts](loop: AbstractEventLoop, callback: Callable[[*_Ts], _T], *args: *_Ts) -> concurrent.futures.Future[_T]: ...
 async def gather_with_limited_concurrency(limit: int, *tasks: Any, return_exceptions: bool = False) -> Any: ...
 def shutdown_run_callback_threadsafe(loop: AbstractEventLoop) -> None: ...
 def get_scheduled_timer_handles(loop: AbstractEventLoop) -> list[TimerHandle]: ...

homeassistant-stubs/util/frozen_dataclass_compat.pyi

@@ -1,7 +1,9 @@
-from typing import Any
+import dataclasses
+from typing import Any, dataclass_transform
 
 def _class_fields(cls, kw_only: bool) -> list[tuple[str, Any, Any]]: ...
 
+@dataclass_transform(field_specifiers=(dataclasses.field, dataclasses.Field), frozen_default=True, kw_only_default=True)
 class FrozenOrThawed(type):
     def _make_dataclass(cls, name: str, bases: tuple[type, ...], kw_only: bool) -> None: ...
     def __new__(mcs, name: str, bases: tuple[type, ...], namespace: dict[Any, Any], frozen_or_thawed: bool = False, **kwargs: Any) -> Any: ...

homeassistant-stubs/util/language.pyi

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

homeassistant-stubs/util/logging.pyi

@@ -10,13 +10,13 @@ class HomeAssistantQueueHandler(logging.handlers.QueueHandler):
     def close(self) -> None: ...
 
 def async_activate_log_queue_handler(hass: HomeAssistant) -> None: ...
-def log_exception[*_Ts](format_err: Callable[[Unpack[_Ts]], Any], *args: Unpack[_Ts]) -> None: ...
-async def _async_wrapper[*_Ts](async_func: Callable[[Unpack[_Ts]], Coroutine[Any, Any, None]], format_err: Callable[[Unpack[_Ts]], Any], *args: Unpack[_Ts]) -> None: ...
-def _sync_wrapper[*_Ts](func: Callable[[Unpack[_Ts]], Any], format_err: Callable[[Unpack[_Ts]], Any], *args: Unpack[_Ts]) -> None: ...
-def _callback_wrapper[*_Ts](func: Callable[[Unpack[_Ts]], Any], format_err: Callable[[Unpack[_Ts]], Any], *args: Unpack[_Ts]) -> None: ...
+def log_exception[*_Ts](format_err: Callable[[*_Ts], Any], *args: *_Ts) -> None: ...
+async def _async_wrapper[*_Ts](async_func: Callable[[*_Ts], Coroutine[Any, Any, None]], format_err: Callable[[*_Ts], Any], *args: *_Ts) -> None: ...
+def _sync_wrapper[*_Ts](func: Callable[[*_Ts], Any], format_err: Callable[[*_Ts], Any], *args: *_Ts) -> None: ...
+def _callback_wrapper[*_Ts](func: Callable[[*_Ts], Any], format_err: Callable[[*_Ts], Any], *args: *_Ts) -> None: ...
 @overload
-def catch_log_exception[*_Ts](func: Callable[[Unpack[_Ts]], Coroutine[Any, Any, Any]], format_err: Callable[[Unpack[_Ts]], Any], job_type: HassJobType | None = None) -> Callable[[Unpack[_Ts]], Coroutine[Any, Any, None]]: ...
+def catch_log_exception[*_Ts](func: Callable[[*_Ts], Coroutine[Any, Any, Any]], format_err: Callable[[*_Ts], Any], job_type: HassJobType | None = None) -> Callable[[*_Ts], Coroutine[Any, Any, None]]: ...
 @overload
-def catch_log_exception[*_Ts](func: Callable[[Unpack[_Ts]], Any], format_err: Callable[[Unpack[_Ts]], Any], job_type: HassJobType | None = None) -> Callable[[Unpack[_Ts]], None] | Callable[[Unpack[_Ts]], Coroutine[Any, Any, None]]: ...
-def catch_log_coro_exception[_T, *_Ts](target: Coroutine[Any, Any, _T], format_err: Callable[[Unpack[_Ts]], Any], *args: Unpack[_Ts]) -> Coroutine[Any, Any, _T | None]: ...
+def catch_log_exception[*_Ts](func: Callable[[*_Ts], Any], format_err: Callable[[*_Ts], Any], job_type: HassJobType | None = None) -> Callable[[*_Ts], None] | Callable[[*_Ts], Coroutine[Any, Any, None]]: ...
+def catch_log_coro_exception[_T, *_Ts](target: Coroutine[Any, Any, _T], format_err: Callable[[*_Ts], Any], *args: *_Ts) -> Coroutine[Any, Any, _T | None]: ...
 def async_create_catching_coro[_T](target: Coroutine[Any, Any, _T]) -> Coroutine[Any, Any, _T | None]: ...

homeassistant-stubs/util/signal_type.pyi

@@ -10,4 +10,4 @@ class _SignalTypeBase[*_Ts]:
 class SignalType[*_Ts](_SignalTypeBase[*_Ts]): ...
 
 class SignalTypeFormat[*_Ts](_SignalTypeBase[*_Ts]):
-    def format(self, *args: Any, **kwargs: Any) -> SignalType[Unpack[_Ts]]: ...
+    def format(self, *args: Any, **kwargs: Any) -> SignalType[*_Ts]: ...

homeassistant-stubs/util/timeout.pyi

@@ -1,7 +1,6 @@
 import asyncio
 import enum
 from .async_ import run_callback_threadsafe as run_callback_threadsafe
-from _typeshed import Incomplete
 from types import TracebackType
 from typing import Any, Self
 
@@ -14,8 +13,8 @@ class _State(enum.Enum):
     EXIT = 'EXIT'
 
 class _GlobalFreezeContext:
-    _loop: Incomplete
-    _manager: Incomplete
+    _loop: asyncio.AbstractEventLoop
+    _manager: TimeoutManager
     def __init__(self, manager: TimeoutManager) -> None: ...
     async def __aenter__(self) -> Self: ...
     async def __aexit__(self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: TracebackType | None) -> bool | None: ...
@@ -25,8 +24,8 @@ class _GlobalFreezeContext:
     def _exit(self) -> None: ...
 
 class _ZoneFreezeContext:
-    _loop: Incomplete
-    _zone: Incomplete
+    _loop: asyncio.AbstractEventLoop
+    _zone: _ZoneTimeoutManager
     def __init__(self, zone: _ZoneTimeoutManager) -> None: ...
     async def __aenter__(self) -> Self: ...
     async def __aexit__(self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: TracebackType | None) -> bool | None: ...
@@ -36,16 +35,16 @@ class _ZoneFreezeContext:
     def _exit(self) -> None: ...
 
 class _GlobalTaskContext:
-    _loop: Incomplete
-    _manager: Incomplete
-    _task: Incomplete
-    _time_left: Incomplete
-    _expiration_time: Incomplete
-    _timeout_handler: Incomplete
-    _on_wait_task: Incomplete
-    _wait_zone: Incomplete
-    _state: Incomplete
-    _cool_down: Incomplete
+    _loop: asyncio.AbstractEventLoop
+    _manager: TimeoutManager
+    _task: asyncio.Task[Any]
+    _time_left: float
+    _expiration_time: float | None
+    _timeout_handler: asyncio.Handle | None
+    _on_wait_task: asyncio.Task | None
+    _wait_zone: asyncio.Event
+    _state: _State
+    _cool_down: float
     _cancelling: int
     def __init__(self, manager: TimeoutManager, task: asyncio.Task[Any], timeout: float, cool_down: float) -> None: ...
     async def __aenter__(self) -> Self: ...
@@ -62,13 +61,13 @@ class _GlobalTaskContext:
     async def _on_wait(self) -> None: ...
 
 class _ZoneTaskContext:
-    _loop: Incomplete
-    _zone: Incomplete
-    _task: Incomplete
-    _state: Incomplete
-    _time_left: Incomplete
-    _expiration_time: Incomplete
-    _timeout_handler: Incomplete
+    _loop: asyncio.AbstractEventLoop
+    _zone: _ZoneTimeoutManager
+    _task: asyncio.Task[Any]
+    _state: _State
+    _time_left: float
+    _expiration_time: float | None
+    _timeout_handler: asyncio.Handle | None
     _cancelling: int
     def __init__(self, zone: _ZoneTimeoutManager, task: asyncio.Task[Any], timeout: float) -> None: ...
     @property
@@ -82,10 +81,10 @@ class _ZoneTaskContext:
     def reset(self) -> None: ...
 
 class _ZoneTimeoutManager:
-    _manager: Incomplete
-    _zone: Incomplete
-    _tasks: Incomplete
-    _freezes: Incomplete
+    _manager: TimeoutManager
+    _zone: str
+    _tasks: list[_ZoneTaskContext]
+    _freezes: list[_ZoneFreezeContext]
     def __init__(self, manager: TimeoutManager, zone: str) -> None: ...
     def __repr__(self) -> str: ...
     @property
@@ -102,10 +101,10 @@ class _ZoneTimeoutManager:
     def reset(self) -> None: ...
 
 class TimeoutManager:
-    _loop: Incomplete
-    _zones: Incomplete
-    _globals: Incomplete
-    _freezes: Incomplete
+    _loop: asyncio.AbstractEventLoop
+    _zones: dict[str, _ZoneTimeoutManager]
+    _globals: list[_GlobalTaskContext]
+    _freezes: list[_GlobalFreezeContext]
     def __init__(self) -> None: ...
     @property
     def zones_done(self) -> bool: ...

homeassistant-stubs/util/yaml/loader.pyi

@@ -7,6 +7,7 @@ from collections.abc import Callable as Callable, Iterator
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from io import StringIO
 from pathlib import Path
+from propcache import cached_property
 from typing import Any, TextIO, overload
 from yaml import SafeLoader as FastestAvailableSafeLoader
 
@@ -18,7 +19,7 @@ class YamlTypeError(HomeAssistantError): ...
 
 class Secrets:
     config_dir: Incomplete
-    _cache: Incomplete
+    _cache: dict[Path, dict[str, str]]
     def __init__(self, config_dir: Path) -> None: ...
     def get(self, requester_path: str, secret: str) -> str: ...
     def _load_secret_yaml(self, secret_dir: Path) -> dict[str, str]: ...
@@ -26,7 +27,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/util/yaml/objects.pyi

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

{homeassistant_stubs-2025.1.0b9.dist-info → homeassistant_stubs-2025.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homeassistant-stubs
-Version: 2025.1.0b9
+Version: 2025.1.2
 Summary: PEP 484 typing stubs for Home Assistant Core
 Project-URL: Homepage, https://github.com/KapJI/homeassistant-stubs
 Project-URL: Bug Tracker, https://github.com/KapJI/homeassistant-stubs/issues
@@ -18,7 +18,7 @@ Classifier: Topic :: Home Automation
 Classifier: Topic :: Software Development
 Classifier: Typing :: Typed
 Requires-Python: <3.14,>=3.12
-Requires-Dist: homeassistant==2025.1.0b9
+Requires-Dist: homeassistant==2025.1.2
 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)