"""Проверки прода-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_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 (кэш 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 при выключенном 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"