aboutsummaryrefslogtreecommitdiff
path: root/APEX_1.4/include/TestBase.h
blob: e6a69086987743dc21bfadfa36ccbfadfb83309c (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
/*
 * Copyright (c) 2008-2017, NVIDIA CORPORATION.  All rights reserved.
 *
 * NVIDIA CORPORATION and its licensors retain all intellectual property
 * and proprietary rights in and to this software, related documentation
 * and any modifications thereto.  Any use, reproduction, disclosure or
 * distribution of this software and related documentation without an express
 * license agreement from NVIDIA CORPORATION is strictly prohibited.
 */


#ifndef TEST_BASE_H
#define TEST_BASE_H

#include "ApexUsingNamespace.h"

/*!
\file
\brief An TestBase is an interface for managing unit tests
*/

namespace nvidia
{

namespace apex
{

class Actor;

/**
	Interface for user's unit tests
*/
class TestFunctionInterface
{
public:

	/**
		Constructor for TestFunctionInterface
	*/
	TestFunctionInterface(const char* name) : mName(name) {}
	
	/**
		Run CPU tests, returns true if all tests passed
	*/
	virtual bool run(void*, void*) = 0;
	
	/**
		Check state, true if user's test object in correct state
	*/
	virtual bool check(void*, void*) = 0;

	/**
		Run GPU tests, returns true if all tests passed
	*/
	virtual bool runGpu(void*, void*, void*) = 0;

	/**
		User's test name
	*/
	const char* mName;
};

/**
	Defines the UnitTestsActor API which is instantiated from an UnitTestsAsset
*/
class TestBase
{
public:

	/**
	\brief Returns the name of the test at this index.

	\param [in] unitTestsIndex : The test number to refer to; must be less than the result of getUnitTestCount
	*/
	virtual const char* getUnitTestsName(uint32_t unitTestsIndex) const = 0;

	/**
	\brief Returns the index of the test for this name.

	\param [in] unitTestsName : The test name to refer to; if there is no such name method returns -1
	*/
	virtual uint32_t getUnitTestsIndex(const char* unitTestsName) const = 0;

	/**
	\brief run unit test

	\param [in] unitTestsID : The unit test number to refer to; must be less than the result of getUnitTestsCount
	\param [in] dataPtr : The pointer to data which is needed for unit test.
	*/
	virtual bool runUnitTests(uint32_t unitTestsID, void* dataPtr) const = 0;

	/**
	\brief check unit test
	*/
	virtual bool checkUnitTests(uint32_t unitTestsID, void* dataPtr) const = 0;

	/**
	\brief returns the number of unit tests
	*/
	virtual uint32_t getUnitTestsCount() const = 0;

	/**
	\brief set level of runtime check
	\param [in] level - level of runtime check

	 level = 0 - no runtime checks
	 level = 1 - easy-weight checks. Perfomance should not drop more than 10-20%
	 level = 2 - medium-weight checks. Perfomance drop less than 300-500%
	 level = 3 - hard-weight checks. Perfomance drop isn't limited
	*/
	virtual void setRuntimeCheckLevel(uint32_t level) = 0;
};


}; // end of apex namespace
}; // end of nvidia namespace

#endif