core/homeassistant/components/casper_glow/config_flow.py

"""Config flow for Casper Glow integration."""

import logging
from typing import Any, override

from bluetooth_data_tools import human_readable_name
from pycasperglow import CasperGlow, CasperGlowError
import voluptuous as vol

from homeassistant.components.bluetooth import (
    BluetoothServiceInfoBleak,
    async_discovered_service_info,
)
from homeassistant.config_entries import ConfigFlow, ConfigFlowResult
from homeassistant.const import CONF_ADDRESS
from homeassistant.helpers.device_registry import format_mac

from .const import DOMAIN, LOCAL_NAMES

_LOGGER = logging.getLogger(__name__)


def _is_casper_glow_discovery(discovery_info: BluetoothServiceInfoBleak) -> bool:
    """Return whether the Bluetooth discovery looks like a Casper Glow."""
    return bool(
        discovery_info.name
        and any(
            discovery_info.name.startswith(local_name) for local_name in LOCAL_NAMES
        )
    )


class CasperGlowConfigFlow(ConfigFlow, domain=DOMAIN):
    """Handle a config flow for Casper Glow."""

    VERSION = 1
    MINOR_VERSION = 1

    def __init__(self) -> None:
        """Initialize the config flow."""
        self._discovery_info: BluetoothServiceInfoBleak | None = None
        self._discovered_devices: dict[str, BluetoothServiceInfoBleak] = {}

    @override
    async def async_step_bluetooth(
        self, discovery_info: BluetoothServiceInfoBleak
    ) -> ConfigFlowResult:
        """Handle the bluetooth discovery step."""
        if not _is_casper_glow_discovery(discovery_info):
            return self.async_abort(reason="not_supported")

        await self.async_set_unique_id(format_mac(discovery_info.address))
        self._abort_if_unique_id_configured()
        self._discovery_info = discovery_info
        self.context["title_placeholders"] = {
            "name": human_readable_name(
                None, discovery_info.name, discovery_info.address
            )
        }
        return await self.async_step_bluetooth_confirm()

    async def async_step_bluetooth_confirm(
        self, user_input: dict[str, Any] | None = None
    ) -> ConfigFlowResult:
        """Confirm a discovered Casper Glow device."""
        assert self._discovery_info is not None
        if user_input is not None:
            return self.async_create_entry(
                title=self.context["title_placeholders"]["name"],
                data={CONF_ADDRESS: self._discovery_info.address},
            )
        glow = CasperGlow(self._discovery_info.device)
        try:
            await glow.handshake()
        except CasperGlowError:
            return self.async_abort(reason="cannot_connect")
        except Exception:
            _LOGGER.exception(
                "Unexpected error during Casper Glow config flow "
                "(step=bluetooth_confirm, address=%s)",
                self._discovery_info.address,
            )
            return self.async_abort(reason="unknown")
        self._set_confirm_only()
        return self.async_show_form(
            step_id="bluetooth_confirm",
            description_placeholders=self.context["title_placeholders"],
        )

    @override
    async def async_step_user(
        self, user_input: dict[str, Any] | None = None
    ) -> ConfigFlowResult:
        """Handle the user step to pick discovered device."""
        errors: dict[str, str] = {}

        if user_input is not None:
            address = user_input[CONF_ADDRESS]
            discovery_info = self._discovered_devices[address]
            await self.async_set_unique_id(
                format_mac(discovery_info.address), raise_on_progress=False
            )
            self._abort_if_unique_id_configured()
            glow = CasperGlow(discovery_info.device)
            try:
                await glow.handshake()
            except CasperGlowError:
                errors["base"] = "cannot_connect"
            except Exception:
                _LOGGER.exception(
                    "Unexpected error during Casper Glow config flow "
                    "(step=user, address=%s)",
                    discovery_info.address,
                )
                errors["base"] = "unknown"
            else:
                return self.async_create_entry(
                    title=human_readable_name(
                        None, discovery_info.name, discovery_info.address
                    ),
                    data={
                        CONF_ADDRESS: discovery_info.address,
                    },
                )

        if discovery := self._discovery_info:
            self._discovered_devices[discovery.address] = discovery
        else:
            current_addresses = self._async_current_ids(include_ignore=False)
            for discovery in async_discovered_service_info(self.hass):
                if (
                    format_mac(discovery.address) in current_addresses
                    or discovery.address in self._discovered_devices
                    or not _is_casper_glow_discovery(discovery)
                ):
                    continue
                self._discovered_devices[discovery.address] = discovery

        if not self._discovered_devices:
            return self.async_abort(reason="no_devices_found")

        data_schema = vol.Schema(
            {
                vol.Required(CONF_ADDRESS): vol.In(
                    {
                        service_info.address: human_readable_name(
                            None, service_info.name, service_info.address
                        )
                        for service_info in self._discovered_devices.values()
                    }
                ),
            }
        )
        return self.async_show_form(
            step_id="user",
            data_schema=data_schema,
            errors=errors,
        )