1
0
mirror of https://github.com/moparisthebest/curl synced 2024-12-24 00:58:48 -05:00
curl/tests/unit
Marcel Raad 208c77713a
unit1307: just fail without FTP support
I missed to check this in with commit
71786c0505, which only disabled the test.
This fixes the actual linker error.

Closes https://github.com/curl/curl/pull/3568
2019-02-15 09:50:52 +01:00
..
.gitignore tests/unit/.gitignore: hide unit1601 and above, too 2015-04-22 14:20:20 +02:00
CMakeLists.txt tests: add unit tests for url.c 2018-09-05 14:30:48 +02:00
curlcheck.h whitespace fixes 2018-09-23 22:24:02 +00:00
Makefile.am build: get CFLAGS (including -werror) used for examples and tests 2018-03-04 19:46:26 +01:00
Makefile.inc xattr: strip credentials from any URL that is stored 2019-01-10 10:49:51 +01:00
README CURLOPT_RESOLVE: always purge old entry first 2018-06-01 12:47:52 +02:00
unit1300.c unit1300: fix stack-use-after-scope AddressSanitizer warning 2018-10-29 08:05:23 +01:00
unit1301.c unit1301: fix error message on first test 2017-08-31 11:37:13 +02:00
unit1302.c tests: Make sure libtests & unittests call curl_global_cleanup() 2017-08-26 22:01:42 +02:00
unit1303.c cppcheck: fix warnings 2018-06-11 11:14:48 +02:00
unit1304.c netrc: don't ignore the login name specified with "--user" 2018-11-05 20:34:01 +01:00
unit1305.c code style: use spaces around pluses 2017-09-11 09:29:50 +02:00
unit1307.c unit1307: just fail without FTP support 2019-02-15 09:50:52 +01:00
unit1308.c mime: tests and examples. 2017-09-02 19:08:45 +01:00
unit1309.c tests: Fix format specifiers 2018-05-14 09:42:27 +02:00
unit1323.c timediff: return timediff_t from the time diff functions 2017-10-25 09:54:37 +02:00
unit1330.c URLs: change all http:// URLs to https:// 2016-02-03 00:19:02 +01:00
unit1394.c ssl: set engine implicitly when a PKCS#11 URI is provided 2018-08-08 09:46:01 +02:00
unit1395.c tests: Fix format specifiers 2018-05-14 09:42:27 +02:00
unit1396.c code style: use spaces around equals signs 2017-09-11 09:29:50 +02:00
unit1397.c axtls: removed 2018-11-01 10:29:53 +01:00
unit1398.c snprintf: renamed and we now only use msnprintf() 2018-11-23 08:26:51 +01:00
unit1399.c snprintf: renamed and we now only use msnprintf() 2018-11-23 08:26:51 +01:00
unit1600.c tests: Make sure libtests & unittests call curl_global_cleanup() 2017-08-26 22:01:42 +02:00
unit1601.c unit: make unit test source code checksrc compliant 2016-04-03 22:38:36 +02:00
unit1602.c checksrc: white space edits to comply to stricter checksrc 2016-11-24 23:58:22 +01:00
unit1603.c code: style updates 2016-04-03 22:38:36 +02:00
unit1604.c snprintf: renamed and we now only use msnprintf() 2018-11-23 08:26:51 +01:00
unit1605.c tests: Make sure libtests & unittests call curl_global_cleanup() 2017-08-26 22:01:42 +02:00
unit1606.c unit1606: Fixed shadowed variable warning 2017-08-28 23:55:55 +02:00
unit1607.c cleanup: make local functions static 2019-02-10 18:38:57 +01:00
unit1608.c cleanup: make local functions static 2019-02-10 18:38:57 +01:00
unit1609.c cleanup: make local functions static 2019-02-10 18:38:57 +01:00
unit1620.c urldata: rename easy_conn to just conn 2019-01-11 15:35:13 +01:00
unit1621.c xattr: strip credentials from any URL that is stored 2019-01-10 10:49:51 +01:00
unit1650.c printf: fix format specifiers 2019-01-04 23:50:48 +01:00
unit1651.c test1651: unit test Curl_extract_certinfo() 2018-10-27 15:59:43 +02:00
unit1652.c snprintf: renamed and we now only use msnprintf() 2018-11-23 08:26:51 +01:00
unit1653.c unit1653: make it survive torture tests 2019-01-28 08:44:15 +01: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 log/ 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
number that starts with 1300 and you can pick the next free number.

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 documentation.

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

----------------------- start -------------------------------
#include "curlcheck.h"

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

static void unit_setup( void )
{
  /* whatever you want done first */
}

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

----------------------- end -------------------------------