Skip to content

ci: compare the output with htmlcmp 2.4.0 - #915

Merged
andiwand merged 1 commit into
mainfrom
chore/htmlcmp-2.4.0
Sep 20, 2026
Merged

andiwand merged 1 commit into
mainfrom
chore/htmlcmp-2.4.0

Conversation

@andiwand

@andiwand andiwand commented Sep 20, 2026

Copy link
Copy Markdown
Member

test (macos-26) failed on five pull requests in a row — 907, 908, 909, 910, 911 — each naming a different set of files. 908 and 909 changed only spreadsheet and document javascript, which cannot alter a pdf view by a pixel, so the difference was in the rendering rather than in the files.

Two things in compare-html allowed that, both fixed in opendocument-app/compare-html#19 and released as v2.4.0:

  • A shot could catch the page mid-render. screenshot waited for readyState only, which does not cover a web font: the load event fires while the face is still arriving and the text is laid out again once it lands. It now waits for document.fonts.ready and two frames.
  • A single mismatching render decided the file. compare_html now renders a mismatch again before reporting it. A real difference is in the markup and comes back every time, so nothing is hidden, and the matching files — almost all of them — are still rendered once.

2.3.0 comes along with the bump: it modernised the report and crops the empty tail of a tall shot before diffing.

Checked

With 2.4.0 installed from PyPI, the exact invocation this workflow uses:

pair exit
style-various-1.pdf against itself 0
style-various-1.pdf against empty.pdf 1

So a match still passes and a real difference still fails.

No CHANGELOG.md entry: this is CI, which the changelog's own preamble leaves to the generated list.

2.4.0 settles the page before it shoots it - `document.fonts.ready` and two
frames rather than `readyState` alone - and renders a mismatch again before
reporting it. Both are for the `test (macos-26)` job, which failed on five
pull requests in a row naming a different set of files each time, three of
them changing javascript that cannot alter a pdf view.

2.3.0 comes with it: it modernised the report and cropped the empty tail of
a shot before the diff.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0149gFxhkvKTBQidz6brU8Vt
@andiwand
andiwand merged commit e59af25 into main Sep 20, 2026
27 checks passed
@andiwand
andiwand deleted the chore/htmlcmp-2.4.0 branch September 20, 2026 11:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant