#include <KTestSystem.hh>

Description

Kinoko system designed to execute tests.

Definition at line 14 of file KTestSystem.hh.

Inheritance diagram for KTestSystem:

Classes
struct	TestCase

struct	TestData

Public Member Functions
void	init () override
	Initializes the system.

void	calc () override
	Executes a frame.

bool	run () override
	Executes a run.

void	parseOptions (int argc, char **argv) override
	Parses non-generic command line options.

Public Member Functions inherited from KSystem

Static Public Member Functions
static KTestSystem *	CreateInstance ()

static void	DestroyInstance ()

static KTestSystem *	Instance ()

Private Member Functions
	KTestSystem (const KTestSystem &)=delete

	KTestSystem (KTestSystem &&)=delete

template<IntegralType T>
void	checkDesync (const T &t0, const T &t1, const char *name)

template<typename T >
void	checkDesync (const T &t0, const T &t1, const char *name)

void	checkDesync (const f32 &t0, const f32 &t1, const char *name)

void	initSuite ()

void	startNextTestCase ()
	Starts the next test case.

bool	popTestCase ()
	Pops the current test case and frees the KRKG buffer.

bool	calcTest ()
	Checks one frame in the test.

TestData	findCurrentFrameEntry ()
	Finds the test data of the current frame.

void	testFrame (const TestData &data)
	Tests the frame against the provided test data.

bool	runTest ()
	Runs a single test case, and ends when the test is finished or when a desync is found.

void	writeTestOutput () const
	Writes details about the current test to file.

const TestCase &	getCurrentTestCase () const
	Gets the current test case.

Static Private Member Functions
static void	OnInit (System::RaceConfig config, void arg)
	Initializes the race configuration as needed for test cases.

Private Attributes
EGG::SceneManager *	m_sceneMgr

EGG::RamStream	m_stream

std::queue< TestCase >	m_testCases

Host::EOption	m_testMode
	Differentiates between test suite and ghost+krkg.

u16	m_versionMajor

u16	m_versionMinor

u16	m_frameCount

u16	m_currentFrame

bool	m_sync

Additional Inherited Members
Static Protected Attributes inherited from KSystem
static KSystem *	s_instance = nullptr

Constructor & Destructor Documentation

◆ KTestSystem()

KTestSystem::KTestSystem ( )

private

Definition at line 225 of file KTestSystem.cc.

Member Function Documentation

◆ ~KTestSystem()

KTestSystem::~KTestSystem ( )

overrideprivate

Definition at line 227 of file KTestSystem.cc.

◆ calc()

void KTestSystem::calc ( )

overridevirtual

Executes a frame.

Implements KSystem.

Definition at line 106 of file KTestSystem.cc.

◆ calcTest()

bool KTestSystem::calcTest ( )

private

Checks one frame in the test.

Returns: Whether the test can continue.

Definition at line 276 of file KTestSystem.cc.

◆ checkDesync() [1/3]

void KTestSystem::checkDesync	(	const f32 &	t0,
		const f32 &	t1,
		const char *	name )

inlineprivate

Definition at line 103 of file KTestSystem.hh.

◆ checkDesync() [2/3]

template<IntegralType T>

void KTestSystem::checkDesync	(	const T &	t0,
		const T &	t1,
		const char *	name )

inlineprivate

Definition at line 62 of file KTestSystem.hh.

◆ checkDesync() [3/3]

template<typename T >

void KTestSystem::checkDesync	(	const T &	t0,
		const T &	t1,
		const char *	name )

inlineprivate

Definition at line 80 of file KTestSystem.hh.

◆ CreateInstance()

KTestSystem * KTestSystem::CreateInstance ( )

static

Definition at line 212 of file KTestSystem.cc.

◆ DestroyInstance()

void KTestSystem::DestroyInstance ( )

static

Definition at line 218 of file KTestSystem.cc.

◆ findCurrentFrameEntry()

KTestSystem::TestData KTestSystem::findCurrentFrameEntry ( )

private

Finds the test data of the current frame.

Returns: The test data of the current frame.

Definition at line 295 of file KTestSystem.cc.

◆ getCurrentTestCase()

const KTestSystem::TestCase & KTestSystem::getCurrentTestCase ( ) const

private

Gets the current test case.

In the event that there is no active test case, this gets the next test case.

Returns: The current test case.

Definition at line 428 of file KTestSystem.cc.

◆ init()

void KTestSystem::init ( )

overridevirtual

Initializes the system.

Implements KSystem.

Definition at line 31 of file KTestSystem.cc.

