Send HTTP requests with specified method, route, and data. Args: route (str): Represents the specific endpoint that you want to c

Check that the API result is a valid dictionary. If the result is not a dict, logs an error, calls logout and raises DataStructureError. Arg

Create a normalized entity ID name from a raw input string. Args: input_string (str): The raw input string to transform. Returns:

Initialize the APIError exception with the class-level message.

Execute a Pi-hole action. Args: action_name (str): Represents the action to execute. Returns: dict[str, Any]

Find the current network device entry for this MAC address. Updates cached hostname and IP address when found. Returns:

Turn on/off the group. Args: action (str): The action to perform, either "enable" or "disable". with_update (bool): I

Turn on/off the service. Args: action (str): The action to perform, either "enable" or "disable". duration (Any): Opt

Turn on/off the Pi-hole group blocking when triggered via a service call. Args: action (str): The action to perform, either "enab

Drop the current session. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "data". Raises:

Load a component's manifest.json, or None if it has no manifest.

Add new devices and remove entities excluded by the current filter. Devices that Pi-hole simply stops reporting keep their entity, which then

Attempt to connect to the Pi-hole API using the current config. Returns: dict[str, str]: An empty dict on success, or a dict mapp

Execute the full authentication sequence for a given action. Checks current authentication status, aborts logout if not needed, and r

