homeassistant-stubs 2025.3.4__py3-none-any.whl → 2025.4.0b1__py3-none-any.whl

homeassistant-stubs/helpers/config_entry_oauth2_flow.pyi

@@ -58,11 +58,25 @@ class LocalOAuth2Implementation(AbstractOAuth2Implementation):
     def redirect_uri(self) -> str: ...
     @property
     def extra_authorize_data(self) -> dict: ...
+    @property
+    def extra_token_resolve_data(self) -> dict: ...
     async def async_generate_authorize_url(self, flow_id: str) -> str: ...
     async def async_resolve_external_data(self, external_data: Any) -> dict: ...
     async def _async_refresh_token(self, token: dict) -> dict: ...
     async def _token_request(self, data: dict) -> dict: ...
 
+class LocalOAuth2ImplementationWithPkce(LocalOAuth2Implementation):
+    code_verifier: Incomplete
+    def __init__(self, hass: HomeAssistant, domain: str, client_id: str, authorize_url: str, token_url: str, client_secret: str = '', code_verifier_length: int = 128) -> None: ...
+    @property
+    def extra_authorize_data(self) -> dict: ...
+    @property
+    def extra_token_resolve_data(self) -> dict: ...
+    @staticmethod
+    def generate_code_verifier(code_verifier_length: int = 128) -> str: ...
+    @staticmethod
+    def compute_code_challenge(code_verifier: str) -> str: ...
+
 class AbstractOAuth2FlowHandler(config_entries.ConfigFlow, metaclass=ABCMeta):
     DOMAIN: str
     VERSION: int

homeassistant-stubs/helpers/config_validation.pyi

