Mailing-List: contact dev-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@httpd.apache.org
To: httpd-dev <dev@httpd.apache.org>
From: Jacob Champion <champion.p@gmail.com>
Subject: Experimental C unit test suite available for hacking
Message-ID: <999df616-48d6-07d6-25ab-72406bfb3d36@gmail.com>
Date: Thu, 25 May 2017 14:44:49 -0700
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101
 Thunderbird/52.1.1
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
archived-at: Thu, 25 May 2017 21:44:56 -0000

Hi all,

Last week I had a personal hackathon since I couldn't make it out to 
ApacheCon. As a result there is now a C-language unit test suite 
available in branches/httpdunit (based on trunk). I've tested it with a 
Windows+CMake toolchain as well as an Ubuntu+autoconf toolchain.

The suite itself is based on Check, which is a testing library I've had 
some success with in the past. It's supported on a wide variety of 
platforms and has a nice feature of running each test in a separate 
process space, so a crash doesn't derail the entire suite. (Note: Check 
is LGPL.) The build system has been augmented slightly to generate some 
of the more tedious boilerplate code.

If you want to give it a try, just install Check (and, if using the 
configure scripts, make sure Check is visible via pkg-config). The test 
suite will then automatically be added to the default targets. Once 
everything builds you just run the suite directly with

     $ ./test/httpdunit

As a Check binary, it has multiple knobs to control which tests run and 
how the reporting is done, but by default it just runs all the tests and 
prints TAP to stdout.

The example tests that are currently running are testing a new API for 
strict Base64 decoding. Right now it's a feature without a client; I 
included it here because it was a good showcase of the test suite (see 
test/unit/base64.c for the test case code).

Let me know what you think!

--Jacob