From 8a07597d4c7992cd35141020fff11e4f42000299 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sat, 24 Oct 2026 18:39:44 +0000 Subject: [PATCH 1/4] =?UTF-8?q?JaCoCo:=20=D0=B3=D0=B5=D0=B9=D1=82=20=D0=BF?= =?UTF-8?q?=D0=BE=D0=BA=D1=80=D1=8B=D1=82=D0=B8=D1=8F=2090%=20=D1=81=D1=82?= =?UTF-8?q?=D1=80=D0=BE=D0=BA=20+=20=D1=81=D0=B2=D0=BE=D0=B4=D0=BA=D0=B0/?= =?UTF-8?q?=D0=B0=D1=80=D1=82=D0=B5=D1=84=D0=B0=D0=BA=D1=82=D1=8B=20=D1=80?= =?UTF-8?q?=D0=B5=D0=BF=D0=BE=D1=80=D1=82=D0=BE=D0=B2=20=D0=B2=20CI?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Корневой pom: jacoco-maven-plugin 0.8.15 (prepare-agent, report+check на verify, report раньше check — отчёт готов даже при провале гейта), surefire argLine через @{argLine}. pr.yml/main.yml job java: Coverage summary в step summary + артефакт jacoco-html (оба шага if: always()). Тесты ради гейта (23 класса / 218 @Test): app ConversionService/ ApiExceptionHandler/ConversionTimeout +1 в ConvertController; core DrawMlColor/DrawMlText + инкременты ChartSpec/PresetGeometry. Покрытие: core 91,0%, app 92,9% строк. --- .gitea/workflows/main.yml | 33 ++ .gitea/workflows/pr.yml | 33 ++ AGENTS.md | 13 +- pom.xml | 55 +- .../wordpdf/app/ApiExceptionHandlerTest.java | 57 ++ .../wordpdf/app/ConversionServiceTest.java | 144 +++++ .../wordpdf/app/ConversionTimeoutTest.java | 91 +++ .../wordpdf/app/ConvertControllerTest.java | 22 + .../wordpdf/internal/chart/ChartSpecTest.java | 542 ++++++++++++++++++ .../internal/chart/DrawMlColorTest.java | 245 ++++++++ .../internal/chart/DrawMlTextTest.java | 164 ++++++ .../internal/chart/PresetGeometryTest.java | 18 + 12 files changed, 1411 insertions(+), 6 deletions(-) create mode 100644 wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiExceptionHandlerTest.java create mode 100644 wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionServiceTest.java create mode 100644 wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionTimeoutTest.java create mode 100644 wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java create mode 100644 wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java diff --git a/.gitea/workflows/main.yml b/.gitea/workflows/main.yml index 237d128..a4a4493 100644 --- a/.gitea/workflows/main.yml +++ b/.gitea/workflows/main.yml @@ -32,6 +32,39 @@ jobs: - name: Build and test (PMD gate included) run: mvn -B clean verify + - name: Coverage summary + if: always() + run: | + python3 - <<'PY' >> "$GITHUB_STEP_SUMMARY" + import os + import xml.etree.ElementTree as ET + def pct(root, kind): + for c in root.findall("counter"): + if c.get("type") == kind: + missed, covered = int(c.get("missed")), int(c.get("covered")) + return f"{100.0 * covered / (missed + covered):.1f}%" + return "—" + print("## Покрытие (JaCoCo)\n") + print("| Модуль | Строки | Ветви | Порог строк |") + print("|---|---|---|---|") + for m in ("wordpdf-core", "wordpdf-app"): + p = f"{m}/target/site/jacoco/jacoco.xml" + if not os.path.exists(p): + print(f"| {m} | нет данных | — | 90% |") + continue + r = ET.parse(p).getroot() + print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |") + PY + + - name: Upload coverage reports + if: always() + uses: actions/upload-artifact@v4 + with: + name: jacoco-html + path: | + wordpdf-core/target/site/jacoco/ + wordpdf-app/target/site/jacoco/ + web: runs-on: ubuntu-latest steps: diff --git a/.gitea/workflows/pr.yml b/.gitea/workflows/pr.yml index a4fae50..e345498 100644 --- a/.gitea/workflows/pr.yml +++ b/.gitea/workflows/pr.yml @@ -31,6 +31,39 @@ jobs: - name: Build and test (PMD gate included) run: mvn -B clean verify + - name: Coverage summary + if: always() + run: | + python3 - <<'PY' >> "$GITHUB_STEP_SUMMARY" + import os + import xml.etree.ElementTree as ET + def pct(root, kind): + for c in root.findall("counter"): + if c.get("type") == kind: + missed, covered = int(c.get("missed")), int(c.get("covered")) + return f"{100.0 * covered / (missed + covered):.1f}%" + return "—" + print("## Покрытие (JaCoCo)\n") + print("| Модуль | Строки | Ветви | Порог строк |") + print("|---|---|---|---|") + for m in ("wordpdf-core", "wordpdf-app"): + p = f"{m}/target/site/jacoco/jacoco.xml" + if not os.path.exists(p): + print(f"| {m} | нет данных | — | 90% |") + continue + r = ET.parse(p).getroot() + print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |") + PY + + - name: Upload coverage reports + if: always() + uses: actions/upload-artifact@v4 + with: + name: jacoco-html + path: | + wordpdf-core/target/site/jacoco/ + wordpdf-app/target/site/jacoco/ + web: runs-on: ubuntu-latest steps: diff --git a/AGENTS.md b/AGENTS.md index fe61082..776131d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -58,7 +58,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр |`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)| |корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-**21-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose не в репо — его рендерит job `deploy` (лимиты запекаются из Variables); podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)| |корневой `.env.example`|шаблон env для локальных/compose-стендов: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает старт — binding long/int); проду `.env` **не нужен**: ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables, legacy-`.env` на проде удаляется деплоем| -|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)| +|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты + coverage-сводка/артефакты JaCoCo → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)| |корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений| |корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 21 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`| |`develop/` (вне git, gitignored)|рабочие материалы и эталоны Word для ручного сравнения — **не фикстуры**, в тесты/jar не подключать; на 2026-10 директория пуста (эталоны вынесены, пиксельные замеры зашиты числами в chart-тестах)| @@ -66,7 +66,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр ## Development Commands ```bash -mvn clean verify # все модули + тесты + PMD (pmd-ruleset.xml) — обязательный гейт перед push +mvn clean verify # все модули + тесты + PMD (pmd-ruleset.xml) + гейт покрытия JaCoCo 90% строк — обязательный гейт перед push mvn -pl wordpdf-app -am package # исполняемый jar бэкенда java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar # :8080, ключ выключен curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf @@ -90,7 +90,9 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \ ## CI/CD (Gitea Actions) Два workflow. `.gitea/workflows/pr.yml` — `PR checks` (`pull_request` + `workflow_dispatch`): -job `java` (temurin 21, кеш `~/.m2` через `actions/cache`, Maven 3.9.16 ставится вручную с dlcdn, `mvn -B clean verify`) +job `java` (temurin 21, кеш `~/.m2` через `actions/cache`, Maven 3.9.16 ставится вручную с dlcdn, `mvn -B clean verify`, +затем `Coverage summary` — разбор `target/site/jacoco/jacoco.xml` python-сниппетом в лог job'а и +`actions/upload-artifact` HTML-отчётов обоих модулей артефактом `jacoco-html`) и `web` (кеш `~/.npm`, `npm ci`/`build`/`lint`). `.gitea/workflows/main.yml` — `Main: tests, deploy, autotests` (`push` в `main` + `workflow_dispatch`): те же `java`/`web` (байт-в-байт дубль — файлы самодостаточны, reusable-workflow не вводить), затем `images-app`/`images-web` @@ -135,7 +137,7 @@ SSH-пользователи/логины, ни хосты, ни директо - `wordpdf-app/src/main/resources/application.properties` — multipart 100MB (`max-file-size`/`max-request-size` + `file-size-threshold=100MB`, держит файл в памяти; в тон gateway `client_max_body_size 100m`), `wordpdf.convert-timeout=2m`, пустой `wordpdf.api-key`, `server.forward-headers-strategy=framework` (префикс прод-прокси для springdoc) + `springdoc.swagger-ui.persist-authorization=true`; `wordpdf.max-mb`/`max-pages` здесь намеренно нет. - `wordpdf-app/pom.xml` — `spring-boot-maven-plugin` с **явной** execution `repackage` (в 4.1.1 сам не связывается, jar останется тонким); `slf4j-simple` исключён; `spring-boot-starter-webmvc` (Boot 4: переименован из starter-web) + `spring-boot-starter-actuator` (нужен HEALTHCHECK контейнера `/actuator/health`); тест-зависимости: `spring-boot-webmvc-test` (в Boot 4 автоконфиг MockMvc вынесен из starter-test), test-jar core. - `wordpdf-core/pom.xml` — `maven-jar-plugin` execution `test-jar` (публикует фикстуры для app). -- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox `3.0.8` (`fontbox` — compile в core: глиф-движок `GlyphFont`; `pdfbox` — test в обоих модулях), POI `5.5.1` (test: генератор фикстур + in-memory документы в `WordPdfValidatorTest`), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; pluginManagement: compiler `3.16.0`, surefire `3.6.0` с `-Djava.awt.headless=true`, jar `3.5.1`, PMD `3.28.0`. +- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox `3.0.8` (`fontbox` — compile в core: глиф-движок `GlyphFont`; `pdfbox` — test в обоих модулях), POI `5.5.1` (test: генератор фикстур + in-memory документы в `WordPdfValidatorTest`), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; pluginManagement: compiler `3.16.0`, surefire `3.6.0` с `-Djava.awt.headless=true`, jar `3.5.1`, PMD `3.28.0`, JaCoCo `0.8.15`. - Корневой `pmd-ruleset.xml` — ruleset PMD (см. Testing & QA): `category/java/codestyle.xml` минус opinionated-правила, `MethodNamingConventions` с `junit5TestPattern` под underscore-имена регрессий, `TooManyStaticImports` до 12, XPath-правило `LiteralFirstInEquals`, unused-правила из `bestpractices.xml`, `ReturnEmptyCollectionRatherThanNull` (errorprone, priority 1), `AvoidLiteralsInIfCondition` (errorprone, дефолтная 3), `EmptyCatchBlock` (errorprone) и `ForLoopCanBeForeach` (bestpractices) — оба priority 2. - `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF. - `gateway/nginx.conf` — единственный вход: `/api/`, `/swagger-ui`, `/v3/api-docs`, `/actuator` → `app:8080`, остальное → `web:80`; `client_max_body_size 100m` (без директивы upload режется HTML-413 шлюза вместо JSON-ошибки API); `resolver 10.113.0.1` + `proxy_pass` через переменные (статический proxy_pass резолвит имя один раз при старте — gateway раньше app поднялся бы с 502 до перезапуска). `wordpdf-web/nginx.conf` — чистая статика с SPA-fallback, `/api` НЕ проксирует. @@ -155,7 +157,8 @@ SSH-пользователи/логины, ни хосты, ни директо ## Testing & QA - Гейт `maven-pmd-plugin` 3.28.0 (PMD 7.17) на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются; `failurePriority` не задан — на практике `verify` валят нарушения любой приоритетности, проверено на priority 3–4: строки `[WARNING] PMD Failure` = BUILD FAILURE). Литералы в условиях `if` — только именованными константами (`AvoidLiteralsInIfCondition`; `else if`-ветки правило не проверяет, обычный вложенный `if` — проверяет; пустые `while` тоже валятся — `EmptyControlStatement`), `null` вместо пустой коллекции запрещён (`ReturnEmptyCollectionRatherThanNull` — `GlyphCoverageNormalizer.split` возвращает пустой список). -- 18 тестовых классов / 170 `@Test` (core 15/143, app 3/27: ConvertController 18 + ApiKeyFilter 7 + ConvertLimits 2). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`). +- Гейт JaCoCo `0.8.15`: `jacoco:check` (правило LINE, COVEREDRATIO `0.90`) на `verify` обоих модулей; агент подключается в surefire через `argLine` = `@{argLine} -Djava.awt.headless=true` (свойство `argLine` в корневом pom по умолчанию пусто и перезаписывается `prepare-agent` — `mvn test -Djacoco.skip=true` без агента работоспособно); `report` и `check` оба на `verify`, report раньше — при провале порога отчёт уже на диске; отчёты `target/site/jacoco/` (html+xml, xml нужен CI-сводке). Плотность покрытия держат тесты, а не заглушки: промахи в основном недостижимые IOException/catch-ветки (`GlyphFont`, `BundledFonts`) и рендер-код, требующий эталонного Word. +- 23 тестовых класса / 218 `@Test` (core 17/180, app 6/38: ConvertController 19 + ApiKeyFilter 7 + ConvertLimits 2 + ConversionService 5 + ApiExceptionHandler 4 + ConversionTimeout 1). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`). - **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах). - Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word, допуски `assertRatio` <0.06 (`PiePainterTest` аспект h/w=0.585) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px и перцентильные коридоры яркости. Эталонные замеры — по Word-экспорту 300 dpi (числа зашиты в тесты; эталонные файлы — `develop/`, вне git, на 2026-10 пуста). - `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig. diff --git a/pom.xml b/pom.xml index de28b58..29d2458 100644 --- a/pom.xml +++ b/pom.xml @@ -33,6 +33,12 @@ 6.1.3 3.0.8 5.5.1 + + + 0.8.15 + + @@ -132,7 +138,7 @@ 3.6.0 - -Djava.awt.headless=true + @{argLine} -Djava.awt.headless=true @@ -162,6 +168,49 @@ + + org.jacoco + jacoco-maven-plugin + ${jacoco.version} + + + prepare-agent + + prepare-agent + + + + + report + verify + + report + + + + check + verify + + check + + + + + BUNDLE + + + LINE + COVEREDRATIO + 0.90 + + + + + + + + org.springframework.boot spring-boot-maven-plugin @@ -175,6 +224,10 @@ org.apache.maven.plugins maven-pmd-plugin + + org.jacoco + jacoco-maven-plugin + diff --git a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiExceptionHandlerTest.java b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiExceptionHandlerTest.java new file mode 100644 index 0000000..a824e6e --- /dev/null +++ b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiExceptionHandlerTest.java @@ -0,0 +1,57 @@ +package ru.pjandro.wordpdf.app; + +import org.junit.jupiter.api.Test; +import org.springframework.http.HttpStatus; +import org.springframework.web.multipart.MaxUploadSizeExceededException; + +import java.time.Duration; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; + +/** + * Прямые юниты {@link ApiExceptionHandler} для кодов, не выжимаемых из + * MockMvc детерминированно: 503 (очередь полна — гонка по времени), 413 + * (нужна загрузка за 100 МБ), catch-all 500 (все штатные исключения + * замаплены). Контракт — код + дословный текст {@code {"error": …}}. + */ +class ApiExceptionHandlerTest { + + private final ApiExceptionHandler handler = new ApiExceptionHandler(); + + /** Занятая очередь — 503 с подсказкой «повторите», текст — контракт. */ + @Test + void rejected_returns503WithRetryHint() { + var response = handler.rejected(new ConversionRejectedException()); + assertEquals(HttpStatus.SERVICE_UNAVAILABLE, response.getStatusCode()); + assertEquals("Сервис конвертации занят — повторите позже", + response.getBody().error()); + } + + /** Превышение wordpdf.convert-timeout — 504 с длительностью лимита. */ + @Test + void timeout_returns504WithLimitSeconds() { + var response = handler.timeout(new ConversionTimeoutException(Duration.ofSeconds(120))); + assertEquals(HttpStatus.GATEWAY_TIMEOUT, response.getStatusCode()); + assertEquals("Конвертация превысила 120 с — документ слишком сложный", + response.getBody().error()); + } + + /** Контейнерный потолок multipart — 413 со своим текстом (не 400 ядра). */ + @Test + void tooLarge_returns413ContainerLimit() { + var response = handler.tooLarge(new MaxUploadSizeExceededException(100L * 1024 * 1024)); + assertEquals(HttpStatus.PAYLOAD_TOO_LARGE, response.getStatusCode()); + assertEquals("Файл больше 100 МБ", response.getBody().error()); + } + + /** Прочее исключение — 500 с общим текстом; подробность причины — только в лог. */ + @Test + void unexpected_returns500WithoutDetails() { + var response = handler.unexpected(new IllegalStateException("секретная подробность")); + assertEquals(HttpStatus.INTERNAL_SERVER_ERROR, response.getStatusCode()); + assertEquals("Внутренняя ошибка конвертации", response.getBody().error()); + assertFalse(response.getBody().error().contains("секретная"), + "подробность исключения утекла в ответ"); + } +} diff --git a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionServiceTest.java b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionServiceTest.java new file mode 100644 index 0000000..eb6c8d3 --- /dev/null +++ b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionServiceTest.java @@ -0,0 +1,144 @@ +package ru.pjandro.wordpdf.app; + +import org.junit.jupiter.api.Test; +import ru.pjandro.wordpdf.ConvertOptions; + +import java.io.IOException; +import java.io.InputStream; +import java.lang.reflect.Field; +import java.nio.charset.StandardCharsets; +import java.time.Duration; +import java.util.ArrayList; +import java.util.List; +import java.util.concurrent.CountDownLatch; +import java.util.concurrent.Future; +import java.util.concurrent.ThreadPoolExecutor; +import java.util.concurrent.TimeUnit; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Юниты {@link ConversionService} вне Spring и HTTP: ветки отказa очереди + * ({@link ConversionRejectedException}), прерывания ожидающего потока, + * фолбэка санитизации имени. Сквозные успех/400/500 — в + * {@code ConvertControllerTest}, таймаут 504 — в {@code ConversionTimeoutTest}. + */ +class ConversionServiceTest { + + /** Инспекция приватного executor'а: детерминированная сатурация очереди. */ + private static ThreadPoolExecutor workersOf(ConversionService svc) throws Exception { + Field f = ConversionService.class.getDeclaredField("workers"); + f.setAccessible(true); + return (ThreadPoolExecutor) f.get(svc); + } + + /** Байты фикстуры из classpath (test-jar core: samples/…). */ + private static byte[] bytes(String resource) throws IOException { + try (InputStream in = ConversionServiceTest.class.getResourceAsStream(resource)) { + assertTrue(in != null, "Нет ресурса: " + resource); + return in.readAllBytes(); + } + } + + /** + * Очередь забита (1 воркер занят + QUEUE_CAPACITY в ожидании) — новый + * запрос отвергается сразу, не становясь 17-м в очереди: 503-контракт + * {@code RejectedExecutionException → ConversionRejectedException}. + */ + @Test + void saturatedQueue_rejectsImmediately() throws Exception { + ConversionService svc = new ConversionService(Duration.ofMinutes(2)); + ThreadPoolExecutor workers = workersOf(svc); + CountDownLatch block = new CountDownLatch(1); + List> fillers = new ArrayList<>(); + try { + // заглушки-блокировки вместо реальных конвертаций: воркер занят, + // очередь полна, ни одной лишней конвертации в JVM + for (int i = 0; i <= ConversionService.QUEUE_CAPACITY; i++) { + fillers.add(workers.submit(() -> { + block.await(); + return null; + })); + } + long deadline = System.nanoTime() + 5_000_000_000L; + while ((workers.getActiveCount() < 1 + || workers.getQueue().size() < ConversionService.QUEUE_CAPACITY) + && System.nanoTime() < deadline) { + Thread.sleep(5); + } + assertEquals(1, workers.getActiveCount(), "воркер не занят"); + assertEquals(ConversionService.QUEUE_CAPACITY, workers.getQueue().size(), + "очередь не полна"); + + byte[] sample = bytes("/samples/ru-plain.docx"); + ConversionRejectedException e = assertThrows(ConversionRejectedException.class, + () -> svc.convert(sample, "queue.docx", ConvertOptions.defaults())); + assertEquals("Сервис конвертации занят — повторите позже", e.getMessage()); + } finally { + block.countDown(); + for (Future f : fillers) { + f.get(10, TimeUnit.SECONDS); + } + svc.shutdown(); + } + } + + /** + * Поток ожидания прерван — {@code future.get} бросает + * {@code InterruptedException}: флаг прерывания восстанавливается, задача + * отменяется, ответ — тот же 503-контракт занятости. + */ + @Test + void interruptedWaiter_rejectsAndRestoresFlag() throws Exception { + ConversionService svc = new ConversionService(Duration.ofMinutes(2)); + byte[] sample = bytes("/samples/ru-plain.docx"); + try { + Thread.currentThread().interrupt(); + ConversionRejectedException e = assertThrows(ConversionRejectedException.class, + () -> svc.convert(sample, "ru-plain.docx", ConvertOptions.defaults())); + assertEquals("Сервис конвертации занят — повторите позже", e.getMessage()); + assertTrue(Thread.currentThread().isInterrupted(), + "флаг прерывания обязан быть восстановлен"); + } finally { + Thread.interrupted(); // не травим subsequent-тесты surefire-потока + } + // барьер: отменённая задача ещё домучивает рендер на воркере, а + // глобальный реестр шрифтов ядра не потокобезопасен — ждём освобождения + // воркера через успешную сериализованную конвертацию + byte[] pdf = svc.convert(sample, "barrier.docx", ConvertOptions.defaults()); + assertEquals("%PDF", new String(pdf, 0, 4, StandardCharsets.US_ASCII)); + svc.shutdown(); + } + + /** Пустое после очистки имя (и {@code null}) — фолбэк {@code document}. */ + @Test + void safeBaseName_blankAfterSanitize_fallsBackToDocument() { + assertEquals("document", ConversionService.safeBaseName(null)); + assertEquals("document", ConversionService.safeBaseName(" ")); + assertEquals("document", ConversionService.safeBaseName("###.docx")); + assertEquals("document", ConversionService.safeBaseName("!!!")); + } + + /** Каталог (оба разделителя) и суффикс .docx вырезаются, кириллица живёт. */ + @Test + void safeBaseName_stripsDirectoryAndSuffix() { + assertEquals("evil", ConversionService.safeBaseName("a/../../evil.docx")); + assertEquals("evil", ConversionService.safeBaseName("C:\\tmp\\evil.docx")); + assertEquals("отчёт", ConversionService.safeBaseName("отчёт.DOCX")); + } + + /** + * Оборачиваемый отказ воркера: single-arg конструктор даёт единый + * пользовательский текст 500 без подробностей причины (они — в логе). + */ + @Test + void failedException_singleArg_genericMessageWithCause() { + Throwable cause = new IllegalStateException("подробность воркера"); + ConversionFailedException e = new ConversionFailedException(cause); + assertEquals("Внутренняя ошибка конвертации", e.getMessage()); + assertSame(cause, e.getCause()); + } +} diff --git a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionTimeoutTest.java b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionTimeoutTest.java new file mode 100644 index 0000000..1f23ce8 --- /dev/null +++ b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionTimeoutTest.java @@ -0,0 +1,91 @@ +package ru.pjandro.wordpdf.app; + +import org.junit.jupiter.api.AfterEach; +import org.junit.jupiter.api.Test; +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.boot.webmvc.test.autoconfigure.AutoConfigureMockMvc; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.http.MediaType; +import org.springframework.mock.web.MockMultipartFile; +import org.springframework.test.context.TestPropertySource; +import org.springframework.test.web.servlet.MockMvc; + +import java.io.IOException; +import java.io.InputStream; +import java.lang.reflect.Field; +import java.util.concurrent.ThreadPoolExecutor; + +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.multipart; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +/** + * Таймаут конвертации сквозь HTTP: отдельный контекст с + * {@code wordpdf.convert-timeout=1ms} — конвертация заведомо дольше + * (docx4j + FOP — сотни миллисекунд), значит ответ обязан быть 504 с + * текстом {@link ConversionTimeoutException}, а не зависание и не 500. + * Отдельный класс: {@code @TestPropertySource} даёт отдельный контекст, + * а 1 мс в общем контексте сломала бы все успех-тесты. + */ +@SpringBootTest +@AutoConfigureMockMvc +@TestPropertySource(properties = "wordpdf.convert-timeout=1ms") +class ConversionTimeoutTest { + + private static final MediaType DOCX = + MediaType.parseMediaType("application/vnd.openxmlformats-officedocument.wordprocessingml.document"); + + @Autowired + private MockMvc mockMvc; + + @Autowired + private ConversionService conversionService; + + private static byte[] bytes(String resource) throws IOException { + try (InputStream in = ConversionTimeoutTest.class.getResourceAsStream(resource)) { + assertNotNull(in, "Нет ресурса: " + resource); + return in.readAllBytes(); + } + } + + private static MockMultipartFile docx(String filename, byte[] content) { + return new MockMultipartFile("file", filename, DOCX.toString(), content); + } + + @Test + void conversionOverrunsTimeout_returns504() throws Exception { + byte[] sample = bytes("/samples/ru-plain.docx"); + mockMvc.perform(multipart("/api/v1/convert") + .file(docx("ru-plain.docx", sample))) + .andExpect(status().isGatewayTimeout()) + .andExpect(jsonPath("$.error", + org.hamcrest.Matchers.containsString("превысила"))); + // воркер ещё домучивает отменённый рендер — второй запрос ждёт в + // очереди заведомо дольше 1 мс и тоже получает 504, а не 503: + // очередь при этом не переполнена + mockMvc.perform(multipart("/api/v1/convert") + .file(docx("ru-plain.docx", sample))) + .andExpect(status().isGatewayTimeout()) + .andExpect(jsonPath("$.error", + org.hamcrest.Matchers.containsString("превысила"))); + } + + /** + * Отменённая по таймауту задача продолжает рендерить на воркере + * (осознанный компромисс {@link ConversionService}) и мутирует глобальный + * реестр шрифтов ядра — дожидаться освобождения executor'я обязательно, + * иначе фоновый рендер гонит гонку с другими тест-классами JVM. + */ + @AfterEach + void drainWorker() throws Exception { + Field f = ConversionService.class.getDeclaredField("workers"); + f.setAccessible(true); + ThreadPoolExecutor workers = (ThreadPoolExecutor) f.get(conversionService); + long deadline = System.nanoTime() + 60_000_000_000L; + while ((workers.getActiveCount() > 0 || !workers.getQueue().isEmpty()) + && System.nanoTime() < deadline) { + Thread.sleep(20); + } + } +} diff --git a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java index 8b80fa2..279c8f5 100644 --- a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java +++ b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java @@ -15,6 +15,7 @@ import org.springframework.http.MediaType; import org.springframework.mock.web.MockMultipartFile; import org.springframework.test.web.servlet.MockMvc; import org.springframework.test.web.servlet.MvcResult; +import ru.pjandro.wordpdf.ValidationException; import java.io.ByteArrayOutputStream; import java.io.IOException; @@ -400,4 +401,25 @@ class ConvertControllerTest { .andExpect(jsonPath("$.error", org.hamcrest.Matchers.containsString("Не найдено"))); } + + /** + * Отказ чтения партиты контейнером ({@code IOException} из + * {@code getBytes}) — {@link ValidationException} (400-смысл: вход не + * прочитан), а не 500 от catch-all. + */ + @Test + void unreadableUpload_rejected() { + MockMultipartFile broken = new MockMultipartFile( + "file", "x.docx", DOCX.toString(), "junk".getBytes(StandardCharsets.UTF_8)) { + @Override + public byte[] getBytes() throws IOException { + throw new IOException("поток загрузки оборвался"); + } + }; + ConvertController controller = + new ConvertController(new ConversionService(Duration.ofSeconds(5)), 5L, 100); + ValidationException e = assertThrows(ValidationException.class, + () -> controller.convert(broken, null, null, null)); + assertTrue(e.getMessage().contains("Не удалось прочитать"), e.getMessage()); + } } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java index 066529f..9213770 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java @@ -1,17 +1,71 @@ package ru.pjandro.wordpdf.internal.chart; +import org.docx4j.dml.CTLineProperties; +import org.docx4j.dml.CTNoFillProperties; +import org.docx4j.dml.CTRegularTextRun; +import org.docx4j.dml.CTShapeProperties; +import org.docx4j.dml.CTSolidColorFillProperties; +import org.docx4j.dml.CTSRgbColor; +import org.docx4j.dml.CTTextBody; +import org.docx4j.dml.CTTextParagraph; +import org.docx4j.dml.chart.CTAreaChart; +import org.docx4j.dml.chart.CTAreaSer; +import org.docx4j.dml.chart.CTAxDataSource; +import org.docx4j.dml.chart.CTAxPos; +import org.docx4j.dml.chart.CTAxisUnit; +import org.docx4j.dml.chart.CTBandFmt; +import org.docx4j.dml.chart.CTBandFmts; import org.docx4j.dml.chart.CTBarChart; +import org.docx4j.dml.chart.CTBarDir; +import org.docx4j.dml.chart.CTBarSer; import org.docx4j.dml.chart.CTBoolean; import org.docx4j.dml.chart.CTChart; +import org.docx4j.dml.chart.CTChartLines; +import org.docx4j.dml.chart.CTChartSpace; +import org.docx4j.dml.chart.CTDPt; +import org.docx4j.dml.chart.CTDateAx; +import org.docx4j.dml.chart.CTDepthPercent; +import org.docx4j.dml.chart.CTDouble; import org.docx4j.dml.chart.CTDoughnutChart; import org.docx4j.dml.chart.CTFirstSliceAng; import org.docx4j.dml.chart.CTGapAmount; import org.docx4j.dml.chart.CTHoleSize; +import org.docx4j.dml.chart.CTLegend; +import org.docx4j.dml.chart.CTLegendPos; +import org.docx4j.dml.chart.CTLineChart; +import org.docx4j.dml.chart.CTLineSer; +import org.docx4j.dml.chart.CTMarker; +import org.docx4j.dml.chart.CTMarkerStyle; +import org.docx4j.dml.chart.CTNumData; +import org.docx4j.dml.chart.CTNumDataSource; +import org.docx4j.dml.chart.CTNumFmt; +import org.docx4j.dml.chart.CTNumRef; +import org.docx4j.dml.chart.CTNumVal; import org.docx4j.dml.chart.CTOverlap; +import org.docx4j.dml.chart.CTPerspective; import org.docx4j.dml.chart.CTPieChart; +import org.docx4j.dml.chart.CTPieSer; +import org.docx4j.dml.chart.CTPlotArea; +import org.docx4j.dml.chart.CTRotY; +import org.docx4j.dml.chart.CTScaling; +import org.docx4j.dml.chart.CTSerAx; +import org.docx4j.dml.chart.CTSerTx; +import org.docx4j.dml.chart.CTStrData; +import org.docx4j.dml.chart.CTStrRef; +import org.docx4j.dml.chart.CTStrVal; +import org.docx4j.dml.chart.CTSurface3DChart; import org.docx4j.dml.chart.CTTitle; +import org.docx4j.dml.chart.CTTx; +import org.docx4j.dml.chart.CTUnsignedInt; +import org.docx4j.dml.chart.CTValAx; +import org.docx4j.dml.chart.CTView3D; +import org.docx4j.dml.chart.STAxPos; +import org.docx4j.dml.chart.STBarDir; +import org.docx4j.dml.chart.STLegendPos; +import org.docx4j.dml.chart.STMarkerStyle; import org.junit.jupiter.api.Test; +import java.awt.Color; import java.util.List; import static org.junit.jupiter.api.Assertions.*; @@ -92,11 +146,13 @@ class ChartSpecTest { CTHoleSize hole = new CTHoleSize(); hole.setVal((short) 75); chart.setHoleSize(hole); + chart.getSer().add(new CTPieSer()); ChartSpec spec = new ChartSpec(); ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of()); assertEquals(ChartSpec.Type.DOUGHNUT, spec.type); assertEquals(45, spec.firstSliceAng); assertEquals(75, spec.holeSize); + assertEquals(1, spec.series.size()); } /** @@ -115,6 +171,492 @@ class ChartSpecTest { assertEquals(0, bar.overlap); } + @Test + void parseWithoutChartStaysUnsupported() { + ChartSpec spec = ChartSpec.parse(new CTChartSpace(), new DrawMlColor(null)); + assertEquals(ChartSpec.Type.UNSUPPORTED, spec.type); + } + + /** Пустой chartSpace без spPr/legend/title — только дефолты модели. */ + @Test + void bareChartKeepsDefaults() { + ChartSpec spec = ChartSpec.parse(spaceWith(new CTChart()), new DrawMlColor(null)); + assertEquals(Color.WHITE, spec.chartFill); + assertNull(spec.legendPos, "без c:legend легенды нет"); + assertNull(spec.title); + } + + @Test + void chartFrameFillAndBorderParsed() { + CTChartSpace space = spaceWith(new CTChart()); + CTShapeProperties sp = new CTShapeProperties(); + sp.setSolidFill(fill("FFEEEE")); + CTLineProperties ln = new CTLineProperties(); + ln.setSolidFill(fill("EE0000")); + ln.setW(25400); + sp.setLn(ln); + space.setSpPr(sp); + ChartSpec spec = ChartSpec.parse(space, new DrawMlColor(null)); + assertEquals(new Color(0xFF, 0xEE, 0xEE), spec.chartFill); + assertEquals(new Color(0xEE, 0, 0), spec.chartBorder); + assertEquals(2.0, spec.chartBorderWidth, 0.001); + } + + @Test + void chartFrameBorderNoFillClearsBorder() { + CTChartSpace space = spaceWith(new CTChart()); + CTShapeProperties sp = new CTShapeProperties(); + CTLineProperties ln = new CTLineProperties(); + ln.setNoFill(new CTNoFillProperties()); + sp.setLn(ln); + space.setSpPr(sp); + ChartSpec spec = ChartSpec.parse(space, new DrawMlColor(null)); + assertNull(spec.chartBorder); + } + + @Test + void view3DPerspectiveAndNegativeRotY() { + CTChart chart = new CTChart(); + CTView3D v = new CTView3D(); + CTRotY ry = new CTRotY(); + ry.setVal(-45); + CTPerspective p = new CTPerspective(); + p.setVal((short) 45); + CTDepthPercent d = new CTDepthPercent(); + d.setVal(80); + CTBoolean ra = new CTBoolean(); + ra.setVal(Boolean.FALSE); + v.setRotY(ry); + v.setPerspective(p); + v.setDepthPercent(d); + v.setRAngAx(ra); + chart.setView3D(v); + ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null)); + assertEquals(315, spec.rotY); + assertEquals(45, spec.perspective); + assertEquals(80, spec.depthPercent); + assertFalse(spec.rightAngledAxes); + } + + @Test + void horizontalBarDirectionParsed() { + CTBarChart bar = new CTBarChart(); + CTBarDir dir = new CTBarDir(); + dir.setVal(STBarDir.BAR); + bar.setBarDir(dir); + ChartSpec spec = new ChartSpec(); + ChartSpec.readGroup(bar, spec, new DrawMlColor(null), List.of()); + assertEquals(ChartSpec.Type.BAR_HORIZONTAL, spec.type); + } + + /** c:val с дырявыми c:pt и ptCount больше числа точек — дыры dobиваются null. */ + @Test + void barSeriesSparseValuesPadded() { + CTBarChart bar = new CTBarChart(); + CTBarSer ser = new CTBarSer(); + CTSerTx tx = new CTSerTx(); + tx.setStrRef(strRef("Продажи")); + ser.setTx(tx); + ser.setCat(catStr("Q1", "Q2")); + CTNumDataSource val = new CTNumDataSource(); + CTNumRef numRef = new CTNumRef(); + CTNumData cache = new CTNumData(); + cache.setPtCount(uint(4)); + cache.getPt().add(numPt(0, "1.0")); + cache.getPt().add(numPt(2, "abc")); + numRef.setNumCache(cache); + val.setNumRef(numRef); + ser.setVal(val); + CTShapeProperties sp = new CTShapeProperties(); + sp.setSolidFill(fill("00FF00")); + ser.setSpPr(sp); + bar.getSer().add(ser); + ChartSpec spec = new ChartSpec(); + ChartSpec.readGroup(bar, spec, new DrawMlColor(null), List.of()); + ChartSpec.Series s = spec.series.get(0); + assertEquals("Продажи", s.name); + assertEquals(List.of("Q1", "Q2"), s.categories); + assertEquals(4, s.values.size()); + assertEquals(1.0, s.values.get(0)); + assertNull(s.values.get(1)); + assertNull(s.values.get(2), "не-число — null, не падение"); + assertNull(s.values.get(3)); + assertEquals(new Color(0, 0xFF, 0), s.fill); + } + + @Test + void areaSeriesFillAndLinePropsParsed() { + CTAreaChart area = new CTAreaChart(); + CTAreaSer ser = new CTAreaSer(); + CTShapeProperties sp = new CTShapeProperties(); + sp.setSolidFill(fill("0000FF")); + CTLineProperties ln = new CTLineProperties(); + ln.setSolidFill(fill("FF0000")); + ln.setW(12700); + sp.setLn(ln); + ser.setSpPr(sp); + area.getSer().add(ser); + CTAreaSer noSpPr = new CTAreaSer(); + CTAreaSer fillOnly = new CTAreaSer(); + CTShapeProperties fillSp = new CTShapeProperties(); + fillSp.setSolidFill(fill("000001")); + fillOnly.setSpPr(fillSp); + area.getSer().add(noSpPr); + area.getSer().add(fillOnly); + ChartSpec spec = new ChartSpec(); + ChartSpec.readGroup(area, spec, new DrawMlColor(null), List.of()); + assertEquals(ChartSpec.Type.AREA, spec.type); + ChartSpec.Series s = spec.series.get(0); + assertNull(s.name, "c:tx без c:v и без strRef — имени нет"); + assertEquals(new Color(0, 0, 0xFF), s.fill); + assertEquals(new Color(0xFF, 0, 0), s.lineColor); + assertEquals(1.0, s.lineWidth, 0.001); + assertNull(spec.series.get(1).lineColor, "spPr=null — линия не задана"); + assertNull(spec.series.get(2).lineColor, "spPr без a:ln — линия не задана"); + } + + /** c:tx/c:v, пустой c:tx, дырявые строковые categories, пустое c:v. */ + @Test + void seriesNameVariantsAndSparseCategories() { + CTBarChart bar = new CTBarChart(); + CTBarSer withV = new CTBarSer(); + CTSerTx txV = new CTSerTx(); + txV.setV("Ряд1"); + withV.setTx(txV); + CTAxDataSource cat = new CTAxDataSource(); + CTStrRef strRef = new CTStrRef(); + CTStrData cache = new CTStrData(); + CTStrVal pt = new CTStrVal(); + pt.setIdx(2); + pt.setV("Март"); + cache.getPt().add(pt); + strRef.setStrCache(cache); + cat.setStrRef(strRef); + withV.setCat(cat); + CTBarSer emptyTx = new CTBarSer(); + emptyTx.setTx(new CTSerTx()); + CTBarSer blankVal = new CTBarSer(); + CTNumDataSource val = new CTNumDataSource(); + CTNumData lit = new CTNumData(); + lit.getPt().add(numPt(0, " ")); + val.setNumLit(lit); + blankVal.setVal(val); + bar.getSer().add(withV); + bar.getSer().add(emptyTx); + bar.getSer().add(blankVal); + ChartSpec spec = new ChartSpec(); + ChartSpec.readGroup(bar, spec, new DrawMlColor(null), List.of()); + assertEquals("Ряд1", spec.series.get(0).name); + assertEquals(List.of("", "", "Март"), spec.series.get(0).categories); + assertNull(spec.series.get(1).name); + assertEquals(1, spec.series.get(2).values.size()); + assertNull(spec.series.get(2).values.get(0), "пустое значение — null"); + } + + @Test + void lineSeriesNoFillAndMarkerNone() { + CTLineChart line = new CTLineChart(); + CTLineSer ser = new CTLineSer(); + CTShapeProperties sp = new CTShapeProperties(); + CTLineProperties ln = new CTLineProperties(); + ln.setNoFill(new CTNoFillProperties()); + sp.setLn(ln); + ser.setSpPr(sp); + CTMarker m = new CTMarker(); + CTMarkerStyle sym = new CTMarkerStyle(); + sym.setVal(STMarkerStyle.NONE); + m.setSymbol(sym); + ser.setMarker(m); + line.getSer().add(ser); + ChartSpec spec = new ChartSpec(); + ChartSpec.readGroup(line, spec, new DrawMlColor(null), List.of()); + assertTrue(spec.series.get(0).lineNoFill); + assertFalse(spec.series.get(0).marker); + assertEquals("none", spec.series.get(0).markerSymbol); + } + + @Test + void pieSeriesOutlineParsed() { + CTPieChart pie = new CTPieChart(); + CTPieSer ser = new CTPieSer(); + CTShapeProperties sp = new CTShapeProperties(); + sp.setSolidFill(fill("112233")); + CTLineProperties ln = new CTLineProperties(); + ln.setSolidFill(fill("445566")); + ln.setW(12700); + sp.setLn(ln); + ser.setSpPr(sp); + pie.getSer().add(ser); + ChartSpec spec = new ChartSpec(); + ChartSpec.readGroup(pie, spec, new DrawMlColor(null), List.of()); + ChartSpec.Series s = spec.series.get(0); + assertEquals(new Color(0x11, 0x22, 0x33), s.fill); + assertEquals(new Color(0x44, 0x55, 0x66), s.outlineColor); + assertEquals(1.0, s.outlineWidth, 0.001); + } + + @Test + void pieSeriesOutlineNoFill() { + CTPieChart pie = new CTPieChart(); + CTPieSer ser = new CTPieSer(); + CTShapeProperties sp = new CTShapeProperties(); + CTLineProperties ln = new CTLineProperties(); + ln.setNoFill(new CTNoFillProperties()); + sp.setLn(ln); + ser.setSpPr(sp); + pie.getSer().add(ser); + ChartSpec spec = new ChartSpec(); + ChartSpec.readGroup(pie, spec, new DrawMlColor(null), List.of()); + assertTrue(spec.series.get(0).outlineNoFill); + } + + /** c:bandFmt без своего цвета — цвет из палитры по c:idx. */ + @Test + void surfaceBandFmtsExplicitAndPalette() { + CTSurface3DChart surf = new CTSurface3DChart(); + CTBoolean wf = new CTBoolean(); + wf.setVal(Boolean.TRUE); + surf.setWireframe(wf); + CTBandFmts fmts = new CTBandFmts(); + CTBandFmt withColor = new CTBandFmt(); + withColor.setIdx(uint(0)); + CTShapeProperties sp = new CTShapeProperties(); + sp.setSolidFill(fill("ABCDEF")); + withColor.setSpPr(sp); + CTBandFmt fallback = new CTBandFmt(); + fallback.setIdx(uint(1)); + fmts.getBandFmt().add(withColor); + fmts.getBandFmt().add(fallback); + surf.setBandFmts(fmts); + ChartSpec spec = new ChartSpec(); + ChartSpec.readGroup(surf, spec, new DrawMlColor(null), + List.of(Color.RED, Color.GREEN, Color.BLUE)); + assertTrue(spec.wireframe); + assertEquals(List.of(new Color(0xAB, 0xCD, 0xEF), Color.GREEN), spec.bandColors); + } + + /** c:dPt без c:spPr/c:solidFill пропускается, валидная точка получает цвет. */ + @Test + void dataPointFillAppliedAndIncompleteSkipped() { + CTPieChart pie = new CTPieChart(); + CTPieSer ser = new CTPieSer(); + CTDPt good = new CTDPt(); + good.setIdx(uint(1)); + CTShapeProperties sp = new CTShapeProperties(); + sp.setSolidFill(fill("FF00FF")); + good.setSpPr(sp); + CTDPt noFill = new CTDPt(); + noFill.setIdx(uint(2)); + ser.getDPt().add(good); + ser.getDPt().add(noFill); + pie.getSer().add(ser); + ChartSpec spec = new ChartSpec(); + ChartSpec.readGroup(pie, spec, new DrawMlColor(null), List.of()); + assertEquals(new Color(0xFF, 0, 0xFF), spec.series.get(0).pointFills.get(1)); + assertEquals(1, spec.series.get(0).pointFills.size()); + } + + @Test + void legendOverlayClearsPosExplicitPosWins() { + CTChart chart = new CTChart(); + CTLegend legend = new CTLegend(); + CTBoolean overlay = new CTBoolean(); + overlay.setVal(Boolean.TRUE); + legend.setOverlay(overlay); + chart.setLegend(legend); + ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null)); + assertNull(spec.legendPos, "overlay-легенда не резервирует место"); + + CTChart chart2 = new CTChart(); + CTLegend legend2 = new CTLegend(); + CTBoolean overlay2 = new CTBoolean(); + overlay2.setVal(Boolean.TRUE); + legend2.setOverlay(overlay2); + CTLegendPos pos = new CTLegendPos(); + pos.setVal(STLegendPos.T); + legend2.setLegendPos(pos); + chart2.setLegend(legend2); + ChartSpec spec2 = ChartSpec.parse(spaceWith(chart2), new DrawMlColor(null)); + assertEquals("t", spec2.legendPos); + } + + @Test + void titleFromStrRefAndRichText() { + CTChart chart = new CTChart(); + CTTitle title = new CTTitle(); + CTTx tx = new CTTx(); + tx.setStrRef(strRef("Отчёт")); + title.setTx(tx); + chart.setTitle(title); + ChartSpec spec = new ChartSpec(); + ChartSpec.readTitle(chart, spec, new DrawMlColor(null)); + assertEquals("Отчёт", spec.title); + + CTChart chart2 = new CTChart(); + CTTitle title2 = new CTTitle(); + CTTx tx2 = new CTTx(); + CTTextBody rich = new CTTextBody(); + CTTextParagraph p = new CTTextParagraph(); + CTRegularTextRun run = new CTRegularTextRun(); + run.setT("Привет"); + p.getEGTextRun().add(run); + rich.getP().add(p); + tx2.setRich(rich); + title2.setTx(tx2); + chart2.setTitle(title2); + ChartSpec spec2 = new ChartSpec(); + ChartSpec.readTitle(chart2, spec2, new DrawMlColor(null)); + assertEquals("Привет", spec2.title); + } + + /** valAx со scaling/единицами/сеткой/numFmt, dateAx как catAxis, serAx. */ + @Test + void axesParsedIncludingDateAxisFallback() { + CTChart chart = new CTChart(); + CTPlotArea pa = new CTPlotArea(); + CTValAx val = new CTValAx(); + CTScaling scaling = new CTScaling(); + CTDouble min = new CTDouble(); + min.setVal(-5.0); + CTDouble max = new CTDouble(); + max.setVal(50.0); + scaling.setMin(min); + scaling.setMax(max); + val.setScaling(scaling); + CTAxisUnit unit = new CTAxisUnit(); + unit.setVal(10.0); + val.setMajorUnit(unit); + CTChartLines grid = new CTChartLines(); + CTShapeProperties gsp = new CTShapeProperties(); + CTLineProperties gln = new CTLineProperties(); + gln.setSolidFill(fill("00FF00")); + gsp.setLn(gln); + grid.setSpPr(gsp); + val.setMajorGridlines(grid); + CTNumFmt fmt = new CTNumFmt(); + fmt.setFormatCode("0.0"); + val.setNumFmt(fmt); + CTBoolean del = new CTBoolean(); + del.setVal(Boolean.TRUE); + val.setDelete(del); + CTAxPos pos = new CTAxPos(); + pos.setVal(STAxPos.R); + val.setAxPos(pos); + CTShapeProperties asp = new CTShapeProperties(); + CTLineProperties aln = new CTLineProperties(); + aln.setNoFill(new CTNoFillProperties()); + asp.setLn(aln); + val.setSpPr(asp); + pa.getValAxOrCatAxOrDateAx().add(val); + pa.getValAxOrCatAxOrDateAx().add(new CTDateAx()); + pa.getValAxOrCatAxOrDateAx().add(new CTSerAx()); + pa.getValAxOrCatAxOrDateAx().add("не-ось"); + chart.setPlotArea(pa); + ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null)); + assertEquals(-5.0, spec.valAxis.min); + assertEquals(50.0, spec.valAxis.max); + assertEquals(10.0, spec.valAxis.majorUnit); + assertTrue(spec.valAxis.gridlines); + assertEquals(new Color(0, 0xFF, 0), spec.valAxis.gridColor); + assertEquals("0.0", spec.valAxis.numFmt); + assertTrue(spec.valAxis.deleted); + assertEquals("r", spec.valAxis.pos); + assertNull(spec.valAxis.axisLineColor); + assertNotNull(spec.catAxis, "c:dateAx становится catAxis"); + assertEquals("General", spec.catAxis.numFmt); + assertNotNull(spec.serAxis); + assertEquals("General", spec.serAxis.numFmt); + } + + @Test + void numericCategoriesSparsePadded() { + CTBarChart bar = new CTBarChart(); + CTBarSer ser = new CTBarSer(); + CTAxDataSource cat = new CTAxDataSource(); + CTNumRef numRef = new CTNumRef(); + CTNumData cache = new CTNumData(); + CTNumVal pt = new CTNumVal(); + pt.setIdx(2); + pt.setV("2024"); + cache.getPt().add(pt); + numRef.setNumCache(cache); + cat.setNumRef(numRef); + ser.setCat(cat); + bar.getSer().add(ser); + ChartSpec spec = new ChartSpec(); + ChartSpec.readGroup(bar, spec, new DrawMlColor(null), List.of()); + assertEquals(List.of("", "", "2024"), spec.series.get(0).categories); + } + + /** Общие categories пустые — берутся из первого ряда. */ + @Test + void categoriesCopiedFromFirstSeries() { + CTChart chart = new CTChart(); + CTPlotArea pa = new CTPlotArea(); + CTBarChart bar = new CTBarChart(); + CTBarSer ser = new CTBarSer(); + ser.setCat(catStr("Я", "Ф", "М")); + bar.getSer().add(ser); + pa.getAreaChartOrArea3DChartOrLineChart().add(bar); + chart.setPlotArea(pa); + ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null)); + assertEquals(List.of("Я", "Ф", "М"), spec.categories); + } + + private static CTChartSpace spaceWith(CTChart chart) { + CTChartSpace space = new CTChartSpace(); + space.setChart(chart); + return space; + } + + private static CTSolidColorFillProperties fill(String hex) { + CTSolidColorFillProperties f = new CTSolidColorFillProperties(); + CTSRgbColor s = new CTSRgbColor(); + s.setVal(hex); + f.setSrgbClr(s); + return f; + } + + private static CTUnsignedInt uint(long v) { + CTUnsignedInt u = new CTUnsignedInt(); + u.setVal(v); + return u; + } + + private static CTStrRef strRef(String v) { + CTStrRef ref = new CTStrRef(); + CTStrData cache = new CTStrData(); + CTStrVal pt = new CTStrVal(); + pt.setIdx(0); + pt.setV(v); + cache.getPt().add(pt); + ref.setStrCache(cache); + return ref; + } + + private static CTAxDataSource catStr(String... names) { + CTAxDataSource cat = new CTAxDataSource(); + CTStrRef ref = new CTStrRef(); + CTStrData cache = new CTStrData(); + for (int i = 0; i < names.length; i++) { + CTStrVal pt = new CTStrVal(); + pt.setIdx(i); + pt.setV(names[i]); + cache.getPt().add(pt); + } + ref.setStrCache(cache); + cat.setStrRef(ref); + return cat; + } + + private static CTNumVal numPt(long idx, String v) { + CTNumVal pt = new CTNumVal(); + pt.setIdx(idx); + pt.setV(v); + return pt; + } + + private static CTChart emptyTitleChart() { CTChart chart = new CTChart(); chart.setTitle(new CTTitle()); diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java new file mode 100644 index 0000000..0316227 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java @@ -0,0 +1,245 @@ +package ru.pjandro.wordpdf.internal.chart; + +import jakarta.xml.bind.JAXBElement; +import org.docx4j.dml.BaseStyles; +import org.docx4j.dml.CTColor; +import org.docx4j.dml.CTColorScheme; +import org.docx4j.dml.CTFixedPercentage; +import org.docx4j.dml.CTFontReference; +import org.docx4j.dml.CTGradientStop; +import org.docx4j.dml.CTHslColor; +import org.docx4j.dml.CTPercentage; +import org.docx4j.dml.CTPositiveFixedAngle; +import org.docx4j.dml.CTPositiveFixedPercentage; +import org.docx4j.dml.CTPositivePercentage; +import org.docx4j.dml.CTScRgbColor; +import org.docx4j.dml.CTSchemeColor; +import org.docx4j.dml.CTSRgbColor; +import org.docx4j.dml.CTSolidColorFillProperties; +import org.docx4j.dml.CTSystemColor; +import org.docx4j.dml.FontCollection; +import org.docx4j.dml.STSchemeColorVal; +import org.docx4j.dml.TextFont; +import org.docx4j.dml.Theme; +import org.junit.jupiter.api.Test; + +import javax.xml.namespace.QName; +import java.awt.Color; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Палитра DrawingML: тема/дефолтная Office-палитра, базовые цвета + * (srgb/scrgb/hsl/sys/scheme) и цепочки трансформаций (lumMod/lumOff/ + * satMod/satOff/hueMod/hueOff/tint/shade/alpha) со всеми классами + * процентных значений; неизвестная трансформация пропускается. + */ +class DrawMlColorTest { + + private static final String DML_NS = "http://schemas.openxmlformats.org/drawingml/2006/main"; + private static final Color OFFICE_ACCENT1 = new Color(0x44, 0x72, 0xC4); + private static final Color OFFICE_ACCENT2 = new Color(0xED, 0x7D, 0x31); + + private static JAXBElement transform(String kind, Class cls, T value) { + return new JAXBElement<>(new QName(DML_NS, kind), cls, value); + } + + private static CTSRgbColor srgbColor(String hex) { + CTSRgbColor s = new CTSRgbColor(); + s.setVal(hex); + return s; + } + + private static CTColor srgb(String hex) { + CTColor c = new CTColor(); + c.setSrgbClr(srgbColor(hex)); + return c; + } + + private static CTColor scheme(STSchemeColorVal val) { + CTColor c = new CTColor(); + CTSchemeColor sc = new CTSchemeColor(); + sc.setVal(val); + c.setSchemeClr(sc); + return c; + } + + private static CTPositiveFixedPercentage fixedPct(int val) { + CTPositiveFixedPercentage p = new CTPositiveFixedPercentage(); + p.setVal(val); + return p; + } + + private static CTFixedPercentage fixed(int val) { + CTFixedPercentage p = new CTFixedPercentage(); + p.setVal(val); + return p; + } + + private static CTPositivePercentage positive(int val) { + CTPositivePercentage p = new CTPositivePercentage(); + p.setVal(val); + return p; + } + + private static CTPercentage pct(int val) { + CTPercentage p = new CTPercentage(); + p.setVal(val); + return p; + } + + private static CTPositiveFixedAngle angle(int val) { + CTPositiveFixedAngle a = new CTPositiveFixedAngle(); + a.setVal(val); + return a; + } + + @Test + void themeColorsAndFontsParsed() { + Theme theme = new Theme(); + BaseStyles el = new BaseStyles(); + CTColorScheme cs = new CTColorScheme(); + cs.setAccent1(srgb("FF0000")); + el.setClrScheme(cs); + BaseStyles.FontScheme fs = new BaseStyles.FontScheme(); + FontCollection minor = new FontCollection(); + TextFont latin = new TextFont(); + latin.setTypeface("Arimo"); + minor.setLatin(latin); + fs.setMinorFont(minor); + // majorFont без a:latin — имя остаётся дефолтным + fs.setMajorFont(new FontCollection()); + el.setFontScheme(fs); + theme.setThemeElements(el); + DrawMlColor colors = new DrawMlColor(theme); + assertEquals(new Color(0xFF, 0, 0), colors.schemeColor("accent1")); + assertEquals("Arimo", colors.minorFontName()); + assertEquals("Calibri Light", colors.majorFontName()); + } + + @Test + void schemeColorNullAndUnknownFallBackToBlack() { + DrawMlColor colors = new DrawMlColor(null); + assertEquals(Color.BLACK, colors.schemeColor(null)); + assertEquals(Color.BLACK, colors.schemeColor("no-such-color")); + assertEquals(OFFICE_ACCENT1, colors.schemeColor("ACCENT1")); + assertEquals(colors.schemeColor("dk1"), colors.schemeColor("tx1")); + assertEquals(colors.schemeColor("lt1"), colors.schemeColor("bg1")); + } + + @Test + void resolveNullsReturnNull() { + DrawMlColor colors = new DrawMlColor(null); + assertNull(colors.resolve(null)); + assertNull(colors.resolve(new CTColor())); + assertNull(colors.resolveFill(null)); + assertNull(colors.resolveStop(null)); + assertNull(colors.resolveFontRef(null)); + } + + @Test + void baseColorKindsResolved() { + DrawMlColor colors = new DrawMlColor(null); + CTColor scrgb = new CTColor(); + CTScRgbColor s = new CTScRgbColor(); + s.setR(1); + s.setG(0); + s.setB(0); + scrgb.setScrgbClr(s); + assertEquals(Color.RED, colors.resolve(scrgb)); + CTColor hsl = new CTColor(); + CTHslColor h = new CTHslColor(); + h.setHue(0); + h.setSat(100000); + h.setLum(50000); + hsl.setHslClr(h); + assertEquals(Color.RED, colors.resolve(hsl)); + CTColor window = new CTColor(); + CTSystemColor w = new CTSystemColor(); + w.setVal("window"); + window.setSysClr(w); + assertEquals(Color.WHITE, colors.resolve(window)); + assertEquals(OFFICE_ACCENT1, colors.resolve(scheme(STSchemeColorVal.ACCENT_1))); + } + + @Test + void srgbTransformsChainApplied() { + DrawMlColor colors = new DrawMlColor(null); + CTColor c = srgb("808080"); + var transforms = c.getSrgbClr().getEGColorTransform(); + transforms.add(transform("lumMod", CTPositiveFixedPercentage.class, fixedPct(50000))); + transforms.add(transform("lumOff", CTFixedPercentage.class, fixed(10000))); + transforms.add(transform("satMod", CTPositivePercentage.class, positive(200000))); + transforms.add(transform("satOff", CTPositivePercentage.class, positive(10000))); + transforms.add(transform("hueMod", CTPositiveFixedPercentage.class, fixedPct(50000))); + transforms.add(transform("hueOff", CTPositiveFixedAngle.class, angle(5400000))); + transforms.add(transform("tint", CTPositiveFixedPercentage.class, fixedPct(80000))); + transforms.add(transform("shade", CTPositiveFixedPercentage.class, fixedPct(90000))); + transforms.add(transform("alpha", CTPercentage.class, pct(50000))); + Color resolved = colors.resolve(c); + assertNotNull(resolved); + assertEquals(128, resolved.getAlpha()); + } + + @Test + void unknownTransformSkipped() { + DrawMlColor colors = new DrawMlColor(null); + CTColor c = srgb("123456"); + c.getSrgbClr().getEGColorTransform() + .add(transform("bogus", String.class, "x")); + assertEquals(new Color(0x12, 0x34, 0x56), colors.resolve(c)); + } + + @Test + void schemeAndSystemColorTransformsApplied() { + DrawMlColor colors = new DrawMlColor(null); + CTColor accent = scheme(STSchemeColorVal.ACCENT_1); + accent.getSchemeClr().getEGColorTransform() + .add(transform("tint", CTPositiveFixedPercentage.class, fixedPct(60000))); + Color resolved = colors.resolve(accent); + assertNotNull(resolved); + assertTrue(resolved.getRed() >= OFFICE_ACCENT1.getRed() + && resolved.getBlue() >= OFFICE_ACCENT1.getBlue(), + "tint обязан осветлять, а не темнить"); + CTColor sys = new CTColor(); + CTSystemColor w = new CTSystemColor(); + w.setVal("windowText"); + w.getEGColorTransform() + .add(transform("shade", CTPositiveFixedPercentage.class, fixedPct(50000))); + sys.setSysClr(w); + assertEquals(Color.BLACK, colors.resolve(sys)); + } + + @Test + void gradientStopAndFontRefResolve() { + DrawMlColor colors = new DrawMlColor(null); + CTGradientStop gs = new CTGradientStop(); + gs.setSrgbClr(srgbColor("FF8000")); + assertEquals(new Color(0xFF, 0x80, 0), colors.resolveStop(gs)); + CTFontReference ref = new CTFontReference(); + CTSchemeColor sc = new CTSchemeColor(); + sc.setVal(STSchemeColorVal.ACCENT_2); + ref.setSchemeClr(sc); + assertEquals(OFFICE_ACCENT2, colors.resolveFontRef(ref)); + } + + @Test + void resolveFillWrapsColorSet() { + DrawMlColor colors = new DrawMlColor(null); + CTSolidColorFillProperties fill = new CTSolidColorFillProperties(); + CTSchemeColor sc = new CTSchemeColor(); + sc.setVal(STSchemeColorVal.DK_1); + fill.setSchemeClr(sc); + assertEquals(Color.BLACK, colors.resolveFill(fill)); + } + + @Test + void withAlphaScalesAlphaChannel() { + Color c = DrawMlColor.withAlpha(Color.BLUE, 0.5); + assertEquals(128, c.getAlpha()); + assertEquals(Color.BLUE.getRGB() & 0xFFFFFF, c.getRGB() & 0xFFFFFF); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java new file mode 100644 index 0000000..703d3c4 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlTextTest.java @@ -0,0 +1,164 @@ +package ru.pjandro.wordpdf.internal.chart; + +import org.docx4j.dml.CTNoFillProperties; +import org.docx4j.dml.CTRegularTextRun; +import org.docx4j.dml.CTTextBody; +import org.docx4j.dml.CTTextCharacterProperties; +import org.docx4j.dml.CTTextParagraph; +import org.docx4j.dml.CTTextParagraphProperties; +import org.docx4j.dml.STTextAlignType; +import org.docx4j.dml.TextFont; +import org.junit.jupiter.api.Test; +import ru.pjandro.wordpdf.fonts.BundledFonts; + +import java.awt.Color; +import java.awt.Graphics2D; +import java.awt.geom.Rectangle2D; +import java.awt.image.BufferedImage; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Текст DrawingML: наследование defRPr/rPr (включая a:noFill → прозрачный + * цвет и алиас «+mj-lt» → семейство темы), фолбэк шрифта для неизвестного + * семейства и растеризация: вертикальный/горизонтальный align, перенос + * длинного слова, жёсткий перевод строки, двойные пробелы. + */ +class DrawMlTextTest { + + private static final DrawMlText.Style STYLE = + new DrawMlText.Style(10, false, false, Color.BLACK, "DejaVu Sans"); + + private static DrawMlText.Style style(String family, boolean bold, boolean italic) { + return new DrawMlText.Style(10, bold, italic, Color.BLACK, family); + } + + private static final int MIN_INK_PER_ROW = 2; + + /** Полосы строк: ряды не менее чем с двумя тёмными пикселями + * (одиночная вершина «A» не полоса). */ + private static int inkBands(BufferedImage img) { + int bands = 0; + boolean in = false; + for (int y = 0; y < img.getHeight(); y++) { + int cnt = 0; + for (int x = 0; x < img.getWidth(); x++) { + int argb = img.getRGB(x, y); + if (argb >>> 24 > 0 && (argb & 0xFFFFFF) < 0x808080) { + cnt++; + } + } + boolean dark = cnt >= MIN_INK_PER_ROW; + if (dark && !in) { + bands++; + in = true; + } else if (!dark) { + in = false; + } + } + return bands; + } + + private static BufferedImage paint(List paragraphs, + Rectangle2D box, String defAlign, String vAlign) { + BufferedImage img = new BufferedImage((int) box.getWidth() + 10, + (int) box.getHeight() + 10, BufferedImage.TYPE_INT_ARGB); + Graphics2D g = img.createGraphics(); + DrawMlText.paint(g, paragraphs, box, defAlign, vAlign, 1.2); + g.dispose(); + return img; + } + + @Test + void defaultStyleNullPaths() { + DrawMlColor colors = new DrawMlColor(null); + DrawMlText.Style def = DrawMlText.defaultStyle(null, colors, + "DejaVu Sans", 9, Color.GRAY); + assertEquals(9, def.sizePt()); + CTTextBody body = new CTTextBody(); + body.getP().add(new CTTextParagraph()); + DrawMlText.Style base = DrawMlText.defaultStyle(body, colors, + "DejaVu Sans", 9, Color.GRAY); + assertEquals(Color.GRAY, base.color(), "без a:pPr/a:defRPr — фолбэк-цвет"); + } + + @Test + void paragraphsNullBodyAndRunStyles() { + BundledFonts.init(); + DrawMlColor colors = new DrawMlColor(null); + assertTrue(DrawMlText.paragraphs(null, colors, "DejaVu Sans", 9, Color.GRAY).isEmpty()); + CTTextBody body = new CTTextBody(); + CTTextParagraph p = new CTTextParagraph(); + CTTextParagraphProperties pPr = new CTTextParagraphProperties(); + pPr.setAlgn(STTextAlignType.CTR); + CTTextCharacterProperties defRPr = new CTTextCharacterProperties(); + defRPr.setSz(1400); + TextFont major = new TextFont(); + major.setTypeface("+mj-lt"); + defRPr.setLatin(major); + pPr.setDefRPr(defRPr); + p.setPPr(pPr); + CTRegularTextRun run = new CTRegularTextRun(); + CTTextCharacterProperties rPr = new CTTextCharacterProperties(); + rPr.setNoFill(new CTNoFillProperties()); + run.setRPr(rPr); + run.setT("Привет"); + p.getEGTextRun().add(run); + body.getP().add(p); + List paras = DrawMlText.paragraphs(body, colors, + "DejaVu Sans", 9, Color.GRAY); + assertEquals(1, paras.size()); + assertEquals("Привет", paras.get(0).text()); + assertEquals("ctr", paras.get(0).align()); + assertEquals(14.0, paras.get(0).style().sizePt()); + assertEquals("carlito", paras.get(0).style().family(), + "«+mj-lt» разрешается в major-шрифт темы"); + assertEquals(0, paras.get(0).style().color().getAlpha(), + "a:noFill в a:rPr — прозрачный цвет"); + } + + @Test + void fontForUnknownFamilyFallsBack() { + assertNotNull(DrawMlText.fontFor(style("NoSuchFamily", true, true))); + assertNotNull(DrawMlText.fontFor(style("Noto Naskh Arabic", false, true)), + "нет bold-italic в семействе — фолбэк без null"); + } + + @Test + void paintEmptyIsNoop() { + BufferedImage img = paint(List.of(), + new Rectangle2D.Double(0, 0, 50, 50), null, null); + assertEquals(0, inkBands(img)); + } + + @Test + void paintBottomAndRightAlignDrawsInk() { + BufferedImage img = paint( + List.of(new DrawMlText.Paragraph("Тест", STYLE, "r")), + new Rectangle2D.Double(0, 0, 120, 60), null, "b"); + assertTrue(inkBands(img) >= 1, "right/bottom-выравнивание рисует текст"); + } + + @Test + void paintHardNewlineCreatesGap() { + BufferedImage gap = paint( + List.of(new DrawMlText.Paragraph("A\n\nB", STYLE, null)), + new Rectangle2D.Double(0, 0, 120, 80), "ctr", "t"); + assertEquals(2, inkBands(gap), "пустая строка между A и B — разрыв полос"); + BufferedImage one = paint( + List.of(new DrawMlText.Paragraph("A B", STYLE, null)), + new Rectangle2D.Double(0, 0, 120, 40), null, "t"); + assertEquals(1, inkBands(one), "двойной пробел не рвёт строку"); + } + + @Test + void paintLongWordSplitsIntoLines() { + BufferedImage img = paint( + List.of(new DrawMlText.Paragraph("A WWWWWWWWWWWWWWWWW", STYLE, null)), + new Rectangle2D.Double(0, 0, 20, 120), null, "t"); + assertTrue(inkBands(img) >= 3, "длинное слово режется по символам"); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/PresetGeometryTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/PresetGeometryTest.java index 9fffbfc..f4ce70f 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/PresetGeometryTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/PresetGeometryTest.java @@ -272,4 +272,22 @@ class PresetGeometryTest { } assertEquals(4, segments); } + + /** Арифметика префиксных формул (+, -, *, /), голый литерал, пустая/битая fmla → 0. */ + @Test + void adjustValuesEvaluatesFormulasAndBlanks() { + CTPresetGeometry2D geom = new CTPresetGeometry2D(); + CTGeomGuideList av = new CTGeomGuideList(); + av.getGd().add(guide("adj1", "45000")); + av.getGd().add(guide("adj2", "+ 1 2")); + av.getGd().add(guide("adj3", "- 5 2")); + av.getGd().add(guide("adj4", "* 2 3 4")); + av.getGd().add(guide("adj5", "/ 2 4 6")); + av.getGd().add(guide("adj6", null)); + av.getGd().add(guide("adj7", "+ 1")); + geom.setAvLst(av); + assertArrayEquals(new int[]{45000, 3, 3, 1, 1, 0, 0}, + PresetGeometry.adjustValues(geom), + "* = a*b/c, / = (a+b)/c; пустая и оборванная формула — 0"); + } } -- 2.56.1 From 3886b152e0566c12b0083a8fd1b9437925be6d5c Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sat, 24 Oct 2026 18:41:51 +0000 Subject: [PATCH 2/4] =?UTF-8?q?CI:=20upload-artifact=20v4=20->=20v3=20?= =?UTF-8?q?=E2=80=94=20=D0=B0=D1=80=D1=82=D0=B5=D1=84=D0=B0=D0=BA=D1=82-?= =?UTF-8?q?=D1=81=D0=B5=D1=80=D0=B2=D0=B5=D1=80=20Gitea=20=D0=BD=D0=B5=20?= =?UTF-8?q?=D0=BF=D0=BE=D0=B4=D0=B4=D0=B5=D1=80=D0=B6=D0=B8=D0=B2=D0=B0?= =?UTF-8?q?=D0=B5=D1=82=20=D0=BF=D1=80=D0=BE=D1=82=D0=BE=D0=BA=D0=BE=D0=BB?= =?UTF-8?q?=20v4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitea/workflows/main.yml | 4 +++- .gitea/workflows/pr.yml | 4 +++- AGENTS.md | 3 ++- 3 files changed, 8 insertions(+), 3 deletions(-) diff --git a/.gitea/workflows/main.yml b/.gitea/workflows/main.yml index a4a4493..4cb9e7f 100644 --- a/.gitea/workflows/main.yml +++ b/.gitea/workflows/main.yml @@ -56,9 +56,11 @@ jobs: print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |") PY + # v3, не v4: артефакт-сервер Gitea говорит по протоколу actions/artifact v1, + # v4+ падает «not currently supported on GHES» - name: Upload coverage reports if: always() - uses: actions/upload-artifact@v4 + uses: actions/upload-artifact@v3 with: name: jacoco-html path: | diff --git a/.gitea/workflows/pr.yml b/.gitea/workflows/pr.yml index e345498..65a3b8c 100644 --- a/.gitea/workflows/pr.yml +++ b/.gitea/workflows/pr.yml @@ -55,9 +55,11 @@ jobs: print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |") PY + # v3, не v4: артефакт-сервер Gitea говорит по протоколу actions/artifact v1, + # v4+ падает «not currently supported on GHES» - name: Upload coverage reports if: always() - uses: actions/upload-artifact@v4 + uses: actions/upload-artifact@v3 with: name: jacoco-html path: | diff --git a/AGENTS.md b/AGENTS.md index 776131d..ccfa0b7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -92,7 +92,8 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \ Два workflow. `.gitea/workflows/pr.yml` — `PR checks` (`pull_request` + `workflow_dispatch`): job `java` (temurin 21, кеш `~/.m2` через `actions/cache`, Maven 3.9.16 ставится вручную с dlcdn, `mvn -B clean verify`, затем `Coverage summary` — разбор `target/site/jacoco/jacoco.xml` python-сниппетом в лог job'а и -`actions/upload-artifact` HTML-отчётов обоих модулей артефактом `jacoco-html`) +`actions/upload-artifact@v3` HTML-отчётов обоих модулей артефактом `jacoco-html`; именно v3 — +артефакт-сервер Gitea не понимает протокол v4 («not currently supported on GHES»)) и `web` (кеш `~/.npm`, `npm ci`/`build`/`lint`). `.gitea/workflows/main.yml` — `Main: tests, deploy, autotests` (`push` в `main` + `workflow_dispatch`): те же `java`/`web` (байт-в-байт дубль — файлы самодостаточны, reusable-workflow не вводить), затем `images-app`/`images-web` -- 2.56.1 From f702b704cad8ecac434dbfaed2c5465ba17641a0 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sat, 24 Oct 2026 18:48:00 +0000 Subject: [PATCH 3/4] =?UTF-8?q?CI:=20=D1=80=D0=B5=D0=BF=D0=BE=D1=80=D1=82?= =?UTF-8?q?=D1=8B=20=D0=BF=D0=BE=D0=BA=D1=80=D1=8B=D1=82=D0=B8=D1=8F=20?= =?UTF-8?q?=D0=BE=D0=B4=D0=BD=D0=B8=D0=BC=20zip=20=E2=80=94=20v1-=D0=BF?= =?UTF-8?q?=D1=80=D0=BE=D1=82=D0=BE=D0=BA=D0=BE=D0=BB=20Gitea=20=D0=B3?= =?UTF-8?q?=D1=80=D1=83=D0=B7=D0=B8=D1=82=20=D1=84=D0=B0=D0=B9=D0=BB=20?= =?UTF-8?q?=D0=B7=D0=B0=20=D0=B7=D0=B0=D0=BF=D1=80=D0=BE=D1=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitea/workflows/main.yml | 21 +++++++++++++++++---- .gitea/workflows/pr.yml | 21 +++++++++++++++++---- AGENTS.md | 6 ++++-- 3 files changed, 38 insertions(+), 10 deletions(-) diff --git a/.gitea/workflows/main.yml b/.gitea/workflows/main.yml index 4cb9e7f..cc4044e 100644 --- a/.gitea/workflows/main.yml +++ b/.gitea/workflows/main.yml @@ -57,15 +57,28 @@ jobs: PY # v3, не v4: артефакт-сервер Gitea говорит по протоколу actions/artifact v1, - # v4+ падает «not currently supported on GHES» + # v4+ падает «not currently supported on GHES». Один zip вместо ~150 файлов: + # v1 грузит каждый файл отдельным запросом — поштучно это минуты; + # python3 (не zip) — гарантирован на раннере, см. шаг Coverage summary + - name: Pack coverage reports + if: always() + run: | + python3 - <<'PY' + import os, zipfile + with zipfile.ZipFile("jacoco-html.zip", "w", zipfile.ZIP_DEFLATED) as z: + for m in ("wordpdf-core", "wordpdf-app"): + d = f"{m}/target/site/jacoco" + for root, _, files in os.walk(d): + for f in files: + p = os.path.join(root, f) + z.write(p, p) + PY - name: Upload coverage reports if: always() uses: actions/upload-artifact@v3 with: name: jacoco-html - path: | - wordpdf-core/target/site/jacoco/ - wordpdf-app/target/site/jacoco/ + path: jacoco-html.zip web: runs-on: ubuntu-latest diff --git a/.gitea/workflows/pr.yml b/.gitea/workflows/pr.yml index 65a3b8c..e14b021 100644 --- a/.gitea/workflows/pr.yml +++ b/.gitea/workflows/pr.yml @@ -56,15 +56,28 @@ jobs: PY # v3, не v4: артефакт-сервер Gitea говорит по протоколу actions/artifact v1, - # v4+ падает «not currently supported on GHES» + # v4+ падает «not currently supported on GHES». Один zip вместо ~150 файлов: + # v1 грузит каждый файл отдельным запросом — поштучно это минуты; + # python3 (не zip) — гарантирован на раннере, см. шаг Coverage summary + - name: Pack coverage reports + if: always() + run: | + python3 - <<'PY' + import os, zipfile + with zipfile.ZipFile("jacoco-html.zip", "w", zipfile.ZIP_DEFLATED) as z: + for m in ("wordpdf-core", "wordpdf-app"): + d = f"{m}/target/site/jacoco" + for root, _, files in os.walk(d): + for f in files: + p = os.path.join(root, f) + z.write(p, p) + PY - name: Upload coverage reports if: always() uses: actions/upload-artifact@v3 with: name: jacoco-html - path: | - wordpdf-core/target/site/jacoco/ - wordpdf-app/target/site/jacoco/ + path: jacoco-html.zip web: runs-on: ubuntu-latest diff --git a/AGENTS.md b/AGENTS.md index ccfa0b7..b10cce7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -92,8 +92,10 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \ Два workflow. `.gitea/workflows/pr.yml` — `PR checks` (`pull_request` + `workflow_dispatch`): job `java` (temurin 21, кеш `~/.m2` через `actions/cache`, Maven 3.9.16 ставится вручную с dlcdn, `mvn -B clean verify`, затем `Coverage summary` — разбор `target/site/jacoco/jacoco.xml` python-сниппетом в лог job'а и -`actions/upload-artifact@v3` HTML-отчётов обоих модулей артефактом `jacoco-html`; именно v3 — -артефакт-сервер Gitea не понимает протокол v4 («not currently supported on GHES»)) +`Pack coverage reports` (python3 `zipfile` — один `jacoco-html.zip`) и `actions/upload-artifact@v3` +артефактом `jacoco-html`; именно v3 и именно один zip — артефакт-сервер Gitea не понимает протокол +v4 («not currently supported on GHES»), а v1 грузит каждый файл отдельным запросом (~150 HTML-файлов +поштучно = минуты простоя)) и `web` (кеш `~/.npm`, `npm ci`/`build`/`lint`). `.gitea/workflows/main.yml` — `Main: tests, deploy, autotests` (`push` в `main` + `workflow_dispatch`): те же `java`/`web` (байт-в-байт дубль — файлы самодостаточны, reusable-workflow не вводить), затем `images-app`/`images-web` -- 2.56.1 From b9ce970d2603c9d35d85878a29a930d85850f299 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sat, 24 Oct 2026 18:54:53 +0000 Subject: [PATCH 4/4] =?UTF-8?q?CI:=20=D0=BF=D0=BE=D0=BA=D1=80=D1=8B=D1=82?= =?UTF-8?q?=D0=B8=D0=B5=20=E2=80=94=20=D0=BA=D0=BE=D0=BC=D0=BC=D0=B5=D0=BD?= =?UTF-8?q?=D1=82=D0=B0=D1=80=D0=B8=D0=B5=D0=BC=20=D0=B2=20PR=20=D0=B2?= =?UTF-8?q?=D0=BC=D0=B5=D1=81=D1=82=D0=BE=20=D0=B0=D1=80=D1=82=D0=B5=D1=84?= =?UTF-8?q?=D0=B0=D0=BA=D1=82=D0=BE=D0=B2=20(artifact-=D1=81=D0=B5=D1=80?= =?UTF-8?q?=D0=B2=D0=B5=D1=80=20Gitea=20=D0=BD=D0=B5=D0=BF=D1=80=D0=B8?= =?UTF-8?q?=D0=B3=D0=BE=D0=B4=D0=B5=D0=BD)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit upload-artifact@v4 не поддерживается, @v3 на этом стенде висит на загрузке (run 508 — 153 файла, run 509 — один zip; оба отменены в полёте). Вместо артефактов: Coverage summary пишет coverage-summary.md (он же в step summary), Comment coverage on PR постит/обновляет комментарий в PR по маркеру (continue-on-error). Шаг продублирован в main.yml байт-в-байт, там if не срабатывает. HTML — локально target/site/jacoco. --- .gitea/workflows/main.yml | 55 ++++++++++++++++++++++++--------------- .gitea/workflows/pr.yml | 55 ++++++++++++++++++++++++--------------- AGENTS.md | 16 +++++++----- 3 files changed, 78 insertions(+), 48 deletions(-) diff --git a/.gitea/workflows/main.yml b/.gitea/workflows/main.yml index cc4044e..37508c8 100644 --- a/.gitea/workflows/main.yml +++ b/.gitea/workflows/main.yml @@ -35,7 +35,7 @@ jobs: - name: Coverage summary if: always() run: | - python3 - <<'PY' >> "$GITHUB_STEP_SUMMARY" + python3 - <<'PY' > coverage-summary.md import os import xml.etree.ElementTree as ET def pct(root, kind): @@ -44,6 +44,7 @@ jobs: missed, covered = int(c.get("missed")), int(c.get("covered")) return f"{100.0 * covered / (missed + covered):.1f}%" return "—" + print("") print("## Покрытие (JaCoCo)\n") print("| Модуль | Строки | Ветви | Порог строк |") print("|---|---|---|---|") @@ -55,30 +56,42 @@ jobs: r = ET.parse(p).getroot() print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |") PY + cat coverage-summary.md >> "$GITHUB_STEP_SUMMARY" - # v3, не v4: артефакт-сервер Gitea говорит по протоколу actions/artifact v1, - # v4+ падает «not currently supported on GHES». Один zip вместо ~150 файлов: - # v1 грузит каждый файл отдельным запросом — поштучно это минуты; - # python3 (не zip) — гарантирован на раннере, см. шаг Coverage summary - - name: Pack coverage reports - if: always() + # Таблица покрытия — комментарием в PR: видно в обсуждении, не открывая run. + # Повторные push обновляют тот же комментарий (поиск по маркеру), + # github.token — task-токен раннера, падение не валит job. Артефактов с + # отчётами НЕТ намеренно: upload-artifact@v4 Gitea не поддерживает, @v3 на + # этом стенде висит на загрузке (отменена и с 153 файлами, и с одним zip); + # HTML — локально в target/site/jacoco. Шаг байт-в-байт одинаков в обоих + # workflow, в main.yml if не срабатывает — нет PR-события + - name: Comment coverage on PR + if: always() && github.event_name == 'pull_request' + continue-on-error: true + env: + GITEA_TOKEN: ${{ github.token }} + API: ${{ github.api_url }} + REPO: ${{ github.repository }} + PR_NUMBER: ${{ github.event.pull_request.number }} run: | + [ -s coverage-summary.md ] || exit 0 python3 - <<'PY' - import os, zipfile - with zipfile.ZipFile("jacoco-html.zip", "w", zipfile.ZIP_DEFLATED) as z: - for m in ("wordpdf-core", "wordpdf-app"): - d = f"{m}/target/site/jacoco" - for root, _, files in os.walk(d): - for f in files: - p = os.path.join(root, f) - z.write(p, p) + import json, os, urllib.request + api, repo, pr = os.environ["API"], os.environ["REPO"], os.environ["PR_NUMBER"] + token = os.environ["GITEA_TOKEN"] + body = open("coverage-summary.md").read() + def req(method, url, payload=None): + data = json.dumps(payload).encode() if payload is not None else None + r = urllib.request.Request(url, data=data, method=method, + headers={"Authorization": f"token {token}", + "Content-Type": "application/json"}) + return json.loads(urllib.request.urlopen(r).read() or "null") + base = f"{api}/repos/{repo}/issues/{pr}/comments" + existing = next((c["id"] for c in req("GET", base) + if "" in c.get("body", "")), None) + req("PATCH" if existing else "POST", + f"{base}/{existing}" if existing else base, {"body": body}) PY - - name: Upload coverage reports - if: always() - uses: actions/upload-artifact@v3 - with: - name: jacoco-html - path: jacoco-html.zip web: runs-on: ubuntu-latest diff --git a/.gitea/workflows/pr.yml b/.gitea/workflows/pr.yml index e14b021..6cb3b02 100644 --- a/.gitea/workflows/pr.yml +++ b/.gitea/workflows/pr.yml @@ -34,7 +34,7 @@ jobs: - name: Coverage summary if: always() run: | - python3 - <<'PY' >> "$GITHUB_STEP_SUMMARY" + python3 - <<'PY' > coverage-summary.md import os import xml.etree.ElementTree as ET def pct(root, kind): @@ -43,6 +43,7 @@ jobs: missed, covered = int(c.get("missed")), int(c.get("covered")) return f"{100.0 * covered / (missed + covered):.1f}%" return "—" + print("") print("## Покрытие (JaCoCo)\n") print("| Модуль | Строки | Ветви | Порог строк |") print("|---|---|---|---|") @@ -54,30 +55,42 @@ jobs: r = ET.parse(p).getroot() print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |") PY + cat coverage-summary.md >> "$GITHUB_STEP_SUMMARY" - # v3, не v4: артефакт-сервер Gitea говорит по протоколу actions/artifact v1, - # v4+ падает «not currently supported on GHES». Один zip вместо ~150 файлов: - # v1 грузит каждый файл отдельным запросом — поштучно это минуты; - # python3 (не zip) — гарантирован на раннере, см. шаг Coverage summary - - name: Pack coverage reports - if: always() + # Таблица покрытия — комментарием в PR: видно в обсуждении, не открывая run. + # Повторные push обновляют тот же комментарий (поиск по маркеру), + # github.token — task-токен раннера, падение не валит job. Артефактов с + # отчётами НЕТ намеренно: upload-artifact@v4 Gitea не поддерживает, @v3 на + # этом стенде висит на загрузке (отменена и с 153 файлами, и с одним zip); + # HTML — локально в target/site/jacoco. Шаг байт-в-байт одинаков в обоих + # workflow, в main.yml if не срабатывает — нет PR-события + - name: Comment coverage on PR + if: always() && github.event_name == 'pull_request' + continue-on-error: true + env: + GITEA_TOKEN: ${{ github.token }} + API: ${{ github.api_url }} + REPO: ${{ github.repository }} + PR_NUMBER: ${{ github.event.pull_request.number }} run: | + [ -s coverage-summary.md ] || exit 0 python3 - <<'PY' - import os, zipfile - with zipfile.ZipFile("jacoco-html.zip", "w", zipfile.ZIP_DEFLATED) as z: - for m in ("wordpdf-core", "wordpdf-app"): - d = f"{m}/target/site/jacoco" - for root, _, files in os.walk(d): - for f in files: - p = os.path.join(root, f) - z.write(p, p) + import json, os, urllib.request + api, repo, pr = os.environ["API"], os.environ["REPO"], os.environ["PR_NUMBER"] + token = os.environ["GITEA_TOKEN"] + body = open("coverage-summary.md").read() + def req(method, url, payload=None): + data = json.dumps(payload).encode() if payload is not None else None + r = urllib.request.Request(url, data=data, method=method, + headers={"Authorization": f"token {token}", + "Content-Type": "application/json"}) + return json.loads(urllib.request.urlopen(r).read() or "null") + base = f"{api}/repos/{repo}/issues/{pr}/comments" + existing = next((c["id"] for c in req("GET", base) + if "" in c.get("body", "")), None) + req("PATCH" if existing else "POST", + f"{base}/{existing}" if existing else base, {"body": body}) PY - - name: Upload coverage reports - if: always() - uses: actions/upload-artifact@v3 - with: - name: jacoco-html - path: jacoco-html.zip web: runs-on: ubuntu-latest diff --git a/AGENTS.md b/AGENTS.md index b10cce7..bba424b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -58,7 +58,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр |`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)| |корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-**21-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose не в репо — его рендерит job `deploy` (лимиты запекаются из Variables); podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)| |корневой `.env.example`|шаблон env для локальных/compose-стендов: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает старт — binding long/int); проду `.env` **не нужен**: ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables, legacy-`.env` на проде удаляется деплоем| -|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты + coverage-сводка/артефакты JaCoCo → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)| +|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты + coverage-сводка и комментарий в PR → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)| |корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений| |корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 21 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`| |`develop/` (вне git, gitignored)|рабочие материалы и эталоны Word для ручного сравнения — **не фикстуры**, в тесты/jar не подключать; на 2026-10 директория пуста (эталоны вынесены, пиксельные замеры зашиты числами в chart-тестах)| @@ -91,11 +91,15 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \ Два workflow. `.gitea/workflows/pr.yml` — `PR checks` (`pull_request` + `workflow_dispatch`): job `java` (temurin 21, кеш `~/.m2` через `actions/cache`, Maven 3.9.16 ставится вручную с dlcdn, `mvn -B clean verify`, -затем `Coverage summary` — разбор `target/site/jacoco/jacoco.xml` python-сниппетом в лог job'а и -`Pack coverage reports` (python3 `zipfile` — один `jacoco-html.zip`) и `actions/upload-artifact@v3` -артефактом `jacoco-html`; именно v3 и именно один zip — артефакт-сервер Gitea не понимает протокол -v4 («not currently supported on GHES»), а v1 грузит каждый файл отдельным запросом (~150 HTML-файлов -поштучно = минуты простоя)) +затем `Coverage summary` — разбор `target/site/jacoco/jacoco.xml` python-сниппетом в файл +`coverage-summary.md` + step summary job'а и `Comment coverage on PR` — тот же текст +комментарием в PR (создаётся один раз, повторные push обновляют по маркеру +``; `continue-on-error` — падение комментария не валит job; +в `main.yml` шаг продублирован байт-в-байт, но `if: github.event_name == 'pull_request'` +там не срабатывает). **Артефактов покрытия нет намеренно**: `upload-artifact@v4` Gitea +не поддерживает («not currently supported on GHES»), `@v3` на этом стенде зависает на +загрузке (проверено: отменена и с ~150 файлов, и с одним zip); HTML-отчёт — локально +`target/site/jacoco/`) и `web` (кеш `~/.npm`, `npm ci`/`build`/`lint`). `.gitea/workflows/main.yml` — `Main: tests, deploy, autotests` (`push` в `main` + `workflow_dispatch`): те же `java`/`web` (байт-в-байт дубль — файлы самодостаточны, reusable-workflow не вводить), затем `images-app`/`images-web` -- 2.56.1