homeassistant-stubs 2024.7.3__py3-none-any.whl → 2024.8.0__py3-none-any.whl

homeassistant-stubs/helpers/update_coordinator.pyi

@@ -4,15 +4,16 @@ from . import entity as entity, event as event
 from .debounce import Debouncer as Debouncer
 from _typeshed import Incomplete
 from abc import abstractmethod
-from collections.abc import Awaitable, Callable as Callable, Coroutine
+from collections.abc import Awaitable, Callable as Callable, Coroutine, Generator
 from datetime import datetime, timedelta
+from functools import cached_property as cached_property
 from homeassistant import config_entries as config_entries
 from homeassistant.const import EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP
 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
 from homeassistant.util.dt import utcnow as utcnow
 from typing import Any, Generic, Protocol
-from typing_extensions import Generator, TypeVar
+from typing_extensions import TypeVar
 
 REQUEST_REFRESH_DEFAULT_COOLDOWN: int
 REQUEST_REFRESH_DEFAULT_IMMEDIATE: bool
@@ -29,6 +30,7 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     logger: Incomplete
     name: Incomplete
     update_method: Incomplete
+    setup_method: Incomplete
     _update_interval_seconds: Incomplete
     _shutdown_requested: bool
     config_entry: Incomplete
@@ -42,7 +44,7 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     last_update_success: bool
     last_exception: Incomplete
     _debounced_refresh: Incomplete
