Add empty line after module docstring [helpers + other] (#112707)

homeassistant/__main__.py

@@ -1,4 +1,5 @@
 """Start Home Assistant."""
+
 from __future__ import annotations
 
 import argparse

homeassistant/auth/__init__.py

@@ -1,4 +1,5 @@
 """Provide an authentication layer for Home Assistant."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/auth/auth_store.py

@@ -1,4 +1,5 @@
 """Storage for auth models."""
+
 from __future__ import annotations
 
 from datetime import timedelta

homeassistant/auth/const.py

@@ -1,4 +1,5 @@
 """Constants for the auth module."""
+
 from datetime import timedelta
 
 ACCESS_TOKEN_EXPIRATION = timedelta(minutes=30)

homeassistant/auth/jwt_wrapper.py

@@ -4,6 +4,7 @@ Since we decode the same tokens over and over again
 we can cache the result of the decode of valid tokens
 to speed up the process.
 """
+
 from __future__ import annotations
 
 from datetime import timedelta

homeassistant/auth/mfa_modules/__init__.py

@@ -1,4 +1,5 @@
 """Pluggable auth modules for Home Assistant."""
+
 from __future__ import annotations
 
 import importlib

homeassistant/auth/mfa_modules/insecure_example.py

@@ -1,4 +1,5 @@
 """Example auth module."""
+
 from __future__ import annotations
 
 from typing import Any

homeassistant/auth/mfa_modules/notify.py

@@ -2,6 +2,7 @@
 
 Sending HOTP through notify service
 """
+
 from __future__ import annotations
 
 import asyncio

homeassistant/auth/mfa_modules/totp.py

@@ -1,4 +1,5 @@
 """Time-based One Time Password auth module."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/auth/models.py

@@ -1,4 +1,5 @@
 """Auth models."""
+
 from __future__ import annotations
 
 from datetime import datetime, timedelta

homeassistant/auth/permissions/__init__.py

@@ -1,4 +1,5 @@
 """Permissions for Home Assistant."""
+
 from __future__ import annotations
 
 from collections.abc import Callable

homeassistant/auth/permissions/entities.py

@@ -1,4 +1,5 @@
 """Entity permissions."""
+
 from __future__ import annotations
 
 from collections import OrderedDict

homeassistant/auth/permissions/events.py

@@ -1,4 +1,5 @@
 """Permission for events."""
+
 from __future__ import annotations
 
 from typing import Final

homeassistant/auth/permissions/merge.py

@@ -1,4 +1,5 @@
 """Merging of policies."""
+
 from __future__ import annotations
 
 from typing import cast

homeassistant/auth/permissions/models.py

@@ -1,4 +1,5 @@
 """Models for permissions."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING

homeassistant/auth/permissions/system_policies.py

@@ -1,4 +1,5 @@
 """System policies."""
+
 from .const import CAT_ENTITIES, POLICY_READ, SUBCAT_ALL
 
 ADMIN_POLICY = {CAT_ENTITIES: True}

homeassistant/auth/permissions/types.py

@@ -1,4 +1,5 @@
 """Common code for permissions."""
+
 from collections.abc import Mapping
 
 # MyPy doesn't support recursion yet. So writing it out as far as we need.

homeassistant/auth/permissions/util.py

@@ -1,4 +1,5 @@
 """Helpers to deal with permissions."""
+
 from __future__ import annotations
 
 from collections.abc import Callable

homeassistant/auth/providers/__init__.py

@@ -1,4 +1,5 @@
 """Auth providers for Home Assistant."""
+
 from __future__ import annotations
 
 from collections.abc import Mapping

homeassistant/auth/providers/command_line.py

@@ -1,4 +1,5 @@
 """Auth provider that validates credentials via an external command."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/auth/providers/homeassistant.py

@@ -1,4 +1,5 @@
 """Home Assistant auth provider."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/auth/providers/insecure_example.py

@@ -1,4 +1,5 @@
 """Example auth provider."""
+
 from __future__ import annotations
 
 from collections.abc import Mapping

homeassistant/auth/providers/legacy_api_password.py

@@ -2,6 +2,7 @@
 
 It will be removed when auth system production ready
 """
+
 from __future__ import annotations
 
 from collections.abc import Mapping

homeassistant/auth/providers/trusted_networks.py

@@ -3,6 +3,7 @@
 It shows list of users if access from trusted network.
 Abort login flow if not access from trusted network.
 """
+
 from __future__ import annotations
 
 from collections.abc import Mapping

homeassistant/backports/enum.py

@@ -6,6 +6,7 @@ Since we have dropped support for Python 3.10, we can remove this backport.
 This file is kept for now to avoid breaking custom components that might
 import it.
 """
+
 from __future__ import annotations
 
 from enum import StrEnum

homeassistant/block_async_io.py

@@ -1,4 +1,5 @@
 """Block blocking calls being done in asyncio."""
+
 from http.client import HTTPConnection
 import time
 

homeassistant/bootstrap.py

@@ -1,4 +1,5 @@
 """Provide methods to bootstrap a Home Assistant instance."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/components/__init__.py

@@ -6,6 +6,7 @@ Component design guidelines:
   format "<DOMAIN>.<OBJECT_ID>".
 - Each component should publish services only under its own domain.
 """
+
 from __future__ import annotations
 
 import logging

homeassistant/config.py

@@ -1,4 +1,5 @@
 """Module to help with parsing and generating configuration files."""
+
 from __future__ import annotations
 
 from collections import OrderedDict

homeassistant/config_entries.py

@@ -1,4 +1,5 @@
 """Manage config entries in Home Assistant."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/const.py

@@ -1,4 +1,5 @@
 """Constants used by Home Assistant components."""
+
 from __future__ import annotations
 
 from enum import StrEnum

homeassistant/core.py

@@ -3,6 +3,7 @@
 Home Assistant is a Home Automation framework for observing the state
 of entities and react to changes.
 """
+
 from __future__ import annotations
 
 import asyncio

homeassistant/data_entry_flow.py

@@ -1,4 +1,5 @@
 """Classes to help gather user submissions."""
+
 from __future__ import annotations
 
 import abc

homeassistant/exceptions.py

@@ -1,4 +1,5 @@
 """The exceptions used by Home Assistant."""
+
 from __future__ import annotations
 
 from collections.abc import Generator, Sequence

homeassistant/helpers/__init__.py

@@ -1,4 +1,5 @@
 """Helper methods for components within Home Assistant."""
+
 from __future__ import annotations
 
 from collections.abc import Iterable, Sequence

homeassistant/helpers/aiohttp_client.py

@@ -1,4 +1,5 @@
 """Helper for aiohttp webclient stuff."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/area_registry.py

@@ -1,4 +1,5 @@
 """Provide a way to connect devices to one physical location."""
+
 from __future__ import annotations
 
 from collections.abc import Iterable

homeassistant/helpers/check_config.py

@@ -1,4 +1,5 @@
 """Helper to check the configuration file."""
+
 from __future__ import annotations
 
 from collections import OrderedDict

homeassistant/helpers/collection.py

@@ -1,4 +1,5 @@
 """Helper to deal with YAML + storage."""
+
 from __future__ import annotations
 
 from abc import ABC, abstractmethod

homeassistant/helpers/condition.py

@@ -1,4 +1,5 @@
 """Offer reusable conditions."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/config_entry_flow.py

@@ -1,4 +1,5 @@
 """Helpers for data entry flows for config entries."""
+
 from __future__ import annotations
 
 from collections.abc import Awaitable, Callable

homeassistant/helpers/config_entry_oauth2_flow.py

@@ -5,6 +5,7 @@ This module exists of the following parts:
  - OAuth2 implementation that works with local provided client ID/secret
 
 """
+
 from __future__ import annotations
 
 from abc import ABC, ABCMeta, abstractmethod

homeassistant/helpers/config_validation.py

@@ -1,4 +1,5 @@
 """Helpers for config validation using voluptuous."""
+
 from __future__ import annotations
 
 from collections.abc import Callable, Hashable

homeassistant/helpers/data_entry_flow.py

@@ -1,4 +1,5 @@
 """Helpers for the data entry flow."""
+
 from __future__ import annotations
 
 from http import HTTPStatus

homeassistant/helpers/debounce.py

@@ -1,4 +1,5 @@
 """Debounce helper."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/deprecation.py

@@ -1,4 +1,5 @@
 """Deprecation helpers for Home Assistant."""
+
 from __future__ import annotations
 
 from collections.abc import Callable

homeassistant/helpers/device_registry.py

@@ -1,4 +1,5 @@
 """Provide a way to connect entities belonging to one device."""
+
 from __future__ import annotations
 
 from collections import UserDict

homeassistant/helpers/discovery.py

@@ -5,6 +5,7 @@ There are two different types of discoveries that can be fired/listened for.
  - listen_platform/discover_platform is for platforms. These are used by
    components to allow discovery of their platforms.
 """
+
 from __future__ import annotations
 
 from collections.abc import Callable, Coroutine

homeassistant/helpers/discovery_flow.py

@@ -1,4 +1,5 @@
 """The discovery flow helper."""
+
 from __future__ import annotations
 
 from collections.abc import Coroutine

homeassistant/helpers/dispatcher.py

@@ -1,4 +1,5 @@
 """Helpers for Home Assistant dispatcher & internal component/platform."""
+
 from __future__ import annotations
 
 from collections.abc import Callable, Coroutine

homeassistant/helpers/entity.py

@@ -1,4 +1,5 @@
 """An abstract class for entities."""
+
 from __future__ import annotations
 
 from abc import ABCMeta

homeassistant/helpers/entity_component.py

@@ -1,4 +1,5 @@
 """Helpers for components that manage entities."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/entity_platform.py

@@ -1,4 +1,5 @@
 """Class to manage the entities for a single platform."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/entity_registry.py

@@ -7,6 +7,7 @@ The Entity Registry will persist itself 10 seconds after a new entity is
 registered. Registering a new entity while a timer is in progress resets the
 timer.
 """
+
 from __future__ import annotations
 
 from collections import UserDict

homeassistant/helpers/entity_values.py

@@ -1,4 +1,5 @@
 """A class to hold entity values."""
+
 from __future__ import annotations
 
 from collections import OrderedDict

homeassistant/helpers/entityfilter.py

@@ -1,4 +1,5 @@
 """Helper class to implement include/exclude of entities and domains."""
+
 from __future__ import annotations
 
 from collections.abc import Callable

homeassistant/helpers/event.py

@@ -1,4 +1,5 @@
 """Helpers for listening to events."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/floor_registry.py

@@ -1,4 +1,5 @@
 """Provide a way to assign areas to floors in one's home."""
+
 from __future__ import annotations
 
 from collections.abc import Iterable

homeassistant/helpers/frame.py

@@ -1,4 +1,5 @@
 """Provide frame helper for finding the current frame context."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/group.py

@@ -1,4 +1,5 @@
 """Helper for groups."""
+
 from __future__ import annotations
 
 from collections.abc import Iterable

homeassistant/helpers/http.py

@@ -1,4 +1,5 @@
 """Helper to track the current http request."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/httpx_client.py

@@ -1,4 +1,5 @@
 """Helper for httpx."""
+
 from __future__ import annotations
 
 from collections.abc import Callable

homeassistant/helpers/icon.py

@@ -1,4 +1,5 @@
 """Icon helper methods."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/instance_id.py

@@ -1,4 +1,5 @@
 """Helper to create a unique instance ID."""
+
 from __future__ import annotations
 
 import logging

homeassistant/helpers/integration_platform.py

@@ -1,4 +1,5 @@
 """Helpers to help with integration platforms."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/issue_registry.py

@@ -1,4 +1,5 @@
 """Persistently store issues raised by integrations."""
+
 from __future__ import annotations
 
 import dataclasses

homeassistant/helpers/json.py

@@ -1,4 +1,5 @@
 """Helpers to help with encoding Home Assistant objects in JSON."""
+
 from collections import deque
 from collections.abc import Callable
 import datetime

homeassistant/helpers/label_registry.py

@@ -1,4 +1,5 @@
 """Provide a way to label and group anything."""
+
 from __future__ import annotations
 
 from collections.abc import Iterable

homeassistant/helpers/location.py

@@ -1,4 +1,5 @@
 """Location helpers for Home Assistant."""
+
 from __future__ import annotations
 
 from collections.abc import Iterable

homeassistant/helpers/network.py

@@ -1,4 +1,5 @@
 """Network helpers."""
+
 from __future__ import annotations
 
 from collections.abc import Callable

homeassistant/helpers/normalized_name_base_registry.py

@@ -1,4 +1,5 @@
 """Provide a base class for registries that use a normalized name index."""
+
 from collections import UserDict
 from collections.abc import ValuesView
 from dataclasses import dataclass

homeassistant/helpers/ratelimit.py

@@ -1,4 +1,5 @@
 """Ratelimit helper."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/redact.py

@@ -1,4 +1,5 @@
 """Helpers to redact sensitive data."""
+
 from __future__ import annotations
 
 from collections.abc import Callable, Iterable, Mapping

homeassistant/helpers/registry.py

@@ -1,4 +1,5 @@
 """Provide a base implementation for registries."""
+
 from __future__ import annotations
 
 from abc import ABC, abstractmethod

homeassistant/helpers/reload.py

@@ -1,4 +1,5 @@
 """Class to reload platforms."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/restore_state.py

@@ -1,4 +1,5 @@
 """Support for restoring entity states on startup."""
+
 from __future__ import annotations
 
 from abc import ABC, abstractmethod

homeassistant/helpers/schema_config_entry_flow.py

@@ -1,4 +1,5 @@
 """Helpers for creating schema based data entry flows."""
+
 from __future__ import annotations
 
 from abc import ABC, abstractmethod

homeassistant/helpers/script.py

@@ -1,4 +1,5 @@
 """Helpers to execute scripts."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/script_variables.py

@@ -1,4 +1,5 @@
 """Script variables."""
+
 from __future__ import annotations
 
 from collections.abc import Mapping

homeassistant/helpers/selector.py

@@ -1,4 +1,5 @@
 """Selectors for Home Assistant."""
+
 from __future__ import annotations
 
 from collections.abc import Callable, Mapping, Sequence

homeassistant/helpers/sensor.py

@@ -1,4 +1,5 @@
 """Common functions related to sensor device management."""
+
 from __future__ import annotations
 
 from typing import TYPE_CHECKING

homeassistant/helpers/service.py

@@ -1,4 +1,5 @@
 """Service calling related helpers."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/service_info/mqtt.py

@@ -1,4 +1,5 @@
 """MQTT Discovery data."""
+
 from dataclasses import dataclass
 import datetime as dt
 

homeassistant/helpers/significant_change.py

@@ -26,6 +26,7 @@ The following cases will never be passed to your function:
 - if either state is unknown/unavailable
 - state adding/removing
 """
+
 from __future__ import annotations
 
 from collections.abc import Callable

homeassistant/helpers/singleton.py

@@ -1,4 +1,5 @@
 """Helper to help coordinating calls."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/start.py

@@ -1,4 +1,5 @@
 """Helpers to help during startup."""
+
 from __future__ import annotations
 
 from collections.abc import Callable, Coroutine

homeassistant/helpers/state.py

@@ -1,4 +1,5 @@
 """Helpers that help with state related things."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/storage.py

@@ -1,4 +1,5 @@
 """Helper to help store data."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/sun.py

@@ -1,4 +1,5 @@
 """Helpers for sun events."""
+
 from __future__ import annotations
 
 from collections.abc import Callable

homeassistant/helpers/system_info.py

@@ -1,4 +1,5 @@
 """Helper to gather system info."""
+
 from __future__ import annotations
 
 from functools import cache

homeassistant/helpers/temperature.py

@@ -1,4 +1,5 @@
 """Temperature helpers for Home Assistant."""
+
 from __future__ import annotations
 
 from numbers import Number

homeassistant/helpers/template.py

@@ -1,4 +1,5 @@
 """Template helper methods for rendering strings with Home Assistant data."""
+
 from __future__ import annotations
 
 from ast import literal_eval

homeassistant/helpers/trace.py

@@ -1,4 +1,5 @@
 """Helpers for script and condition tracing."""
+
 from __future__ import annotations
 
 from collections import deque

homeassistant/helpers/translation.py

@@ -1,4 +1,5 @@
 """Translation string lookup helpers."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/trigger.py

@@ -1,4 +1,5 @@
 """Triggers."""
+
 from __future__ import annotations
 
 import asyncio

homeassistant/helpers/trigger_template_entity.py

@@ -1,4 +1,5 @@
 """TemplateEntity utility class."""
+
 from __future__ import annotations
 
 import contextlib

homeassistant/helpers/typing.py

@@ -1,4 +1,5 @@
 """Typing Helpers for Home Assistant."""
+
 from collections.abc import Mapping
 from enum import Enum
 from typing import Any, TypeVar

homeassistant/helpers/update_coordinator.py

@@ -1,4 +1,5 @@
 """Helpers to help coordinate updates."""
+
 from __future__ import annotations
 
 from abc import abstractmethod

homeassistant/loader.py

@@ -3,6 +3,7 @@
 This module has quite some complex parts. I have tried to add as much
 documentation as possible to keep it understandable.
 """
+
 from __future__ import annotations
 
 import asyncio

homeassistant/requirements.py

@@ -1,4 +1,5 @@
 """Module to handle installing requirements."""
+
 from __future__ import annotations
 
 import asyncio