@@ -149,7 +149,6 @@ def key_value_schemas(key: str, value_schemas: dict[Hashable, VolSchemaType | Ca
 def key_dependency[_KT: Hashable, _VT](key: Hashable, dependency: Hashable) -> Callable[[dict[_KT, _VT]], dict[_KT, _VT]]: ...
 def custom_serializer(schema: Any) -> Any: ...
 def _custom_serializer(schema: Any, *, allow_section: bool) -> Any: ...
-def expand_condition_shorthand(value: Any | None) -> Any: ...
 def empty_config_schema(domain: str) -> Callable[[dict], dict]: ...
 def _no_yaml_config_schema(domain: str, issue_base: str, translation_key: str, translation_placeholders: dict[str, str]) -> Callable[[dict], dict]: ...
 def config_entry_only_config_schema(domain: str) -> Callable[[dict], dict]: ...
@@ -202,10 +201,14 @@ NOT_CONDITION_SCHEMA: Incomplete
 NOT_CONDITION_SHORTHAND_SCHEMA: Incomplete
 DEVICE_CONDITION_BASE_SCHEMA: Incomplete
 DEVICE_CONDITION_SCHEMA: Incomplete
-dynamic_template_condition_action: Incomplete
+
+def expand_condition_shorthand(value: Any | None) -> Any: ...
+
+dynamic_template_condition: Incomplete
 CONDITION_SHORTHAND_SCHEMA: Incomplete
 CONDITION_SCHEMA: vol.Schema
 CONDITIONS_SCHEMA: Incomplete
+dynamic_template_condition_action: Incomplete
 CONDITION_ACTION_SCHEMA: vol.Schema
 
 def _trigger_pre_validator(value: Any | None) -> Any: ...

homeassistant-stubs/helpers/frame.pyi

@@ -3,15 +3,24 @@ import logging
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
-from homeassistant.core import HomeAssistant as HomeAssistant, async_get_hass_or_none as async_get_hass_or_none
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.loader import Integration as Integration, async_get_issue_integration as async_get_issue_integration, async_suggest_report_issue as async_suggest_report_issue
+from homeassistant.util.async_ import run_callback_threadsafe as run_callback_threadsafe
 from propcache.api import cached_property
 from types import FrameType
 
 _LOGGER: Incomplete
 _REPORTED_INTEGRATIONS: set[str]
 
+class _Hass:
+    hass: HomeAssistant | None
+
+_hass: Incomplete
+
+@callback
+def async_setup(hass: HomeAssistant) -> None: ...
+
 @dataclass(kw_only=True)
 class IntegrationFrame:
     custom_integration: bool
@@ -32,15 +41,15 @@ def get_integration_frame(exclude_integrations: set | None = None) -> Integratio
 
 class MissingIntegrationFrame(HomeAssistantError): ...
 
-def report(what: str, *, exclude_integrations: set[str] | None = None, error_if_core: bool = True, error_if_integration: bool = False, level: int = ..., log_custom_component_only: bool = False) -> None: ...
-
 class ReportBehavior(enum.Enum):
     IGNORE = ...
     LOG = ...
     ERROR = ...
 
 def report_usage(what: str, *, breaks_in_ha_version: str | None = None, core_behavior: ReportBehavior = ..., core_integration_behavior: ReportBehavior = ..., custom_integration_behavior: ReportBehavior = ..., exclude_integrations: set[str] | None = None, integration_domain: str | None = None, level: int = ...) -> None: ...
-def _report_integration_domain(hass: HomeAssistant | None, what: str, breaks_in_ha_version: str | None, integration: Integration, core_integration_behavior: ReportBehavior, custom_integration_behavior: ReportBehavior, level: int) -> None: ...
-def _report_integration_frame(what: str, breaks_in_ha_version: str | None, integration_frame: IntegrationFrame, level: int = ..., error: bool = False) -> None: ...
+def _report_usage(hass: HomeAssistant, what: str, *, breaks_in_ha_version: str | None, core_behavior: ReportBehavior, core_integration_behavior: ReportBehavior, custom_integration_behavior: ReportBehavior, exclude_integrations: set[str] | None, integration_domain: str | None, level: int) -> None: ...
+def _report_usage_integration_domain(hass: HomeAssistant | None, what: str, breaks_in_ha_version: str | None, integration: Integration, core_integration_behavior: ReportBehavior, custom_integration_behavior: ReportBehavior, level: int) -> None: ...
+def _report_usage_integration_frame(hass: HomeAssistant, what: str, breaks_in_ha_version: str | None, integration_frame: IntegrationFrame, level: int = ..., error: bool = False) -> None: ...
+def _report_usage_no_integration(what: str, core_behavior: ReportBehavior, breaks_in_ha_version: str | None, err: MissingIntegrationFrame | None) -> None: ...
 def warn_use[_CallableT: Callable](func: _CallableT, what: str) -> _CallableT: ...
 def report_non_thread_safe_operation(what: str) -> None: ...

homeassistant-stubs/helpers/intent.pyi

@@ -19,7 +19,7 @@ from typing import Any
 
 _LOGGER: Incomplete
 type _SlotsType = dict[str, Any]
-type _IntentSlotsType = dict[str | tuple[str, str], VolSchemaType | Callable[[Any], Any]]
+type _IntentSlotsType = dict[str | tuple[str, str], IntentSlotInfo | VolSchemaType | Callable[[Any], Any]]
 INTENT_TURN_OFF: str
 INTENT_TURN_ON: str
 INTENT_TOGGLE: str
@@ -135,8 +135,9 @@ 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: ...
+def _default_area_candidate_filter(candidate: MatchTargetsCandidate, possible_area_ids: Collection[str]) -> bool: ...
 @callback
-def async_match_targets(hass: HomeAssistant, constraints: MatchTargetsConstraints, preferences: MatchTargetsPreferences | None = None, states: list[State] | None = None) -> MatchTargetsResult: ...
+def async_match_targets(hass: HomeAssistant, constraints: MatchTargetsConstraints, preferences: MatchTargetsPreferences | None = None, states: list[State] | None = None, area_candidate_filter: Callable[[MatchTargetsCandidate, Collection[str]], bool] = ...) -> 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]: ...
@@ -160,6 +161,14 @@ class IntentHandler:
 
 def non_empty_string(value: Any) -> str: ...
 
+@dataclass(kw_only=True)
+class IntentSlotInfo:
+    service_data_name: str | None = ...
+    description: str | None = ...
+    value_schema: VolSchemaType | Callable[[Any], Any] = ...
+
+def _convert_slot_info(key: str | tuple[str, str], value: IntentSlotInfo | VolSchemaType | Callable[[Any], Any]) -> tuple[str, IntentSlotInfo]: ...
+
 class DynamicServiceIntentHandler(IntentHandler, metaclass=abc.ABCMeta):
     service_timeout: float
     intent_type: Incomplete
@@ -170,8 +179,8 @@ class DynamicServiceIntentHandler(IntentHandler, metaclass=abc.ABCMeta):
     description: Incomplete
     platforms: Incomplete
     device_classes: Incomplete
-    required_slots: _IntentSlotsType
-    optional_slots: _IntentSlotsType
+    required_slots: dict[str, IntentSlotInfo]
+    optional_slots: dict[str, IntentSlotInfo]
     def __init__(self, intent_type: str, speech: str | None = None, required_slots: _IntentSlotsType | None = None, optional_slots: _IntentSlotsType | None = None, required_domains: set[str] | None = None, required_features: int | None = None, required_states: set[str] | None = None, description: str | None = None, platforms: set[str] | None = None, device_classes: set[type[StrEnum]] | None = None) -> None: ...
     @cached_property
     def slot_schema(self) -> dict: ...

homeassistant-stubs/helpers/llm.pyi

@@ -23,6 +23,7 @@ ACTION_PARAMETERS_CACHE: HassKey[dict[str, dict[str, tuple[str | None, vol.Schem
 LLM_API_ASSIST: str
 BASE_PROMPT: str
 DEFAULT_INSTRUCTIONS_PROMPT: str
+NO_ENTITIES_PROMPT: str
 
 @callback
 def async_render_no_api_prompt(hass: HomeAssistant) -> str: ...
@@ -96,7 +97,7 @@ class AssistAPI(API):
     @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, dict[str, Any]]]: ...
+def _get_exposed_entities(hass: HomeAssistant, assistant: str, include_state: bool = True) -> dict[str, dict[str, dict[str, Any]]]: ...
 def _selector_serializer(schema: Any) -> Any: ...
 def _get_cached_action_parameters(hass: HomeAssistant, domain: str, action: str) -> tuple[str | None, vol.Schema]: ...
 
@@ -117,3 +118,8 @@ class CalendarGetEventsTool(Tool):
     parameters: Incomplete
     def __init__(self, calendars: list[str]) -> None: ...
     async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...
+
+class GetHomeStateTool(Tool):
+    name: str
+    description: str
+    async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...

homeassistant-stubs/helpers/selector.pyi

@@ -42,6 +42,7 @@ class DeviceFilterSelectorConfig(TypedDict, total=False):
     integration: str
     manufacturer: str
     model: str
+    model_id: str
 
 class ActionSelectorConfig(TypedDict): ...
 

homeassistant-stubs/helpers/template.pyi

@@ -7,7 +7,7 @@ from .singleton import singleton as singleton
 from .translation import async_translate_state as async_translate_state
 from .typing import TemplateVarsType as TemplateVarsType
 from _typeshed import Incomplete, OptExcInfo as OptExcInfo
-from collections.abc import Callable as Callable, Generator, Iterable
+from collections.abc import Callable as Callable, Generator, Iterable, MutableSequence
 from contextlib import AbstractContextManager
 from contextvars import ContextVar
 from datetime import datetime, timedelta
@@ -255,6 +255,7 @@ def floors(hass: HomeAssistant) -> Iterable[str | None]: ...
 def floor_id(hass: HomeAssistant, lookup_value: Any) -> str | None: ...
 def floor_name(hass: HomeAssistant, lookup_value: str) -> str | None: ...
 def floor_areas(hass: HomeAssistant, floor_id_or_name: str) -> Iterable[str]: ...
+def floor_entities(hass: HomeAssistant, floor_id_or_name: str) -> Iterable[str]: ...
 def areas(hass: HomeAssistant) -> Iterable[str | None]: ...
 def area_id(hass: HomeAssistant, lookup_value: str) -> str | None: ...
 def _get_area_name(area_reg: area_registry.AreaRegistry, valid_area_id: str) -> str: ...
@@ -345,6 +346,18 @@ def time_until(hass: HomeAssistant, value: Any | datetime, precision: int = 1) -
 def urlencode(value): ...
 def slugify(value, separator: str = '_'): ...
 def iif(value: Any, if_true: Any = True, if_false: Any = False, if_none: Any = ...) -> Any: ...
+def shuffle(*args: Any, seed: Any = None) -> MutableSequence[Any]: ...
+def typeof(value: Any) -> Any: ...
+def flatten(value: Iterable[Any], levels: int | None = None) -> list[Any]: ...
+def intersect(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+def difference(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+def union(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+def symmetric_difference(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+def combine(*args: Any, recursive: bool = False) -> dict[Any, Any]: ...
+def md5(value: str) -> str: ...
+def sha1(value: str) -> str: ...
+def sha256(value: str) -> str: ...
+def sha512(value: str) -> str: ...
 
 class TemplateContextManager(AbstractContextManager):
     def set_template(self, template_str: str, action: str) -> None: ...

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,23 @@
 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
+    _last_reset: float
+    _log_counts: dict[str, int]
+    _warned_modules: set[str]
+    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: ...
 
 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.4.dist-info → homeassistant_stubs-2025.4.0b1.dist-info}/METADATA

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