homeassistant-stubs 2023.4.0b4__tar.gz → 2023.4.0b6__tar.gz

homeassistant_stubs-2023.4.0b6/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.1
+Name: homeassistant-stubs
+Version: 2023.4.0b6
+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.10,<4.0
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development
+Classifier: Typing :: Typed
+Requires-Dist: homeassistant (==2023.4.0b6)
+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 --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-2023.4.0b6/homeassistant-stubs/auth/__init__.pyi

@@ -0,0 +1,72 @@
+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
+from .mfa_modules import MultiFactorAuthModule as MultiFactorAuthModule, auth_mfa_module_from_config as auth_mfa_module_from_config
+from .providers import AuthProvider as AuthProvider, LoginFlow as LoginFlow, auth_provider_from_config as auth_provider_from_config
+from _typeshed import Incomplete
+from datetime import timedelta
+from homeassistant import data_entry_flow as data_entry_flow
+from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.data_entry_flow import FlowResult as FlowResult
+from typing import Any
+
+EVENT_USER_ADDED: str
+EVENT_USER_UPDATED: str
+EVENT_USER_REMOVED: str
+_MfaModuleDict = dict[str, MultiFactorAuthModule]
+_ProviderKey: Incomplete
+_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):
+    auth_manager: Incomplete
+    def __init__(self, hass: HomeAssistant, auth_manager: AuthManager) -> None: ...
+    async def async_create_flow(self, handler_key: str, *, context: dict[str, Any] | None = ..., data: dict[str, Any] | None = ...) -> data_entry_flow.FlowHandler: ...
+    async def async_finish_flow(self, flow: data_entry_flow.FlowHandler, result: FlowResult) -> FlowResult: ...
+
+class AuthManager:
+    hass: Incomplete
+    _store: Incomplete
+    _providers: Incomplete
+    _mfa_modules: Incomplete
+    login_flow: Incomplete
+    _revoke_callbacks: Incomplete
+    def __init__(self, hass: HomeAssistant, store: auth_store.AuthStore, providers: _ProviderDict, mfa_modules: _MfaModuleDict) -> 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 = ..., local_only: bool | None = ...) -> models.User: ...
+    async def async_create_user(self, name: str, *, group_ids: list[str] | None = ..., local_only: bool | 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 = ..., is_active: bool | None = ..., group_ids: list[str] | None = ..., local_only: bool | None = ...) -> 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 = ..., client_name: str | None = ..., client_icon: str | None = ..., token_type: str | None = ..., access_token_expiration: timedelta = ..., credential: models.Credentials | None = ...) -> models.RefreshToken: ...
+    async def async_get_refresh_token(self, token_id: str) -> models.RefreshToken | None: ...
+    async def async_get_refresh_token_by_token(self, token: str) -> models.RefreshToken | None: ...
+    async def async_remove_refresh_token(self, refresh_token: models.RefreshToken) -> 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 = ...) -> 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: ...
+    async 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-2023.4.0b6/homeassistant-stubs/auth/auth_store.pyi

