homeassistant-stubs 2024.9.3__py3-none-any.whl → 2024.10.0__py3-none-any.whl

homeassistant-stubs/helpers/discovery_flow.pyi

@@ -1,3 +1,4 @@
+import dataclasses
 from _typeshed import Incomplete
 from collections.abc import Coroutine
 from homeassistant.config_entries import ConfigFlowResult as ConfigFlowResult
@@ -6,12 +7,21 @@ from homeassistant.core import CoreState as CoreState, Event as Event, HomeAssis
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.async_ import gather_with_limited_concurrency as gather_with_limited_concurrency
 from homeassistant.util.hass_dict import HassKey as HassKey
-from typing import Any, NamedTuple
+from typing import Any, NamedTuple, Self
 
 FLOW_INIT_LIMIT: int
 DISCOVERY_FLOW_DISPATCHER: HassKey[FlowDispatcher]
 
-def async_create_flow(hass: HomeAssistant, domain: str, context: dict[str, Any], data: Any) -> None: ...
+@dataclasses.dataclass(kw_only=True, slots=True)
+class DiscoveryKey:
+    domain: str
+    key: str | tuple[str, ...]
+    version: int
+    @classmethod
+    def from_json_dict(cls, json_dict: dict[str, Any]) -> Self: ...
+    def __init__(self, *, domain, key, version) -> None: ...
+
+def async_create_flow(hass: HomeAssistant, domain: str, context: dict[str, Any], data: Any, *, discovery_key: DiscoveryKey | None = None) -> None: ...
 def _async_init_flow(hass: HomeAssistant, domain: str, context: dict[str, Any], data: Any) -> Coroutine[None, None, ConfigFlowResult] | None: ...
 
 class PendingFlowKey(NamedTuple):

homeassistant-stubs/helpers/frame.pyi

@@ -32,7 +32,7 @@ def get_integration_frame(exclude_integrations: set | None = None) -> Integratio
 
 class MissingIntegrationFrame(HomeAssistantError): ...
 
-def report(what: str, exclude_integrations: set | None = None, error_if_core: bool = True, level: int = ..., log_custom_component_only: bool = False, error_if_integration: bool = False) -> None: ...
+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: ...
 def _report_integration(what: str, integration_frame: IntegrationFrame, level: int = ..., error: bool = False) -> None: ...
 def warn_use(func: _CallableT, what: str) -> _CallableT: ...
 def report_non_thread_safe_operation(what: str) -> None: ...

homeassistant-stubs/helpers/llm.pyi

@@ -6,13 +6,13 @@ from _typeshed import Incomplete
 from abc import ABC, abstractmethod
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
-from homeassistant.components.climate.intent import INTENT_GET_TEMPERATURE as INTENT_GET_TEMPERATURE
-from homeassistant.components.conversation.trace import ConversationTraceEventType as ConversationTraceEventType, async_conversation_trace_append as async_conversation_trace_append
-from homeassistant.components.cover.intent import INTENT_CLOSE_COVER as INTENT_CLOSE_COVER, INTENT_OPEN_COVER as INTENT_OPEN_COVER
-from homeassistant.components.homeassistant.exposed_entities import async_should_expose as async_should_expose
+from homeassistant.components.climate import INTENT_GET_TEMPERATURE as INTENT_GET_TEMPERATURE
+from homeassistant.components.conversation import ConversationTraceEventType as ConversationTraceEventType, async_conversation_trace_append as async_conversation_trace_append
+from homeassistant.components.cover import INTENT_CLOSE_COVER as INTENT_CLOSE_COVER, INTENT_OPEN_COVER as INTENT_OPEN_COVER
+from homeassistant.components.homeassistant import async_should_expose as async_should_expose
 from homeassistant.components.intent import async_device_supports_timers as async_device_supports_timers
 from homeassistant.components.script import ATTR_VARIABLES as ATTR_VARIABLES
-from homeassistant.components.weather.intent import INTENT_GET_WEATHER as INTENT_GET_WEATHER
+from homeassistant.components.weather import INTENT_GET_WEATHER as INTENT_GET_WEATHER
 from homeassistant.const import ATTR_DOMAIN as ATTR_DOMAIN, ATTR_ENTITY_ID as ATTR_ENTITY_ID, ATTR_SERVICE as ATTR_SERVICE, EVENT_HOMEASSISTANT_CLOSE as EVENT_HOMEASSISTANT_CLOSE, EVENT_SERVICE_REMOVED as EVENT_SERVICE_REMOVED, SERVICE_TURN_ON as SERVICE_TURN_ON
 from homeassistant.core import Context as Context, Event as Event, HomeAssistant as HomeAssistant, callback as callback, split_entity_id as split_entity_id
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError

homeassistant-stubs/helpers/script.pyi

