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:
@@ -0,0 +1,250 @@
|
||||
"""Проверки прода-API wordpdf: gateway → Spring Boot (`POST /api/v1/convert` за X-API-Key) + SPA.
|
||||
|
||||
Коды и тела ответов соответствуют ApiExceptionHandler / ApiKeyFilter /
|
||||
ConvertController на main. Флаги конвертации передаются только в query-строке
|
||||
(контроллер принимает и form, но query детерминированнее).
|
||||
"""
|
||||
|
||||
import requests
|
||||
|
||||
from conftest import TIMEOUT, needs_key
|
||||
|
||||
CONVERT = "/api/v1/convert"
|
||||
|
||||
|
||||
# --- открытые пути (ключ не нужен ни при каком стенде) -----------------------
|
||||
|
||||
|
||||
def test_health(url):
|
||||
"""Живость: actuator health открыт без ключа (HEALTHCHECK контейнера)."""
|
||||
r = requests.get(url("/actuator/health"), timeout=TIMEOUT)
|
||||
assert r.status_code == 200
|
||||
assert r.json()["status"] == "UP"
|
||||
|
||||
|
||||
def test_spa_root(url):
|
||||
"""SPA отдаётся гейтваем: корень — HTML приложения с монтажным узлом."""
|
||||
r = requests.get(url("/"), timeout=TIMEOUT)
|
||||
assert r.status_code == 200
|
||||
assert "text/html" in r.headers["content-type"]
|
||||
assert 'id="root"' in r.text
|
||||
|
||||
|
||||
def test_swagger_ui_open_without_key(url):
|
||||
"""Документация открыта без ключа — регрессия docsOpenWithoutKey."""
|
||||
r = requests.get(url("/swagger-ui.html"), timeout=TIMEOUT)
|
||||
assert r.status_code == 200
|
||||
|
||||
|
||||
def test_api_docs_spec(url):
|
||||
"""Спек OpenAPI открыт без ключа и описывает единственный эндпоинт."""
|
||||
r = requests.get(url("/v3/api-docs"), timeout=TIMEOUT)
|
||||
assert r.status_code == 200
|
||||
assert "/api/v1/convert" in r.text
|
||||
|
||||
|
||||
# --- дальше все проверки требуют переданный ключ ----------------------------
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_no_key_rejected(url, samples):
|
||||
"""Граница доступа: запрос без заголовка X-API-Key — 401 от ApiKeyFilter."""
|
||||
r = requests.post(
|
||||
url(CONVERT),
|
||||
files={"file": ("en-plain.docx", (samples / "en-plain.docx").read_bytes())},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
assert r.status_code == 401
|
||||
assert "X-API-Key" in r.json()["error"]
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_wrong_key_rejected(url, samples):
|
||||
"""Граница доступа: неверный ключ — тот же 401, без различения «нет/неверен»."""
|
||||
r = requests.post(
|
||||
url(CONVERT),
|
||||
headers={"X-API-Key": "wrong-key-000"},
|
||||
files={"file": ("en-plain.docx", (samples / "en-plain.docx").read_bytes())},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
assert r.status_code == 401
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_convert_returns_pdf(url, samples, key_header):
|
||||
"""Основной путь: .docx → PDF-аттачмент с ASCII-именем в filename*."""
|
||||
r = requests.post(
|
||||
url(CONVERT),
|
||||
headers=key_header,
|
||||
files={"file": ("en-plain.docx", (samples / "en-plain.docx").read_bytes())},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
assert r.status_code == 200
|
||||
assert "application/pdf" in r.headers["content-type"]
|
||||
assert r.content[:4] == b"%PDF"
|
||||
disp = r.headers["content-disposition"]
|
||||
assert "attachment" in disp
|
||||
assert "filename*=UTF-8''en-plain.pdf" in disp
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_convert_cyrillic_filename_rfc5987(url, samples, key_header):
|
||||
"""Кириллическое имя части → RFC 5987 filename* (safeBaseName), заголовок не режется наружным nginx.
|
||||
|
||||
Если стенд вернёт filename*=UTF-8''document.pdf — Tomcat не раскодировал
|
||||
UTF-8 имя части (имя теряется на стенде); тогда ассерт фиксирует фактическое значение.
|
||||
"""
|
||||
r = requests.post(
|
||||
url(CONVERT),
|
||||
headers=key_header,
|
||||
files={"file": ("тест документ.docx", (samples / "en-plain.docx").read_bytes())},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
assert r.status_code == 200
|
||||
assert (
|
||||
"filename*=UTF-8''%D1%82%D0%B5%D1%81%D1%82%20"
|
||||
"%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82.pdf"
|
||||
in r.headers["content-disposition"]
|
||||
)
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_too_many_pages_vs_limit(url, samples, key_header, max_pages):
|
||||
"""too-many-pages.docx (151 стр.): сверх лимита стенда — 400 до рендера; ниже лимита — конвертится.
|
||||
|
||||
Лимит страниц — конфигурация сервера (env WORDPDF_MAX_PAGES), не константа
|
||||
набора: прод идёт со 1000, там фикстура — валидный вход; 400-ветка покрыта
|
||||
Java-регрессией WordPdfConverterTest#staleCachePageCountRejectedBeforeRender.
|
||||
"""
|
||||
r = requests.post(
|
||||
url(CONVERT),
|
||||
headers=key_header,
|
||||
files={"file": ("too-many-pages.docx", (samples / "too-many-pages.docx").read_bytes())},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
if max_pages < 151:
|
||||
assert r.status_code == 400
|
||||
assert "error" in r.json()
|
||||
else:
|
||||
assert r.status_code == 200
|
||||
assert r.content[:4] == b"%PDF"
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_stale_cache_vs_limit(url, samples, key_header, max_pages):
|
||||
"""stale-cache.docx (кэш <Pages>1 + 110 lastRenderedPageBreak = 111 стр.): валидатор считает разрывы, не кэш.
|
||||
|
||||
Сверх лимита — 400 (заниженный кэш не спасает), ниже лимита — 200;
|
||||
ветки те же, что у test_too_many_pages_vs_limit.
|
||||
"""
|
||||
r = requests.post(
|
||||
url(CONVERT),
|
||||
headers=key_header,
|
||||
files={"file": ("stale-cache.docx", (samples / "stale-cache.docx").read_bytes())},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
if max_pages < 111:
|
||||
assert r.status_code == 400
|
||||
assert "error" in r.json()
|
||||
else:
|
||||
assert r.status_code == 200
|
||||
assert r.content[:4] == b"%PDF"
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_not_a_zip_rejected(url, notzip_docx, key_header):
|
||||
"""Граница «сломанный контейнер → 400, а не 500»: .docx-суффикс, содержимое — мусор."""
|
||||
r = requests.post(
|
||||
url(CONVERT),
|
||||
headers=key_header,
|
||||
files={"file": (notzip_docx.name, notzip_docx.read_bytes())},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
assert r.status_code == 400
|
||||
assert "error" in r.json()
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_wrong_extension_rejected(url, samples, key_header):
|
||||
"""Расширение проверяет контроллер (ядро байтов его не видит) — регрессия nonDocxFilename_rejected."""
|
||||
r = requests.post(
|
||||
url(CONVERT),
|
||||
headers=key_header,
|
||||
files={"file": ("file.txt", (samples / "en-plain.docx").read_bytes())},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
assert r.status_code == 400
|
||||
assert ".docx" in r.json()["error"]
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_empty_file_rejected(url, key_header):
|
||||
"""Пустая часть — некорректный вход (400), а не ошибка рендера."""
|
||||
r = requests.post(
|
||||
url(CONVERT),
|
||||
headers=key_header,
|
||||
files={"file": ("empty.docx", b"")},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
assert r.status_code == 400
|
||||
assert "error" in r.json()
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_missing_part_rejected(url, key_header):
|
||||
"""Партиты `file` нет в multipart — 400 от MissingServletRequestPartException."""
|
||||
r = requests.post(
|
||||
url(CONVERT),
|
||||
headers=key_header,
|
||||
files={"junk": ("x", b"1")},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
assert r.status_code == 400
|
||||
assert "file" in r.json()["error"]
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_unknown_path_not_found(url, key_header):
|
||||
"""Неизвестный путь под ключом — 404 JSON, а не 500 (regression unknownPath_notFound)."""
|
||||
r = requests.get(url("/api/v1/nope"), headers=key_header, timeout=TIMEOUT)
|
||||
assert r.status_code == 404
|
||||
assert "error" in r.json()
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_error_on_charts_rejected(url, samples, key_header):
|
||||
"""errorOnCharts при выключенном renderCharts — 422 (DrawingRejectedException); render-флаг приоритетнее."""
|
||||
r = requests.post(
|
||||
url(CONVERT) + "?errorOnCharts=true&renderCharts=false",
|
||||
headers=key_header,
|
||||
files={"file": ("charts-smartart.docx", (samples / "charts-smartart.docx").read_bytes())},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
assert r.status_code == 422
|
||||
assert "error" in r.json()
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_render_flags_off_converts(url, samples, key_header):
|
||||
"""Оба render-флага выключены — диаграммы/SmartArt пропускаются до рендера, PDF без них."""
|
||||
r = requests.post(
|
||||
url(CONVERT) + "?renderCharts=false&renderSmartArt=false",
|
||||
headers=key_header,
|
||||
files={"file": ("charts-smartart.docx", (samples / "charts-smartart.docx").read_bytes())},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
assert r.status_code == 200
|
||||
assert r.content[:4] == b"%PDF"
|
||||
|
||||
|
||||
@needs_key
|
||||
def test_charts_full_render(url, samples, key_header):
|
||||
"""Дефолтные флаги — полный Java2D-путь диаграмм/SmartArt в PNG — фикстура charts-smartart.docx."""
|
||||
r = requests.post(
|
||||
url(CONVERT),
|
||||
headers=key_header,
|
||||
files={"file": ("charts-smartart.docx", (samples / "charts-smartart.docx").read_bytes())},
|
||||
timeout=TIMEOUT,
|
||||
)
|
||||
assert r.status_code == 200
|
||||
assert r.content[:4] == b"%PDF"
|
||||
Reference in New Issue
Block a user