test(core): пин w:framePr - фрейм hAnchor=page позиционируется от края страницы (17.4.31)
PR checks / web (pull_request) Successful in 41s
PR checks / java (pull_request) Successful in 1m47s

docx4j 17.3.6 транслирует w:framePr в fo:block-container absolute-position=fixed
(left/top) - до апгрейда текст фрейма шёл общим потоком у левого поля. Замер
реаудита (x=252pt) был для hAnchor=margin; фикстура frame-pr.docx пинит
hAnchor/vAnchor=page x=3600 -> текст на 180pt от края страницы, обычный абзац -
72pt от поля. Регрессия WordPdfConverterTest#framePr_positionedLikeWord.
Счётчики: фикстуры 14 docx, тесты 57/885 (догнаны до фактических).
This commit is contained in:
Pjandro
2026-11-08 23:26:30 +00:00
parent 87b9288aaf
commit 7d11572487
5 changed files with 82 additions and 3 deletions
+1 -1
View File
@@ -120,7 +120,7 @@ python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources
- Стек: JUnit 6 (`org.junit.jupiter`), только `Assertions` — Mockito/AssertJ не использовать; в app-тестах допустим inline-Hamcrest `containsString` в `andExpect`; тестовые классы package-private, зеркалят main-пакеты. Счётчики — `docs/agent/testing.md`.
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3, `PDFTextStripper`; негативные маркеры — `.notdef` (`#`) и `Helvetica`; текст нормализуется по пробелам (`norm`). Пиксельные проверки — только в юнитах chart-пейнтеров (допуски `assertRatio` < 0.06 / < 0.10). Детали — `docs/agent/repo-map.md`.
- Регрессивная конвенция: фикс = нормализатор/рендерер + юнит + конвертер-тест; в javadoc фикса — ссылка «Регрессия — Test#имя, фикстура samples/…». Пары `XxxNormalizerTest`↔`тест-в-конвейере` воспроизводятся грепом по этим ссылкам; исключения — `docs/agent/testing.md`.
- Фикстуры — только закоммиченные `samples/*.docx` (13) + `samples/*.doc` (12), в тестах не генерировать; контракт нормализаторов «нечего менять → тот же массив» (`assertSame`) + неприкосновенность частей вне `word/*.xml`.
- Фикстуры — только закоммиченные `samples/*.docx` (14) + `samples/*.doc` (12), в тестах не генерировать; контракт нормализаторов «нечего менять → тот же массив» (`assertSame`) + неприкосновенность частей вне `word/*.xml`.
- App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); четыре набора свойств = четыре контекста (отдельные классы, не `@Nested`); `ConversionServiceTest`/`ApiExceptionHandlerTest` — без Spring. Core-юниты Spring **не поднимают**; app-тесты проверяют только HTTP-код/заголовки/текст ошибки. Детали — `docs/agent/testing.md`.
- Жизненный цикл: только `@Test`; исключения — два `@BeforeAll` (прогрев шрифтов) и `@AfterEach drainWorker` в `ConversionTimeoutTest`. Ни `@Nested`, ни `@ParameterizedTest`, ни `@Disabled`, ни `assertAll`.
- Идиомы загрузки фикстур: **core** — classloader без ведущего слэша, **app** — class-relative со слэшем (core test-jar). Синтетика: docx — `ZipOutputStream`, `.doc` — крафт `POIFSFileSystem`.