@@ -143,7 +143,7 @@ class _QueuedScriptRun(_ScriptRun):
 def _schedule_stop_scripts_after_shutdown(hass: HomeAssistant) -> None: ...
 async def _async_stop_scripts_after_shutdown(hass: HomeAssistant, point_in_time: datetime) -> None: ...
 async def _async_stop_scripts_at_shutdown(hass: HomeAssistant, event: Event) -> None: ...
-_VarsType = dict[str, Any] | MappingProxyType[str, Any]
+_VarsType = dict[str, Any] | Mapping[str, Any] | MappingProxyType[str, Any]
 
 def _referenced_extract_ids(data: Any, key: str, found: set[str]) -> None: ...
 

homeassistant-stubs/helpers/state.pyi

@@ -1,7 +1,8 @@
 from _typeshed import Incomplete
 from collections.abc import Iterable
+from homeassistant.components.lock import LockState as LockState
 from homeassistant.components.sun import STATE_ABOVE_HORIZON as STATE_ABOVE_HORIZON, STATE_BELOW_HORIZON as STATE_BELOW_HORIZON
-from homeassistant.const import STATE_CLOSED as STATE_CLOSED, STATE_HOME as STATE_HOME, STATE_LOCKED as STATE_LOCKED, STATE_NOT_HOME as STATE_NOT_HOME, STATE_OFF as STATE_OFF, STATE_ON as STATE_ON, STATE_OPEN as STATE_OPEN, STATE_UNKNOWN as STATE_UNKNOWN, STATE_UNLOCKED as STATE_UNLOCKED
+from homeassistant.const import STATE_CLOSED as STATE_CLOSED, STATE_HOME as STATE_HOME, STATE_NOT_HOME as STATE_NOT_HOME, STATE_OFF as STATE_OFF, STATE_ON as STATE_ON, STATE_OPEN as STATE_OPEN, STATE_UNKNOWN as STATE_UNKNOWN
 from homeassistant.core import Context as Context, HomeAssistant as HomeAssistant, State as State
 from homeassistant.loader import IntegrationNotFound as IntegrationNotFound, async_get_integration as async_get_integration, bind_hass as bind_hass
 from typing import Any

homeassistant-stubs/helpers/template.pyi

@@ -1,5 +1,6 @@
 import jinja2
 from . import area_registry as area_registry, device_registry as device_registry, entity_registry as entity_registry, issue_registry as issue_registry, label_registry as label_registry
+from .deprecation import deprecated_function as deprecated_function
 from .singleton import singleton as singleton
 from .translation import async_translate_state as async_translate_state
 from .typing import TemplateVarsType as TemplateVarsType
@@ -10,7 +11,7 @@ from contextvars import ContextVar
 from datetime import datetime, timedelta
 from functools import cached_property as cached_property
 from homeassistant.const import ATTR_ENTITY_ID as ATTR_ENTITY_ID, ATTR_LATITUDE as ATTR_LATITUDE, ATTR_LONGITUDE as ATTR_LONGITUDE, ATTR_PERSONS as ATTR_PERSONS, ATTR_UNIT_OF_MEASUREMENT as ATTR_UNIT_OF_MEASUREMENT, EVENT_HOMEASSISTANT_START as EVENT_HOMEASSISTANT_START, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN, UnitOfLength as UnitOfLength
-from homeassistant.core import Context as Context, HomeAssistant as HomeAssistant, State as State, callback as callback, split_entity_id as split_entity_id, valid_domain as valid_domain, valid_entity_id as valid_entity_id
+from homeassistant.core import Context as Context, HomeAssistant as HomeAssistant, ServiceResponse as ServiceResponse, State as State, callback as callback, split_entity_id as split_entity_id, valid_domain as valid_domain, valid_entity_id as valid_entity_id
 from homeassistant.exceptions import TemplateError as TemplateError
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util import convert as convert
@@ -41,6 +42,7 @@ template_cv: ContextVar[tuple[str, str] | None]
 CACHED_TEMPLATE_STATES: int
 EVAL_CACHE_SIZE: int
 MAX_CUSTOM_TEMPLATE_SIZE: Incomplete
+MAX_TEMPLATE_OUTPUT: Incomplete
 CACHED_TEMPLATE_LRU: LRU[State, TemplateState]
 CACHED_TEMPLATE_NO_COLLECT_LRU: LRU[State, TemplateState]
 ENTITY_COUNT_GROWTH_FACTOR: float
@@ -50,6 +52,7 @@ def _template_state_no_collect(hass: HomeAssistant, state: State) -> TemplateSta
 def _template_state(hass: HomeAssistant, state: State) -> TemplateState: ...
 def async_setup(hass: HomeAssistant) -> bool: ...
 def attach(hass: HomeAssistant, obj: Any) -> None: ...
+def _attach(hass: HomeAssistant, obj: Any) -> None: ...
 def render_complex(value: Any, variables: TemplateVarsType = None, limited: bool = False, parse_result: bool = True) -> Any: ...
 def is_complex(value: Any) -> bool: ...
 def is_template_string(maybe_template: str) -> bool: ...
