homeassistant-stubs 2025.3.3__py3-none-any.whl → 2025.4.0__py3-none-any.whl

homeassistant-stubs/loader.pyi

@@ -15,7 +15,8 @@ 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
+from .helpers.typing import ConfigType as ConfigType, UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
+from .util.async_ import create_eager_task as create_eager_task
 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
@@ -158,8 +159,7 @@ class Integration:
     pkg_path: Incomplete
     file_path: Incomplete
     manifest: Incomplete
-    _all_dependencies_resolved: bool | None
-    _all_dependencies: set[str] | None
+    _all_dependencies: set[str] | Exception | None
     _platforms_to_preload: Incomplete
     _component_future: asyncio.Future[ComponentProtocol] | None
     _import_futures: dict[str, asyncio.Future[ModuleType]]
@@ -227,7 +227,7 @@ class Integration:
     def all_dependencies(self) -> set[str]: ...
     @property
     def all_dependencies_resolved(self) -> bool: ...
-    async def resolve_dependencies(self) -> bool: ...
+    async def resolve_dependencies(self) -> set[str] | None: ...
     async def async_get_component(self) -> ComponentProtocol: ...
     def get_component(self) -> ComponentProtocol: ...
     def _get_component(self, preload_platforms: bool = False) -> ComponentProtocol: ...
@@ -250,6 +250,18 @@ def async_get_loaded_integration(hass: HomeAssistant, domain: str) -> Integratio
 async def async_get_integration(hass: HomeAssistant, domain: str) -> Integration: ...
 async def async_get_integrations(hass: HomeAssistant, domains: Iterable[str]) -> dict[str, Integration | Exception]: ...
 
+class _ResolveDependenciesCacheProtocol(Protocol):
+    def get(self, itg: Integration) -> set[str] | Exception | None: ...
+    def __setitem__(self, itg: Integration, all_dependencies: set[str] | Exception) -> None: ...
+
+class _ResolveDependenciesCache(_ResolveDependenciesCacheProtocol):
+    def get(self, itg: Integration) -> set[str] | Exception | None: ...
+    def __setitem__(self, itg: Integration, all_dependencies: set[str] | Exception) -> None: ...
+
+async def resolve_integrations_dependencies(hass: HomeAssistant, integrations: Iterable[Integration]) -> dict[str, set[str]]: ...
+async def resolve_integrations_after_dependencies(hass: HomeAssistant, integrations: Iterable[Integration], possible_after_dependencies: set[str] | None = None, *, ignore_exceptions: bool = False) -> dict[str, set[str]]: ...
+async def _do_resolve_dependencies(itg: Integration, *, cache: _ResolveDependenciesCacheProtocol, possible_after_dependencies: set[str] | None | UndefinedType = ..., ignore_exceptions: bool = False) -> set[str]: ...
+
 class LoaderError(Exception): ...
 
 class IntegrationNotFound(LoaderError):
@@ -261,9 +273,8 @@ class IntegrationNotLoaded(LoaderError):
     def __init__(self, domain: str) -> None: ...
 
 class CircularDependency(LoaderError):
-    from_domain: Incomplete
-    to_domain: Incomplete
-    def __init__(self, from_domain: str | set[str], to_domain: str) -> None: ...
+    def __init__(self, domain_cycle: list[str]) -> None: ...
+    def extend_cycle(self, domain: str) -> None: ...
 
 def _load_file(hass: HomeAssistant, comp_or_platform: str, base_paths: list[str]) -> ComponentProtocol | None: ...
 
@@ -284,7 +295,6 @@ class Helpers:
     def __getattr__(self, helper_name: str) -> ModuleWrapper: ...
 
 def bind_hass[_CallableT: Callable[..., Any]](func: _CallableT) -> _CallableT: ...
-async def _async_component_dependencies(hass: HomeAssistant, integration: Integration) -> set[str]: ...
 def _async_mount_config_dir(hass: HomeAssistant) -> None: ...
 def _lookup_path(hass: HomeAssistant) -> list[str]: ...
 def is_component_module_loaded(hass: HomeAssistant, module: str) -> bool: ...

homeassistant-stubs/scripts/check_config.pyi

@@ -5,7 +5,6 @@ from homeassistant.config import get_default_config_dir as get_default_config_di
 from homeassistant.config_entries import ConfigEntries as ConfigEntries
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.check_config import async_check_ha_config_file as async_check_ha_config_file
-from homeassistant.util.yaml import Secrets as Secrets
 from typing import Any
 
 REQUIREMENTS: Incomplete

homeassistant-stubs/util/logging.pyi

@@ -1,8 +1,25 @@
 import logging
 import logging.handlers
