• Home
Name Date Size #Lines LOC

..--

data/03-May-2024-2,9422,477

texts/in-house/03-May-2024-32,29031,957

CMakeLists.txtD03-May-20241.3 KiB2926

Makefile.amD03-May-2024695 4031

README.mdD03-May-20241.9 KiB4237

hb-diffD03-May-2024227 116

hb-diff-colorizeD03-May-2024253 84

hb-diff-filter-failuresD03-May-2024166 62

hb-diff-statD03-May-2024108 62

hb-unicode-decodeD03-May-2024130 62

hb-unicode-encodeD03-May-2024134 62

hb-unicode-prettynameD03-May-2024175 73

hb_test_tools.pyD03-May-202413.8 KiB577471

record-test.shD03-May-20243.3 KiB127112

run-tests.pyD03-May-20243.6 KiB142112

README.md

1Adding tests
2============
3
4You can test shaping of a unicode sequence against a font like this:
5```sh
6$ ./hb-unicode-encode 41 42 43 627 | ../../util/hb-shape font.ttf
7```
8assuming an in-tree build.  The 41 42 43 627 here is a sequence of
9Unicode codepoints: U+0041,0042,0043,0627.  When you are happy with
10the shape results, you can use the `record-test.sh` script to add
11this to the test suite.  `record-test.sh` requires `pyftsubset` to
12be installed.  You can get `pyftsubset` by installing
13FontTools from <https://github.com/behdad/fonttools>.
14
15To use `record-test.sh`, just put it right before the `hb-shape` invocation:
16```sh
17$ ./hb-unicode-encode 41 42 43 627 | ./record-test.sh ../../util/hb-shape font.ttf
18```
19what this does is:
20  * Subset the font for the sequence of Unicode characters requested,
21  * Compare the `hb-shape` output of the original font versus the subset
22    font for the input sequence,
23  * If the outputs differ, perhaps it is because the font does not have
24    glyph names; it then compares the output of `hb-view` for both fonts.
25  * If the outputs differ, recording fails.  Otherwise, it will move the
26    subset font file into `data/in-house/fonts` and name it after its
27    hash, and print out the test case input, which you can then redirect
28    to an existing or new test file in `data/in-house/tests` using `-o`,
29    e.g.:
30```sh
31$ ./hb-unicode-encode 41 42 43 627 | ./record-test.sh -o data/in-house/tests/test-name.test ../../util/hb-shape font.ttf
32```
33
34If you created a new test file, add it to `data/in-house/Makefile.sources`
35so it is run.  Check that `make check` does indeed run it, and that the
36test passes.  When everything looks good, `git add` the new font as well
37as the new test file if you created any.  You can see what new files are
38there by running `git status data/in-house`.  And commit!
39
40*Note!*  Please only add tests using Open Source fonts, preferably under
41OFL or similar license.
42