733662770b
- ConvertController: расширение .xlsx, текст 400 «только .docx, .doc и .xlsx» (контракт с фронтом), @Operation — флаг errorOnSmartArt на .xlsx не срабатывает; safeBaseName срезает .xlsx - фронт: DropZone accept/подпись, подзаголовок App, api.ts фолбэк-имя режет .xlsx; web build+lint зелёные - app-тесты: xlsxFile_convertsToPdf (200, PDF, filename* Отчёт.pdf, текст доехал), nonDocxFilename_rejected — .xlsx в тексте, safeBaseName .XLSX - прод-автотест test_convert_xlsx (32 проверки) - docs: новая docs/agent/xlsx-bridge.md (классы, единицы, деградации, соглашения PrintLayout↔валидатора); AGENTS.md — роутинг входа, секция моста .xlsx, REST/фронт/счётчики (75 классов/1095 тестов, 32 фикстуры); pipeline.md (ContainerKind, estimateXlsxPages), repo-map.md (пакет, DocxPackageWriter, генераторы, пересоздание xlsx), testing.md, doc-bridge.md (DocxWriter → internal/DocxPackageWriter) Сквозная проверка java -jar + curl: xlsx→PDF 200 (filename* RFC5987), chart-fixture 200 с отрисованными PNG, errorOnCharts=true → 422 контрактный текст, .txt → 400 новый текст, .doc-регресс 200
489 lines
19 KiB
Python
489 lines
19 KiB
Python
"""Проверки прода-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_xlsx(url, samples, key_header):
|
||
""".xlsx → PDF: мост internal.xlsx на проде."""
|
||
r = requests.post(
|
||
url(CONVERT),
|
||
headers=key_header,
|
||
files={"file": ("xlsx-basic.xlsx", (samples / "xlsx-basic.xlsx").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''xlsx-basic.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"
|