zapret-kvn/tests/test_update_store_step.py
loop-uh abb4525e09
Some checks failed
Windows project source guards / test (push) Failing after 9s
Раздача обновлений через интернет: переключатель (выключен) и запасной путь
Как в Zapret 2 GUI. Переключатель «Делиться обновлениями через интернет» в
настройках, в разделе «Обновления», выключен, пока человек сам не включит:
роутер открывает порт, а IP-адрес виден тем, кто соединится.

- общее ядро zapret_update обновлено копией из Zapret 2 GUI (сертификат Ed25519,
  проброс порта UPnP, книга соседей, поиск и раздача по интернету);
- файлы берутся у копий в интернете только если серверы обновлений их не
  отдали; пока серверы живы, адрес человека соседям по интернету не виден;
- книга соседей лежит в data/runtime, адрес для записи на сервере очереди —
  тот же, что у вопроса об обновлениях;
- текст шага экскурсии «Обновления» рассказывает про оба выключателя.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-08 12:40:51 -05:00

184 lines
9.1 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

from __future__ import annotations
"""Лестница загрузки обновления: хранилище с заплатками → куски архива → архив целиком."""
import tempfile
import unittest
from pathlib import Path
from types import SimpleNamespace
from unittest.mock import patch
from xray_fluent.updates import app_updater, share_wiring
from zapret_update import manifest as update_manifest
def _manifest(*, with_store: bool):
return update_manifest.parse({
"schema": 1, "product": "zapret-kvn", "channel": "stable", "version": "9.9.9", "created": 1, "key": "k",
"files": [{"path": "ZapretKVN.exe", "size": 3, "sha256": "a" * 64, "zsize": 2 if with_store else 0}],
})
class StoreStepTests(unittest.TestCase):
def setUp(self) -> None:
self._tmp = tempfile.TemporaryDirectory()
self.addCleanup(self._tmp.cleanup)
self.app = Path(self._tmp.name) / "app"
self.app.mkdir()
# Тесты не шлют в сеть настоящий вопрос соседям: выключатель раздачи выключен.
switch = patch.object(share_wiring, "_enabled", False)
switch.start()
self.addCleanup(switch.stop)
def _downloader(self, manifest):
update = app_updater.AppUpdate("9.9.9", "v9.9.9", "https://iianajhlkh.zapret.moe/x.zip", 100, "", "b" * 64, (), manifest)
return app_updater.UpdateDownloader(update, app_dir=self.app)
def test_release_without_a_store_skips_the_step(self) -> None:
with patch("zapret_update.fetch.fetch_plan") as fetch:
self.assertIsNone(self._downloader(_manifest(with_store=False))._try_store())
fetch.assert_not_called()
def test_store_builds_the_new_version_tree(self) -> None:
tree = self.app / "data" / "runtime" / "app_update" / "store-9.9.9" / "tree"
def build(planned, *, root, ready, stage_dir):
stage_dir.mkdir(parents=True)
(stage_dir / "ZapretKVN.exe").write_bytes(b"new")
return stage_dir
with patch("zapret_update.fetch.fetch_plan", return_value={}) as fetch, patch(
"zapret_update.stage.build_stage", side_effect=build
), patch("zapret_update.store.codecs", return_value=frozenset({"zstd"})):
self.assertEqual(self._downloader(_manifest(with_store=True))._try_store(), tree)
# Скачанное лежит в постоянной папке: после перезапуска загрузка продолжится.
self.assertEqual(fetch.call_args.kwargs["work_dir"], tree.parent)
self.assertIn("zapretkvn/generic/zapret-kvn-store/1/", fetch.call_args.kwargs["sources"][0].url_for("x.zst"))
def test_neighbours_are_asked_after_the_plan_and_before_the_servers(self) -> None:
calls: list[str] = []
def search(product, version, **kwargs):
calls.append(f"search {product} {version} enabled={kwargs.get('enabled')}")
return object()
def servers(*_a, **_k):
calls.append("servers")
raise OSError("stop here")
real_plan = app_updater.__dict__.get("update_plan")
with patch("zapret_update.share_client.start_search", search), patch(
"zapret_update.share_client.fill_from_neighbours",
lambda planned, **kw: calls.append(f"neighbours {kw['work_dir'].name}"),
), patch("zapret_update.fetch.fetch_plan", servers), patch(
"zapret_update.store.codecs", return_value=frozenset({"zstd"})
):
self.assertIsNone(self._downloader(_manifest(with_store=True))._try_store())
self.assertEqual(calls, ["search zapret-kvn 9.9.9 enabled=False", "neighbours store-9.9.9", "servers"])
del real_plan
def _fallback_run(self, *, finder, taken):
from zapret_update import fetch, share_prefill
calls: list[str] = []
def servers(*_a, **_k):
calls.append("servers")
if calls.count("servers") == 1 or not taken:
raise fetch.FetchError("blocked", "net")
return {}
def internet(planned, **kwargs):
calls.append("internet")
return share_prefill.PrefillResult(files=taken, bytes=0)
def stop_after(*_a, **_k):
calls.append("stage")
raise OSError("downloaded")
with patch("zapret_update.fetch.fetch_plan", servers), patch(
"zapret_update.share_client.fill_from_internet", internet
), patch.object(share_wiring, "internet_finder", lambda version: finder), patch(
"zapret_update.stage.build_stage", stop_after
), patch("zapret_update.store.codecs", return_value=frozenset({"zstd"})):
result = self._downloader(_manifest(with_store=True))._try_store()
return calls, result
def test_internet_copies_are_asked_only_after_the_servers_failed(self) -> None:
calls, result = self._fallback_run(finder=lambda: [], taken=2)
self.assertEqual(calls, ["servers", "internet", "servers", "stage"])
self.assertIsNone(result) # сборка дерева в тесте оборвана: ступень честно отдаёт следующую
def test_without_the_internet_switch_the_server_failure_hands_over_to_the_next_step(self) -> None:
calls, result = self._fallback_run(finder=None, taken=2)
self.assertEqual(calls, ["servers"])
self.assertIsNone(result)
def test_if_internet_copies_gave_nothing_the_next_step_takes_over(self) -> None:
calls, result = self._fallback_run(finder=lambda: [], taken=0)
self.assertEqual(calls, ["servers", "internet"])
self.assertIsNone(result)
def test_switch_on_lets_the_search_run(self) -> None:
seen = {}
with patch.object(share_wiring, "_enabled", True), patch(
"zapret_update.share_client.start_search", lambda *a, **k: seen.update(k) or object()
), patch("zapret_update.share_client.fill_from_neighbours", lambda *a, **k: None), patch(
"zapret_update.fetch.fetch_plan", side_effect=OSError("stop")
), patch("zapret_update.store.codecs", return_value=frozenset({"zstd"})):
self._downloader(_manifest(with_store=True))._try_store()
self.assertTrue(seen["enabled"])
def test_log_names_patch_kinds(self) -> None:
import hashlib
old = b"old"
(self.app / "ZapretKVN.exe").write_bytes(old)
listed = update_manifest.parse({
"schema": 1, "product": "zapret-kvn", "channel": "stable", "version": "9.9.9", "created": 1, "key": "k",
"files": [{"path": "ZapretKVN.exe", "size": 3, "sha256": "a" * 64, "zsize": 50}],
"patches": [{"from": hashlib.sha256(old).hexdigest(), "to": "a" * 64, "size": 7}],
})
def build(planned, *, root, ready, stage_dir):
stage_dir.mkdir(parents=True)
(stage_dir / "ZapretKVN.exe").write_bytes(b"new")
return stage_dir
with patch("zapret_update.fetch.fetch_plan", return_value={}), patch(
"zapret_update.stage.build_stage", side_effect=build
), patch("zapret_update.store.codecs", return_value=frozenset({"zstd"})), self.assertLogs(
app_updater._log, "INFO"
) as logs:
downloader = self._downloader(listed)
self.assertIsNotNone(downloader._try_store())
self.assertIn("скачано 7 из 100 байт (файлов 1, заплаток 1 (zstd 1), без изменений 0)", "\n".join(logs.output))
# Ступень и объём уходят серверу вместе с «дошла».
self.assertEqual((downloader.via, downloader.downloaded), ("files", 7))
def test_without_zstd_unpacker_nothing_is_downloaded(self) -> None:
# 0.8.26 собрана на Python 3.12 без zstandard: качала файл и падала на распаковке.
with patch("zapret_update.fetch.fetch_plan") as fetch, patch(
"zapret_update.store.codecs", return_value=frozenset({"bsdiff"})
):
self.assertIsNone(self._downloader(_manifest(with_store=True))._try_store())
fetch.assert_not_called()
def test_failed_store_hands_over_to_the_next_step(self) -> None:
from zapret_update.fetch import FetchError
with patch("zapret_update.fetch.fetch_plan", side_effect=FetchError("нет сети")) as fetch, patch(
"zapret_update.store.codecs", return_value=frozenset({"zstd"})
):
self.assertIsNone(self._downloader(_manifest(with_store=True))._try_store())
fetch.assert_called_once()
def test_store_comes_before_archive_pieces(self) -> None:
downloader = self._downloader(_manifest(with_store=True))
order = []
downloader._try_store = lambda: order.append("store") or None
downloader._try_delta = lambda work_dir: order.append("delta") or None
downloader._fetch = lambda archive: (order.append("zip"), (_ for _ in ()).throw(app_updater.DownloadFailed("стоп")))
with patch.object(app_updater, "_purge_stale_update_dirs"):
downloader.run()
self.assertEqual(order, ["store", "delta", "zip"])