-    def __init__(self, hass: HomeAssistant, logger: logging.Logger, *, name: str, update_interval: timedelta | None = None, update_method: Callable[[], Awaitable[_DataT]] | None = None, request_refresh_debouncer: Debouncer[Coroutine[Any, Any, None]] | None = None, always_update: bool = True) -> None: ...
+    def __init__(self, hass: HomeAssistant, logger: logging.Logger, *, 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: ...
     def async_add_listener(self, update_callback: CALLBACK_TYPE, context: Any = None) -> Callable[[], None]: ...
     def async_update_listeners(self) -> None: ...
@@ -62,6 +64,8 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     async def async_request_refresh(self) -> None: ...
     async def _async_update_data(self) -> _DataT: ...
     async def async_config_entry_first_refresh(self) -> None: ...
+    async def __wrap_async_setup(self) -> bool: ...
+    async def _async_setup(self) -> None: ...
     async def async_refresh(self) -> None: ...
     async def _async_refresh(self, log_failures: bool = True, raise_on_auth_failed: bool = False, scheduled: bool = False, raise_on_entry_error: bool = False) -> None: ...
     def _async_refresh_finished(self) -> None: ...
@@ -76,7 +80,7 @@ class BaseCoordinatorEntity(entity.Entity, metaclass=abc.ABCMeta):
     coordinator: Incomplete
     coordinator_context: Incomplete
     def __init__(self, coordinator: _BaseDataUpdateCoordinatorT, context: Any = None) -> None: ...
-    @property
+    @cached_property
     def should_poll(self) -> bool: ...
     async def async_added_to_hass(self) -> None: ...
     def _handle_coordinator_update(self) -> None: ...

homeassistant-stubs/runner.pyi

@@ -25,7 +25,7 @@ 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: ...
+    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: ...
 
 def can_use_pidfd() -> bool: ...
 

homeassistant-stubs/setup.pyi

@@ -11,11 +11,10 @@ from .util.async_ import create_eager_task as create_eager_task
 from .util.hass_dict import HassKey as HassKey
 from _typeshed import Incomplete
 from collections import defaultdict
-from collections.abc import Awaitable, Callable as Callable, Mapping
+from collections.abc import Awaitable, Callable as Callable, Generator, Mapping
 from enum import StrEnum
 from types import ModuleType
 from typing import Final, TypedDict
-from typing_extensions import Generator
 
 current_setup_group: contextvars.ContextVar[tuple[str, str | None] | None]
 _LOGGER: Incomplete
@@ -48,13 +47,13 @@ def _async_when_setup(hass: core.HomeAssistant, component: str, when_setup_cb: C
 def async_get_loaded_integrations(hass: core.HomeAssistant) -> set[str]: ...
 
 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
+    SETUP = 'setup'
+    CONFIG_ENTRY_SETUP = 'config_entry_setup'
+    PLATFORM_SETUP = 'platform_setup'
+    CONFIG_ENTRY_PLATFORM_SETUP = 'config_entry_platform_setup'
+    WAIT_BASE_PLATFORM_SETUP = 'wait_base_component'
+    WAIT_IMPORT_PLATFORMS = 'wait_import_platforms'
+    WAIT_IMPORT_PACKAGES = 'wait_import_packages'
 
 def _setup_started(hass: core.HomeAssistant) -> dict[tuple[str, str | None], float]: ...
 def async_pause_setup(hass: core.HomeAssistant, phase: SetupPhases) -> Generator[None]: ...

homeassistant-stubs/util/event_type.pyi

@@ -7,7 +7,7 @@ __all__ = ['EventType']
 _DataT = TypeVar('_DataT', bound=Mapping[str, Any], default=Mapping[str, Any])
 
 class EventType(Generic[_DataT]):
-    def __init__(self, value: str) -> None: ...
+    def __init__(self, value: str, /) -> None: ...
     def __len__(self) -> int: ...
     def __hash__(self) -> int: ...
     def __eq__(self, value: object) -> bool: ...

homeassistant-stubs/util/hass_dict.pyi

@@ -5,7 +5,7 @@ __all__ = ['HassDict', 'HassEntryKey', 'HassKey']
 _T = TypeVar('_T')
 
 class _Key(Generic[_T]):
-    def __init__(self, value: str) -> None: ...
+    def __init__(self, value: str, /) -> None: ...
     def __len__(self) -> int: ...
     def __hash__(self) -> int: ...
     def __eq__(self, other: object) -> bool: ...
@@ -28,38 +28,38 @@ class HassDict(dict[_Key[Any] | str, Any]):
     @overload
     def __setitem__(self, key: str, value: Any) -> None: ...
     @overload
-    def setdefault(self, key: HassEntryKey[_S], default: dict[str, _S]) -> dict[str, _S]: ...
+    def setdefault(self, key: HassEntryKey[_S], default: dict[str, _S], /) -> dict[str, _S]: ...
     @overload
-    def setdefault(self, key: HassKey[_S], default: _S) -> _S: ...
+    def setdefault(self, key: HassKey[_S], default: _S, /) -> _S: ...
     @overload
-    def setdefault(self, key: str, default: None = None) -> Any | None: ...
+    def setdefault(self, key: str, default: None = None, /) -> Any | None: ...
     @overload
-    def setdefault(self, key: str, default: Any) -> Any: ...
+    def setdefault(self, key: str, default: Any, /) -> Any: ...
     @overload
-    def get(self, key: HassEntryKey[_S]) -> dict[str, _S] | None: ...
+    def get(self, key: HassEntryKey[_S], /) -> dict[str, _S] | None: ...
     @overload
-    def get(self, key: HassEntryKey[_S], default: _U) -> dict[str, _S] | _U: ...
+    def get(self, key: HassEntryKey[_S], default: _U, /) -> dict[str, _S] | _U: ...
     @overload
-    def get(self, key: HassKey[_S]) -> _S | None: ...
+    def get(self, key: HassKey[_S], /) -> _S | None: ...
     @overload
-    def get(self, key: HassKey[_S], default: _U) -> _S | _U: ...
+    def get(self, key: HassKey[_S], default: _U, /) -> _S | _U: ...
     @overload
-    def get(self, key: str) -> Any | None: ...
+    def get(self, key: str, /) -> Any | None: ...
     @overload
-    def get(self, key: str, default: Any) -> Any: ...
+    def get(self, key: str, default: Any, /) -> Any: ...
     @overload
-    def pop(self, key: HassEntryKey[_S]) -> dict[str, _S]: ...
+    def pop(self, key: HassEntryKey[_S], /) -> dict[str, _S]: ...
     @overload
-    def pop(self, key: HassEntryKey[_S], default: dict[str, _S]) -> dict[str, _S]: ...
+    def pop(self, key: HassEntryKey[_S], default: dict[str, _S], /) -> dict[str, _S]: ...
     @overload
-    def pop(self, key: HassEntryKey[_S], default: _U) -> dict[str, _S] | _U: ...
+    def pop(self, key: HassEntryKey[_S], default: _U, /) -> dict[str, _S] | _U: ...
     @overload
-    def pop(self, key: HassKey[_S]) -> _S: ...
+    def pop(self, key: HassKey[_S], /) -> _S: ...
     @overload
-    def pop(self, key: HassKey[_S], default: _S) -> _S: ...
+    def pop(self, key: HassKey[_S], default: _S, /) -> _S: ...
     @overload
-    def pop(self, key: HassKey[_S], default: _U) -> _S | _U: ...
+    def pop(self, key: HassKey[_S], default: _U, /) -> _S | _U: ...
     @overload
-    def pop(self, key: str) -> Any: ...
+    def pop(self, key: str, /) -> Any: ...
     @overload
-    def pop(self, key: str, default: _U) -> Any | _U: ...
+    def pop(self, key: str, default: _U, /) -> Any | _U: ...

homeassistant-stubs/util/json.pyi

@@ -1,14 +1,11 @@
-import json
-from .file import WriteError as WriteError
 from _typeshed import Incomplete
-from collections.abc import Callable as Callable
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from os import PathLike
 from typing import Any
 
 _SENTINEL: Incomplete
 _LOGGER: Incomplete
-JsonValueType: Incomplete
+JsonValueType = dict[str, JsonValueType] | list[JsonValueType] | str | int | float | bool | None
 JsonArrayType = list[JsonValueType]
 JsonObjectType = dict[str, JsonValueType]
 JSON_ENCODE_EXCEPTIONS: Incomplete
@@ -16,12 +13,10 @@ JSON_DECODE_EXCEPTIONS: Incomplete
 
 class SerializationError(HomeAssistantError): ...
 
-def json_loads(__obj: bytes | bytearray | memoryview | str) -> JsonValueType: ...
-def json_loads_array(__obj: bytes | bytearray | memoryview | str) -> JsonArrayType: ...
-def json_loads_object(__obj: bytes | bytearray | memoryview | str) -> JsonObjectType: ...
+def json_loads(__obj: bytes | bytearray | memoryview | str, /) -> JsonValueType: ...
+def json_loads_array(__obj: bytes | bytearray | memoryview | str, /) -> JsonArrayType: ...
+def json_loads_object(__obj: bytes | bytearray | memoryview | str, /) -> JsonObjectType: ...
 def load_json(filename: str | PathLike[str], default: JsonValueType = ...) -> JsonValueType: ...
 def load_json_array(filename: str | PathLike[str], default: JsonArrayType = ...) -> JsonArrayType: ...
 def load_json_object(filename: str | PathLike[str], default: JsonObjectType = ...) -> JsonObjectType: ...
-def save_json(filename: str, data: list | dict, private: bool = False, *, encoder: type[json.JSONEncoder] | None = None, atomic_writes: bool = False) -> None: ...
 def format_unserializable_data(data: dict[str, Any]) -> str: ...
-def find_paths_unserializable_data(bad_data: Any, *, dump: Callable[[Any], str] = ...) -> dict[str, Any]: ...

homeassistant-stubs/util/language.pyi

@@ -19,7 +19,7 @@ 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 __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/signal_type.pyi

@@ -3,7 +3,7 @@ from typing import Any
 __all__ = ['SignalType', 'SignalTypeFormat']
 
 class _SignalTypeBase:
-    def __init__(self, value: str) -> None: ...
+    def __init__(self, value: str, /) -> None: ...
     def __hash__(self) -> int: ...
     def __eq__(self, other: object) -> bool: ...
 

homeassistant-stubs/util/ssl.pyi

@@ -3,9 +3,9 @@ from _typeshed import Incomplete
 from enum import StrEnum
 
 class SSLCipherList(StrEnum):
-    PYTHON_DEFAULT: str
-    INTERMEDIATE: str
-    MODERN: str
+    PYTHON_DEFAULT = 'python_default'
+    INTERMEDIATE = 'intermediate'
+    MODERN = 'modern'
 
 SSL_CIPHER_LISTS: Incomplete
 

homeassistant-stubs/util/timeout.pyi

@@ -8,10 +8,10 @@ from typing import Any, Self
 ZONE_GLOBAL: str
 
 class _State(str, enum.Enum):
-    INIT: str
-    ACTIVE: str
-    TIMEOUT: str
-    EXIT: str
+    INIT = 'INIT'
+    ACTIVE = 'ACTIVE'
+    TIMEOUT = 'TIMEOUT'
+    EXIT = 'EXIT'
 
 class _GlobalFreezeContext:
     _loop: Incomplete

homeassistant-stubs/util/ulid.pyi

@@ -1,5 +1,5 @@
-from ulid_transform import bytes_to_ulid as bytes_to_ulid, ulid_at_time as ulid_at_time, ulid_hex as ulid_hex, ulid_now as ulid_now, ulid_to_bytes as ulid_to_bytes
+from ulid_transform import bytes_to_ulid as bytes_to_ulid, bytes_to_ulid_or_none as bytes_to_ulid_or_none, ulid_at_time as ulid_at_time, ulid_hex as ulid_hex, ulid_now as ulid_now, ulid_to_bytes as ulid_to_bytes, ulid_to_bytes_or_none as ulid_to_bytes_or_none
 
-__all__ = ['ulid', 'ulid_hex', 'ulid_at_time', 'ulid_to_bytes', 'bytes_to_ulid', 'ulid_now']
+__all__ = ['ulid', 'ulid_hex', 'ulid_at_time', 'ulid_to_bytes', 'bytes_to_ulid', 'ulid_now', 'ulid_to_bytes_or_none', 'bytes_to_ulid_or_none']
 
 def ulid(timestamp: float | None = None) -> str: ...

homeassistant-stubs/util/yaml/loader.pyi

@@ -13,7 +13,7 @@ from typing import Any, TextIO, overload
 from yaml import SafeLoader as FastestAvailableSafeLoader
 
 HAS_C_LOADER: bool
-JSON_TYPE: Incomplete
+JSON_TYPE = list | dict | str
 _LOGGER: Incomplete
 
 class YamlTypeError(HomeAssistantError): ...
@@ -60,8 +60,7 @@ class SafeLineLoader(PythonSafeLoader):
     def add_multi_constructor(cls, tag_prefix: str, multi_constructor: Callable) -> None: ...
     @staticmethod
     def __report_deprecated() -> None: ...
-
-LoaderType: Incomplete
+LoaderType = FastSafeLoader | PythonSafeLoader
 
 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: ...

{homeassistant_stubs-2024.7.3.dist-info → homeassistant_stubs-2024.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: homeassistant-stubs
-Version: 2024.7.3
+Version: 2024.8.0
 Summary: PEP 484 typing stubs for Home Assistant Core
 Home-page: https://github.com/KapJI/homeassistant-stubs
 License: MIT
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development
 Classifier: Typing :: Typed
-Requires-Dist: homeassistant (==2024.7.3)
+Requires-Dist: homeassistant (==2024.8.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