+from _typeshed import Incomplete
 from collections.abc import Callable, Coroutine
 from homeassistant.core import HassJobType as HassJobType, HomeAssistant as HomeAssistant, callback as callback, get_hassjob_callable_job_type as get_hassjob_callable_job_type
-from typing import Any, overload
+from queue import SimpleQueue
+from typing import Any, overload, override
+
+_LOGGER: Incomplete
+
+class HomeAssistantQueueListener(logging.handlers.QueueListener):
+    LOG_COUNTS_RESET_INTERVAL: int
+    MAX_LOGS_COUNT: int
+    EXCLUDED_LOG_COUNT_MODULES: Incomplete
+    _last_reset: float
+    _log_counts: dict[str, int]
+    _module_log_count_skip_flags: dict[str, bool]
+    def __init__(self, queue: SimpleQueue[logging.Handler], *handlers: logging.Handler) -> None: ...
+    @override
+    def handle(self, record: logging.LogRecord) -> None: ...
+    def _reset_counters(self, time_sec: float) -> None: ...
+    def _update_skip_flags(self, module_name: str) -> bool: ...
 
 class HomeAssistantQueueHandler(logging.handlers.QueueHandler):
     listener: logging.handlers.QueueListener | None

homeassistant-stubs/util/unit_conversion.pyi

@@ -58,6 +58,9 @@ class BaseUnitConverter:
     def get_unit_ratio(cls, from_unit: str | None, to_unit: str | None) -> float: ...
     @classmethod
     @lru_cache
+    def get_unit_floored_log_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):

homeassistant-stubs/util/unit_system.pyi

@@ -1,5 +1,6 @@
 from .unit_conversion import AreaConverter as AreaConverter, DistanceConverter as DistanceConverter, PressureConverter as PressureConverter, SpeedConverter as SpeedConverter, TemperatureConverter as TemperatureConverter, VolumeConverter as VolumeConverter
 from _typeshed import Incomplete
+from dataclasses import dataclass
 from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass
 from homeassistant.const import ACCUMULATED_PRECIPITATION as ACCUMULATED_PRECIPITATION, AREA as AREA, LENGTH as LENGTH, MASS as MASS, PRESSURE as PRESSURE, TEMPERATURE as TEMPERATURE, UNIT_NOT_RECOGNIZED_TEMPLATE as UNIT_NOT_RECOGNIZED_TEMPLATE, UnitOfArea as UnitOfArea, UnitOfLength as UnitOfLength, UnitOfMass as UnitOfMass, UnitOfPrecipitationDepth as UnitOfPrecipitationDepth, UnitOfPressure as UnitOfPressure, UnitOfSpeed as UnitOfSpeed, UnitOfTemperature as UnitOfTemperature, UnitOfVolume as UnitOfVolume, UnitOfVolumetricFlux as UnitOfVolumetricFlux, VOLUME as VOLUME, WIND_SPEED as WIND_SPEED
 from typing import Final
@@ -18,17 +19,18 @@ _VALID_BY_TYPE: dict[str, set[str] | set[str | None]]
 
 def _is_valid_unit(unit: str, unit_type: str) -> bool: ...
 
+@dataclass(frozen=True, kw_only=True)
 class UnitSystem:
-    _name: Incomplete
-    accumulated_precipitation_unit: Incomplete
-    area_unit: Incomplete
-    length_unit: Incomplete
-    mass_unit: Incomplete
-    pressure_unit: Incomplete
-    temperature_unit: Incomplete
-    volume_unit: Incomplete
-    wind_speed_unit: Incomplete
-    _conversions: Incomplete
+    _name: str
+    accumulated_precipitation_unit: UnitOfPrecipitationDepth
+    area_unit: UnitOfArea
+    length_unit: UnitOfLength
+    mass_unit: UnitOfMass
+    pressure_unit: UnitOfPressure
+    temperature_unit: UnitOfTemperature
+    volume_unit: UnitOfVolume
+    wind_speed_unit: UnitOfSpeed
+    _conversions: dict[tuple[SensorDeviceClass | str | None, str | None], str]
     def __init__(self, name: str, *, accumulated_precipitation: UnitOfPrecipitationDepth, area: UnitOfArea, conversions: dict[tuple[SensorDeviceClass | str | None, str | None], str], length: UnitOfLength, mass: UnitOfMass, pressure: UnitOfPressure, temperature: UnitOfTemperature, volume: UnitOfVolume, wind_speed: UnitOfSpeed) -> None: ...
     def temperature(self, temperature: float, from_unit: str) -> float: ...
     def length(self, length: float | None, from_unit: str) -> float: ...

homeassistant-stubs/util/yaml/__init__.pyi

@@ -1,7 +1,6 @@
-from .const import SECRET_YAML as SECRET_YAML
 from .dumper import dump as dump, save_yaml as save_yaml