@@ -0,0 +1,50 @@
+from . import models as models
+from .const import ACCESS_TOKEN_EXPIRATION as ACCESS_TOKEN_EXPIRATION, GROUP_ID_ADMIN as GROUP_ID_ADMIN, GROUP_ID_READ_ONLY as GROUP_ID_READ_ONLY, GROUP_ID_USER as GROUP_ID_USER
+from .permissions import system_policies as system_policies
+from .permissions.models import PermissionLookup as PermissionLookup
+from .permissions.types import PolicyType as PolicyType
+from _typeshed import Incomplete
+from datetime import timedelta
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.storage import Store as Store
+from typing import Any
+
+STORAGE_VERSION: int
+STORAGE_KEY: str
+GROUP_NAME_ADMIN: str
+GROUP_NAME_USER: str
+GROUP_NAME_READ_ONLY: str
+
+class AuthStore:
+    hass: Incomplete
+    _users: Incomplete
+    _groups: Incomplete
+    _perm_lookup: Incomplete
+    _store: Incomplete
+    _lock: Incomplete
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    async def async_get_groups(self) -> list[models.Group]: ...
+    async def async_get_group(self, group_id: str) -> models.Group | 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_create_user(self, name: str | None, is_owner: bool | None = ..., is_active: bool | None = ..., system_generated: bool | None = ..., credentials: models.Credentials | None = ..., group_ids: list[str] | None = ..., local_only: bool | None = ...) -> 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 = ..., is_active: bool | None = ..., group_ids: list[str] | None = ..., local_only: bool | None = ...) -> 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_create_refresh_token(self, user: models.User, client_id: str | None = ..., client_name: str | None = ..., client_icon: str | None = ..., token_type: str = ..., access_token_expiration: timedelta = ..., credential: models.Credentials | None = ...) -> models.RefreshToken: ...
+    async def async_remove_refresh_token(self, refresh_token: models.RefreshToken) -> None: ...
+    async def async_get_refresh_token(self, token_id: str) -> models.RefreshToken | None: ...
+    async def async_get_refresh_token_by_token(self, token: str) -> models.RefreshToken | None: ...
+    def async_log_refresh_token_usage(self, refresh_token: models.RefreshToken, remote_ip: str | None = ...) -> None: ...
+    async def _async_load(self) -> None: ...
+    async def _async_load_task(self) -> None: ...
+    def _async_schedule_save(self) -> None: ...
+    def _data_to_save(self) -> dict[str, list[dict[str, Any]]]: ...
+    def _set_defaults(self) -> None: ...
+
+def _system_admin_group() -> models.Group: ...
+def _system_user_group() -> models.Group: ...
+def _system_read_only_group() -> models.Group: ...

homeassistant_stubs-2023.4.0b6/homeassistant-stubs/auth/jwt_wrapper.pyi

@@ -0,0 +1,14 @@
+from _typeshed import Incomplete
+from datetime import timedelta
+from jwt import PyJWS, PyJWT
+from typing import Any
+
+class _PyJWSWithLoadCache(PyJWS):
+    def _load(self, jwt: str | bytes) -> tuple[bytes, bytes, dict, bytes]: ...
+
+class _PyJWTWithVerify(PyJWT):
+    def decode_payload(self, jwt: str, key: str, options: dict[str, Any], algorithms: list[str]) -> dict[str, Any]: ...
+    def verify_and_decode(self, jwt: str, key: str, algorithms: list[str], issuer: str | None = ..., leeway: int | float | timedelta = ..., options: dict[str, Any] | None = ...) -> dict[str, Any]: ...
+
+verify_and_decode: Incomplete
+unverified_hs256_token_decode: Incomplete

homeassistant_stubs-2023.4.0b6/homeassistant-stubs/auth/mfa_modules/__init__.pyi

@@ -0,0 +1,45 @@
+import types
+import voluptuous as vol
+from _typeshed import Incomplete
+from homeassistant import data_entry_flow as data_entry_flow, requirements as requirements
+from homeassistant.const import CONF_ID as CONF_ID, CONF_NAME as CONF_NAME, CONF_TYPE as CONF_TYPE
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.data_entry_flow import FlowResult as FlowResult
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.util.decorator import Registry as Registry
+from typing import Any
+
+MULTI_FACTOR_AUTH_MODULES: Registry[str, type[MultiFactorAuthModule]]
+MULTI_FACTOR_AUTH_MODULE_SCHEMA: Incomplete
+DATA_REQS: str
+_LOGGER: Incomplete
+
+class MultiFactorAuthModule:
+    DEFAULT_TITLE: str
+    MAX_RETRY_TIME: int
+    hass: Incomplete
+    config: Incomplete
+    def __init__(self, hass: HomeAssistant, config: dict[str, Any]) -> None: ...
+    @property
+    def id(self) -> str: ...
+    @property
+    def type(self) -> str: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def input_schema(self) -> vol.Schema: ...
+    async def async_setup_flow(self, user_id: str) -> SetupFlow: ...
+    async def async_setup_user(self, user_id: str, setup_data: Any) -> Any: ...
+    async def async_depose_user(self, user_id: str) -> None: ...
+    async def async_is_user_setup(self, user_id: str) -> bool: ...
+    async def async_validate(self, user_id: str, user_input: dict[str, Any]) -> bool: ...
+
+class SetupFlow(data_entry_flow.FlowHandler):
+    _auth_module: Incomplete
+    _setup_schema: Incomplete
+    _user_id: Incomplete
+    def __init__(self, auth_module: MultiFactorAuthModule, setup_schema: vol.Schema, user_id: str) -> None: ...
+    async def async_step_init(self, user_input: dict[str, str] | None = ...) -> FlowResult: ...
+
+async def auth_mfa_module_from_config(hass: HomeAssistant, config: dict[str, Any]) -> MultiFactorAuthModule: ...
+async def _load_mfa_module(hass: HomeAssistant, module_name: str) -> types.ModuleType: ...

