kc3-lang/harfbuzz/TESTING.md

Branch : - branch - main - tag -

• Show log

  Commit

• Author : Behdad Esfahbod
  Date : 2022-06-04 06:01:17
  Hash : 3972ec73
  Message : [TESTING.md] Update profiling instructions.

• 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
  
  For profiling, see `perf/README.md`.