Files
java-word-pdf/prod-autotests/test_prod_api.py
T
Pjandro fe693efcb0
PR checks / web (pull_request) Successful in 32s
PR checks / java (pull_request) Successful in 1m7s
Main: tests, deploy, autotests / web (push) Successful in 30s
Main: tests, deploy, autotests / java (push) Successful in 1m3s
Main: tests, deploy, autotests / images-web (push) Successful in 28s
Main: tests, deploy, autotests / images-app (push) Successful in 43s
Main: tests, deploy, autotests / deploy (push) Successful in 1m36s
Main: tests, deploy, autotests / autotests (push) Successful in 40s
Main: tests, deploy, autotests / rollback (push) Has been skipped
Прод-автотесты: верный filename* для .doc + 405/415/500/SmartArt/битый флаг + .doc-пары ограничений и растеров
2026-10-31 18:46:17 +00:00

474 lines
19 KiB
Python
Raw 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.
"""Проверки прода-API wordpdf: gateway → Spring Boot (`POST /api/v1/convert` за X-API-Key) + SPA.
Коды и тела ответов соответствуют ApiExceptionHandler / ApiKeyFilter /
ConvertController на main. Флаги конвертации передаются только в query-строке
(контроллер принимает и form, но query детерминированнее).
"""
import io
import zipfile
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_binary_doc(url, samples, key_header):
"""Бинарный .doc (Word 97-2003) → PDF: мост internal.doc на проде."""
r = requests.post(
url(CONVERT),
headers=key_header,
files={"file": ("ru-plain.doc", (samples / "ru-plain.doc").read_bytes())},
timeout=TIMEOUT,
)
assert r.status_code == 200
assert "application/pdf" in r.headers["content-type"]
assert r.content[:4] == b"%PDF"
assert "filename*=UTF-8''ru-plain.pdf" in r.headers["content-disposition"]
@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), не константа
набора: лимит стенда приходит переменной `WORDPDF_MAX_PAGES` (на проде —
Gitea Variable, сейчас 100), там фикстура — отказ; 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_oversized_vs_limit(url, samples, key_header, max_mb):
"""Граница размера: валидный zip-docx больше WORDPDF_MAX_MB стенда (МБ) — 400 от checkInput до рендера.
Раздутый нулями ZIP_STORED-филлер остаётся валидным zip, так что 400
может дать только проверка размера (не подпись zip). Если лимит сервера
расходится с WORDPDF_MAX_MB в большую сторону — сервер вернёт не 400
и тест это поймает.
"""
max_bytes = max_mb * 1024 * 1024
buf = io.BytesIO()
with zipfile.ZipFile(samples / "en-plain.docx") as src, \
zipfile.ZipFile(buf, "w", zipfile.ZIP_STORED) as out:
for item in src.infolist():
out.writestr(item, src.read(item.filename))
out.writestr("filler.bin", b"\0" * (max_bytes + 1))
payload = buf.getvalue()
assert len(payload) > max_bytes
r = requests.post(
url(CONVERT),
headers=key_header,
files={"file": ("oversized.docx", payload)},
timeout=TIMEOUT,
)
assert r.status_code == 400
assert "error" in r.json()
@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_plain_zip_not_docx_rejected(url, key_header):
"""Граница «не .docx → 400»: валидный zip без манифеста wordprocessingml под .docx-суффиксом."""
buf = io.BytesIO()
with zipfile.ZipFile(buf, "w") as z:
z.writestr("hello.txt", "не документ")
r = requests.post(
url(CONVERT),
headers=key_header,
files={"file": ("archive.docx", buf.getvalue())},
timeout=TIMEOUT,
)
assert r.status_code == 400
assert "не является .docx" in r.json()["error"]
@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=true — 422 (DrawingRejectedException); конвертация всегда,
отказ только по error-флагу."""
r = requests.post(
url(CONVERT) + "?errorOnCharts=true",
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()
assert "диаграммы" in r.json()["error"]
@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"
@needs_key
def test_error_on_ole_rejected(url, samples, key_header):
"""errorOnOle=true — 422; OLE-объекты найдены, документ отвергнут по флагу."""
r = requests.post(
url(CONVERT) + "?errorOnOle=true",
headers=key_header,
files={"file": ("ole-embedded.docx", (samples / "ole-embedded.docx").read_bytes())},
timeout=TIMEOUT,
)
assert r.status_code == 422
assert "error" in r.json()
assert "OLE" in r.json()["error"]
@needs_key
def test_ole_removed_by_default(url, samples, key_header):
"""Дефолтные флаги — OLE-объекты тихо удаляются, документ конвертируется."""
r = requests.post(
url(CONVERT),
headers=key_header,
files={"file": ("ole-embedded.docx", (samples / "ole-embedded.docx").read_bytes())},
timeout=TIMEOUT,
)
assert r.status_code == 200
assert r.content[:4] == b"%PDF"
@needs_key
def test_error_on_smartart_rejected(url, samples, key_header):
"""errorOnSmartArt=true — 422 с текстом про SmartArt (диаграммы конвертируются,
их error-флаг выключен) — регрессия errorFlagSmartArt_rejected; текст — контракт с фронтом."""
r = requests.post(
url(CONVERT) + "?errorOnSmartArt=true",
headers=key_header,
files={"file": ("charts-smartart.docx", (samples / "charts-smartart.docx").read_bytes())},
timeout=TIMEOUT,
)
assert r.status_code == 422
assert "SmartArt" in r.json()["error"]
@needs_key
def test_get_method_returns_405(url, key_header):
"""GET на эндпоинт — 405 JSON от ApiExceptionHandler — регрессия methodNotSupportedReturns405."""
r = requests.get(url(CONVERT), headers=key_header, timeout=TIMEOUT)
assert r.status_code == 405
assert r.json()["error"] == "Метод не поддерживается"
@needs_key
def test_json_body_returns_415(url, key_header):
"""Не multipart-тело (application/json) — 415 JSON — регрессия badContentTypeReturns415."""
r = requests.post(url(CONVERT), headers=key_header, json={}, timeout=TIMEOUT)
assert r.status_code == 415
assert r.json()["error"] == "Неподдерживаемый тип содержимого"
@needs_key
def test_error_flag_not_boolean_rejected(url, samples, key_header):
"""errorOnCharts=tru3 — 400 от MethodArgumentTypeMismatchException, имя параметра в тексте —
регрессия errorFlagNotBoolean_rejected."""
r = requests.post(
url(CONVERT) + "?errorOnCharts=tru3",
headers=key_header,
files={"file": ("en-plain.docx", (samples / "en-plain.docx").read_bytes())},
timeout=TIMEOUT,
)
assert r.status_code == 400
assert "errorOnCharts" in r.json()["error"]
@needs_key
def test_junk_inside_valid_container_returns_500(url, key_header):
"""Манифест декларирует документ wordprocessingml, пакет битый (нет _rels/.rels) —
500 ConversionFailedException, а не 400 валидации — регрессия junkInsideValidZip_conversionError.
Побайтово повторяет Java-хелпер docxPackageWithGarbage (ConvertControllerTest);
голый zip без манифеста остаётся 400 — test_plain_zip_not_docx_rejected.
"""
content_types = (
'<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
'<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">'
'<Default Extension="xml" ContentType="application/xml"/>'
'<Override PartName="/word/document.xml"'
' ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document"/>'
"</Types>"
)
document = (
'<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
'<w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">'
"<w:body><w:p/></w:body></w:document>"
)
buf = io.BytesIO()
with zipfile.ZipFile(buf, "w") as z:
z.writestr("[Content_Types].xml", content_types)
z.writestr("word/document.xml", document)
r = requests.post(
url(CONVERT),
headers=key_header,
files={"file": ("bad.docx", buf.getvalue())},
timeout=TIMEOUT,
)
assert r.status_code == 500
assert "Не удалось конвертировать" in r.json()["error"]
@needs_key
def test_too_many_pages_doc_vs_limit(url, samples, key_header, max_pages):
"""too-many-pages.doc (кэш PageCount=150, 1+явные разрывы=151): валидатор .doc-пути
считает max(кэш, разрывы). Ветки те же, что у test_too_many_pages_vs_limit —
регрессия WordPdfConverterTest#tooManyPages (doc-пара, assertTooManyPages)."""
r = requests.post(
url(CONVERT),
headers=key_header,
files={"file": ("too-many-pages.doc", (samples / "too-many-pages.doc").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_doc_converts(url, samples, key_header, max_pages):
"""stale-cache.doc (кэш PageCount=5, lastRenderedPageBreak в .doc нет) — конвертится:
заниженный кэш на .doc-пути не «спасает» и не «топит» (семантика запинена Java-тестом)."""
r = requests.post(
url(CONVERT),
headers=key_header,
files={"file": ("stale-cache.doc", (samples / "stale-cache.doc").read_bytes())},
timeout=TIMEOUT,
)
if max_pages < 5:
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_binary_doc_ole_removed_by_default(url, samples, key_header):
"""Дефолтные флаги — .doc с OLE конвертится: OLE-fallback BLIP становится картинкой —
пара oleObjects_removedAndConverted."""
r = requests.post(
url(CONVERT),
headers=key_header,
files={"file": ("ole-embedded.doc", (samples / "ole-embedded.doc").read_bytes())},
timeout=TIMEOUT,
)
assert r.status_code == 200
assert r.content[:4] == b"%PDF"
@needs_key
def test_binary_doc_drawings_converted(url, samples, key_header):
"""Дефолтные флаги — .doc с диаграммами/SmartArt конвертится: BLIP-плейсхолдеры →
картинки (error-флаги на .doc не срабатывают по документированной семантике) —
пара chartsSmartArt_drawingsBecomeImages."""
r = requests.post(
url(CONVERT),
headers=key_header,
files={"file": ("charts-smartart.doc", (samples / "charts-smartart.doc").read_bytes())},
timeout=TIMEOUT,
)
assert r.status_code == 200
assert r.content[:4] == b"%PDF"