homeassistant_stubs-2023.4.0b6/homeassistant-stubs/auth/mfa_modules/notify.pyi

@@ -0,0 +1,70 @@
+import voluptuous as vol
+from . import MULTI_FACTOR_AUTH_MODULES as MULTI_FACTOR_AUTH_MODULES, MULTI_FACTOR_AUTH_MODULE_SCHEMA as MULTI_FACTOR_AUTH_MODULE_SCHEMA, MultiFactorAuthModule as MultiFactorAuthModule, SetupFlow as SetupFlow
+from _typeshed import Incomplete
+from homeassistant.const import CONF_EXCLUDE as CONF_EXCLUDE, CONF_INCLUDE as CONF_INCLUDE
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.data_entry_flow import FlowResult as FlowResult
+from homeassistant.exceptions import ServiceNotFound as ServiceNotFound
+from homeassistant.helpers.storage import Store as Store
+from typing import Any
+
+REQUIREMENTS: Incomplete
+CONF_MESSAGE: str
+CONFIG_SCHEMA: Incomplete
+STORAGE_VERSION: int
+STORAGE_KEY: str
+STORAGE_USERS: str
+STORAGE_USER_ID: str
+INPUT_FIELD_CODE: str
+_LOGGER: Incomplete
+
+def _generate_secret() -> str: ...
+def _generate_random() -> int: ...
+def _generate_otp(secret: str, count: int) -> str: ...
+def _verify_otp(secret: str, otp: str, count: int) -> bool: ...
+
+class NotifySetting:
+    secret: str
+    counter: int
+    notify_service: str | None
+    target: str | None
+    def __init__(self, secret, counter, notify_service, target) -> None: ...
+    def __lt__(self, other): ...
+    def __le__(self, other): ...
+    def __gt__(self, other): ...
+    def __ge__(self, other): ...
+_UsersDict = dict[str, NotifySetting]
+
+class NotifyAuthModule(MultiFactorAuthModule):
+    DEFAULT_TITLE: str
+    _user_settings: Incomplete
+    _user_store: Incomplete
+    _include: Incomplete
+    _exclude: Incomplete
+    _message_template: Incomplete
+    _init_lock: Incomplete
+    def __init__(self, hass: HomeAssistant, config: dict[str, Any]) -> None: ...
+    @property
+    def input_schema(self) -> vol.Schema: ...
+    async def _async_load(self) -> None: ...
+    async def _async_save(self) -> None: ...
+    def aync_get_available_notify_services(self) -> list[str]: ...
+    async def async_setup_flow(self, user_id: str) -> SetupFlow: ...
+    async def async_setup_user(self, user_id: str, setup_data: Any) -> Any: ...
+    async def async_depose_user(self, user_id: str) -> None: ...
+    async def async_is_user_setup(self, user_id: str) -> bool: ...
+    async def async_validate(self, user_id: str, user_input: dict[str, Any]) -> bool: ...
+    async def async_initialize_login_mfa_step(self, user_id: str) -> None: ...
+    async def async_notify_user(self, user_id: str, code: str) -> None: ...
+    async def async_notify(self, code: str, notify_service: str, target: str | None = ...) -> None: ...
+
+class NotifySetupFlow(SetupFlow):
+    _auth_module: Incomplete
+    _available_notify_services: Incomplete
+    _secret: Incomplete
+    _count: Incomplete
+    _notify_service: Incomplete
+    _target: Incomplete
+    def __init__(self, auth_module: NotifyAuthModule, setup_schema: vol.Schema, user_id: str, available_notify_services: list[str]) -> None: ...
+    async def async_step_init(self, user_input: dict[str, str] | None = ...) -> FlowResult: ...
+    async def async_step_setup(self, user_input: dict[str, str] | None = ...) -> FlowResult: ...

