Files
templates/tools/pdf-scan-to-vector/tests/test_host.py
T
Andrey afdf62cfa4 Добавить проверку Flash SCI, системные диалоги и векторизацию PDF
Расширить протокол SCI проверкой содержимого Flash и комплектом RAM-ядер.
Добавить утилиту векторизации PDF с OCR, общие диалоги DSView и проверки.
2026-11-18 16:03:53 +03:00

109 lines
14 KiB
Python

import json # Проверяем настоящий строковый обмен через локальный канал.
import os # Qt без рабочего стола позволяет повторять проверки на машине сборки.
import time # Ограничиваем ожидание асинхронных событий реальным сроком.
import uuid # Каналы параллельных запусков проверок не пересекаются.
os.environ.setdefault("QT_QPA_PLATFORM", "offscreen") # Режим задаётся до первого создания QApplication.
import pymupdf as fitz # Создаём реальные PDF без пользовательских документов.
import pytest # Фикстуры освобождают окна и временные профили после каждого сценария.
from PySide6.QtNetwork import QLocalServer # Проверяем тот же канал, которым управляет вкладка SETGUI.
from gui import application # Используем фактическое оформление и жизненный цикл программы.
from host import HostedWindow # Адаптер проверяется вместе с настоящим исходным интерфейсом.
def wait_until(predicate, app): # Локальный цикл обслуживает Qt во время ожидания ответа компонента.
deadline = time.monotonic() + 5 # Пять секунд достаточно для обмена внутри одного процесса без OCR.
while not predicate() and time.monotonic() < deadline: # Готовность проверяется без бесконечного ожидания.
app.processEvents() # Соединение и команды обрабатываются настоящим циклом Qt.
time.sleep(0.005) # Короткая пауза не загружает ядро процессора ожиданием.
assert predicate() # Неполученный ответ является отказом проверки, а не молчаливым успехом.
@pytest.fixture # Каждая проверка получает собственные канал, настройки и рабочий каталог.
def hosted(tmp_path): # Исходные пользовательские документы и реестр Windows не затрагиваются.
app = application() # Все тестовые окна используют единственный экземпляр QApplication.
server = QLocalServer() # Управляющая сторона повторяет локальный сервер SETGUI.
assert server.listen("pdf-vector-test-" + uuid.uuid4().hex) # Проверка не использует постоянные имена каналов.
window = HostedWindow(server.serverName(), tmp_path / "profile.ini") # Параметры программы записываются только в папку проверки.
window.show() # Полный интерфейс получает нормальные события видимости и закрытия.
wait_until(server.hasPendingConnections, app) # Ожидаем фактического подключения адаптера.
channel = server.nextPendingConnection() # Тест управляет ровно одним подключённым окном.
wait_until(channel.canReadLine, app) # Готовность должна передать целую строку JSON.
ready = json.loads(bytes(channel.readLine())) # Читаем настоящее сообщение вместо подмены метода send.
assert ready == {"event": "ready", "window": int(window.winId())} # Родитель получает реальный дескриптор созданного окна.
yield app, window, channel # Сценарий может отправлять команды и проверять сохранность документа.
window.result_saved = True # Освобождение фикстуры не должно показывать диалог, уже проверенный сценарием.
window.close() # Штатный обработчик закрывает PDF и удаляет собственный временный каталог.
channel.abort() # Завершаем управляющую сторону только после закрытия окна.
server.close() # Освобождаем уникальное имя локального сервера.
app.processEvents() # Qt завершает отложенные события освобождения канала.
def send(channel, **message): # Команды передаются тем же форматом, что из внешнего SETGUI.
channel.write((json.dumps(message) + "\n").encode("utf-8")) # Путь Unicode передаётся без shell и изменения разделителей.
channel.flush() # Обмен начинается до следующего действия сценария.
def test_local_protocol_opens_unicode_pdf_and_reports_bad_command(hosted, tmp_path): # Реальное открытие подтверждается фактическим состоянием исходного окна.
app, window, channel = hosted # Сохраняем доступ к приложению и управляющему каналу.
path = tmp_path / "Схема с пробелами.pdf" # Кириллица и пробелы проверяют сериализацию пути.
with fitz.open() as document: # Искусственный PDF создаётся без внешних библиотек или файлов.
document.new_page() # Достаточно одной страницы для проверки загрузки и предпросмотра.
document.save(path) # Сохраняем настоящий PDF в изолированном каталоге.
send(channel, command="open", path=str(path)) # Команда должна открыть документ в существующем процессе.
wait_until(channel.canReadLine, app) # Ответ поступает после исходной проверки PDF.
reply = json.loads(bytes(channel.readLine())) # Проверяем сообщение, которое реально получит SETGUI.
assert reply["event"] == "opened" and reply["accepted"] # Успех означает открытие документа, а не только приём строки.
assert window.source_path == path.resolve() and len(window.source) == 1 # Исходное окно содержит именно запрошенную страницу.
channel.write(b"[]\n") # Неверный тип JSON воспроизводит повреждённую команду локального протокола.
channel.flush() # Ошибочная команда должна быть обработана немедленно.
wait_until(channel.canReadLine, app) # Адаптер отвечает диагностикой без закрытия PDF.
assert json.loads(bytes(channel.readLine()))["event"] == "error" # Отказ не превращается в исключение главного цикла.
assert window.source_path == path.resolve() and window.isVisible() # Документ и интерфейс сохраняются после ошибки канала.
def test_cancel_close_preserves_unsaved_result_and_replies_to_host(hosted, monkeypatch): # Отмена выхода должна сохранить также родительский SETGUI.
app, window, channel = hosted # Используем готовый интерфейс с настоящим локальным соединением.
window.result = fitz.open() # Имитируем уже сформированный результат без дорогого повторного OCR.
window.result.new_page() # Непустой PDF должен остаться доступным после отказа от выхода.
monkeypatch.setattr("host.W.QMessageBox.question", lambda *_args: window_button_cancel()) # Выбираем системный ответ «Отмена» без интерактивного диалога проверки.
send(channel, command="close") # Запрос приходит тем же путём, что при выходе из SETGUI.
wait_until(channel.canReadLine, app) # Родитель обязан получить явный отказ вместо бесконечного ожидания.
assert json.loads(bytes(channel.readLine())) == {"event": "close_cancelled"} # Событие снимает ожидание закрытия внешней вкладки.
assert window.isVisible() and len(window.result) == 1 # Несохранённый документ остаётся открытым и пригодным к экспорту.
assert not window.result_saved # Отмена не должна ложно отмечать PDF сохранённым.
def window_button_cancel(): # Числовое значение ответа берётся из того же Qt, что проверяемое окно.
from PySide6.QtWidgets import QMessageBox # Локальный импорт не создаёт дополнительных виджетов.
return QMessageBox.Cancel # Сохраняем семантику настоящей кнопки отмены диалога.
@pytest.mark.parametrize("save_succeeds", [True, False]) # Ошибка экспорта должна сохранять окно так же, как явная отмена выхода.
def test_close_saves_result_only_after_successful_export(hosted, tmp_path, monkeypatch, save_succeeds): # Проверяем реальный путь Save через диалог и атомарную публикацию PDF.
from PySide6.QtWidgets import QMessageBox # Используем штатные ответы той же привязки Qt.
app, window, channel = hosted # Сценарий управляет настоящим окном через локальный канал.
original = tmp_path / "Исходный скан.pdf" # Этот путь должен остаться неизменным после сохранения результата.
original.write_bytes(b"unchanged source") # Для проверки сохранности исходника достаточно контрольных байтов.
result = tmp_path / "Готовый результат.pdf" # Пользовательский файл отделён от временного PDF приложения.
window.source_path = original # Диалог сохранения предлагает имя относительно исходного документа.
window.result = fitz.open() # Создаём уже готовый результат без повторного запуска OCR.
window.result.new_page() # Сохранённый PDF должен содержать действительную страницу.
temporary = tmp_path / "temporary.pdf" # Отчёт ссылается на готовый внутренний файл программы.
window.result.save(temporary) # Временный документ записывается до вызова экспортной команды.
window.report = {"path": str(temporary)} # Экспорт использует тот же путь, который возвращает настоящий рабочий процесс.
monkeypatch.setattr("host.W.QMessageBox.question", lambda *_args: QMessageBox.Save) # Выбираем сохранение перед выходом вместо обхода проверки.
monkeypatch.setattr("gui.W.QFileDialog.getSaveFileName", lambda *_args: (str(result), "PDF")) # Диалог возвращает изолированное имя пользовательского результата.
monkeypatch.setattr("gui.W.QMessageBox.warning", lambda *_args: QMessageBox.Ok) # Ошибка записи диагностируется без модального ожидания ручного ввода тестировщика.
if not save_succeeds: # Отсутствующий временный файл имитирует реальную ошибку чтения при экспорте.
temporary.unlink() # Атомарный экспорт обязан отказаться от публикации и не отмечать PDF сохранённым.
send(channel, command="close") # Запрос проходит всю процедуру закрытия HostedWindow.
wait_until(lambda: not window.isVisible() if save_succeeds else channel.canReadLine(), app) # Успех завершает окно, ошибка должна ответить родителю отменой выхода.
assert window.result_saved == save_succeeds # Флаг относится только к реально опубликованному пользовательскому файлу.
assert original.read_bytes() == b"unchanged source" # Исходный документ сохраняется независимо от результата экспорта.
if save_succeeds: # Успех проверяется чтением фактического PDF, а не только состоянием интерфейса.
with fitz.open(result) as saved: # Новый документ должен быть корректным после закрытия всех внутренних ресурсов.
assert len(saved) == 1 # Пользовательский результат содержит исходную тестовую страницу.
else: # Ошибка сохранения оставляет возможность исправить назначение и повторить экспорт.
assert json.loads(bytes(channel.readLine())) == {"event": "close_cancelled"} # SETGUI снимает ожидание завершения и сохраняет рабочий сеанс.
assert window.isVisible() and not result.exists() # Частичный пользовательский файл не публикуется при отказе атомарного копирования.