homeassistant-stubs 2024.3.3__py3-none-any.whl → 2024.4.0__py3-none-any.whl

homeassistant-stubs/loader.pyi

@@ -2,6 +2,7 @@ import pathlib
 import voluptuous as vol
 from . import generated as generated
 from .config_entries import ConfigEntry as ConfigEntry
+from .const import Platform as Platform
 from .core import HomeAssistant as HomeAssistant, callback as callback
 from .generated.application_credentials import APPLICATION_CREDENTIALS as APPLICATION_CREDENTIALS
 from .generated.bluetooth import BLUETOOTH as BLUETOOTH
@@ -24,6 +25,7 @@ from typing import Any, Literal, Protocol, TypeVar, TypedDict
 
 _CallableT = TypeVar('_CallableT', bound=Callable[..., Any])
 _LOGGER: Incomplete
+BASE_PRELOAD_PLATFORMS: Incomplete
 
 @dataclass
 class BlockedIntegration:
@@ -36,11 +38,12 @@ DATA_COMPONENTS: str
 DATA_INTEGRATIONS: str
 DATA_MISSING_PLATFORMS: str
 DATA_CUSTOM_COMPONENTS: str
+DATA_PRELOAD_PLATFORMS: str
 PACKAGE_CUSTOM_COMPONENTS: str
 PACKAGE_BUILTIN: str
 CUSTOM_WARNING: str
+IMPORT_EVENT_LOOP_WARNING: str
 _UNDEF: Incomplete
-MAX_LOAD_CONCURRENTLY: int
 MOVED_ZEROCONF_PROPS: Incomplete
 
 class DHCPMatcherRequired(TypedDict, total=True):
@@ -93,7 +96,7 @@ class Manifest(TypedDict, total=False):
     name: str
     disabled: str
     domain: str
-    integration_type: Literal['entity', 'device', 'hardware', 'helper', 'hub', 'service', 'system']
+    integration_type: Literal['entity', 'device', 'hardware', 'helper', 'hub', 'service', 'system', 'virtual']
     dependencies: list[str]
     after_dependencies: list[str]
     requirements: list[str]
@@ -145,6 +148,7 @@ def homekit_always_discover(iot_class: str | None) -> bool: ...
 async def async_get_homekit(hass: HomeAssistant) -> dict[str, HomeKitDiscoveredIntegration]: ...
 async def async_get_ssdp(hass: HomeAssistant) -> dict[str, list[dict[str, str]]]: ...
 async def async_get_mqtt(hass: HomeAssistant) -> dict[str, list[str]]: ...
+def async_register_preload_platform(hass: HomeAssistant, platform_name: str) -> None: ...
 
 class Integration:
     @classmethod
@@ -155,8 +159,13 @@ class Integration:
     manifest: Incomplete
     _all_dependencies_resolved: Incomplete
     _all_dependencies: Incomplete
+    _platforms_to_preload: Incomplete
+    _component_future: Incomplete
     _import_futures: Incomplete
-    def __init__(self, hass: HomeAssistant, pkg_path: str, file_path: pathlib.Path, manifest: Manifest) -> None: ...
+    _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 name(self) -> str: ...
     @cached_property
@@ -182,9 +191,13 @@ class Integration:
     @cached_property
     def iot_class(self) -> str | None: ...
     @cached_property
-    def integration_type(self) -> Literal['entity', 'device', 'hardware', 'helper', 'hub', 'service', 'system']: ...
+    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: ...
     @property
@@ -212,9 +225,15 @@ class Integration:
     async def resolve_dependencies(self) -> bool: ...
     async def async_get_component(self) -> ComponentProtocol: ...
     def get_component(self) -> ComponentProtocol: ...
+    def _get_component(self, preload_platforms: bool = False) -> ComponentProtocol: ...
+    def _load_platforms(self, platform_names: Iterable[str]) -> dict[str, ModuleType]: ...
     async def async_get_platform(self, platform_name: str) -> ModuleType: ...
