Viktor Szakats 96c29900bc build: delete checks for C89 standard headers 1 year ago
..
.gitignore 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
CMakeLists.txt 39e7c22bb4 cmake: add `libcurlu`/`libcurltool` for unit tests 1 year ago
Makefile.am 7c8bae0d9c nss: remove support for this TLS library 1 year ago
Makefile.inc 849b3fed04 unittest/makefile: remove unneeded unit1621_LDADD 1 year ago
README.md 6e3734f74f tests: fix unit tests to run with a dynamic log directory 1 year ago
curlcheck.h 06cdfad49f tests: log the test result code after each libtest 1 year ago
unit1300.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1302.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1303.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1304.c 97a79c79a7 test1304: build and skip without netrc support 1 year ago
unit1305.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1307.c 29d7c3bdbd tests: fix MSVC unreachable code warnings in unit tests 1 year ago
unit1308.c 3aa3cc9b05 misc: better random strings 1 year ago
unit1309.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1323.c 51118ba84c tests: fix bad printf format flags in test code 1 year ago
unit1330.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1394.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1395.c 4cfa5bcc9a urlapi: cleanups 1 year ago
unit1396.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1397.c 78d6232f1f gskit: remove 1 year ago
unit1398.c 51118ba84c tests: fix bad printf format flags in test code 1 year ago
unit1399.c 127eb0d83a misc: fix spelling mistakes 1 year ago
unit1600.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1601.c e92edfbef6 lib: add ability to disable auths individually 1 year ago
unit1602.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1603.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1604.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1605.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1606.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1607.c 51118ba84c tests: fix bad printf format flags in test code 1 year ago
unit1608.c 7c4cb065b7 test1608: make it build and get skipped without shuffle DNS support 1 year ago
unit1609.c 51118ba84c tests: fix bad printf format flags in test code 1 year ago
unit1610.c e92edfbef6 lib: add ability to disable auths individually 1 year ago
unit1611.c e587598534 md4: only build when used 1 year ago
unit1612.c e92edfbef6 lib: add ability to disable auths individually 1 year ago
unit1614.c 29d7c3bdbd tests: fix MSVC unreachable code warnings in unit tests 1 year ago
unit1620.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1621.c a13ef31d0f unit tests: use the unit test infrastructure better 1 year ago
unit1650.c a13ef31d0f unit tests: use the unit test infrastructure better 1 year ago
unit1651.c 78d6232f1f gskit: remove 1 year ago
unit1652.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit1653.c f198d33e8d checksrc: disallow spaces before labels 1 year ago
unit1654.c f198d33e8d checksrc: disallow spaces before labels 1 year ago
unit1655.c a13ef31d0f unit tests: use the unit test infrastructure better 1 year ago
unit1660.c a13ef31d0f unit tests: use the unit test infrastructure better 1 year ago
unit1661.c 2bc1d775f5 copyright: update all copyright lines and remove year ranges 1 year ago
unit2600.c 96c29900bc build: delete checks for C89 standard headers 1 year ago
unit2601.c e12b39e133 trace: make tracing available in non-debug builds 1 year ago
unit2602.c e12b39e133 trace: make tracing available in non-debug builds 1 year ago
unit2603.c e12b39e133 trace: make tracing available in non-debug builds 1 year ago
unit3200.c e90d356570 unit3200: skip testing if function is not present 1 year ago

README.md

Unit tests

The goal is to add tests for all functions in libcurl. If functions are too big and complicated, we should split them into smaller and testable ones.

Build Unit Tests

./configure --enable-debug is required for the unit tests to build. To enable unit tests, there will be a separate static libcurl built that will be used exclusively for linking unit test programs. Just build everything as normal, and then you can run the unit test cases as well.

Run Unit Tests

Unit tests are run as part of the regular test suite. If you have built everything to run unit tests, to can do 'make test' at the root level. Or you can cd tests and make and then invoke individual unit tests with ./runtests.pl NNNN where NNNN is the specific test number.

Debug Unit Tests

If a specific test fails you will get told. The test case then has output left in the %LOGDIR subdirectory, but most importantly you can re-run the test again using gdb by doing ./runtests.pl -g NNNN. That is, add a -g to make it start up gdb and run the same case using that.

Write Unit Tests

We put tests that focus on an area or a specific function into a single C source file. The source file should be named unitNNNN.c where NNNN is a previously unused number.

Add your test to tests/unit/Makefile.inc (if it is a unit test). Add your test data file name to tests/data/Makefile.inc

You also need a separate file called tests/data/testNNNN (using the same number) that describes your test case. See the test1300 file for inspiration and the tests/FILEFORMAT.md documentation.

For the actual C file, here's a simple example: ~~~c

#include "curlcheck.h"

#include "a libcurl header.h" /* from the lib dir */

static CURLcode unit_setup( void )
{
  /* whatever you want done first */
  return CURLE_OK;
}

static void unit_stop( void )
{
  /* done before shutting down and exiting */
}

UNITTEST_START

  /* here you start doing things and checking that the results are good */

  fail_unless( size == 0 , "initial size should be zero" );
  fail_if( head == NULL , "head should not be initiated to NULL" );

  /* you end the test code like this: */

UNITTEST_STOP