Build a log message string from an HTTP response. Args: request (ClientResponse): The HTTP response object. method (s

Build and return the voluptuous schema for the options flow form. Returns: vol.Schema: The schema to be used in the options flow form.

Remove device_tracker entities and their network devices from the registries. Removes any network device (and its device_tracker entity) already

Attempt to parse the JSON body from an HTTP response. Handles encoding errors gracefully and optionally redacts the session SID for privacy.

Calculate the duration in seconds from a timedelta or integer value. Args: duration (Any): The duration to convert. Can be a timedelta, a

Calculate the remaining seconds until the blocking mode is automatically restored. Args: entity (Any): The entity holding the API cache w

Retrieve the current authentication session status. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "da

Retrieve current blocking status. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "data". Rais

Parse a raw MAC address list into a normalized set. Accepts MAC addresses separated by commas, newlines, or both. Each address is lowercased

Reset a specific cache entry to its default error state. Args: data_name (str): The name of the cache to reset. Currently support

Initialize a Pi-hole V6 group switch. Args: hole_data (PiHoleV6Data): The runtime data containing the API client and coordinator.

Abort a logout call if no active session exists. Raises AbortLogoutError when a logout is requested but there is no active session to

Validate the user input from the options flow form. Args: user_input (dict[str, Any]): The input submitted by the user in the options for

Execute the authentication sequence with a lock for non-auth actions. Acquires the call lock before running the authentication step to preven

Build a predicate that decides whether a network device should be tracked. Like `_build_mac_filter`, but also matches the device's current IP add

Build a predicate that decides whether a MAC address should be tracked. Reads the whitelist/blacklist mode and address list from the config entry

Verify the current session is still valid and reset it if not. Calls the authentication status endpoint and sets the SID to None if t

Build a log message string from an API exception and its associated HTTP response. Args: api_error (APIError): The API exception

Return the best display name for a network device. Picks the first non-null hostname from the device's IP list, falling back to the MAC addre

Build and return the voluptuous schema for the main config flow form. Args: user_input (Any): Previously entered user input used to pre-f

Request a login if no active session exists. Triggers a login call when the action is not already a login and no session ID is curren

Fetch all required data from the Pi-hole API. Sequentially calls each API endpoint and validates the result structure. Args: api_cli

Handle user's reauth credentials. Args: user_input (dict[str, Any] | None): The input submitted by the user, or None when display

Flush the network table. This includes emptying the ARP table and removing both all known devices and their associated addresses. Re

Flush the DNS logs. This includes emptying the DNS log file and purging the most recent 24 hours from both the database and FTL's internal me

Purge all FTL diagnosis messages. Iterates over cached messages and deletes each one via the API. Clears the local message cache afte

Run gravity. Update Pi-hole's adlists by running pihole -g. Returns: dict[str, Any]: A dictionary with the keys "code",

Restart the pihole-FTL service. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "data". Raises

Disable blocking for DNS requests. Args: duration (int | None): The time duration in seconds for which blocking will be disabled.

Enable blocking for DNS requests. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "data". Rais

Retrieve all active sessions. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "data". Raises:

Retrieve the configured clients. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "data". Raise

Retrieve the active DHCP leases. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "data". Raise

Retrieve the list of FTL diagnosis messages. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "data".

Retrieve the count of FTL diagnosis messages. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "data".

Retrieve the list of Pi-hole groups. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "data". R

Retrieve the list of known network devices. Args: max_devices (int): The maximum number of devices to retrieve. Defaults to MAX_N

Disable a Pi-hole group. Args: group (str): The name of the group to disable. Returns: dict[str, Any]: A dic

Enable a Pi-hole group. Args: group (str): The name of the group to enable. Returns: dict[str, Any]: A dicti

Authenticate against the Pi-hole API using the configured password. Returns: dict[str, Any]: A dictionary with the keys "code", "

Retrieve the Pi-hole API Dashboard information. Args: full (bool): If True, retrieves the full dashboard data. Defaults to True.

Retrieve an overview of Pi-hole activity. Returns: dict[str, Any]: A dictionary with the keys "code", "reason", and "data".

Return every component reachable from default_config's dependency tree.

Map each dependency's lowercased package name to its pinned requirement string.

Locate the installed homeassistant.components package directory.

Find a sensor entity by its key within a given context. Args: current_hass (HomeAssistant): The Home Assistant instance. key (str

Find a switch entity by its key within a given context. Args: current_hass (HomeAssistant): The Home Assistant instance. key (str

Determine whether the entity should be enabled in the registry by default. Returns True if the entity matches the Docker context (Docker inst

Retrieve the remaining dates cache from the first registered switch entity. Args: hass (HomeAssistant): The Home Assistant instance.

Raise specific exceptions based on the input status code. Args: status_code (int): Represents the status code and handles it based on the

Regenerate requirements.txt's default_config requirements block.

Compute the remaining seconds until blocking mode is automatically restored. Updates the cache of remaining dates based on the current blocki

Replace the generated requirements block, keeping the pinned base requirements above it.

Update the remaining blocking mode sensor state on each timer tick. Computes the remaining seconds and updates the entity state and attributes ac

Update all switch entity states related to blocking timers on each timer tick. Iterates over all remaining dates, updates attributes and remainin

Initialize a Pi-hole V6 sensor. Args: api (ClientAPI): The Pi-hole API client instance. coordinator (DataUpdateCoordi

Initialize the config flow.

Initialize Pi-hole API Client object with an API URL. Args: session (client.ClientSession): The aiohttp client session used to pe

Initialize the ActionExecutionError exception with the class-level message.

Initialize the AbortLogoutError exception with the class-level message.

Initialize the ClientConnectorError exception, optionally appending a custom message. Args: custom_message (str): An optional add

Initialize the ContentTypeError exception with the class-level message.

Initialize a Pi-hole V6 switch. Args: api (PiholeAPI): The Pi-hole API client instance. coordinator (DataUpdateCoordi

Initialize Pi-hole V6 button. Args: api (PiholeAPI): The Pi-hole API client instance. coordinator (DataUpdateCoordina

Initialize a Pi-hole V6 sensor. Args: api (PiholeAPI): The Pi-hole API client instance. coordinator (DataUpdateCoordi

Initialize a Pi-hole V6 device tracker entity. Args: api (PiholeAPI): The Pi-hole API client instance. coordinator (D

Initialize a Pi-hole update entity. Args: api (ClientAPI): The Pi-hole API client instance. coordinator (DataUpdateCo

Initialize a Pi-hole V6 entity. Args: api (PiholeAPI): The Pi-hole API client instance. coordinator (DataUpdateCoordi

Forget a manually removed network device so it can be recreated later. When the user removes a network device from the UI, it disappears from

Schedule adding and removing trackers when coordinator updates. Returns: None

Get the options flow for this handler. Args: config_entry (Any): The current config entry (unused). Returns:

Log out from the Pi-hole API when Home Assistant stops. Args: _ (Event): The Home Assistant stop event (unused). Returns

Press the button. Returns: None

Allow manual removal of a network device from the UI. Only network devices (identified by a MAC connection) created by the device_tracker pla

Disable the Pi-hole blocking via the service call. Args: duration (Any): Optional duration as a timedelta or int (seconds) for wh

Disable the Pi-hole group blocking via the service call. Args: duration (Any): Optional duration as a timedelta or int (seconds)

Enable the Pi-hole blocking via the service call. Returns: None

Enable the Pi-hole group blocking via the service call. Returns: None

Set up the Pi-hole V6 sensor. Args: hass (HomeAssistant): The Home Assistant instance. entry (PiHoleV6ConfigEntry): The config en

Set up Pi-hole V6 entry. Args: hass (HomeAssistant): The Home Assistant instance. entry (PiHoleV6ConfigEntry): The config entry t

Set up the Pi-hole V6 switch. Args: hass (HomeAssistant): The Home Assistant instance. entry (PiHoleV6ConfigEntry): The config en

Set up the Pi-hole V6 button entities. Args: hass (HomeAssistant): The Home Assistant instance (unused). entry (PiHoleV6ConfigEnt

Set up the Pi-hole V6 binary sensor. Args: hass (HomeAssistant): The Home Assistant instance (unused). entry (PiHoleV6ConfigEntry

Set up Pi-hole V6 device tracker from network devices. Creates a device tracker entity for each network device known to Pi-hole. New devices