◆ initSuite()

void KTestSystem::initSuite ( )

private

This reads over the KRKG and generates the list of test cases, before starting the first test case and initializing the race scene.

Definition at line 48 of file KTestSystem.cc.

◆ Instance()

static KTestSystem * KTestSystem::Instance ( )

inlinestatic

Definition at line 24 of file KTestSystem.hh.

◆ OnInit()

void KTestSystem::OnInit	(	System::RaceConfig *	config,
		void *	arg )

staticprivate

Initializes the race configuration as needed for test cases.

Parameters

config	The race configuration instance.
arg	Unused optional argument.

Definition at line 436 of file KTestSystem.cc.

◆ parseOptions()

void KTestSystem::parseOptions	(	int	argc,
		char **	argv )

overridevirtual

Parses non-generic command line options.

Test mode currently accepts either a suite of tests or a RKG + KRKG.

Parameters

argc	The number of arguments.
argv	The arguments.

Implements KSystem.

Definition at line 136 of file KTestSystem.cc.

◆ popTestCase()

bool KTestSystem::popTestCase ( )

private

Pops the current test case and frees the KRKG buffer.

Returns: Whether the queue still has elements remaining.

Definition at line 266 of file KTestSystem.cc.

◆ run()

bool KTestSystem::run ( )

overridevirtual

Executes a run.

A run consists of iterating over all tests.

Returns: Whether the run was successful or not.

Implements KSystem.

Definition at line 113 of file KTestSystem.cc.

◆ runTest()

bool KTestSystem::runTest ( )

private

Runs a single test case, and ends when the test is finished or when a desync is found.

This will also accumulate results in results.txt.

Returns: Whether the run synchronized or desynchronized.

Definition at line 403 of file KTestSystem.cc.

◆ startNextTestCase()

void KTestSystem::startNextTestCase ( )

private

Starts the next test case.

Definition at line 235 of file KTestSystem.cc.

◆ testFrame()

void KTestSystem::testFrame ( const TestData & data )

private

Tests the frame against the provided test data.

Parameters

data	The test data to compare against.

Definition at line 356 of file KTestSystem.cc.

◆ writeTestOutput()

void KTestSystem::writeTestOutput ( ) const

private

Writes details about the current test to file.

This is designed to be cumulative across multiple tests.

Definition at line 417 of file KTestSystem.cc.

Member Data Documentation

◆ m_currentFrame

u16 KTestSystem::m_currentFrame

private

Definition at line 150 of file KTestSystem.hh.

◆ m_frameCount

u16 KTestSystem::m_frameCount

private

Definition at line 149 of file KTestSystem.hh.

◆ m_sceneMgr

EGG::SceneManager* KTestSystem::m_sceneMgr

private

Definition at line 142 of file KTestSystem.hh.

◆ m_stream

EGG::RamStream KTestSystem::m_stream

private

Definition at line 143 of file KTestSystem.hh.

◆ m_sync

bool KTestSystem::m_sync

private

Definition at line 151 of file KTestSystem.hh.

◆ m_testCases

std::queue<TestCase> KTestSystem::m_testCases

private

Definition at line 144 of file KTestSystem.hh.

◆ m_testMode

Host::EOption KTestSystem::m_testMode

private

Differentiates between test suite and ghost+krkg.

Definition at line 145 of file KTestSystem.hh.

◆ m_versionMajor

u16 KTestSystem::m_versionMajor

private

Definition at line 147 of file KTestSystem.hh.

◆ m_versionMinor

u16 KTestSystem::m_versionMinor

private

Definition at line 148 of file KTestSystem.hh.

Description

Classes

Public Member Functions

Static Public Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ KTestSystem()

Member Function Documentation

◆ ~KTestSystem()

◆ calc()

◆ calcTest()

◆ checkDesync() [1/3]

◆ checkDesync() [2/3]

◆ checkDesync() [3/3]

◆ CreateInstance()

◆ DestroyInstance()

◆ findCurrentFrameEntry()

◆ getCurrentTestCase()

◆ init()

◆ initSuite()

◆ Instance()

◆ OnInit()

◆ parseOptions()

◆ popTestCase()

◆ run()

◆ runTest()

◆ startNextTestCase()

◆ testFrame()

◆ writeTestOutput()

Member Data Documentation

◆ m_currentFrame

◆ m_frameCount

◆ m_sceneMgr

◆ m_stream

◆ m_sync

◆ m_testCases

◆ m_testMode

◆ m_versionMajor

◆ m_versionMinor