lumiera_documentation/tests/basics/singleton-testmock-test.cpp
Ichthyostega 9c74466778 Tests: build an link a test-support library
This is something I wanted to clean-up since a very long time indeed,
but always postponed it, since it requires a lot of nasty clean-up and disentangling....

Several parts had been stashed away into `src/lib/test`, which are not really related:
 * the testrunner and testsuite builder
 * generic helper utilities
 * specialised test-support facilities, e.g. the EventLog

This changeset introduces a new top-level test folder and a namespace `::test`
Code from this folder is linked into a shared library `libtestsupport.so`,
which resides in the linkage hierarchy between »Vessel« and »Vault«,
yet is no longer part of the Lumiera application and only linked into the test-suite.
2026-03-06 23:16:32 +01:00

164 lines
3.9 KiB
C++
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
SingletonTestMock(Test) - using Singleton for injecting Test-Mocks
Copyright (C)
2008, Hermann Vosseler <Ichthyostega@web.de>
  **Lumiera** is free software; you can redistribute it and/or modify it
  under the terms of the GNU General Public License as published by the
  Free Software Foundation; either version 2 of the License, or (at your
  option) any later version. See the file COPYING for further details.
* *****************************************************************/
/** @file singleton-testmock-test.cpp
** unit test \ref SingletonTestMock_test
*/
#include "test/run.hpp"
#include "lib/depend-inject.hpp"
#include "lib/util.hpp"
#include "lib/format-cout.hpp"
#include "lib/format-string.hpp"
using util::_Fmt;
using util::isnil;
namespace lib {
namespace test{
/**
* Client Class normally to be instantiated as Singleton.
* But for tests, this class should be replaced by a Mock....
*/
class TestSingO
{
int callCnt_;
Symbol typid_;
_Fmt msg_;
public:
TestSingO(Symbol ty="TestSingO")
: callCnt_(0)
, typid_(ty)
, msg_("%s::doIt() call=%d\n")
{
TRACE (test, "ctor %s", typid_.c());
}
virtual
~TestSingO()
{
TRACE (test, "dtor %s", typid_.c());
}
void doIt ()
{
++callCnt_;
cout << msg_ % typid_ % callCnt_;
}
int getCnt ()
{
return callCnt_;
}
};
/**
* Mock-1 to replace the Client Class...
*/
struct Mock_1 : TestSingO
{
Mock_1() : TestSingO("Mock_1") { };
};
/**
* Mock-2 to replace the Client Class...
* @note no default ctor
*/
struct Mock_2 : TestSingO
{
int id;
Mock_2(Literal specialID, int i)
: TestSingO{Symbol (_Fmt{"%s_%d"} % specialID % i)}
, id{i}
{ };
};
/***************************************************************//**
* @test inject a Mock object into the Singleton Factory,
* to be returned and used in place of the original object.
* This test covers the full usage cycle: first access the
* Client Object, then replace it by two different mocks,
* and finally restore the original Client Object.
* @see lib::Depend
* @see depend-inject.hpp
* @see DependencyFactory_test
*/
class SingletonTestMock_test : public Test
{
void
run (Arg)
{
Depend<TestSingO> sing;
sing().doIt();
sing().doIt();
CHECK (sing().getCnt() == 2);
{
// shadow by local Mock instance
DependInject<TestSingO>::Local<Mock_1> mock_1;
sing().doIt();
sing().doIt();
sing().doIt();
sing().doIt();
sing().doIt();
CHECK (sing().getCnt() == 5);
// shadow again by different local Mock, this time with special ctor call
int instanceID = 0;
DependInject<TestSingO>::Local<Mock_2> mock_2 ([&]{ return new Mock_2{"Mock", instanceID}; });
// NOTE: the ctor call for the Mock really happens delayed...
instanceID = rani(10);
sing().doIt(); // ctor invoked on first access
CHECK (sing().getCnt() == 1);
// can access the Mock for instrumentation
CHECK (instanceID == mock_2->id);
}// original instance automatically un-shadowed here
CHECK (sing().getCnt() == 2);
sing().doIt();
CHECK (sing().getCnt() == 3);
}
};
/** Register this test class... */
LAUNCHER (SingletonTestMock_test, "unit common");
}} // namespace lib::test