64 lines
2 KiB
Python
64 lines
2 KiB
Python
"""Config flow for NEW_NAME integration."""
|
|
import logging
|
|
|
|
import voluptuous as vol
|
|
|
|
from homeassistant import core, config_entries, exceptions
|
|
|
|
from .const import DOMAIN # pylint:disable=unused-import
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
# TODO adjust the data schema to the data that you need
|
|
DATA_SCHEMA = vol.Schema({"host": str, "username": str, "password": str})
|
|
|
|
|
|
async def validate_input(hass: core.HomeAssistant, data):
|
|
"""Validate the user input allows us to connect.
|
|
|
|
Data has the keys from DATA_SCHEMA with values provided by the user.
|
|
"""
|
|
# TODO validate the data can be used to set up a connection.
|
|
# If you cannot connect:
|
|
# throw CannotConnect
|
|
# If the authentication is wrong:
|
|
# InvalidAuth
|
|
|
|
# Return some info we want to store in the config entry.
|
|
return {"title": "Name of the device"}
|
|
|
|
|
|
class DomainConfigFlow(config_entries.ConfigFlow, domain=DOMAIN):
|
|
"""Handle a config flow for NEW_NAME."""
|
|
|
|
VERSION = 1
|
|
# TODO pick one of the available connection classes in homeassistant/config_entries.py
|
|
CONNECTION_CLASS = config_entries.CONN_CLASS_UNKNOWN
|
|
|
|
async def async_step_user(self, user_input=None):
|
|
"""Handle the initial step."""
|
|
errors = {}
|
|
if user_input is not None:
|
|
try:
|
|
info = await validate_input(self.hass, user_input)
|
|
|
|
return self.async_create_entry(title=info["title"], data=user_input)
|
|
except CannotConnect:
|
|
errors["base"] = "cannot_connect"
|
|
except InvalidAuth:
|
|
errors["base"] = "invalid_auth"
|
|
except Exception: # pylint: disable=broad-except
|
|
_LOGGER.exception("Unexpected exception")
|
|
errors["base"] = "unknown"
|
|
|
|
return self.async_show_form(
|
|
step_id="user", data_schema=DATA_SCHEMA, errors=errors
|
|
)
|
|
|
|
|
|
class CannotConnect(exceptions.HomeAssistantError):
|
|
"""Error to indicate we cannot connect."""
|
|
|
|
|
|
class InvalidAuth(exceptions.HomeAssistantError):
|
|
"""Error to indicate there is invalid auth."""
|