-from .input import UndefinedSubstitution as UndefinedSubstitution, extract_inputs as extract_inputs, substitute as substitute
-from .loader import Secrets as Secrets, YamlTypeError as YamlTypeError, load_yaml as load_yaml, load_yaml_dict as load_yaml_dict, parse_yaml as parse_yaml, secret_yaml as secret_yaml
-from .objects import Input as Input
+from .loader import Secrets as Secrets, load_yaml as load_yaml, load_yaml_dict as load_yaml_dict, parse_yaml as parse_yaml, secret_yaml as secret_yaml
+from annotatedyaml import Input as Input, SECRET_YAML as SECRET_YAML, YamlTypeError as YamlTypeError
+from annotatedyaml.input import UndefinedSubstitution as UndefinedSubstitution, extract_inputs as extract_inputs, substitute as substitute
 
 __all__ = ['SECRET_YAML', 'Input', 'Secrets', 'UndefinedSubstitution', 'YamlTypeError', 'dump', 'extract_inputs', 'load_yaml', 'load_yaml_dict', 'parse_yaml', 'save_yaml', 'secret_yaml', 'substitute']

homeassistant-stubs/util/yaml/dumper.pyi

@@ -1,9 +1,3 @@
-import yaml
-from .objects import Input as Input, NodeDictClass as NodeDictClass, NodeListClass as NodeListClass, NodeStrClass as NodeStrClass
-from _typeshed import Incomplete
-from typing import Any
+from annotatedyaml.dumper import add_representer as add_representer, dump as dump, represent_odict as represent_odict, save_yaml as save_yaml
 
-def dump(_dict: dict | list) -> str: ...
-def save_yaml(path: str, data: dict) -> None: ...
-def represent_odict(dumper, tag, mapping, flow_style: Incomplete | None = None) -> yaml.MappingNode: ...
-def add_representer(klass: Any, representer: Any) -> None: ...
+__all__ = ['add_representer', 'dump', 'represent_odict', 'save_yaml']

homeassistant-stubs/util/yaml/input.pyi

@@ -1,11 +1,4 @@
 from .objects import Input as Input
-from _typeshed import Incomplete
-from typing import Any
+from annotatedyaml.input import UndefinedSubstitution as UndefinedSubstitution, extract_inputs as extract_inputs, substitute as substitute
 
-class UndefinedSubstitution(Exception):
-    input: Incomplete
-    def __init__(self, input_name: str) -> None: ...
-
-def extract_inputs(obj: Any) -> set[str]: ...
-def _extract_inputs(obj: Any, found: set[str]) -> None: ...
-def substitute(obj: Any, substitutions: dict[str, Any]) -> Any: ...
+__all__ = ['Input', 'UndefinedSubstitution', 'extract_inputs', 'substitute']

homeassistant-stubs/util/yaml/loader.pyi

@@ -1,81 +1,13 @@
 import os
 import yaml
-from .const import SECRET_YAML as SECRET_YAML
-from .objects import Input as Input, NodeDictClass as NodeDictClass, NodeListClass as NodeListClass, NodeStrClass as NodeStrClass
-from _typeshed import Incomplete
-from collections.abc import Callable as Callable, Iterator
-from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from annotatedyaml import YamlTypeError as YamlTypeError
+from annotatedyaml.loader import HAS_C_LOADER as HAS_C_LOADER, JSON_TYPE as JSON_TYPE, LoaderType, Secrets as Secrets, add_constructor as add_constructor
 from io import StringIO
-from pathlib import Path
-from propcache.api import cached_property
-from typing import Any, TextIO, overload
-from yaml import SafeLoader as FastestAvailableSafeLoader
+from typing import TextIO
 
-HAS_C_LOADER: bool
-JSON_TYPE = list | dict | str
-_LOGGER: Incomplete
-
-class YamlTypeError(HomeAssistantError): ...
-
-class Secrets:
-    config_dir: 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]: ...
-
-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):
-    stream: Incomplete
-    name: str
-    secrets: Incomplete
-    def __init__(self, stream: Any, secrets: Secrets | None = None) -> None: ...
-
-class PythonSafeLoader(yaml.SafeLoader, _LoaderMixin):
-    secrets: Incomplete
-    def __init__(self, stream: Any, secrets: Secrets | None = None) -> None: ...
-type LoaderType = FastSafeLoader | PythonSafeLoader
+__all__ = ['HAS_C_LOADER', 'JSON_TYPE', 'Secrets', 'YamlTypeError', 'add_constructor', 'load_yaml', 'load_yaml_dict', 'parse_yaml', 'secret_yaml']
 
 def load_yaml(fname: str | os.PathLike[str], secrets: Secrets | None = None) -> JSON_TYPE | None: ...
 def load_yaml_dict(fname: str | os.PathLike[str], secrets: Secrets | None = None) -> dict: ...
 def parse_yaml(content: str | TextIO | StringIO, secrets: Secrets | None = None) -> JSON_TYPE: ...
