| 1 | README.tests
|
|---|
| 2 |
|
|---|
| 3 | Instructions for standalone test regressions of libxml2
|
|---|
| 4 |
|
|---|
| 5 | libxml2-tests-$version.tar.gz contains 3 standalone C programs as well
|
|---|
| 6 | as a large amount of tests and results coming from libxml2 itself and
|
|---|
| 7 | from W3C, NIST, Sun Microsystems, Microsoft and James Clark. Each C
|
|---|
| 8 | program has a different testing purpose:
|
|---|
| 9 |
|
|---|
| 10 | runtest.c : runs libxml2 basic internal regression tests
|
|---|
| 11 | runsuite.c: runs libxml2 against external regression tests
|
|---|
| 12 | testapi.c : exercises the library public entry points
|
|---|
| 13 | testchar.c: exercise the check of character ranges and UTF-8 validation
|
|---|
| 14 |
|
|---|
| 15 | The command:
|
|---|
| 16 |
|
|---|
| 17 | make check
|
|---|
| 18 | or
|
|---|
| 19 | make -f Makefile.tests check
|
|---|
| 20 |
|
|---|
| 21 | should be sufficient on an Unix system to build and exercise the tests
|
|---|
| 22 | for the version of the library installed on the system. Note however
|
|---|
| 23 | that there isn't backward compatibility provided so if the installed
|
|---|
| 24 | version is older than the testsuite one, failing to compile or run the tests
|
|---|
| 25 | is likely. In any event this won't work with an installed libxml2 older
|
|---|
| 26 | than 2.6.20.
|
|---|
| 27 |
|
|---|
| 28 | Building on other platforms should be a matter of compiling the C files
|
|---|
| 29 | like any other program using libxml2, running the test should be done
|
|---|
| 30 | simply by launching the resulting executables.
|
|---|
| 31 |
|
|---|
| 32 | Also note the availability of a "make valgrind" target which will run the
|
|---|
| 33 | above tests under valgrind to check for memory errors (but this relies
|
|---|
| 34 | on the availability of the valgrind command and take far more time to
|
|---|
| 35 | complete).
|
|---|
| 36 |
|
|---|
| 37 | Daniel Veillard
|
|---|
| 38 | Mon May 7 2012
|
|---|
| 39 |
|
|---|
