harfbuzz/TESTING.md

## Build and Test

```shell
meson build
ninja -Cbuild
meson test -Cbuild
```

### Debug with GDB

```shell
meson test -Cbuild --gdb testname
```

## Build and Run

Depending on what area you are working in change or add `HB_DEBUG_<whatever>`.
Values defined in `hb-debug.hh`.

```shell
CPPFLAGS='-DHB_DEBUG_SUBSET=100' meson setup build --reconfigure
meson test -C build
```

### Run tests with asan

```shell
meson setup build -Db_sanitize=address --reconfigure
meson compile -C build
meson test -C build
```

### Enable Debug Logging

```shell
CPPFLAGS=-DHB_DEBUG_SUBSET=100 meson build --reconfigure
ninja -C build
```

## Test with the Fuzzer

```shell
CXXFLAGS="-fsanitize=address,fuzzer-no-link" meson fuzzbuild --default-library=static -Dfuzzer_ldflags="-fsanitize=address,fuzzer" -Dexperimental_api=true
ninja -Cfuzzbuild test/fuzzing/hb-{shape,draw,subset,set}-fuzzer
fuzzbuild/test/fuzzing/hb-subset-fuzzer test/fuzzing/fonts
```

## Profiling

```
meson build --reconfigure
meson compile -C build
build/perf/perf
```
[docs] Reorder TESTING.md sections And use --reconfigure where makes sense 2020-08-14 05:44:14 +00:00			`## Build and Test`

			```shell
			`meson build`
			`ninja -Cbuild`
			`meson test -Cbuild`
			```

			`### Debug with GDB`

			```shell
			`meson test -Cbuild --gdb testname`
			```

			`## Build and Run`
[docs] add sample commands for test exec 2019-05-08 16:42:35 +00:00
			Depending on what area you are working in change or add `HB_DEBUG_<whatever>`.
			Values defined in `hb-debug.hh`.

			```shell
[docs] Reorder TESTING.md sections And use --reconfigure where makes sense 2020-08-14 05:44:14 +00:00			`CPPFLAGS='-DHB_DEBUG_SUBSET=100' meson setup build --reconfigure`
[docs] Update TESTING.md with meson 2020-07-30 10:50:17 +00:00			`meson test -C build`
[docs] add sample commands for test exec 2019-05-08 16:42:35 +00:00			```

Update TESTING.md 2019-05-10 23:52:43 +00:00			`### Run tests with asan`

			```shell
[docs] Reorder TESTING.md sections And use --reconfigure where makes sense 2020-08-14 05:44:14 +00:00			`meson setup build -Db_sanitize=address --reconfigure`
[docs] Update TESTING.md with meson 2020-07-30 10:50:17 +00:00			`meson compile -C build`
[docs] minor on TESTING.md 2020-08-04 12:19:27 +00:00			`meson test -C build`
Update TESTING.md 2019-05-10 23:52:43 +00:00			```

[docs] add sample commands for test exec 2019-05-08 16:42:35 +00:00			`### Enable Debug Logging`

			```shell
[docs] Reorder TESTING.md sections And use --reconfigure where makes sense 2020-08-14 05:44:14 +00:00			`CPPFLAGS=-DHB_DEBUG_SUBSET=100 meson build --reconfigure`
[docs] Update TESTING.md with meson 2020-07-30 10:50:17 +00:00			`ninja -C build`
[docs] add sample commands for test exec 2019-05-08 16:42:35 +00:00			```

[docs] add fuzzer instructions (courtesy of Garret) 2019-05-08 16:47:34 +00:00			`## Test with the Fuzzer`

			```shell
[docs] Minor in TESTING.md Start the fuzzer with test/fuzzing/fonts seeds 2020-08-14 05:49:33 +00:00			`CXXFLAGS="-fsanitize=address,fuzzer-no-link" meson fuzzbuild --default-library=static -Dfuzzer_ldflags="-fsanitize=address,fuzzer" -Dexperimental_api=true`
			`ninja -Cfuzzbuild test/fuzzing/hb-{shape,draw,subset,set}-fuzzer`
			`fuzzbuild/test/fuzzing/hb-subset-fuzzer test/fuzzing/fonts`
[docs] add fuzzer instructions (courtesy of Garret) 2019-05-08 16:47:34 +00:00			```
Added profiling instructions to TESTING.md 2019-09-27 16:55:17 +00:00
			`## Profiling`

			```
[docs] Reorder TESTING.md sections And use --reconfigure where makes sense 2020-08-14 05:44:14 +00:00			`meson build --reconfigure`
[docs] Update TESTING.md with meson 2020-07-30 10:50:17 +00:00			`meson compile -C build`
			`build/perf/perf`
Added profiling instructions to TESTING.md 2019-09-27 16:55:17 +00:00			```