-    def _get_platform_cached(self, full_name: str) -> ModuleType | None: ...
+    async def async_get_platforms(self, platform_names: Iterable[Platform | str]) -> dict[str, ModuleType]: ...
+    def _get_platform_cached_or_raise(self, platform_name: str) -> ModuleType | None: ...
+    def platforms_are_loaded(self, platform_names: Iterable[str]) -> bool: ...
+    def get_platform_cached(self, platform_name: str) -> ModuleType | None: ...
     def get_platform(self, platform_name: str) -> ModuleType: ...
+    def platforms_exists(self, platform_names: Iterable[str]) -> list[str]: ...
     def _load_platform(self, platform_name: str) -> ModuleType: ...
     def _import_platform(self, platform_name: str) -> ModuleType: ...
     def __repr__(self) -> str: ...

homeassistant-stubs/setup.pyi

@@ -1,17 +1,20 @@
+import contextvars
 from . import core as core, loader as loader, requirements as requirements
 from .const import EVENT_COMPONENT_LOADED as EVENT_COMPONENT_LOADED, EVENT_HOMEASSISTANT_START as EVENT_HOMEASSISTANT_START, PLATFORM_FORMAT as PLATFORM_FORMAT, Platform as Platform
 from .core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from .exceptions import DependencyError as DependencyError, HomeAssistantError as HomeAssistantError
 from .helpers import translation as translation
 from .helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue
-from .helpers.typing import ConfigType as ConfigType, EventType as EventType
-from .util import ensure_unique_string as ensure_unique_string
+from .helpers.typing import ConfigType as ConfigType
 from .util.async_ import create_eager_task as create_eager_task
 from _typeshed import Incomplete
-from collections.abc import Awaitable, Callable as Callable, Generator, Iterable
+from collections import defaultdict
+from collections.abc import Awaitable, Callable as Callable, Generator
+from enum import StrEnum
 from types import ModuleType
 from typing import Final, TypedDict
 
+current_setup_group: contextvars.ContextVar[tuple[str, str | None] | None]
 _LOGGER: Incomplete
 ATTR_COMPONENT: Final[str]
 BASE_PLATFORMS: Incomplete