-def _parse_yaml_python(content: str | TextIO | StringIO, secrets: Secrets | None = None) -> JSON_TYPE: ...
-def _parse_yaml(loader: type[FastSafeLoader | PythonSafeLoader], content: str | TextIO, secrets: Secrets | None = None) -> JSON_TYPE: ...
-@overload
-def _add_reference(obj: list | NodeListClass, loader: LoaderType, node: yaml.nodes.Node) -> NodeListClass: ...
-@overload
-def _add_reference(obj: str | NodeStrClass, loader: LoaderType, node: yaml.nodes.Node) -> NodeStrClass: ...
-@overload
-def _add_reference(obj: dict | NodeDictClass, loader: LoaderType, node: yaml.nodes.Node) -> NodeDictClass: ...
-@overload
-def _add_reference_to_node_class(obj: NodeListClass, loader: LoaderType, node: yaml.nodes.Node) -> NodeListClass: ...
-@overload
-def _add_reference_to_node_class(obj: NodeStrClass, loader: LoaderType, node: yaml.nodes.Node) -> NodeStrClass: ...
-@overload
-def _add_reference_to_node_class(obj: NodeDictClass, loader: LoaderType, node: yaml.nodes.Node) -> NodeDictClass: ...
-def _raise_if_no_value[NodeT: yaml.nodes.Node, _R](func: Callable[[LoaderType, NodeT], _R]) -> Callable[[LoaderType, NodeT], _R]: ...
-@_raise_if_no_value
-def _include_yaml(loader: LoaderType, node: yaml.nodes.Node) -> JSON_TYPE: ...
-def _is_file_valid(name: str) -> bool: ...
-def _find_files(directory: str, pattern: str) -> Iterator[str]: ...
-@_raise_if_no_value
-def _include_dir_named_yaml(loader: LoaderType, node: yaml.nodes.Node) -> NodeDictClass: ...
-@_raise_if_no_value
-def _include_dir_merge_named_yaml(loader: LoaderType, node: yaml.nodes.Node) -> NodeDictClass: ...
-@_raise_if_no_value
-def _include_dir_list_yaml(loader: LoaderType, node: yaml.nodes.Node) -> list[JSON_TYPE]: ...
-@_raise_if_no_value
-def _include_dir_merge_list_yaml(loader: LoaderType, node: yaml.nodes.Node) -> JSON_TYPE: ...
-def _handle_mapping_tag(loader: LoaderType, node: yaml.nodes.MappingNode) -> NodeDictClass: ...
-def _construct_seq(loader: LoaderType, node: yaml.nodes.Node) -> JSON_TYPE: ...
-def _handle_scalar_tag(loader: LoaderType, node: yaml.nodes.ScalarNode) -> str | int | float | None: ...
-def _env_var_yaml(loader: LoaderType, node: yaml.nodes.Node) -> str: ...
 def secret_yaml(loader: LoaderType, node: yaml.nodes.Node) -> JSON_TYPE: ...
-def add_constructor(tag: Any, constructor: Any) -> None: ...

homeassistant-stubs/util/yaml/objects.pyi

@@ -1,27 +1,3 @@
-import voluptuous as vol
-import yaml
-from _typeshed import Incomplete
-from dataclasses import dataclass
-from typing import Any
+from annotatedyaml import Input as Input, NodeDictClass as NodeDictClass, NodeListClass as NodeListClass, NodeStrClass as NodeStrClass
 
-class NodeListClass(list):
-    __slots__: Incomplete
-    __config_file__: str
-    __line__: int | str
-
-class NodeStrClass(str):
-    __slots__: Incomplete
-    __config_file__: str
-    __line__: int | str
-    def __voluptuous_compile__(self, schema: vol.Schema) -> Any: ...
-
-class NodeDictClass(dict):
-    __slots__: Incomplete
-    __config_file__: str
-    __line__: int | str
-
-@dataclass(slots=True, frozen=True)
-class Input:
-    name: str
-    @classmethod
-    def from_node(cls, loader: yaml.Loader, node: yaml.nodes.Node) -> Input: ...
+__all__ = ['Input', 'NodeDictClass', 'NodeListClass', 'NodeStrClass']

{homeassistant_stubs-2025.3.3.dist-info → homeassistant_stubs-2025.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homeassistant-stubs
-Version: 2025.3.3
+Version: 2025.4.0
 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.3.3
+Requires-Dist: homeassistant==2025.4.0
 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)