| Index: third_party/libusb/src/tests/libusbx_testlib.h
|
| diff --git a/third_party/libusb/src/tests/libusbx_testlib.h b/third_party/libusb/src/tests/libusbx_testlib.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..06dbc8ec7e9ec0077ea3decfcb8a0c15b3374929
|
| --- /dev/null
|
| +++ b/third_party/libusb/src/tests/libusbx_testlib.h
|
| @@ -0,0 +1,107 @@
|
| +/*
|
| + * libusbx test library helper functions
|
| + * Copyright © 2012 Toby Gray <toby.gray@realvnc.com>
|
| + *
|
| + * This library is free software; you can redistribute it and/or
|
| + * modify it under the terms of the GNU Lesser General Public
|
| + * License as published by the Free Software Foundation; either
|
| + * version 2.1 of the License, or (at your option) any later version.
|
| + *
|
| + * This library is distributed in the hope that it will be useful,
|
| + * but WITHOUT ANY WARRANTY; without even the implied warranty of
|
| + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
| + * Lesser General Public License for more details.
|
| + *
|
| + * You should have received a copy of the GNU Lesser General Public
|
| + * License along with this library; if not, write to the Free Software
|
| + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
| + */
|
| +
|
| +#ifndef LIBUSBX_TESTLIB_H
|
| +#define LIBUSBX_TESTLIB_H
|
| +
|
| +#include <stdio.h>
|
| +
|
| +#if !defined(bool)
|
| +#define bool int
|
| +#endif
|
| +#if !defined(true)
|
| +#define true (1 == 1)
|
| +#endif
|
| +#if !defined(false)
|
| +#define false (!true)
|
| +#endif
|
| +
|
| +/** Values returned from a test function to indicate test result */
|
| +typedef enum {
|
| + /** Indicates that the test ran successfully. */
|
| + TEST_STATUS_SUCCESS,
|
| + /** Indicates that the test failed one or more test. */
|
| + TEST_STATUS_FAILURE,
|
| + /** Indicates that an unexpected error occurred. */
|
| + TEST_STATUS_ERROR,
|
| + /** Indicates that the test can't be run. For example this may be
|
| + * due to no suitable device being connected to perform the tests.*/
|
| + TEST_STATUS_SKIP
|
| +} libusbx_testlib_result;
|
| +
|
| +/**
|
| + * Context for test library functions
|
| + */
|
| +typedef struct {
|
| + char ** test_names;
|
| + int test_count;
|
| + bool list_tests;
|
| + bool verbose;
|
| + int old_stdout;
|
| + int old_stderr;
|
| + FILE* output_file;
|
| + int null_fd;
|
| +} libusbx_testlib_ctx;
|
| +
|
| +/**
|
| + * Logs some test information or state
|
| + */
|
| +void libusbx_testlib_logf(libusbx_testlib_ctx * ctx,
|
| + const char* fmt, ...);
|
| +
|
| +/**
|
| + * Function pointer for a libusbx test function.
|
| + *
|
| + * Should return TEST_STATUS_SUCCESS on success or another TEST_STATUS value.
|
| + */
|
| +typedef libusbx_testlib_result
|
| +(*libusbx_testlib_test_function)(libusbx_testlib_ctx * ctx);
|
| +
|
| +/**
|
| + * Structure holding a test description.
|
| + */
|
| +typedef struct {
|
| + /** Human readable name of the test. */
|
| + const char * name;
|
| + /** The test library will call this function to run the test. */
|
| + libusbx_testlib_test_function function;
|
| +} libusbx_testlib_test;
|
| +
|
| +/**
|
| + * Value to use at the end of a test array to indicate the last
|
| + * element.
|
| + */
|
| +#define LIBUSBX_NULL_TEST {NULL, NULL}
|
| +
|
| +/**
|
| + * Runs the tests provided.
|
| + *
|
| + * Before running any tests argc and argv will be processed
|
| + * to determine the mode of operation.
|
| + *
|
| + * \param argc The argc from main
|
| + * \param argv The argv from main
|
| + * \param tests A NULL_TEST terminated array of tests
|
| + * \return 0 on success, non-zero on failure
|
| + */
|
| +int libusbx_testlib_run_tests(int argc,
|
| + char ** argv,
|
| + const libusbx_testlib_test * tests);
|
| +
|
| +#endif //LIBUSBX_TESTLIB_H
|
|
|