@@ -40,4 +43,18 @@ def async_when_setup(hass: core.HomeAssistant, component: str, when_setup_cb: Ca
 def async_when_setup_or_start(hass: core.HomeAssistant, component: str, when_setup_cb: Callable[[core.HomeAssistant, str], Awaitable[None]]) -> None: ...
 def _async_when_setup(hass: core.HomeAssistant, component: str, when_setup_cb: Callable[[core.HomeAssistant, str], Awaitable[None]], start_event: bool) -> None: ...
 def async_get_loaded_integrations(hass: core.HomeAssistant) -> set[str]: ...
-def async_start_setup(hass: core.HomeAssistant, components: Iterable[str]) -> Generator[None, None, None]: ...
+
+class SetupPhases(StrEnum):
+    SETUP: str
+    CONFIG_ENTRY_SETUP: str
+    PLATFORM_SETUP: str
+    CONFIG_ENTRY_PLATFORM_SETUP: str
+    WAIT_BASE_PLATFORM_SETUP: str
+    WAIT_IMPORT_PLATFORMS: str
+    WAIT_IMPORT_PACKAGES: str
+
+def _setup_started(hass: core.HomeAssistant) -> dict[tuple[str, str | None], float]: ...
+def async_pause_setup(hass: core.HomeAssistant, phase: SetupPhases) -> Generator[None, None, None]: ...
+def _setup_times(hass: core.HomeAssistant) -> defaultdict[str, defaultdict[str | None, defaultdict[SetupPhases, float]]]: ...
+def async_start_setup(hass: core.HomeAssistant, integration: str, phase: SetupPhases, group: str | None = None) -> Generator[None, None, None]: ...
+def async_get_setup_timings(hass: core.HomeAssistant) -> dict[str, float]: ...

homeassistant-stubs/util/async_.pyi

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

homeassistant-stubs/util/percentage.pyi

@@ -6,4 +6,4 @@ _T = TypeVar('_T')
 def ordered_list_item_to_percentage(ordered_list: list[_T], item: _T) -> int: ...
 def percentage_to_ordered_list_item(ordered_list: list[_T], percentage: int) -> _T: ...
 def ranged_value_to_percentage(low_high_range: tuple[float, float], value: float) -> int: ...
-def percentage_to_ranged_value(low_high_range: tuple[float, float], percentage: int) -> float: ...
+def percentage_to_ranged_value(low_high_range: tuple[float, float], percentage: float) -> float: ...

homeassistant-stubs/util/signal_type.pyi

@@ -0,0 +1,20 @@
+from dataclasses import dataclass
+from typing import Any, Generic, TypeVarTuple
+
+_Ts = TypeVarTuple('_Ts')
+
+@dataclass(frozen=True)
+class _SignalTypeBase(Generic[*_Ts]):
+    name: str
+    def __hash__(self) -> int: ...
+    def __eq__(self, other: Any) -> bool: ...
+    def __init__(self, name) -> None: ...
+
+@dataclass(frozen=True, eq=False)
+class SignalType(_SignalTypeBase[*_Ts]):
+    def __init__(self, name) -> None: ...
+
+@dataclass(frozen=True, eq=False)
+class SignalTypeFormat(_SignalTypeBase[*_Ts]):
+    def format(self, *args: Any, **kwargs: Any) -> SignalType[Unpack[_Ts]]: ...
+    def __init__(self, name) -> None: ...

homeassistant-stubs/util/unit_conversion.pyi

@@ -101,6 +101,16 @@ class SpeedConverter(BaseUnitConverter):
     NORMALIZED_UNIT: Incomplete
     _UNIT_CONVERSION: dict[str | None, float]
     VALID_UNITS: Incomplete
+    @classmethod
+    def converter_factory(cls, from_unit: str | None, to_unit: str | None) -> Callable[[float], float]: ...
+    @classmethod
+    def converter_factory_allow_none(cls, from_unit: str | None, to_unit: str | None) -> Callable[[float | None], float | None]: ...
+    @classmethod
+    def _converter_factory(cls, from_unit: str | None, to_unit: str | None) -> Callable[[float], float]: ...
+    @classmethod
+    def _ms_to_beaufort(cls, ms: float) -> float: ...
+    @classmethod
+    def _beaufort_to_ms(cls, beaufort: float) -> float: ...
 
 class TemperatureConverter(BaseUnitConverter):
     UNIT_CLASS: str

{homeassistant_stubs-2024.3.3.dist-info → homeassistant_stubs-2024.4.0.dist-info}/METADATA

@@ -1,23 +1,22 @@
 Metadata-Version: 2.1
 Name: homeassistant-stubs
-Version: 2024.3.3
+Version: 2024.4.0
 Summary: PEP 484 typing stubs for Home Assistant Core
 Home-page: https://github.com/KapJI/homeassistant-stubs
 License: MIT
 Keywords: homeassistant,typing,pep484
 Author: Ruslan Sayfutdinov
 Author-email: ruslan@sayfutdinov.com
-Requires-Python: >=3.11,<3.13
+Requires-Python: >=3.12,<3.13
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development
 Classifier: Typing :: Typed
-Requires-Dist: homeassistant (==2024.3.3)
+Requires-Dist: homeassistant (==2024.4.0)
 Project-URL: Bug Tracker, https://github.com/KapJI/homeassistant-stubs/issues
 Project-URL: Repository, https://github.com/KapJI/homeassistant-stubs
 Project-URL: Release Notes, https://github.com/KapJI/homeassistant-stubs/releases