homeassistant_stubs-2023.4.0b6/homeassistant-stubs/auth/mfa_modules/totp.pyi

@@ -0,0 +1,49 @@
+import voluptuous as vol
+from . import MULTI_FACTOR_AUTH_MODULES as MULTI_FACTOR_AUTH_MODULES, MULTI_FACTOR_AUTH_MODULE_SCHEMA as MULTI_FACTOR_AUTH_MODULE_SCHEMA, MultiFactorAuthModule as MultiFactorAuthModule, SetupFlow as SetupFlow
+from _typeshed import Incomplete
+from homeassistant.auth.models import User as User
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.data_entry_flow import FlowResult as FlowResult
+from homeassistant.helpers.storage import Store as Store
+from typing import Any
+
+REQUIREMENTS: Incomplete
+CONFIG_SCHEMA: Incomplete
+STORAGE_VERSION: int
+STORAGE_KEY: str
+STORAGE_USERS: str
+STORAGE_USER_ID: str
+STORAGE_OTA_SECRET: str
+INPUT_FIELD_CODE: str
+DUMMY_SECRET: str
+
+def _generate_qr_code(data: str) -> str: ...
+def _generate_secret_and_qr_code(username: str) -> tuple[str, str, str]: ...
+
+class TotpAuthModule(MultiFactorAuthModule):
+    DEFAULT_TITLE: str
+    MAX_RETRY_TIME: int
+    _users: Incomplete
+    _user_store: Incomplete
+    _init_lock: Incomplete
+    def __init__(self, hass: HomeAssistant, config: dict[str, Any]) -> None: ...
+    @property
+    def input_schema(self) -> vol.Schema: ...
+    async def _async_load(self) -> None: ...
+    async def _async_save(self) -> None: ...
+    def _add_ota_secret(self, user_id: str, secret: str | None = ...) -> str: ...
+    async def async_setup_flow(self, user_id: str) -> SetupFlow: ...
+    async def async_setup_user(self, user_id: str, setup_data: Any) -> str: ...
+    async def async_depose_user(self, user_id: str) -> None: ...
+    async def async_is_user_setup(self, user_id: str) -> bool: ...
+    async def async_validate(self, user_id: str, user_input: dict[str, Any]) -> bool: ...
+    def _validate_2fa(self, user_id: str, code: str) -> bool: ...
+
+class TotpSetupFlow(SetupFlow):
+    _auth_module: Incomplete
+    _user: Incomplete
+    _ota_secret: str
+    _url: Incomplete
+    _image: Incomplete
+    def __init__(self, auth_module: TotpAuthModule, setup_schema: vol.Schema, user: User) -> None: ...
+    async def async_step_init(self, user_input: dict[str, str] | None = ...) -> FlowResult: ...

homeassistant_stubs-2023.4.0b6/homeassistant-stubs/auth/models.pyi

