tests: prod-autotests — pytest-набор автотестов API прода (env-конфигурация, mise-окружение)

18 проверок gateway → Spring Boot + SPA: открытые пути (actuator, SPA,
springdoc), граница X-API-Key (401), конвертация (PDF, RFC 5987 filename*),
отказы входа (400/422), лимит страниц — limit-aware через WORDPDF_MAX_PAGES.
Стенд задаётся только env; прод-раннер живёт вне git.
This commit is contained in:
Pjandro
2026-10-19 22:31:44 +00:00
parent e7db0c6b06
commit ee49993aff
6 changed files with 349 additions and 0 deletions
+86
View File
@@ -0,0 +1,86 @@
"""Автотесты прода wordpdf: стенд задаётся исключительно переменными окружения.
Запуск из этого каталога (подхватывается mise.toml — python + venv + зависимости):
WORDPDF_BASE_URL=<стенд> [WORDPDF_API_KEY=<ключ>] mise exec -- python -m pytest -q .
WORDPDF_BASE_URL обязателен: без него все проверки падают — набор принципиально
не знает ни одного хоста. WORDPDF_API_KEY факультативен: без него проверки,
где есть заголовок ключа или ожидается 401, пропускаются (без локального ключа
нельзя знать, включена ли аутентификация на стенде). WORDPDF_MAX_PAGES — ожидаемый
лимит страниц стенда (конфигурация сервера, не константа набора; дефолт 100 =
дефолт ядра). .docx-фикстуры — из wordpdf-core/src/test/resources/samples,
либо из WORDPDF_SAMPLES_DIR.
"""
import os
from pathlib import Path
import pytest
# (connect, read): read 180 с — с запасом над серверным wordpdf.convert-timeout=2m
# (504 по таймауту — тоже ответ сервера, но до него не доходим).
TIMEOUT = (10, 180)
# Навешивается на все проверки с заголовком ключа или ожиданием 401: на стенде
# без аутентификации (dev) они дали бы ложный FAIL, а не честный SKIP.
needs_key = pytest.mark.skipif(
not os.environ.get("WORDPDF_API_KEY", "").strip(),
reason="WORDPDF_API_KEY не задан — стенд без аутентификации или ключ не передан",
)
@pytest.fixture(scope="session")
def base_url():
"""Корень стенда только из env; пустой — провал, а не дефолт-хост."""
url = os.environ.get("WORDPDF_BASE_URL", "").strip().rstrip("/")
if not url:
pytest.fail("WORDPDF_BASE_URL не задан — набор привязан к стенду только этой переменной")
return url
@pytest.fixture(scope="session")
def url(base_url):
"""Единая склейка base + путь — все запросы тестов идут через неё."""
def join(path):
return base_url + path
return join
@pytest.fixture(scope="session")
def max_pages():
"""Ожидаемый лимит страниц стенда: серверная конфигурация, не константа набора."""
return int(os.environ.get("WORDPDF_MAX_PAGES", "100"))
@pytest.fixture(scope="session")
def api_key():
return os.environ.get("WORDPDF_API_KEY", "").strip()
@pytest.fixture(scope="session")
def key_header(api_key):
return {"X-API-Key": api_key} if api_key else {}
@pytest.fixture(scope="session")
def samples():
"""Каталог закоммиченных .docx-фикстур ядра (только чтение)."""
env = os.environ.get("WORDPDF_SAMPLES_DIR", "").strip()
d = Path(env) if env else (
Path(__file__).resolve().parents[1]
/ "wordpdf-core" / "src" / "test" / "resources" / "samples"
)
if not (d / "en-plain.docx").is_file():
pytest.fail("фикстуры не найдены: укажите WORDPDF_SAMPLES_DIR")
return d
@pytest.fixture
def notzip_docx(tmp_path):
"""Файл с валидным .docx-суффиксом и случайным содержимым — граница «не zip → 400, а не 500»."""
p = tmp_path / "notzip.docx"
p.write_bytes(os.urandom(2048))
return p