harfbuzz/test/shape
Andres Salomon 0bbc9d5256 [fonts] move OFL-1.1 license to a higher directory
There's a bunch of font directories inside of test/ for which the vast
majority of fonts are licensed under the SIL open font license. We currently
have a COPYING file in test/shape/data/in-house/COPYING that says that most
of the fonts are OFL-1.1, but that doesn't apply to the fonts in, say,
test/api/fonts/ or test/fuzzing/fonts/. Since there are so many OFL-1.1
fonts all over test, let's move the COPYING file to the top-level test/
directory.
2023-01-25 10:07:03 -07:00
..
data [fonts] move OFL-1.1 license to a higher directory 2023-01-25 10:07:03 -07:00
Makefile.am [test/shape] Remove texts subdirectory 2022-06-03 12:12:13 +01:00
README.md [test] Test the reordering of U+0E33 and U+0EB3 2022-06-27 20:18:17 -06:00
hb-diff [test] Rename shaping/ to shape/ 2021-08-11 18:49:59 -06:00
hb-diff-colorize [test] Rename shaping/ to shape/ 2021-08-11 18:49:59 -06:00
hb-diff-filter-failures [test] Rename shaping/ to shape/ 2021-08-11 18:49:59 -06:00
hb-diff-stat [test] Rename shaping/ to shape/ 2021-08-11 18:49:59 -06:00
hb-unicode-decode [test] Rename shaping/ to shape/ 2021-08-11 18:49:59 -06:00
hb-unicode-encode [test] Rename shaping/ to shape/ 2021-08-11 18:49:59 -06:00
hb-unicode-prettyname [test] Rename shaping/ to shape/ 2021-08-11 18:49:59 -06:00
hb_test_tools.py [util/hb-subset] Support ranges in --unicodes / --unicodes-file 2021-08-11 22:49:47 -06:00
meson.build [build] Change how platform shaper tests are enable 2022-03-24 06:48:12 +02:00
record-test.sh [test/shape] Allow using hb-subset in record-test.sh 2022-06-03 12:12:13 +01:00
run-tests.py [run-tests.py] Write out the failing test 2022-07-30 12:02:36 -06:00

README.md

Adding tests

You can test shaping of a unicode sequence against a font like this:

$ ./hb-unicode-encode 41 42 43 627 | ../../util/hb-shape font.ttf

assuming an in-tree build. The 41 42 43 627 here is a sequence of Unicode codepoints: U+0041,0042,0043,0627. When you are happy with the shape results, you can use the record-test.sh script to add this to the test suite. record-test.sh requires pyftsubset to be installed. You can get pyftsubset by installing FontTools from https://github.com/behdad/fonttools.

To use record-test.sh, just put it right before the hb-shape invocation:

$ ./hb-unicode-encode 41 42 43 627 | ./record-test.sh ../../util/hb-subset ../../util/hb-shape font.ttf

what this does is:

  • Subset the font for the sequence of Unicode characters requested,
  • Compare the hb-shape output of the original font versus the subset font for the input sequence,
  • If the outputs differ, perhaps it is because the font does not have glyph names; it then compares the output of hb-view for both fonts.
  • If the outputs differ, recording fails. Otherwise, it will move the subset font file into data/in-house/fonts and name it after its hash, and print out the test case input, which you can then redirect to an existing or new test file in data/in-house/tests using -o, e.g.:
$ ./hb-unicode-encode 41 42 43 627 | ./record-test.sh -o data/in-house/tests/test-name.tests ../../util/hb-subset ../../util/hb-shape font.ttf

If you created a new test file, add it to data/in-house/Makefile.sources so it is run. Check that make check does indeed run it, and that the test passes. When everything looks good, git add the new font as well as the new test file if you created any. You can see what new files are there by running git status data/in-house. And commit!

Note! Please only add tests using Open Source fonts, preferably under OFL or similar license.