@@ -0,0 +1,80 @@
+from . import permissions as perm_mdl
+from .const import GROUP_ID_ADMIN as GROUP_ID_ADMIN
+from datetime import datetime, timedelta
+from homeassistant.const import __version__ as __version__
+from typing import NamedTuple
+
+TOKEN_TYPE_NORMAL: str
+TOKEN_TYPE_SYSTEM: str
+TOKEN_TYPE_LONG_LIVED_ACCESS_TOKEN: str
+
+class Group:
+    name: str | None
+    policy: perm_mdl.PolicyType
+    id: str
+    system_generated: bool
+    def __init__(self, name, policy, id, system_generated) -> None: ...
+    def __lt__(self, other): ...
+    def __le__(self, other): ...
+    def __gt__(self, other): ...
+    def __ge__(self, other): ...
+
+class User:
+    name: str | None
+    perm_lookup: perm_mdl.PermissionLookup
+    id: str
+    is_owner: bool
+    is_active: bool
+    system_generated: bool
+    local_only: bool
+    groups: list[Group]
+    credentials: list[Credentials]
+    refresh_tokens: dict[str, RefreshToken]
+    _permissions: perm_mdl.PolicyPermissions | None
+    @property
+    def permissions(self) -> perm_mdl.AbstractPermissions: ...
+    @property
+    def is_admin(self) -> bool: ...
+    def invalidate_permission_cache(self) -> None: ...
+    def __init__(self, name, perm_lookup, id, is_owner, is_active, system_generated, local_only, groups, credentials, refresh_tokens, permissions) -> None: ...
+    def __lt__(self, other): ...
+    def __le__(self, other): ...
+    def __gt__(self, other): ...
+    def __ge__(self, other): ...
+
+class RefreshToken:
+    user: User
+    client_id: str | None
+    access_token_expiration: timedelta
+    client_name: str | None
+    client_icon: str | None
+    token_type: str
+    id: str
+    created_at: datetime
+    token: str
+    jwt_key: str
+    last_used_at: datetime | None
+    last_used_ip: str | None
+    credential: Credentials | None
+    version: str | None
+    def __init__(self, user, client_id, access_token_expiration, client_name, client_icon, token_type, id, created_at, token, jwt_key, last_used_at, last_used_ip, credential, version) -> None: ...
+    def __lt__(self, other): ...
+    def __le__(self, other): ...
+    def __gt__(self, other): ...
+    def __ge__(self, other): ...
+
+class Credentials:
+    auth_provider_type: str
+    auth_provider_id: str | None
+    data: dict
+    id: str
+    is_new: bool
+    def __init__(self, auth_provider_type, auth_provider_id, data, id, is_new) -> None: ...
+    def __lt__(self, other): ...
+    def __le__(self, other): ...
+    def __gt__(self, other): ...
+    def __ge__(self, other): ...
+
+class UserMeta(NamedTuple):
+    name: str | None
+    is_active: bool

homeassistant_stubs-2023.4.0b6/homeassistant-stubs/auth/permissions/__init__.pyi

@@ -0,0 +1,28 @@
+from .merge import merge_policies as merge_policies
+from .models import PermissionLookup as PermissionLookup
+from .types import PolicyType as PolicyType
+from _typeshed import Incomplete
+from collections.abc import Callable
+from typing import Any
+
+POLICY_SCHEMA: Incomplete
+
+class AbstractPermissions:
+    _cached_entity_func: Callable[[str, str], bool] | None
+    def _entity_func(self) -> Callable[[str, str], bool]: ...
+    def access_all_entities(self, key: str) -> bool: ...
+    def check_entity(self, entity_id: str, key: str) -> bool: ...
+
+class PolicyPermissions(AbstractPermissions):
+    _policy: Incomplete
+    _perm_lookup: Incomplete
+    def __init__(self, policy: PolicyType, perm_lookup: PermissionLookup) -> None: ...
+    def access_all_entities(self, key: str) -> bool: ...
+    def _entity_func(self) -> Callable[[str, str], bool]: ...
+    def __eq__(self, other: Any) -> bool: ...
+
+class _OwnerPermissions(AbstractPermissions):
+    def access_all_entities(self, key: str) -> bool: ...
+    def _entity_func(self) -> Callable[[str, str], bool]: ...
+
+OwnerPermissions: Incomplete

homeassistant_stubs-2023.4.0b6/homeassistant-stubs/auth/permissions/entities.pyi

