Files
esphome/tests/integration/test_template_text_save.py

132 lines
4.7 KiB
Python

"""Integration test for template text restore_value persistence.
Tests that:
1. A template text with restore_value saves its value to preferences
2. The saved value persists across restarts (binary re-run)
3. Setting the same value again does not produce a spurious "too long" warning
"""
from __future__ import annotations
import asyncio
from pathlib import Path
import socket
from typing import Any
from aioesphomeapi import TextInfo, TextState
import pytest
from .conftest import run_binary_and_wait_for_port, wait_and_connect_api_client
from .state_utils import InitialStateHelper, require_entity
from .types import CompileFunction, ConfigWriter
@pytest.mark.asyncio
async def test_template_text_save(
yaml_config: str,
write_yaml_config: ConfigWriter,
compile_esphome: CompileFunction,
reserved_tcp_port: tuple[int, socket.socket],
) -> None:
"""Test template text save/restore persistence and duplicate-save behavior."""
port, port_socket = reserved_tcp_port
# Clean up any stale preference file from previous runs
prefs_file = (
Path.home() / ".esphome" / "prefs" / "host-template-text-save-test.prefs"
)
if prefs_file.exists():
prefs_file.unlink()
# Write and compile once
config_path = await write_yaml_config(yaml_config)
binary_path = await compile_esphome(config_path)
# Release the reserved port so the binary can bind to it
port_socket.close()
# --- First run: set a value and verify no spurious warnings ---
warning_lines: list[str] = []
def capture_warnings(line: str) -> None:
if "too long to save" in line.lower():
warning_lines.append(line)
async with (
run_binary_and_wait_for_port(
binary_path, "127.0.0.1", port, line_callback=capture_warnings
),
wait_and_connect_api_client(port=port) as client,
):
device_info = await client.device_info()
assert device_info.name == "host-template-text-save-test"
entities, _ = await client.list_entities_services()
text_entity = require_entity(
entities, "test_text_restore", TextInfo, "Test Text Restore"
)
# Set up state tracking
loop = asyncio.get_running_loop()
state_futures: dict[int, asyncio.Future[Any]] = {}
def on_state(state: Any) -> None:
if state.key in state_futures and not state_futures[state.key].done():
state_futures[state.key].set_result(state)
initial_state_helper = InitialStateHelper(entities)
client.subscribe_states(initial_state_helper.on_state_wrapper(on_state))
await initial_state_helper.wait_for_initial_states()
# Verify initial value from config
initial = initial_state_helper.initial_states[text_entity.key]
assert isinstance(initial, TextState)
assert initial.state == "hello"
async def wait_for_state(key: int, timeout: float = 2.0) -> Any:
state_futures[key] = loop.create_future()
try:
return await asyncio.wait_for(state_futures[key], timeout)
finally:
state_futures.pop(key, None)
# Set a new value that fits within max_length
client.text_command(key=text_entity.key, state="world")
state = await wait_for_state(text_entity.key)
assert state.state == "world"
# Set the same value again - should NOT produce "too long" warning
client.text_command(key=text_entity.key, state="world")
# Give time for the warning to appear (if any)
await asyncio.sleep(0.5)
# No warnings should have appeared
assert warning_lines == [], (
f"Unexpected 'too long to save' warning(s): {warning_lines}"
)
# --- Second run: verify the value was restored from preferences ---
async with (
run_binary_and_wait_for_port(binary_path, "127.0.0.1", port),
wait_and_connect_api_client(port=port) as client,
):
entities, _ = await client.list_entities_services()
text_entity = require_entity(
entities, "test_text_restore", TextInfo, "Test Text Restore"
)
initial_state_helper = InitialStateHelper(entities)
client.subscribe_states(initial_state_helper.on_state_wrapper(lambda s: None))
await initial_state_helper.wait_for_initial_states()
# The value should be "world" - restored from preferences
restored = initial_state_helper.initial_states[text_entity.key]
assert isinstance(restored, TextState)
assert restored.state == "world", (
f"Expected restored value 'world', got '{restored.state}'"
)
# Clean up preference file
if prefs_file.exists():
prefs_file.unlink()