1
0
mirror of https://github.com/moparisthebest/curl synced 2024-10-31 15:45:12 -04:00
curl/tests
2003-07-28 09:02:15 +00:00
..
data updated to the new ftp dir parsing code that allows a preceeding double 2003-07-28 09:02:15 +00:00
libtest CURLDEBUG not MALLOCDEBUG anymore 2003-07-04 16:37:16 +00:00
server fixed the CONNECT thing again 2003-07-19 23:54:15 +00:00
.cvsignore better ignore 2003-01-07 09:30:05 +00:00
FILEFORMAT swsclose added 2003-07-19 23:56:44 +00:00
ftpserver.pl oops, committed test code not meant to be here 2003-04-09 12:02:06 +00:00
ftpsserver.pl pass srcdir to the ftps-server as well 2003-01-21 10:29:06 +00:00
getpart.pm make the diffs with 'diff -u' to make them nicer and easier to read 2003-04-30 17:15:00 +00:00
httpserver.pl cut off the old perl one, this only runs the C coded version 2002-02-19 01:03:45 +00:00
httpsserver.pl skip the chmod 2003-01-21 15:09:20 +00:00
Makefile.am make test-full in the root dir should run verbose tests but not stop on 2003-01-21 10:35:34 +00:00
memanalyze.pl pass a file name to memanalyze to read from instead of using stdin 2003-01-09 11:26:57 +00:00
README CURLDEBUG is the symbol now 2003-07-22 09:57:09 +00:00
runtests.pl produce a skip-report at the end of all tests, and thus record and count 2003-06-26 11:44:01 +00:00
stunnel.pem added stunnel PEM 2001-09-17 08:41:45 +00:00
stunnel.pm scan through the PATH as well, to find stunnel 2003-02-03 22:15:33 +00:00

                                  _   _ ____  _     
                              ___| | | |  _ \| |    
                             / __| | | | |_) | |    
                            | (__| |_| |  _ <| |___ 
                             \___|\___/|_| \_\_____|

The cURL Test Suite

Requires:
  perl (and a unix-style shell)
  diff (when a test fail, a diff is shown)
  stunnel (for HTTPS and FTPS tests)

Run:
  'make test'. This invokes the 'runtests.pl' perl script. Edit the top
  variables of that script in case you have some specific needs.

  The script breaks on the first test that doesn't do OK. Use -a to prevent
  the script to abort on the first error. Run the script with -v for more
  verbose output. Use -d to run the test servers with debug output enabled as
  well.

  Use -s for shorter output, or pass test numbers to run specific tests only
  (like "./runtests.pl 3 4" to test 3 and 4 only). It also supports test case
  ranges with 'to'. As in "./runtests 3 to 9" which runs the seven tests from
  3 to 9.

Memory:
  The test script will check that all allocated memory is freed properly IF
  curl has been built with the CURLDEBUG define set. The script will
  automatically detect if that is the case, and it will use the ../memanalyze
  script to analyze the memory debugging output.

Debug:
  If a test case fails, you can conveniently get the script to invoke the
  debugger (gdb) for you with the server running and the exact same command
  line parameters that failed. Just invoke 'runtests.pl <test number> -g' and
  then just type 'run' in the debugger to perform the command through the
  debugger.

  If a test case causes a core dump, analyze it by running gdb like:

          # gdb ../curl/src core

  ... and get a stack trace with the gdb command:

          (gdb) where

Logs:
  All logs are generated in the logs/ subdirctory (it is emtpied first
  in the runtests.pl script). Use runtests.pl -k to make the temporary files
  to be kept after the test run.

Data:
  All test cases are put in the data/ subdirctory. Each test is stored in the
  file named according to the test number.

  The test case file format is simply a way to store different sections within
  the same physical file. The different sections are to be described here
  within shortly.


TEST CASE NUMBERS

 So far, I've used this system:

 1   -  99   HTTP
 100 - 199   FTP
 200 - 299   FILE
 300 - 399   HTTPS
 400 - 499   FTPS
 500 - 599   libcurl source code tests, not using the curl command tool

 Since 30-apr-2003, there's nothing in the system that requires us to keep
 within these number series. Each test case now specifies its own server
 requirements, independent of test number.

TODO:

  * Add persistant connection support and test cases