@@ -283,6 +286,7 @@ def timestamp_utc(value, default=...): ...
 def forgiving_as_timestamp(value, default=...): ...
 def as_datetime(value: Any, default: Any = ...) -> Any: ...
 def as_timedelta(value: str) -> timedelta | None: ...
+def merge_response(value: ServiceResponse) -> list[Any]: ...
 def strptime(string, fmt, default=...): ...
 def fail_when_undefined(value): ...
 def min_max_from_filter(builtin_filter: Any, name: str) -> Any: ...

homeassistant-stubs/util/aiohttp.pyi

@@ -10,6 +10,12 @@ class MockStreamReader:
     def __init__(self, content: bytes) -> None: ...
     async def read(self, byte_count: int = -1) -> bytes: ...
 
+class MockPayloadWriter:
+    def enable_chunking(self) -> None: ...
+    async def write_headers(self, *args: Any, **kwargs: Any) -> None: ...
+
+_MOCK_PAYLOAD_WRITER: Incomplete
+
 class MockRequest:
     mock_source: str | None
     method: Incomplete
@@ -17,8 +23,12 @@ class MockRequest:
     status: Incomplete
     headers: Incomplete
     query_string: Incomplete
+    keep_alive: bool
+    version: Incomplete
     _content: Incomplete
+    _payload_writer: Incomplete
     def __init__(self, content: bytes, mock_source: str, method: str = 'GET', status: int = ..., headers: dict[str, str] | None = None, query_string: str | None = None, url: str = '') -> None: ...
+    async def _prepare_hook(self, response: Any) -> None: ...
     @property
     def query(self) -> MultiDict[str]: ...
     @property

homeassistant-stubs/util/package.pyi

@@ -6,5 +6,8 @@ def is_virtual_env() -> bool: ...
 def is_docker_env() -> bool: ...
 def get_installed_versions(specifiers: set[str]) -> set[str]: ...
 def is_installed(requirement_str: str) -> bool: ...
+
+_UV_ENV_PYTHON_VARS: Incomplete
+
 def install_package(package: str, upgrade: bool = True, target: str | None = None, constraints: str | None = None, timeout: int | None = None) -> bool: ...
 async def async_get_user_site(deps_dir: str) -> str: ...

homeassistant-stubs/util/ssl.pyi

@@ -6,18 +6,22 @@ class SSLCipherList(StrEnum):
     PYTHON_DEFAULT = 'python_default'
     INTERMEDIATE = 'intermediate'
     MODERN = 'modern'
+    INSECURE = 'insecure'
 
 SSL_CIPHER_LISTS: Incomplete
 
-def _create_no_verify_ssl_context(ssl_cipher_list: SSLCipherList) -> ssl.SSLContext: ...
-def create_no_verify_ssl_context(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
-def _client_context(ssl_cipher_list: SSLCipherList) -> ssl.SSLContext: ...
-def client_context(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
+def _client_context_no_verify(ssl_cipher_list: SSLCipherList) -> ssl.SSLContext: ...
+def _client_context(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
 
 _DEFAULT_SSL_CONTEXT: Incomplete
 _DEFAULT_NO_VERIFY_SSL_CONTEXT: Incomplete
+_NO_VERIFY_SSL_CONTEXTS: Incomplete
+_SSL_CONTEXTS: Incomplete
 
 def get_default_context() -> ssl.SSLContext: ...
 def get_default_no_verify_context() -> ssl.SSLContext: ...
+def client_context_no_verify(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
+def client_context(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
+def create_no_verify_ssl_context(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
 def server_context_modern() -> ssl.SSLContext: ...
 def server_context_intermediate() -> ssl.SSLContext: ...

homeassistant-stubs/util/unit_conversion.pyi

@@ -15,6 +15,8 @@ _MIN_TO_SEC: int
 _HRS_TO_MINUTES: int
 _HRS_TO_SECS: Incomplete
 _DAYS_TO_SECS: Incomplete
+_WH_TO_J: int
+_WH_TO_CAL: Incomplete
 _POUND_TO_G: float
 _OUNCE_TO_G: Incomplete
 _STONE_TO_G: Incomplete

homeassistant-stubs/util/unit_system.pyi

@@ -13,6 +13,7 @@ PRESSURE_UNITS: Incomplete
 VOLUME_UNITS: Incomplete
 WIND_SPEED_UNITS: Incomplete
 TEMPERATURE_UNITS: set[str]
+_VALID_BY_TYPE: dict[str, set[str] | set[str | None]]
 
 def _is_valid_unit(unit: str, unit_type: str) -> bool: ...
 

{homeassistant_stubs-2024.9.3.dist-info → homeassistant_stubs-2024.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: homeassistant-stubs
-Version: 2024.9.3
+Version: 2024.10.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.13,>=3.12
-Requires-Dist: homeassistant==2024.9.3
+Requires-Dist: homeassistant==2024.10.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)