curl/tests/unit
Daniel Stenberg 199f2d440d
hostcheck: fix host name wildcard checking
The leftmost "label" of the host name can now only match against single
'*'. Like the browsers have worked for a long time.

- extended unit test 1397 for this
- move some SOURCE variables from unit/Makefile.am to unit/Makefile.inc

Reported-by: Hiroki Kurosawa
Closes #11018
2023-04-26 09:07:27 +02:00
..
.gitignore copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
CMakeLists.txt http2: support HTTP/2 to forward proxies, non-tunneling 2023-04-17 17:27:49 +02:00
curlcheck.h copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
Makefile.am hostcheck: fix host name wildcard checking 2023-04-26 09:07:27 +02:00
Makefile.inc hostcheck: fix host name wildcard checking 2023-04-26 09:07:27 +02:00
README.md tests: fix unit tests to run with a dynamic log directory 2023-03-30 09:53:57 -07:00
unit1300.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1302.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1303.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1304.c tests: fix unit tests to run with a dynamic log directory 2023-03-30 09:53:57 -07:00
unit1305.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1307.c tests: fix MSVC unreachable code warnings in unit tests 2023-03-11 18:54:21 -08:00
unit1308.c tests: fix unit tests to run with a dynamic log directory 2023-03-30 09:53:57 -07:00
unit1309.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1323.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1330.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1394.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1395.c urlapi: cleanups 2023-04-13 08:41:40 +02:00
unit1396.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1397.c hostcheck: fix host name wildcard checking 2023-04-26 09:07:27 +02:00
unit1398.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1399.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1600.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1601.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1602.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1603.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1604.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1605.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1606.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1607.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1608.c unit tests: use the unit test infrastructure better 2023-04-01 08:59:38 -07:00
unit1609.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1610.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1611.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1612.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1614.c tests: fix MSVC unreachable code warnings in unit tests 2023-03-11 18:54:21 -08:00
unit1620.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1621.c unit tests: use the unit test infrastructure better 2023-04-01 08:59:38 -07:00
unit1650.c unit tests: use the unit test infrastructure better 2023-04-01 08:59:38 -07:00
unit1651.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1652.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1653.c urlapi: do the port number extraction without using sscanf() 2023-02-17 16:21:26 +01:00
unit1654.c tests: fix MSVC unreachable code warnings in unit tests 2023-03-11 18:54:21 -08:00
unit1655.c unit tests: use the unit test infrastructure better 2023-04-01 08:59:38 -07:00
unit1660.c unit tests: use the unit test infrastructure better 2023-04-01 08:59:38 -07:00
unit1661.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit2600.c test2600: detect when ALARM_TIMEOUT is in use and adjust 2023-02-22 16:42:36 +01:00
unit2601.c unit tests: use the unit test infrastructure better 2023-04-01 08:59:38 -07:00
unit2602.c http2: support HTTP/2 to forward proxies, non-tunneling 2023-04-17 17:27:49 +02:00
unit2603.c http2: support HTTP/2 to forward proxies, non-tunneling 2023-04-17 17:27:49 +02:00
unit3200.c unit tests: use the unit test infrastructure better 2023-04-01 08:59:38 -07:00

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:


    #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