homeassistant-stubs 2024.7.4__tar.gz → 2024.8.0__tar.gz

homeassistant_stubs-2024.8.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.1
+Name: homeassistant-stubs
+Version: 2024.8.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.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.12
+Classifier: Topic :: Software Development
+Classifier: Typing :: Typed
+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
+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)
+[![PyPI version](https://img.shields.io/pypi/v/homeassistant-stubs)](https://pypi.org/project/homeassistant-stubs/)
+
+# PEP 484 stubs for Home Assistant Core
+
+This is unofficial stub-only package generated from [Home Assistant Core](https://github.com/home-assistant/core) sources.
+You can use it to enable type checks against Home Assistant code in your custom component or AppDaemon app.
+
+## How to use
+
+Add it to dev dependencies of your project.
+I recommend to use [Poetry](https://python-poetry.org/) for managing dependencies:
+
+```shell
+poetry add --group dev homeassistant-stubs
+```
+
+Please note that only stubs from strictly typed modules are added in this package.
+This includes all core modules and some components.
+Generic components like `sensor`, `light` or `media_player` are already typed.
+
+If your project imports not yet typed components, `mypy` will be unable to find that module.
+The best thing you can do to fix this is to submit PR to HA Core which adds type hints for these components.
+After that stubs for these components will become available in this package.
+
+## Motivation
+
+Home Assistant maintainers don't want to distribute typing information with `homeassistant` package
+([[1]](https://github.com/home-assistant/core/pull/28866),
+[[2]](https://github.com/home-assistant/core/pull/47796)).
+The reason is that [PEP 561](https://www.python.org/dev/peps/pep-0561/#packaging-type-information)
+says that `py.typed` marker is applied recursively and the whole package must support type checking.
+But many of the Home Assistant components are currently not type checked.
+
+## How it works
+
+- `update_stubs.py` script extracts list of strictly typed modules from Home Assistant configs.
+- Then it runs `stubgen` which is shipped with `mypy` to generate typing stubs.
+- New versions are generated and published automatically every 12 hours.
+

homeassistant_stubs-2024.8.0/homeassistant-stubs/auth/__init__.pyi

@@ -0,0 +1,84 @@
+from . import auth_store as auth_store, jwt_wrapper as jwt_wrapper, models as models
+from .const import ACCESS_TOKEN_EXPIRATION as ACCESS_TOKEN_EXPIRATION, GROUP_ID_ADMIN as GROUP_ID_ADMIN, REFRESH_TOKEN_EXPIRATION as REFRESH_TOKEN_EXPIRATION
+from .mfa_modules import MultiFactorAuthModule as MultiFactorAuthModule, auth_mfa_module_from_config as auth_mfa_module_from_config
+from .models import AuthFlowResult as AuthFlowResult
+from .providers import AuthProvider as AuthProvider, LoginFlow as LoginFlow, auth_provider_from_config as auth_provider_from_config
+from .providers.homeassistant import HassAuthProvider as HassAuthProvider
+from _typeshed import Incomplete
+from datetime import datetime, timedelta
+from homeassistant import data_entry_flow as data_entry_flow
+from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, HassJob as HassJob, HassJobType as HassJobType, HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.event import async_track_point_in_utc_time as async_track_point_in_utc_time
+from typing import Any
+
+EVENT_USER_ADDED: str
+EVENT_USER_UPDATED: str
+EVENT_USER_REMOVED: str
+_MfaModuleDict = dict[str, MultiFactorAuthModule]
+_ProviderKey = tuple[str, str | None]
+_ProviderDict = dict[_ProviderKey, AuthProvider]
+
+class InvalidAuthError(Exception): ...
+class InvalidProvider(Exception): ...
+
+async def auth_manager_from_config(hass: HomeAssistant, provider_configs: list[dict[str, Any]], module_configs: list[dict[str, Any]]) -> AuthManager: ...
+
+class AuthManagerFlowManager(data_entry_flow.FlowManager[AuthFlowResult, tuple[str, str]]):
+    _flow_result = AuthFlowResult
+    auth_manager: Incomplete
+    def __init__(self, hass: HomeAssistant, auth_manager: AuthManager) -> None: ...
+    async def async_create_flow(self, handler_key: tuple[str, str], *, context: dict[str, Any] | None = None, data: dict[str, Any] | None = None) -> LoginFlow: ...
+    async def async_finish_flow(self, flow: data_entry_flow.FlowHandler[AuthFlowResult, tuple[str, str]], result: AuthFlowResult) -> AuthFlowResult: ...
+
+class AuthManager:
+    hass: Incomplete
+    _store: Incomplete
+    _providers: Incomplete
+    _mfa_modules: Incomplete
+    login_flow: Incomplete
+    _revoke_callbacks: Incomplete
+    _expire_callback: Incomplete
+    _remove_expired_job: Incomplete
+    def __init__(self, hass: HomeAssistant, store: auth_store.AuthStore, providers: _ProviderDict, mfa_modules: _MfaModuleDict) -> None: ...
+    async def async_setup(self) -> None: ...
+    @property
+    def auth_providers(self) -> list[AuthProvider]: ...
+    @property
+    def auth_mfa_modules(self) -> list[MultiFactorAuthModule]: ...
+    def get_auth_provider(self, provider_type: str, provider_id: str | None) -> AuthProvider | None: ...
+    def get_auth_providers(self, provider_type: str) -> list[AuthProvider]: ...
+    def get_auth_mfa_module(self, module_id: str) -> MultiFactorAuthModule | None: ...
+    async def async_get_users(self) -> list[models.User]: ...
+    async def async_get_user(self, user_id: str) -> models.User | None: ...
+    async def async_get_owner(self) -> models.User | None: ...
+    async def async_get_group(self, group_id: str) -> models.Group | None: ...
+    async def async_get_user_by_credentials(self, credentials: models.Credentials) -> models.User | None: ...
+    async def async_create_system_user(self, name: str, *, group_ids: list[str] | None = None, local_only: bool | None = None) -> models.User: ...
+    async def async_create_user(self, name: str, *, group_ids: list[str] | None = None, local_only: bool | None = None) -> models.User: ...
+    async def async_get_or_create_user(self, credentials: models.Credentials) -> models.User: ...
+    async def async_link_user(self, user: models.User, credentials: models.Credentials) -> None: ...
+    async def async_remove_user(self, user: models.User) -> None: ...
+    async def async_update_user(self, user: models.User, name: str | None = None, is_active: bool | None = None, group_ids: list[str] | None = None, local_only: bool | None = None) -> None: ...
+    def async_update_user_credentials_data(self, credentials: models.Credentials, data: dict[str, Any]) -> None: ...
+    async def async_activate_user(self, user: models.User) -> None: ...
+    async def async_deactivate_user(self, user: models.User) -> None: ...
+    async def async_remove_credentials(self, credentials: models.Credentials) -> None: ...
+    async def async_enable_user_mfa(self, user: models.User, mfa_module_id: str, data: Any) -> None: ...
+    async def async_disable_user_mfa(self, user: models.User, mfa_module_id: str) -> None: ...
+    async def async_get_enabled_mfa(self, user: models.User) -> dict[str, str]: ...
+    async def async_create_refresh_token(self, user: models.User, client_id: str | None = None, client_name: str | None = None, client_icon: str | None = None, token_type: str | None = None, access_token_expiration: timedelta = ..., credential: models.Credentials | None = None) -> models.RefreshToken: ...
+    def async_get_refresh_token(self, token_id: str) -> models.RefreshToken | None: ...
+    def async_get_refresh_token_by_token(self, token: str) -> models.RefreshToken | None: ...
+    def async_remove_refresh_token(self, refresh_token: models.RefreshToken) -> None: ...
+    def async_set_expiry(self, refresh_token: models.RefreshToken, *, enable_expiry: bool) -> None: ...
+    def _async_remove_expired_refresh_tokens(self, _: datetime | None = None) -> None: ...
+    def _async_track_next_refresh_token_expiration(self) -> None: ...
+    def _async_cancel_expiration_schedule(self) -> None: ...
+    def _async_unregister(self, callbacks: set[CALLBACK_TYPE], callback_: CALLBACK_TYPE) -> None: ...
+    def async_register_revoke_token_callback(self, refresh_token_id: str, revoke_callback: CALLBACK_TYPE) -> CALLBACK_TYPE: ...
+    def async_create_access_token(self, refresh_token: models.RefreshToken, remote_ip: str | None = None) -> str: ...
+    def _async_resolve_provider(self, refresh_token: models.RefreshToken) -> AuthProvider | None: ...
+    def async_validate_refresh_token(self, refresh_token: models.RefreshToken, remote_ip: str | None = None) -> None: ...
+    def async_validate_access_token(self, token: str) -> models.RefreshToken | None: ...
+    def _async_get_auth_provider(self, credentials: models.Credentials) -> AuthProvider | None: ...
+    async def _user_should_be_owner(self) -> bool: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/auth/permissions/events.pyi

@@ -0,0 +1,12 @@
+from homeassistant.const import EVENT_COMPONENT_LOADED as EVENT_COMPONENT_LOADED, EVENT_CORE_CONFIG_UPDATE as EVENT_CORE_CONFIG_UPDATE, EVENT_LOVELACE_UPDATED as EVENT_LOVELACE_UPDATED, EVENT_PANELS_UPDATED as EVENT_PANELS_UPDATED, EVENT_RECORDER_5MIN_STATISTICS_GENERATED as EVENT_RECORDER_5MIN_STATISTICS_GENERATED, EVENT_RECORDER_HOURLY_STATISTICS_GENERATED as EVENT_RECORDER_HOURLY_STATISTICS_GENERATED, EVENT_SERVICE_REGISTERED as EVENT_SERVICE_REGISTERED, EVENT_SERVICE_REMOVED as EVENT_SERVICE_REMOVED, EVENT_SHOPPING_LIST_UPDATED as EVENT_SHOPPING_LIST_UPDATED, EVENT_STATE_CHANGED as EVENT_STATE_CHANGED, EVENT_THEMES_UPDATED as EVENT_THEMES_UPDATED
+from homeassistant.helpers.area_registry import EVENT_AREA_REGISTRY_UPDATED as EVENT_AREA_REGISTRY_UPDATED
+from homeassistant.helpers.category_registry import EVENT_CATEGORY_REGISTRY_UPDATED as EVENT_CATEGORY_REGISTRY_UPDATED
+from homeassistant.helpers.device_registry import EVENT_DEVICE_REGISTRY_UPDATED as EVENT_DEVICE_REGISTRY_UPDATED
+from homeassistant.helpers.entity_registry import EVENT_ENTITY_REGISTRY_UPDATED as EVENT_ENTITY_REGISTRY_UPDATED
+from homeassistant.helpers.floor_registry import EVENT_FLOOR_REGISTRY_UPDATED as EVENT_FLOOR_REGISTRY_UPDATED
+from homeassistant.helpers.issue_registry import EVENT_REPAIRS_ISSUE_REGISTRY_UPDATED as EVENT_REPAIRS_ISSUE_REGISTRY_UPDATED
+from homeassistant.helpers.label_registry import EVENT_LABEL_REGISTRY_UPDATED as EVENT_LABEL_REGISTRY_UPDATED
+from homeassistant.util.event_type import EventType as EventType
+from typing import Any, Final
+
+SUBSCRIBE_ALLOWLIST: Final[set[EventType[Any] | str]]

homeassistant_stubs-2024.8.0/homeassistant-stubs/auth/permissions/types.pyi

@@ -0,0 +1,7 @@
+from collections.abc import Mapping
+
+ValueType = Mapping[str, bool] | bool | None
+SubCategoryDict = Mapping[str, ValueType]
+SubCategoryType = SubCategoryDict | bool | None
+CategoryType = Mapping[str, SubCategoryType] | Mapping[str, ValueType] | bool | None
+PolicyType = Mapping[str, CategoryType]

homeassistant_stubs-2024.8.0/homeassistant-stubs/auth/permissions/util.pyi

@@ -0,0 +1,12 @@
+from .const import SUBCAT_ALL as SUBCAT_ALL
+from .models import PermissionLookup as PermissionLookup
+from .types import CategoryType as CategoryType, SubCategoryDict as SubCategoryDict, ValueType as ValueType
+from collections.abc import Callable
+
+LookupFunc = Callable[[PermissionLookup, SubCategoryDict, str], ValueType | None]
+SubCatLookupType = dict[str, LookupFunc]
+
+def lookup_all(perm_lookup: PermissionLookup, lookup_dict: SubCategoryDict, object_id: str) -> ValueType: ...
+def compile_policy(policy: CategoryType, subcategories: SubCatLookupType, perm_lookup: PermissionLookup) -> Callable[[str, str], bool]: ...
+def _gen_dict_test_func(perm_lookup: PermissionLookup, lookup_func: LookupFunc, lookup_dict: SubCategoryDict) -> Callable[[str, str], bool | None]: ...
+def test_all(policy: CategoryType, key: str) -> bool: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/auth/providers/trusted_networks.pyi

@@ -0,0 +1,43 @@
+from . import AUTH_PROVIDERS as AUTH_PROVIDERS, AUTH_PROVIDER_SCHEMA as AUTH_PROVIDER_SCHEMA, AuthProvider as AuthProvider, LoginFlow as LoginFlow
+from .. import InvalidAuthError as InvalidAuthError
+from ..models import AuthFlowResult as AuthFlowResult, Credentials as Credentials, RefreshToken as RefreshToken, UserMeta as UserMeta
+from _typeshed import Incomplete
+from collections.abc import Mapping
+from homeassistant.core import callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.network import is_cloud_connection as is_cloud_connection
+from ipaddress import IPv4Address, IPv4Network, IPv6Address, IPv6Network
+from typing import Any
+
+IPAddress = IPv4Address | IPv6Address
+IPNetwork = IPv4Network | IPv6Network
+CONF_TRUSTED_NETWORKS: str
+CONF_TRUSTED_USERS: str
+CONF_GROUP: str
+CONF_ALLOW_BYPASS_LOGIN: str
+CONFIG_SCHEMA: Incomplete
+
+class InvalidUserError(HomeAssistantError): ...
+
+class TrustedNetworksAuthProvider(AuthProvider):
+    DEFAULT_TITLE: str
+    @property
+    def trusted_networks(self) -> list[IPNetwork]: ...
+    @property
+    def trusted_users(self) -> dict[IPNetwork, Any]: ...
+    @property
+    def trusted_proxies(self) -> list[IPNetwork]: ...
+    @property
+    def support_mfa(self) -> bool: ...
+    async def async_login_flow(self, context: dict[str, Any] | None) -> LoginFlow: ...
+    async def async_get_or_create_credentials(self, flow_result: Mapping[str, str]) -> Credentials: ...
+    async def async_user_meta_for_credentials(self, credentials: Credentials) -> UserMeta: ...
+    def async_validate_access(self, ip_addr: IPAddress) -> None: ...
+    def async_validate_refresh_token(self, refresh_token: RefreshToken, remote_ip: str | None = None) -> None: ...
+
+class TrustedNetworksLoginFlow(LoginFlow):
+    _available_users: Incomplete
+    _ip_address: Incomplete
+    _allow_bypass_login: Incomplete
+    def __init__(self, auth_provider: TrustedNetworksAuthProvider, ip_addr: IPAddress, available_users: dict[str, str | None], allow_bypass_login: bool) -> None: ...
+    async def async_step_init(self, user_input: dict[str, str] | None = None) -> AuthFlowResult: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/bootstrap.pyi

@@ -0,0 +1,76 @@
+import logging
+from . import block_async_io as block_async_io, config_entries as config_entries, core as core, loader as loader, requirements as requirements
+from .components import http as http
+from .const import BASE_PLATFORMS as BASE_PLATFORMS, FORMAT_DATETIME as FORMAT_DATETIME, REQUIRED_NEXT_PYTHON_HA_RELEASE as REQUIRED_NEXT_PYTHON_HA_RELEASE, REQUIRED_NEXT_PYTHON_VER as REQUIRED_NEXT_PYTHON_VER, SIGNAL_BOOTSTRAP_INTEGRATIONS as SIGNAL_BOOTSTRAP_INTEGRATIONS
+from .exceptions import HomeAssistantError as HomeAssistantError
+from .helpers import area_registry as area_registry, category_registry as category_registry, device_registry as device_registry, entity as entity, entity_registry as entity_registry, floor_registry as floor_registry, issue_registry as issue_registry, label_registry as label_registry, recorder as recorder, restore_state as restore_state, template as template, translation as translation
+from .helpers.dispatcher import async_dispatcher_send_internal as async_dispatcher_send_internal
+from .helpers.storage import get_internal_store_manager as get_internal_store_manager
+from .helpers.system_info import async_get_system_info as async_get_system_info, is_official_image as is_official_image
+from .helpers.typing import ConfigType as ConfigType
+from .runner import RuntimeConfig as RuntimeConfig
+from .setup import _setup_started as _setup_started, async_get_setup_timings as async_get_setup_timings, async_notify_setup_error as async_notify_setup_error, async_set_domains_to_be_loaded as async_set_domains_to_be_loaded, async_setup_component as async_setup_component
+from .util.async_ import create_eager_task as create_eager_task
+from .util.hass_dict import HassKey as HassKey
+from .util.logging import async_activate_log_queue_handler as async_activate_log_queue_handler
+from .util.package import async_get_user_site as async_get_user_site, is_docker_env as is_docker_env, is_virtual_env as is_virtual_env
+from _typeshed import Incomplete
+from anyio._backends import _asyncio as _asyncio
+from logging.handlers import RotatingFileHandler, TimedRotatingFileHandler
+from typing import Any
+
+_LOGGER: Incomplete
+SETUP_ORDER_SORT_KEY: Incomplete
+ERROR_LOG_FILENAME: str
+DATA_REGISTRIES_LOADED: HassKey[None]
+LOG_SLOW_STARTUP_INTERVAL: int
+SLOW_STARTUP_CHECK_INTERVAL: int
+STAGE_1_TIMEOUT: int
+STAGE_2_TIMEOUT: int
+WRAP_UP_TIMEOUT: int
+COOLDOWN_TIME: int
+DEBUGGER_INTEGRATIONS: Incomplete
+CORE_INTEGRATIONS: Incomplete
+LOGGING_AND_HTTP_DEPS_INTEGRATIONS: Incomplete
+FRONTEND_INTEGRATIONS: Incomplete
+RECORDER_INTEGRATIONS: Incomplete
+DISCOVERY_INTEGRATIONS: Incomplete
+STAGE_1_INTEGRATIONS: Incomplete
+DEFAULT_INTEGRATIONS: Incomplete
+DEFAULT_INTEGRATIONS_RECOVERY_MODE: Incomplete
+DEFAULT_INTEGRATIONS_SUPERVISOR: Incomplete
+CRITICAL_INTEGRATIONS: Incomplete
+SETUP_ORDER: Incomplete
+PRELOAD_STORAGE: Incomplete
+
+async def async_setup_hass(runtime_config: RuntimeConfig) -> core.HomeAssistant | None: ...
+def open_hass_ui(hass: core.HomeAssistant) -> None: ...
+def _init_blocking_io_modules_in_executor() -> None: ...
+async def async_load_base_functionality(hass: core.HomeAssistant) -> None: ...
+async def async_from_config_dict(config: ConfigType, hass: core.HomeAssistant) -> core.HomeAssistant | None: ...
+async def async_enable_logging(hass: core.HomeAssistant, verbose: bool = False, log_rotate_days: int | None = None, log_file: str | None = None, log_no_color: bool = False) -> None: ...
+def _create_log_file(err_log_path: str, log_rotate_days: int | None) -> RotatingFileHandler | TimedRotatingFileHandler: ...
+
+class _RotatingFileHandlerWithoutShouldRollOver(RotatingFileHandler):
+    def shouldRollover(self, record: logging.LogRecord) -> bool: ...
+
+async def async_mount_local_lib_path(config_dir: str) -> str: ...
+def _get_domains(hass: core.HomeAssistant, config: dict[str, Any]) -> set[str]: ...
+
+class _WatchPendingSetups:
+    _hass: Incomplete
+    _setup_started: Incomplete
+    _duration_count: int
+    _handle: Incomplete
+    _previous_was_empty: bool
+    _loop: Incomplete
+    def __init__(self, hass: core.HomeAssistant, setup_started: dict[tuple[str, str | None], float]) -> None: ...
+    def _async_watch(self) -> None: ...
+    def _async_dispatch(self, remaining_with_setup_started: dict[str, float]) -> None: ...
+    def _async_schedule_next(self) -> None: ...
+    def async_start(self) -> None: ...
+    def async_stop(self) -> None: ...
+
+async def async_setup_multi_components(hass: core.HomeAssistant, domains: set[str], config: dict[str, Any]) -> None: ...
+async def _async_resolve_domains_to_setup(hass: core.HomeAssistant, config: dict[str, Any]) -> tuple[set[str], dict[str, loader.Integration]]: ...
+async def _async_set_up_integrations(hass: core.HomeAssistant, config: dict[str, Any]) -> None: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/components/abode/__init__.pyi

@@ -0,0 +1,45 @@
+from .const import CONF_POLLING as CONF_POLLING, DOMAIN as DOMAIN, LOGGER as LOGGER
+from _typeshed import Incomplete
+from dataclasses import dataclass
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import ATTR_DATE as ATTR_DATE, ATTR_DEVICE_ID as ATTR_DEVICE_ID, ATTR_ENTITY_ID as ATTR_ENTITY_ID, ATTR_TIME as ATTR_TIME, CONF_PASSWORD as CONF_PASSWORD, CONF_USERNAME as CONF_USERNAME, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, Platform as Platform
+from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, HomeAssistant as HomeAssistant, ServiceCall as ServiceCall
+from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, ConfigEntryNotReady as ConfigEntryNotReady
+from homeassistant.helpers.dispatcher import dispatcher_send as dispatcher_send
+from homeassistant.helpers.typing import ConfigType as ConfigType
+from jaraco.abode.client import Client as Abode
+
+SERVICE_SETTINGS: str
+SERVICE_CAPTURE_IMAGE: str
+SERVICE_TRIGGER_AUTOMATION: str
+ATTR_DEVICE_NAME: str
+ATTR_DEVICE_TYPE: str
+ATTR_EVENT_CODE: str
+ATTR_EVENT_NAME: str
+ATTR_EVENT_TYPE: str
+ATTR_EVENT_UTC: str
+ATTR_SETTING: str
+ATTR_USER_NAME: str
+ATTR_APP_TYPE: str
+ATTR_EVENT_BY: str
+ATTR_VALUE: str
+CONFIG_SCHEMA: Incomplete
+CHANGE_SETTING_SCHEMA: Incomplete
+CAPTURE_IMAGE_SCHEMA: Incomplete
+AUTOMATION_SCHEMA: Incomplete
+PLATFORMS: Incomplete
+
+@dataclass
+class AbodeSystem:
+    abode: Abode
+    polling: bool
+    entity_ids: set[str | None] = ...
+    logout_listener: CALLBACK_TYPE | None = ...
+    def __init__(self, abode, polling, entity_ids=..., logout_listener=...) -> None: ...
+
+async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
+async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
+def setup_hass_services(hass: HomeAssistant) -> None: ...
+async def setup_hass_events(hass: HomeAssistant) -> None: ...
+def setup_abode_events(hass: HomeAssistant) -> None: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/components/abode/sensor.pyi

@@ -0,0 +1,34 @@
+from . import AbodeSystem as AbodeSystem
+from .const import DOMAIN as DOMAIN
+from .entity import AbodeDevice as AbodeDevice
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import LIGHT_LUX as LIGHT_LUX, PERCENTAGE as PERCENTAGE, UnitOfTemperature as UnitOfTemperature
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from jaraco.abode.devices.sensor import Sensor as Sensor
+
+ABODE_TEMPERATURE_UNIT_HA_UNIT: Incomplete
+
+@dataclass(frozen=True, kw_only=True)
+class AbodeSensorDescription(SensorEntityDescription):
+    value_fn: Callable[[Sensor], float]
+    native_unit_of_measurement_fn: Callable[[Sensor], str]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., value_fn, native_unit_of_measurement_fn) -> None: ...
+
+SENSOR_TYPES: tuple[AbodeSensorDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class AbodeSensor(AbodeDevice, SensorEntity):
+    entity_description: AbodeSensorDescription
+    _device: Sensor
+    _attr_unique_id: Incomplete
+    def __init__(self, data: AbodeSystem, device: Sensor, description: AbodeSensorDescription) -> None: ...
+    @property
+    def native_value(self) -> float: ...
+    @property
+    def native_unit_of_measurement(self) -> str: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/components/accuweather/sensor.pyi

@@ -0,0 +1,59 @@
+from . import AccuWeatherConfigEntry as AccuWeatherConfigEntry
+from .const import API_METRIC as API_METRIC, ATTRIBUTION as ATTRIBUTION, ATTR_CATEGORY as ATTR_CATEGORY, ATTR_DIRECTION as ATTR_DIRECTION, ATTR_ENGLISH as ATTR_ENGLISH, ATTR_LEVEL as ATTR_LEVEL, ATTR_SPEED as ATTR_SPEED, ATTR_VALUE as ATTR_VALUE, MAX_FORECAST_DAYS as MAX_FORECAST_DAYS
+from .coordinator import AccuWeatherDailyForecastDataUpdateCoordinator as AccuWeatherDailyForecastDataUpdateCoordinator, AccuWeatherObservationDataUpdateCoordinator as AccuWeatherObservationDataUpdateCoordinator
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass
+from homeassistant.const import CONCENTRATION_PARTS_PER_CUBIC_METER as CONCENTRATION_PARTS_PER_CUBIC_METER, PERCENTAGE as PERCENTAGE, UV_INDEX as UV_INDEX, UnitOfIrradiance as UnitOfIrradiance, UnitOfLength as UnitOfLength, UnitOfSpeed as UnitOfSpeed, UnitOfTemperature as UnitOfTemperature, UnitOfTime as UnitOfTime, UnitOfVolumetricFlux as UnitOfVolumetricFlux
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+from typing import Any
+
+PARALLEL_UPDATES: int
+
+@dataclass(frozen=True, kw_only=True)
+class AccuWeatherSensorDescription(SensorEntityDescription):
+    value_fn: Callable[[dict[str, Any]], str | int | float | None]
+    attr_fn: Callable[[dict[str, Any]], dict[str, Any]] = ...
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., value_fn, attr_fn=...) -> None: ...
+
+FORECAST_SENSOR_TYPES: tuple[AccuWeatherSensorDescription, ...]
+SENSOR_TYPES: tuple[AccuWeatherSensorDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: AccuWeatherConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class AccuWeatherSensor(CoordinatorEntity[AccuWeatherObservationDataUpdateCoordinator], SensorEntity):
+    _attr_attribution = ATTRIBUTION
+    _attr_has_entity_name: bool
+    entity_description: AccuWeatherSensorDescription
+    _sensor_data: Incomplete
+    _attr_unique_id: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, coordinator: AccuWeatherObservationDataUpdateCoordinator, description: AccuWeatherSensorDescription) -> None: ...
+    @property
+    def native_value(self) -> str | int | float | None: ...
+    @property
+    def extra_state_attributes(self) -> dict[str, Any]: ...
+    def _handle_coordinator_update(self) -> None: ...
+    @staticmethod
+    def _get_sensor_data(sensors: dict[str, Any], kind: str) -> Any: ...
+
+class AccuWeatherForecastSensor(CoordinatorEntity[AccuWeatherDailyForecastDataUpdateCoordinator], SensorEntity):
+    _attr_attribution = ATTRIBUTION
+    _attr_has_entity_name: bool
+    entity_description: AccuWeatherSensorDescription
+    _sensor_data: Incomplete
+    _attr_unique_id: Incomplete
+    _attr_device_info: Incomplete
+    _attr_translation_placeholders: Incomplete
+    forecast_day: Incomplete
+    def __init__(self, coordinator: AccuWeatherDailyForecastDataUpdateCoordinator, description: AccuWeatherSensorDescription, forecast_day: int) -> None: ...
+    @property
+    def native_value(self) -> str | int | float | None: ...
+    @property
+    def extra_state_attributes(self) -> dict[str, Any]: ...
+    def _handle_coordinator_update(self) -> None: ...
+    @staticmethod
+    def _get_sensor_data(sensors: list[dict[str, Any]], kind: str, forecast_day: int) -> Any: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/components/adguard/sensor.pyi

@@ -0,0 +1,31 @@
+from . import AdGuardConfigEntry as AdGuardConfigEntry, AdGuardData as AdGuardData
+from .const import DOMAIN as DOMAIN
+from .entity import AdGuardHomeEntity as AdGuardHomeEntity
+from _typeshed import Incomplete
+from adguardhome import AdGuardHome as AdGuardHome
+from collections.abc import Callable as Callable, Coroutine
+from dataclasses import dataclass
+from homeassistant.components.sensor import SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription
+from homeassistant.const import PERCENTAGE as PERCENTAGE, UnitOfTime as UnitOfTime
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from typing import Any
+
+SCAN_INTERVAL: Incomplete
+PARALLEL_UPDATES: int
+
+@dataclass(frozen=True, kw_only=True)
+class AdGuardHomeEntityDescription(SensorEntityDescription):
+    value_fn: Callable[[AdGuardHome], Coroutine[Any, Any, int | float]]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., value_fn) -> None: ...
+
+SENSORS: tuple[AdGuardHomeEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: AdGuardConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class AdGuardHomeSensor(AdGuardHomeEntity, SensorEntity):
+    entity_description: AdGuardHomeEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, data: AdGuardData, entry: AdGuardConfigEntry, description: AdGuardHomeEntityDescription) -> None: ...
+    _attr_native_value: Incomplete
+    async def _adguard_update(self) -> None: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/components/adguard/switch.pyi

@@ -0,0 +1,35 @@
+from . import AdGuardConfigEntry as AdGuardConfigEntry, AdGuardData as AdGuardData
+from .const import DOMAIN as DOMAIN, LOGGER as LOGGER
+from .entity import AdGuardHomeEntity as AdGuardHomeEntity
+from _typeshed import Incomplete
+from adguardhome import AdGuardHome as AdGuardHome
+from collections.abc import Callable as Callable, Coroutine
+from dataclasses import dataclass
+from homeassistant.components.switch import SwitchEntity as SwitchEntity, SwitchEntityDescription as SwitchEntityDescription
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from typing import Any
+
+SCAN_INTERVAL: Incomplete
+PARALLEL_UPDATES: int
+
+@dataclass(frozen=True, kw_only=True)
+class AdGuardHomeSwitchEntityDescription(SwitchEntityDescription):
+    is_on_fn: Callable[[AdGuardHome], Callable[[], Coroutine[Any, Any, bool]]]
+    turn_on_fn: Callable[[AdGuardHome], Callable[[], Coroutine[Any, Any, None]]]
+    turn_off_fn: Callable[[AdGuardHome], Callable[[], Coroutine[Any, Any, None]]]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., is_on_fn, turn_on_fn, turn_off_fn) -> None: ...
+
+SWITCHES: tuple[AdGuardHomeSwitchEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: AdGuardConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class AdGuardHomeSwitch(AdGuardHomeEntity, SwitchEntity):
+    entity_description: AdGuardHomeSwitchEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, data: AdGuardData, entry: AdGuardConfigEntry, description: AdGuardHomeSwitchEntityDescription) -> None: ...
+    _attr_available: bool
+    async def async_turn_off(self, **kwargs: Any) -> None: ...
+    async def async_turn_on(self, **kwargs: Any) -> None: ...
+    _attr_is_on: Incomplete
+    async def _adguard_update(self) -> None: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/components/airgradient/__init__.pyi

@@ -0,0 +1,19 @@
+from .const import DOMAIN as DOMAIN
+from .coordinator import AirGradientConfigCoordinator as AirGradientConfigCoordinator, AirGradientMeasurementCoordinator as AirGradientMeasurementCoordinator
+from dataclasses import dataclass
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import CONF_HOST as CONF_HOST, Platform as Platform
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+
+PLATFORMS: list[Platform]
+
+@dataclass
+class AirGradientData:
+    measurement: AirGradientMeasurementCoordinator
+    config: AirGradientConfigCoordinator
+    def __init__(self, measurement, config) -> None: ...
+AirGradientConfigEntry = ConfigEntry[AirGradientData]
+
+async def async_setup_entry(hass: HomeAssistant, entry: AirGradientConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: AirGradientConfigEntry) -> bool: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/components/airgradient/button.pyi

@@ -0,0 +1,28 @@
+from . import AirGradientConfigEntry as AirGradientConfigEntry, DOMAIN as DOMAIN
+from .coordinator import AirGradientConfigCoordinator as AirGradientConfigCoordinator
+from .entity import AirGradientEntity as AirGradientEntity
+from _typeshed import Incomplete
+from airgradient import AirGradientClient as AirGradientClient
+from collections.abc import Awaitable, Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.button import ButtonEntity as ButtonEntity, ButtonEntityDescription as ButtonEntityDescription
+from homeassistant.const import EntityCategory as EntityCategory
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+
+@dataclass(frozen=True, kw_only=True)
+class AirGradientButtonEntityDescription(ButtonEntityDescription):
+    press_fn: Callable[[AirGradientClient], Awaitable[None]]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., press_fn) -> None: ...
+
+CO2_CALIBRATION: Incomplete
+LED_BAR_TEST: Incomplete
+
+async def async_setup_entry(hass: HomeAssistant, entry: AirGradientConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class AirGradientButton(AirGradientEntity, ButtonEntity):
+    entity_description: AirGradientButtonEntityDescription
+    coordinator: AirGradientConfigCoordinator
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: AirGradientConfigCoordinator, description: AirGradientButtonEntityDescription) -> None: ...
+    async def async_press(self) -> None: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/components/airgradient/coordinator.pyi

@@ -0,0 +1,20 @@
+from . import AirGradientConfigEntry as AirGradientConfigEntry
+from .const import LOGGER as LOGGER
+from _typeshed import Incomplete
+from airgradient import AirGradientClient as AirGradientClient, Config, Measures
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+
+class AirGradientCoordinator(DataUpdateCoordinator[_DataT]):
+    config_entry: AirGradientConfigEntry
+    client: Incomplete
+    serial_number: Incomplete
+    def __init__(self, hass: HomeAssistant, client: AirGradientClient) -> None: ...
+    async def _async_update_data(self) -> _DataT: ...
+    async def _update_data(self) -> _DataT: ...
+
+class AirGradientMeasurementCoordinator(AirGradientCoordinator[Measures]):
+    async def _update_data(self) -> Measures: ...
+
+class AirGradientConfigCoordinator(AirGradientCoordinator[Config]):
+    async def _update_data(self) -> Config: ...

homeassistant_stubs-2024.8.0/homeassistant-stubs/components/airgradient/number.pyi

@@ -0,0 +1,32 @@
+from . import AirGradientConfigEntry as AirGradientConfigEntry
+from .const import DOMAIN as DOMAIN
+from .coordinator import AirGradientConfigCoordinator as AirGradientConfigCoordinator
+from .entity import AirGradientEntity as AirGradientEntity
+from _typeshed import Incomplete
+from airgradient import AirGradientClient as AirGradientClient, Config as Config
+from collections.abc import Awaitable, Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.number import NumberEntity as NumberEntity, NumberEntityDescription as NumberEntityDescription
+from homeassistant.const import EntityCategory as EntityCategory, PERCENTAGE as PERCENTAGE
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+
+@dataclass(frozen=True, kw_only=True)
+class AirGradientNumberEntityDescription(NumberEntityDescription):
+    value_fn: Callable[[Config], int]
+    set_value_fn: Callable[[AirGradientClient, int], Awaitable[None]]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., max_value=..., min_value=..., mode=..., native_max_value=..., native_min_value=..., native_step=..., native_unit_of_measurement=..., step=..., value_fn, set_value_fn) -> None: ...
+
+DISPLAY_BRIGHTNESS: Incomplete
+LED_BAR_BRIGHTNESS: Incomplete
+
+async def async_setup_entry(hass: HomeAssistant, entry: AirGradientConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class AirGradientNumber(AirGradientEntity, NumberEntity):
+    entity_description: AirGradientNumberEntityDescription
+    coordinator: AirGradientConfigCoordinator
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: AirGradientConfigCoordinator, description: AirGradientNumberEntityDescription) -> None: ...
+    @property
+    def native_value(self) -> int | None: ...
+    async def async_set_native_value(self, value: float) -> None: ...