81 lines
2.9 KiB
Python
81 lines
2.9 KiB
Python
"""Cross-entry lookups for the global config entry's options.
|
|
|
|
The integration uses one global config entry (`unique_id == GLOBAL_UNIQUE_ID`)
|
|
that holds settings shared across every per-object entry — most notably the
|
|
`default_warning_days` value the user picks in the panel's General Settings.
|
|
|
|
Per-object task-create flows (panel, options-flow, WS) need to honour that
|
|
default instead of falling back to the hard-coded `DEFAULT_WARNING_DAYS`
|
|
constant. These helpers centralise the cross-entry lookup.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from collections.abc import Mapping
|
|
from typing import Any
|
|
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.core import HomeAssistant
|
|
|
|
from ..const import (
|
|
CONF_DEFAULT_WARNING_DAYS,
|
|
CONF_PANEL_TITLE,
|
|
DEFAULT_WARNING_DAYS,
|
|
DOMAIN,
|
|
GLOBAL_UNIQUE_ID,
|
|
MAX_PANEL_TITLE_LENGTH,
|
|
PANEL_TITLE,
|
|
)
|
|
|
|
|
|
def get_global_entry(hass: HomeAssistant) -> ConfigEntry | None:
|
|
"""Return the single global config entry (`unique_id == GLOBAL_UNIQUE_ID`).
|
|
|
|
The one place that resolves it — the ~inline `for entry in async_entries(...)
|
|
if unique_id == GLOBAL_UNIQUE_ID` loop was copy-pasted across many modules.
|
|
"""
|
|
for entry in hass.config_entries.async_entries(DOMAIN):
|
|
if entry.unique_id == GLOBAL_UNIQUE_ID:
|
|
return entry
|
|
return None
|
|
|
|
|
|
def get_global_options(hass: HomeAssistant) -> Mapping[str, Any]:
|
|
"""Return the options dict from the global config entry, or empty mapping."""
|
|
entry = get_global_entry(hass)
|
|
return (entry.options or entry.data) if entry is not None else {}
|
|
|
|
|
|
def get_default_warning_days(hass: HomeAssistant) -> int:
|
|
"""Resolve the integration-wide default warning_days for new tasks.
|
|
|
|
Reads the `default_warning_days` option from the global config entry; falls
|
|
back to the constant `DEFAULT_WARNING_DAYS` when the global entry does not
|
|
exist yet (during initial setup) or when no user value has been stored.
|
|
"""
|
|
raw = get_global_options(hass).get(CONF_DEFAULT_WARNING_DAYS, DEFAULT_WARNING_DAYS)
|
|
try:
|
|
value = int(raw)
|
|
except (TypeError, ValueError):
|
|
return DEFAULT_WARNING_DAYS
|
|
if value < 0 or value > 365:
|
|
return DEFAULT_WARNING_DAYS
|
|
return value
|
|
|
|
|
|
def get_panel_title(hass: HomeAssistant) -> str:
|
|
"""Resolve the sidebar panel title for the custom panel.
|
|
|
|
Reads the user-set `panel_title` option from the global config entry so a
|
|
user can rename the sidebar entry (e.g. to avoid clashing with HA's built-in
|
|
"Maintenance" dashboard, 2026.5+). Falls back to the default `PANEL_TITLE`
|
|
when unset, blank, or not a string. Trimmed and length-capped.
|
|
"""
|
|
raw = get_global_options(hass).get(CONF_PANEL_TITLE)
|
|
if not isinstance(raw, str):
|
|
return PANEL_TITLE
|
|
title = raw.strip()
|
|
if not title:
|
|
return PANEL_TITLE
|
|
return title[:MAX_PANEL_TITLE_LENGTH]
|