@@ -0,0 +1,20 @@
+from .const import POLICY_CONTROL as POLICY_CONTROL, POLICY_EDIT as POLICY_EDIT, POLICY_READ as POLICY_READ, SUBCAT_ALL as SUBCAT_ALL
+from .models import PermissionLookup as PermissionLookup
+from .types import CategoryType as CategoryType, SubCategoryDict as SubCategoryDict, ValueType as ValueType
+from .util import SubCatLookupType as SubCatLookupType, compile_policy as compile_policy, lookup_all as lookup_all
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+
+SINGLE_ENTITY_SCHEMA: Incomplete
+ENTITY_DOMAINS: str
+ENTITY_AREAS: str
+ENTITY_DEVICE_IDS: str
+ENTITY_ENTITY_IDS: str
+ENTITY_VALUES_SCHEMA: Incomplete
+ENTITY_POLICY_SCHEMA: Incomplete
+
+def _lookup_domain(perm_lookup: PermissionLookup, domains_dict: SubCategoryDict, entity_id: str) -> ValueType | None: ...
+def _lookup_area(perm_lookup: PermissionLookup, area_dict: SubCategoryDict, entity_id: str) -> ValueType | None: ...
+def _lookup_device(perm_lookup: PermissionLookup, devices_dict: SubCategoryDict, entity_id: str) -> ValueType | None: ...
+def _lookup_entity_id(perm_lookup: PermissionLookup, entities_dict: SubCategoryDict, entity_id: str) -> ValueType | None: ...
+def compile_entities(policy: CategoryType, perm_lookup: PermissionLookup) -> Callable[[str, str], bool]: ...

homeassistant_stubs-2023.4.0b6/homeassistant-stubs/auth/permissions/util.pyi

@@ -0,0 +1,13 @@
+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 _typeshed import Incomplete
+from collections.abc import Callable
+
+LookupFunc: Incomplete
+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-2023.4.0b6/homeassistant-stubs/auth/providers/__init__.pyi

@@ -0,0 +1,58 @@
+import types
+from ..auth_store import AuthStore as AuthStore
+from ..const import MFA_SESSION_EXPIRATION as MFA_SESSION_EXPIRATION
+from ..models import Credentials as Credentials, RefreshToken as RefreshToken, User as User, UserMeta as UserMeta
+from _typeshed import Incomplete
+from collections.abc import Mapping
+from homeassistant import data_entry_flow as data_entry_flow, requirements as requirements
+from homeassistant.const import CONF_ID as CONF_ID, CONF_NAME as CONF_NAME, CONF_TYPE as CONF_TYPE
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.data_entry_flow import FlowResult as FlowResult
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.util.decorator import Registry as Registry
+from typing import Any
+
+_LOGGER: Incomplete
+DATA_REQS: str
+AUTH_PROVIDERS: Registry[str, type[AuthProvider]]
+AUTH_PROVIDER_SCHEMA: Incomplete
+
+class AuthProvider:
+    DEFAULT_TITLE: str
+    hass: Incomplete
+    store: Incomplete
+    config: Incomplete
+    def __init__(self, hass: HomeAssistant, store: AuthStore, config: dict[str, Any]) -> None: ...
+    @property
+    def id(self) -> str | None: ...
+    @property
+    def type(self) -> str: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def support_mfa(self) -> bool: ...
+    async def async_credentials(self) -> list[Credentials]: ...
+    def async_create_credentials(self, data: dict[str, str]) -> Credentials: ...
+    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: ...
+    async def async_initialize(self) -> None: ...
+    def async_validate_refresh_token(self, refresh_token: RefreshToken, remote_ip: str | None = ...) -> None: ...
+
+async def auth_provider_from_config(hass: HomeAssistant, store: AuthStore, config: dict[str, Any]) -> AuthProvider: ...
+async def load_auth_provider_module(hass: HomeAssistant, provider: str) -> types.ModuleType: ...
+
+class LoginFlow(data_entry_flow.FlowHandler):
+    _auth_provider: Incomplete
+    _auth_module_id: Incomplete
+    _auth_manager: Incomplete
+    available_mfa_modules: Incomplete
+    created_at: Incomplete
+    invalid_mfa_times: int
+    user: Incomplete
+    credential: Incomplete
+    def __init__(self, auth_provider: AuthProvider) -> None: ...
+    async def async_step_init(self, user_input: dict[str, str] | None = ...) -> FlowResult: ...
+    async def async_step_select_mfa_module(self, user_input: dict[str, str] | None = ...) -> FlowResult: ...
+    async def async_step_mfa(self, user_input: dict[str, str] | None = ...) -> FlowResult: ...
+    async def async_finish(self, flow_result: Any) -> FlowResult: ...

homeassistant_stubs-2023.4.0b6/homeassistant-stubs/auth/providers/command_line.pyi

