Files
houseplan-card/test/backend-test-hygiene.test.mjs
T
Matysh 8dfb0a9e36 test: put the package stub in one place, under an honest condition
Чистые тесты подменяли custom_components и custom_components.houseplan
пустышками и не убирали их никогда. В CI это не стреляло только потому, что
настоящий пакет успевал импортироваться из файла, который идёт раньше по
алфавиту: условие «если ещё не импортирован» оказывалось ложным. То есть
корректность HA-харнесса держалась на именах файлов в каталоге, и хватило бы
переименования, чтобы получить #389 заново.

Подмена переехала в conftest и стала условной по единственному честному
признаку: есть Home Assistant — работаем с настоящим пакетом и не подменяем
ничего; нет — HA-тесты и так пропущены, ломать нечего.

Первым заходом я делал подмену обратимой прямо в тестах, контекстным
менеджером. Замер показал, что так теряется работоспособность
test_wall_segment_model в песочнице: он импортирует пакет обычным способом и
жил как раз за счёт чужой пустышки. Развилка в conftest сохраняет оба
окружения и убирает зависимость от порядка файлов.

Проверено в обе стороны: в песочнице 240 passed, а в эмуляции «HA есть»
объект пакета после прогона тот же, что был до.

Issue: #394
User-Visible: no
2026-08-30 20:11:31 +03:00

52 lines
3.8 KiB
JavaScript

import test from 'node:test';
import assert from 'node:assert/strict';
import { readFileSync, readdirSync } from 'node:fs';
import { fileURLToPath } from 'node:url';
// Гигиена backend-тестов (#393): тест не имеет права оставлять после себя
// изменённую импорт-машину. В #389 это
// стоило пяти часов красного dev: пустышка в sys.modules пережила свой тест,
// Home Assistant перестал видеть у интеграции async_setup, и 85 тестов
// харнесса падали с голым `assert False`, не намекая на причину.
//
// Проверка статическая — по исходникам, без запуска. Это намеренно: рантайм
// ловит последствие и только на том порядке тестов, который сегодня сложился,
// а исходник ловит намерение.
const BACKEND = fileURLToPath(new URL('../tests_backend/', import.meta.url));
const files = () => readdirSync(BACKEND).filter((name) => name.endsWith('.py'));
const read = (name) => readFileSync(new URL(name, `file://${BACKEND}`), 'utf8');
test('backend-тесты не правят sys.path (#393)', () => {
const offenders = files().filter((name) => /^\s*sys\.path\b/m.test(read(name)));
assert.deepEqual(offenders, [],
'sys.path, изменённый при коллекции, действует на всю сессию: модули пакета'
+ ' становятся импортируемыми ещё и как модули верхнего уровня, и один файл'
+ ' может оказаться в sys.modules дважды с разными объектами классов.'
+ ' Читать модуль без Home Assistant можно и без этого — см. test_trails.py:'
+ ' текст файла и exec нужного среза.');
});
test('пакет интеграции подменяет только conftest и только без HA (#394)', () => {
// Пустышка вместо `custom_components.houseplan` — единственный способ читать
// подмодули без Home Assistant, и запретить её нельзя. Но место у неё одно:
// conftest, где решение принимается по честному признаку «есть ли HA».
//
// Когда её ставили сами тесты под условием «если ещё не импортирован», в CI
// она не срабатывала лишь потому, что настоящий пакет успевал импортироваться
// из файла, который идёт раньше по алфавиту. Корректность харнесса держалась
// на именах файлов; чем это кончается, показал #389.
const assigns = /sys\.modules\[\s*(['"])custom_components/;
const offenders = files().filter((name) => name !== 'conftest.py' && assigns.test(read(name)));
assert.deepEqual(offenders, [],
'подмена пакета интеграции живёт в tests_backend/conftest.py и только там:'
+ ' там она условная (нет Home Assistant — нечего ломать), а в тесте она'
+ ' переживает свой тест и достаётся всей сессии (#389, #394).');
const conftest = read('conftest.py');
assert.match(conftest, /if not HAS_HA:/,
'подмена в conftest обязана быть под условием отсутствия Home Assistant');
const stub = conftest.slice(conftest.indexOf('if not HAS_HA:'));
assert.match(stub, /sys\.modules\[_name\] = _module/);
});