curl/tests/unit
Stefan Eissing 39b9ccea8d
x509asn1: raise size limit for x509 certification information
Raise the limit for certification information from 10 thousand to 100
thousand bytes. Certificates can be larger than 10k.

Change the infof() debug output to add '...' at the end when the max
limit it can handle is exceeded.

Reported-by: Sergio Durigan Junior
Fixes #14352
Closes #14354
2024-08-02 23:20:57 +02:00
..
.gitignore copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
CMakeLists.txt cmake: always build unit tests with the testdeps target 2024-05-27 22:26:41 +02:00
curlcheck.h tests: make the unit test result type CURLcode 2024-05-12 18:53:07 +02:00
Makefile.am nss: remove support for this TLS library 2023-07-29 23:44:28 +02:00
Makefile.inc x509asn1: unittests and fixes for gtime2str 2024-07-30 23:08:59 +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 llist: add Curl_llist_append() 2024-04-11 09:00:51 +02:00
unit1302.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1303.c tests: make the unit test result type CURLcode 2024-05-12 18:53:07 +02:00
unit1304.c test1304: build and skip without netrc support 2023-08-17 17:17:59 +02: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: make the unit test result type CURLcode 2024-05-12 18:53:07 +02:00
unit1309.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1323.c tests: fix bad printf format flags in test code 2023-08-07 10:46:14 +02:00
unit1330.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1394.c windows: use built-in _WIN32 macro to detect Windows 2023-11-22 15:42:25 +00:00
unit1395.c autotools: stop setting -std=gnu89 with --enable-warnings 2023-11-20 22:28:17 +00:00
unit1396.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1397.c gskit: remove 2023-08-07 20:57:48 +02:00
unit1398.c mprintf: overhaul and bugfixes 2023-12-22 09:51:57 +01:00
unit1399.c misc: fix spelling mistakes 2023-05-23 10:42:09 +02:00
unit1600.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1601.c lib: add ability to disable auths individually 2023-09-07 17:45:06 +02:00
unit1602.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1603.c multi: add multi->proto_hash, a key-value store for protocol data 2024-05-26 00:15:01 +02:00
unit1604.c windows: use built-in _WIN32 macro to detect Windows 2023-11-22 15:42:25 +00: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 build: prefer USE_IPV6 macro internally (was: ENABLE_IPV6) 2024-04-13 08:33:26 +00:00
unit1608.c test1608: make it build and get skipped without shuffle DNS support 2023-08-17 17:17:59 +02:00
unit1609.c tests: fix bad printf format flags in test code 2023-08-07 10:46:14 +02:00
unit1610.c lib: add ability to disable auths individually 2023-09-07 17:45:06 +02:00
unit1611.c md4: only build when used 2023-05-13 09:57:35 +02:00
unit1612.c lib: add ability to disable auths individually 2023-09-07 17:45:06 +02:00
unit1614.c noproxy: test bad ipv6 net size first 2024-06-07 00:22:59 +02:00
unit1615.c tests: add SHA-512/256 unit test 2024-02-20 11:36:03 +01:00
unit1616.c http/2, http/3: decouple stream state from easy handle 2024-04-17 14:24:09 +02:00
unit1620.c tests: extend user/password parsing test1620 2024-05-25 23:48:57 +02:00
unit1621.c unit tests: use the unit test infrastructure better 2023-04-01 08:59:38 -07:00
unit1650.c tests: make the unit test result type CURLcode 2024-05-12 18:53:07 +02:00
unit1651.c build: fix some -Wsign-conversion/-Warith-conversion warnings 2023-12-19 12:45:28 +00:00
unit1652.c x509asn1: raise size limit for x509 certification information 2024-08-02 23:20:57 +02:00
unit1653.c checksrc: disallow spaces before labels 2023-05-18 20:45:04 +02:00
unit1654.c checksrc: disallow spaces before labels 2023-05-18 20:45:04 +02:00
unit1655.c unit tests: use the unit test infrastructure better 2023-04-01 08:59:38 -07:00
unit1656.c x509asn1: unittests and fixes for gtime2str 2024-07-30 23:08:59 +02:00
unit1660.c tests: make the unit test result type CURLcode 2024-05-12 18:53:07 +02:00
unit1661.c copyright: update all copyright lines and remove year ranges 2023-01-03 09:19:21 +01:00
unit1663.c socket: support binding to interface *AND* IP 2024-06-04 23:47:54 +02:00
unit2600.c test2600: disable on win32 2024-07-15 23:24:11 +02:00
unit2601.c trace: make tracing available in non-debug builds 2023-08-03 17:32:25 +02:00
unit2602.c trace: make tracing available in non-debug builds 2023-08-03 17:32:25 +02:00
unit2603.c trace: make tracing available in non-debug builds 2023-08-03 17:32:25 +02:00
unit2604.c unit2604: use 'unitfail' instead of 'error' variable 2024-06-19 13:37:36 +02:00
unit3200.c tests: make the unit test result type CURLcode 2024-05-12 18:53:07 +02:00
unit3205.c tidy-up: adjust casing of project names 2024-07-12 13:56:16 +02: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