Skip to content

docs(tests): say how the Hancom-saved fixtures were saved and cleaned #365

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
airmang merged 1 commit into from
Oct 6, 2026
Merged

docs(tests): say how the Hancom-saved fixtures were saved and cleaned #365

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions tests/fixtures/hancom_saved/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# Hancom-saved fixtures

Documents laid out and saved by Hancom's Hangul. Tests compare what python-hwpx writes, reads or estimates
with what Hangul stored in them: line layout caches (`hp:linesegarray`), table and object sizes, field and
style values.

## Saved automatically on Windows

Every file but `equation_*.hwpx` was saved automatically by Hangul's engine for Windows, not from the
Hangul window on a desktop. Such a save writes `os="2"` in `version.xml` and no `Preview/PrvImage.png`
(files saved from the desktop program carry `os="1"` and usually a preview image). `memos_in_fields.hwp`
was saved the same way.

Before a file was committed, only what names its author, the program version and the dates was removed;
every other part keeps the bytes Hangul wrote.

- `.hwpx`
- `version.xml`: `appVersion` emptied.
- `Contents/content.hpf`: the `creator`, `lastsaveby`, `CreatedDate`, `ModifiedDate` and `date` metas
emptied.
- An embedded OLE object (`BinData/*.ole`, a chart): the times of its compound file's root entry zeroed.
- The zip repacked with its entries in the same order and compression, dated 1980-01-01 as Hangul
dates them.
- `.hwp`
- The summary information stream (`\x05HwpSummaryInformation`): the author, the last saver, the program
version, the created and last saved times and the date text emptied. The last printed time is zero as
Hangul writes it.
- The compound file rebuilt; every other stream is as Hangul saved it.

Their document information therefore differs from that of a file saved from the desktop program, while
their content and layout caches do not.

## Equations saved on macOS

`equation_*.hwpx` were cut from documents opened and saved by Hangul for macOS (`os="10"` in
`version.xml`). Each keeps the section's first paragraph and one equation paragraph byte for byte; the
preview image was left out and the author and dates emptied (#351).

## Adding a file

A file saved from the desktop program works the same: remove the information listed above before
committing it, and say in the test what behaviour of Hangul the file shows.
Loading