zapret-kvn/zapret_update/share_client.py
loop-uh c3b7a31cbe
Some checks failed
Windows project source guards / test (push) Failing after 10s
Общее ядро: журнал раздачи (копия из Zapret 2 GUI)
Ядро ведёт журнал обращений к раздаче обновлений (кто, откуда, что просили, сколько
передано); страницы в Zapret KVN для него пока нет. Копия сверена с суммой CORE_SHA256.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-08 13:31:16 -05:00

117 lines
5.4 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.

"""Склейка для обновления: поиск соседей идёт сам, пока считается план.
``start_search`` запускают в самом начале ``prepare`` (поиск занимает до
полутора секунд и идёт в фоне, пока программа сравнивает файлы на диске).
``fill_from_neighbours`` после плана забирает у найденных соседей всё, что
получится. Ни одна из функций не бросает ошибок наружу: соседи — подспорье, и
обновление без них должно идти ровно так же, как раньше.
"""
from __future__ import annotations
import threading
from collections.abc import Callable
from pathlib import Path
from .plan import UpdatePlan
from . import share_discover as discover
from . import share_prefill as prefill
SEARCH_WAIT = discover.FIND_TIMEOUT + 1.0
class Search:
def __init__(self, product: str, version: str, *, enabled: bool = True, find=discover.find_neighbours) -> None:
"""Поиск соседей по локальной сети; ``enabled=False`` — не спрашивать (выключатель выключен)."""
self._found: list[discover.Neighbour] = []
self._thread: threading.Thread | None = None
if not enabled:
return
def run() -> None:
try:
self._found = list(find(product, version))
except Exception: # noqa: BLE001 — поиск не должен ронять обновление
self._found = []
self._thread = threading.Thread(target=run, name="share-search", daemon=True)
self._thread.start()
def result(self, timeout: float = SEARCH_WAIT) -> list[discover.Neighbour]:
if self._thread is not None:
self._thread.join(timeout)
if self._thread.is_alive():
return []
return self._found
def start_search(product: str, version: str, *, enabled: bool = True) -> Search:
return Search(product, version, enabled=enabled)
def fill_from_neighbours(
plan: UpdatePlan,
*,
work_dir: Path,
search: Search,
cancelled: Callable[[], bool] = lambda: False,
on_stage: Callable[[str], None] = lambda _text: None,
report: Callable[[str], None] = lambda _text: None,
fill=prefill.prefill_from_neighbours,
activity=None,
) -> prefill.PrefillResult:
"""Берёт файлы у соседей; при любой беде возвращает пустой итог."""
try:
neighbours = search.result()
if not neighbours or not plan.want:
return prefill.PrefillResult()
on_stage("Скачивание у соседей по сети…")
result = fill(plan, work_dir=work_dir, neighbours=neighbours, cancelled=cancelled, activity=activity)
report(
f"Соседи по сети: найдено {len(neighbours)}, взято файлов {result.files} "
f"({result.bytes / 1048576:.1f} МБ), остальное — с серверов"
)
return result
except Exception as exc: # noqa: BLE001 — обновление идёт и без соседей
report(f"Соседи по сети не помогли: {exc}")
return prefill.PrefillResult()
def fill_from_internet(
plan: UpdatePlan,
*,
work_dir: Path,
find: Callable[[], list[discover.Neighbour]],
cancelled: Callable[[], bool] = lambda: False,
on_stage: Callable[[str], None] = lambda _text: None,
report: Callable[[str], None] = lambda _text: None,
fill=prefill.prefill_from_neighbours,
activity=None,
) -> prefill.PrefillResult:
"""Запасной путь: серверы не отдали файлы, берём их у копий программы в интернете.
Зовётся только после неудачи серверов: при живых серверах адрес человека
соседям по интернету не показывается. Берём всё нужное целиком, даже то, что
с сервера пришло бы маленькой заплаткой: серверов нет, а файл нужен.
"""
try:
if not plan.want:
return prefill.PrefillResult()
on_stage("Серверы не отвечают — ищем копии программы в интернете…")
neighbours = find()
if not neighbours:
report("Серверы обновлений не отдали файлы, а в интернете никого не нашлось")
return prefill.PrefillResult()
result = fill(plan, work_dir=work_dir, neighbours=neighbours, cancelled=cancelled, everything=True, activity=activity)
report(
f"Серверы не отдали файлы: у копий в интернете найдено {len(neighbours)}, взято файлов {result.files} "
f"({result.bytes / 1048576:.1f} МБ)"
)
return result
except Exception as exc: # noqa: BLE001
report(f"Копии в интернете не помогли: {exc}")
return prefill.PrefillResult()
__all__ = ["Search", "fill_from_internet", "fill_from_neighbours", "start_search"]