httpdunit.h

Go to the documentation of this file.

/* Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
/*
 * httpdunit.h: a collection of test helper macros designed to reduce test
 * boilerplate and help the build system autogenerate test case definitions.
 *
 * Here's how the magic works:
 *
 * Every test case under test/unit declares test functions using Check's
 * START_TEST or the HTTPD_START_LOOP_TEST macro. The build system searches each
 * source file for those macros and generates an appropriate stub, called
 * test/unit/<filename>.tests, that will add each test function to the test
 * case. This stub is then pulled in by three lines of boilerplate at the end of
 * every test case's source file (see the HTTPD_BEGIN_TEST_CASE documentation,
 * below).
 *
 * The build system uses that same three-line boilerplate to determine the names
 * of all the test cases, and adds them automatically to the main test suite
 * using a similar generate-stub-and-include process.
 */
 
#include "apr.h"   /* for pid_t on Windows, needed by Check */
 
#if defined(__GNUC__)
#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6)
#pragma GCC diagnostic push
#endif
#pragma GCC diagnostic ignored "-Wstrict-prototypes"
#elif defined(__clang__)
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wstrict-prototypes"
#endif
 
#include "check.h"
 
#if defined(__GNUC__)
#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 6)
#pragma GCC diagnostic pop
#endif
#elif defined(__clang__)
#pragma clang diagnostic pop
#endif
 
/*
 * Boilerplate Macros
 */
 
#define HTTPD_BEGIN_TEST_CASE(NAME) \
TCase * NAME##_test_case(void); \
TCase * NAME##_test_case(void) \
{ \
    TCase *testcase = tcase_create(#NAME);
 
#define HTTPD_BEGIN_TEST_CASE_WITH_FIXTURE(NAME, SETUP, TEARDOWN) \
HTTPD_BEGIN_TEST_CASE(NAME) \
    tcase_add_checked_fixture(testcase, (SETUP), (TEARDOWN));
 
#define HTTPD_END_TEST_CASE \
    return testcase; \
}
 
/*
 * Test Declaration Macros
 */
 
#define HTTPD_START_LOOP_TEST(NAME, NUM_ITERATIONS) START_TEST(NAME)