@@ -0,0 +1,28 @@
+from . import AUTH_PROVIDERS as AUTH_PROVIDERS, AUTH_PROVIDER_SCHEMA as AUTH_PROVIDER_SCHEMA, AuthProvider as AuthProvider, LoginFlow as LoginFlow
+from ..models import Credentials as Credentials, UserMeta as UserMeta
+from _typeshed import Incomplete
+from collections.abc import Mapping
+from homeassistant.const import CONF_COMMAND as CONF_COMMAND
+from homeassistant.data_entry_flow import FlowResult as FlowResult
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from typing import Any
+
+CONF_ARGS: str
+CONF_META: str
+CONFIG_SCHEMA: Incomplete
+_LOGGER: Incomplete
+
+class InvalidAuthError(HomeAssistantError): ...
+
+class CommandLineAuthProvider(AuthProvider):
+    DEFAULT_TITLE: str
+    ALLOWED_META_KEYS: Incomplete
+    _user_meta: Incomplete
+    def __init__(self, *args: Any, **kwargs: Any) -> None: ...
+    async def async_login_flow(self, context: dict[str, Any] | None) -> LoginFlow: ...
+    async def async_validate_login(self, username: str, password: str) -> None: ...
+    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: ...
+
+class CommandLineLoginFlow(LoginFlow):
+    async def async_step_init(self, user_input: dict[str, str] | None = ...) -> FlowResult: ...

homeassistant_stubs-2023.4.0b6/homeassistant-stubs/auth/providers/homeassistant.pyi

@@ -0,0 +1,57 @@
+from . import AUTH_PROVIDERS as AUTH_PROVIDERS, AUTH_PROVIDER_SCHEMA as AUTH_PROVIDER_SCHEMA, AuthProvider as AuthProvider, LoginFlow as LoginFlow
+from ..models import Credentials as Credentials, UserMeta as UserMeta
+from _typeshed import Incomplete
+from collections.abc import Mapping
+from homeassistant.const import CONF_ID as CONF_ID
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.data_entry_flow import FlowResult as FlowResult
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.storage import Store as Store
+from typing import Any
+
+STORAGE_VERSION: int
+STORAGE_KEY: str
+
+def _disallow_id(conf: dict[str, Any]) -> dict[str, Any]: ...
+
+CONFIG_SCHEMA: Incomplete
+
+def async_get_provider(hass: HomeAssistant) -> HassAuthProvider: ...
+
+class InvalidAuth(HomeAssistantError): ...
+class InvalidUser(HomeAssistantError): ...
+
+class Data:
+    hass: Incomplete
+    _store: Incomplete
+    _data: Incomplete
+    is_legacy: bool
+    def __init__(self, hass: HomeAssistant) -> None: ...
+    def normalize_username(self, username: str) -> str: ...
+    async def async_load(self) -> None: ...
+    @property
+    def users(self) -> list[dict[str, str]]: ...
+    def validate_login(self, username: str, password: str) -> None: ...
+    def hash_password(self, password: str, for_storage: bool = ...) -> bytes: ...
+    def add_auth(self, username: str, password: str) -> None: ...
+    def async_remove_auth(self, username: str) -> None: ...
+    def change_password(self, username: str, new_password: str) -> None: ...
+    async def async_save(self) -> None: ...
+
+class HassAuthProvider(AuthProvider):
+    DEFAULT_TITLE: str
+    data: Incomplete
+    _init_lock: Incomplete
+    def __init__(self, *args: Any, **kwargs: Any) -> None: ...
+    async def async_initialize(self) -> None: ...
+    async def async_login_flow(self, context: dict[str, Any] | None) -> LoginFlow: ...
+    async def async_validate_login(self, username: str, password: str) -> None: ...
+    async def async_add_auth(self, username: str, password: str) -> None: ...
+    async def async_remove_auth(self, username: str) -> None: ...
+    async def async_change_password(self, username: str, new_password: str) -> None: ...
+    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: ...
+    async def async_will_remove_credentials(self, credentials: Credentials) -> None: ...
+
+class HassLoginFlow(LoginFlow):
+    async def async_step_init(self, user_input: dict[str, str] | None = ...) -> FlowResult: ...