libc/test/UnitTest/README.md

   1 # The LLVM libc unit test framework
   2
   3 This directory contains a lightweight implementation of a
   4 [gtest](https://github.com/google/googletest) like unit test framework for LLVM
   5 libc.
   6
   7 ## Why not gtest?
   8
   9 While gtest is great, featureful and time tested, it uses the C and C++
  10 standard libraries. Hence, using it to test LLVM libc (which is also an
  11 implementation of the C standard libraries) causes various kinds of
  12 mixup/conflict problems.
  13
  14 ## How is it different from gtest?
  15
  16 LLVM libc's unit test framework is much less featureful as compared to gtest.
  17 But, what is available strives to be exactly like gtest.
  18
  19 ## Will it be made as featureful as gtest in future?
  20
  21 It is not clear if LLVM libc needs/will need every feature of gtest. We only
  22 intend to extend it on an _as needed_ basis. Hence, it might never be as
  23 featureful as gtest.