homeassistant.loader

The methods for loading Home Assistant integrations.

This module has quite some complex parts. I have tried to add as much documentation as possible to keep it understandable.

exception homeassistant.loader.CircularDependency(from_domain: str, to_domain: str)

Raised when a circular dependency is found when resolving components.

class homeassistant.loader.Components(hass: HomeAssistant)

Helper to load components.

class homeassistant.loader.Helpers(hass: HomeAssistant)

Helper to load helpers.

class homeassistant.loader.Integration(hass: HomeAssistant, pkg_path: str, file_path: pathlib.Path, manifest: Dict[str, Any])

An integration in Home Assistant.

property after_dependencies

Return after_dependencies.

property config_flow

Return config_flow.

property dependencies

Return dependencies.

property documentation

Return documentation.

property domain

Return domain.

get_component() → module

Return the component.

get_platform(platform_name: str) → module

Return a platform for an integration.

property is_built_in

Test if package is a built-in integration.

property issue_tracker

Return issue tracker link.

property name

Return name.

property quality_scale

Return Integration Quality Scale.

property requirements

Return requirements.

classmethod resolve_from_root(hass: HomeAssistant, root_module: module, domain: str) → Optional[Integration]

Resolve an integration from a root module.

classmethod resolve_legacy(hass: HomeAssistant, domain: str) → Optional[Integration]

Resolve legacy component.

Will create a stub manifest.

exception homeassistant.loader.IntegrationNotFound(domain: str)

Raised when a component is not found.

exception homeassistant.loader.LoaderError

Loader base error.

class homeassistant.loader.ModuleWrapper(hass: HomeAssistant, module: module)

Class to wrap a Python module and auto fill in hass argument.

async homeassistant.loader.async_component_dependencies(hass: HomeAssistant, domain: str) → Set[str]

Return all dependencies and subdependencies of components.

Raises CircularDependency if a circular dependency is found.

async homeassistant.loader.async_get_config_flows(hass: HomeAssistant) → Set[str]

Return cached list of config flows.

async homeassistant.loader.async_get_custom_components(hass: HomeAssistant) → Dict[str, Integration]

Return cached list of custom integrations.

async homeassistant.loader.async_get_integration(hass: HomeAssistant, domain: str) → homeassistant.loader.Integration

Get an integration.

homeassistant.loader.bind_hass(func: CALLABLE_T) → CALLABLE_T

Decorate function to indicate that first argument is hass.

homeassistant.loader.manifest_from_legacy_module(domain: str, module: module) → Dict

Generate a manifest from a legacy module.